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

逆地理编码
逆地理编码服务将经纬度转换为对应位置(例如区域、道路、小区等)信息。
功能介绍
通过对请求的单个或多个经纬度进行解析并返回该经纬度附近的地址信息或POI信息;支持对请求的图面范围匹配合适的行政区划范围。
接口名
https://api.careland.com.cn/api/v2/mrgeo
HTTP请求方式
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/mrgeo?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 地址描述
  • GeoLevel对照表
  • 排列 字段 说明
    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 引擎内部使用