您当前的位置: 首页 > Web服务 API > 逆地理编码

逆地理编码
逆地理编码服务将经纬度转换为对应位置(例如区域、道路、小区等)信息。
功能介绍
通过对请求的单个或多个经纬度进行解析并返回该经纬度附近的地址信息或POI信息;支持对请求的图面范围匹配合适的行政区划范围。
接口名
https://api.careland.com.cn/api/v2/mrgeo
HTTP请求方式
post、get
请求参数
  • 参数名称 是否必填 默认值 格式举例 说明
    ak
    用户key
    xytype 0
    坐标类型:
    0为凯立德坐标系
    1WGS84坐标系
    2为国家加密坐标系
    p
    116.481488,39.990464;
    116.45669,39.984989
    经纬度坐标;最多支持20个坐标点;多个点之间用";"分割
    range
    定义查询最大范围,默认为1000米
    callback all base,poi,aoi
    回调函数
    callback值是用户定义的函数名称,此参数只在output=json时有效
    extension
    可通过该参数控制返回类型的扩展结果,多个类型之间以半角“,”分隔,例如 poi,road。
    该参数包含 base,返回附近基础信息;
    该参数包含 poi,返回附近 POI(pois);
    该参数包含 aoi,返回附近 AOI(aois);
    该参数包含
    businessarea,返回附近businessAreas();
    streetnumber,返回附近streetNumber();
    all 包含以上各项信息。
  • 请求示例
    https://api.careland.com.cn/api/v2/mrgeo?ak=<您的密匙>&p=419272064,143904887
    返回结果示例
    {
    	"errorMessage": "ok",
    	"results": {
    		"pcd": {
    			"citycode": "010",
    			"province": "北京市",
    			"adcode": "110102",
    			"district": "西城区",
    			"city": "北京市",
    			"country": "中国"
    		},
    		"formatted_address": "中国银行总行大厦",
    		"aois": [{
    			"distance": "11.64",
    			"name": "中国银行总行大厦",
    			"xy": {
    				"y": 143906499,
    				"x": 419275747
    			}
    		}
    		...		
    		],
    		"pois": [{
    			"distance": "24.93",
    			"address": "北京市西城区金融街街道复兴门内大街45号4号楼402室",
    			"direction": "西",
    			"name": "盈辉科创技术培训中心",
    			"type": "科教文化服务,培训机构",
    			"xy": {
    				"y": 143905002,
    				"x": 419271024
    			}
    		 }
    		...
    		],
    		"businessAreas": [{
    			"name": "西单",
    			"xy": {
    				"y": 143916057,
    				"x": 419280503
    			}
    		}]
    	},
    	"errorCode": 0
    }
        
    返回参数说明
  • 名称 类型 说明
    errorCode String 错误代码
    errorMessage String 错误代码
    results Object[] 返回的地理编码结果
    p Object 解析描述性地址返回的坐标结果
    x String 经度
    y String 纬度
    pcd Object 返回结果所在的省市区
    adcode String 行政区划代码
    province String 省、直辖市名称
    province_code Int 省、直辖市代码
    city_code Int 地市代码
    city String 地市名称
    district String 县区名称
    aois Object[]
    name String 当前层级的名称,例如 广东省
    distance String 地址信息是否在 aoi 面之中 0,代表在 aoi 内。其余整数代表距离 AOI 的距离
    xy Object 当前层级的中心点坐标
    x String 经度
    y String 纬度
    pois Object[]
    address String 地址
    direction String 方向
    distance String 地址信息是否在 aoi 面之中 0,代表在 aoi 内 。其余整数代表距离 AOI 的距离
    name String 名称
    type String 类型
    xy Object 当前层级的中心点坐标
    x String 经度
    y String 纬度
    businessAreas Object[]
    name String
    xy Object 坐标信息
    x String 经度
    y String 纬度
    formatted_address String 结构化地址