逆地理编码服务将经纬度转换为对应位置（例如区域、道路、小区等）信息。

通过对请求的单个或多个经纬度进行解析并返回该经纬度附近的地址信息或POI信息；支持对请求的图面范围匹配合适的行政区划范围。

https://api.careland.com.cn/api/v2/rgeo

post、get

请求参数

参数名称	是否必填	默认值	格式举例	说明
ak	是			用户key
xytype	否	0		坐标类型： 0为凯立德坐标系 1WGS84坐标系 2为国家加密坐标系
userid	否			用户id
p	是		116.481488,39.990464; 116.45669,39.984989	经纬度坐标;最多支持20个坐标点;多个点之间用";"分割
show_address	否		show_address=true show_address=false	是否返回匹配的地址信息
point_type	否	RGEO_SINGLE		定义逆地理编码查询类型 RGEO_SINGLE：单点逆地理编码结果返回 RGEO_BATCH：多点逆地理编码结果返回默认为RGEO_SINGLE
pn	否			定义返回的POI数量(最多返回10条POI数据)
range	否			定义查询最大范围，默认为1000米
detail_level	否	DETAIL_REGULAR		返回结果的详细程度。默认DETAIL_RE1GULAR。DETAIL_BRIEF：返回poi基础信息，如名称、地址等； DETAIL_VERBOSE：增加返回poi全量的深度信息，如小区的多边形等；
app	否	webapi		应用名称及版本（基础服务统计用）
sort_regulation	否	1		1默认,2物流行业
adcode_type	否	0	0或1	输入输出行政区编码类型 0 凯立德标准编码 1 国际标准编码当输入adcode_type=1时，输入的行政区编码会优先检查是否是国际标准，不是国际标准会再次检查是否是凯立德编码，当adcode_type=0时，只会检查凯立德编码。
callback	否			回调函数 callback值是用户定义的函数名称，此参数只在output=json时有效

注：xytype为1时，输入坐标为WGS84坐标系，输出为凯立德坐标系

请求示例

https://api.careland.com.cn/api/v2/rgeo?ak=<您的密匙>&userid=23623198&pn=2&range=10&p=410817100,81363000

返回结果示例

{
"errorCode": "0",
"errorMessage": "ok",
"results": [
{
    "pcd": {
        "adcode": 440304,
        "province": "广东省",
        "province_code":440000, 
        "city_code":440300,
        "city": "深圳市",
        "district": "福田区"
    },
    "address": "",
    "xy": {
        "x": "114115861",
        "y": "22600833"
    },
    "locations": [
        {
            "name": "香蜜湖街道",
            "level": "GEO_TOWN",
            "xy": {
                "name": 0,
                "level": 0
            }
        },
        {
            "name": "车公庙",
            "level": "GEO_AREA",
            "xy": {
                "name": 0,
                "level": 0
            }
        },
        {
            "name": "深南大道",
            "level": "GEO_ROAD",
            "xy": {
                "name": 114115747,
                "level": 22601495
            }
        },
        {
            "name": "6023号",
            "level": "GEO_NUMBER",
            "xy": {
                "name": 0,
                "level": 0
            }
        },
        {
            "name": "创建大厦",
            "level": "GEO_AOI",
            "xy": {
                "name": 0,
                "level": 0
            }
        }
    ],
    "pois": [
        {
            "id": "16963280",
            "name": "西南证券",
            "address": "",
            "haspcd": true,
            "pcd": {
                "adcode": 440304,
                "province": "广东省",
                "province_code":440000, 
                "city_code":440300,
                "city": "深圳市",
                "district": "福田区"
            },
            "tel_num": [],
            "hasxy": true,
            "xy": {
                "x": "114115853",
                "y": "22600918"
            },
            "type_code": 0,
            "type_name": "",
            "road_id": 0,
            "distance": 9,
            "preferred": true,
            "shapesflag": false,
            "hassubpois": false,
            "hasdeepinfo": false,
            "routingpointscount": 0,
            "hasshapes": false
        },
        {
            "id": "18518133",
            "name": "创建美食城东入口",
            "address": "广东省深圳市福田区深南大道6023号创建大厦",
            "haspcd": true,
            "pcd": {
                "adcode": 440304,
                "province": "广东省",
                "province_code":440000, 
                "city_code":440300,
                "city": "深圳市",
                "district": "福田区"
            },
            "tel_num": [],
            "hasxy": true,
            "xy": {
                "x": "114116028",
                "y": "22600679"
            },
            "type_code": 0,
            "type_name": "",
            "road_id": 0,
            "distance": 24,
            "preferred": true,
            "shapesflag": false,
            "hassubpois": false,
            "hasdeepinfo": false,
            "routingpointscount": 0,
            "hasshapes": false
        }
    ]
}]
}

返回参数说明

名称				类型	说明
errorCode				String	错误代码
errorMessage				String	错误代码
results				Object[]	返回的地理编码结果
	pcd			Object	返回结果所在的省市区
		adcode		String	行政区划代码
		province		String	省、直辖市名称
		province_code		Int	省、直辖市代码
		city_code		Int	地市代码
		city		String	地市名称
		district		String	县区名称
	locations			Object[]	附近的商圈、aoi、道路、门址等信息
		name		String	当前层级的名称，例如广东省
		level		String	对应GeoLevel的地址分级等级，例如GEO_PROVINCE
		xy		Object	当前层级的中心点坐标
			x	String	经度
			y	String	纬度
	address			String	拼装的地址（原则上不包含省市区信息）
	pois			Object[]	请求点附近的POI列表，数量小于等于请求的pn；pois消息结果参见周边搜索返回结果
	xy			Object	解析描述性地址返回的坐标结果
		x		String	经度
		y		String	纬度
	detailed_addres			string	详细地址
	description			String	地址描述

排列	字段	说明
1	GEO_COUNTRY	国家
2	GEO_PROVINCE	省、直辖市
3	GEO_CITY	地市
4	GEO_COUNTY	区县
5	GEO_TOWN	乡镇
6	GEO_VILLAGE	村
7	GEO_NATURE	自然地名，如山、河、湖等
8	GEO_AREA	商圈
9	GEO_ROAD	道路
10	GEO_CROSS	路口
11	GEO_NUMBER	门牌号
12	GEO_INTER	插值门牌
13	GEO_AOI	兴趣面
14	GEO_POI	兴趣点
15	GEO_SUB	poi附属设施
16	GEO_DIR	方向
17	GEO_OTHER	其他
18	GEO_INVALID	引擎内部使用