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

地理编码
地理编码服务将结构化地址数据,(如:深圳市福田区深南大道6023号)转换为对应经纬度
注意:如地址描述过于简单,如前进大街6号,因全国会有很多匹配结果,服务无法判断用户请求的是哪一个,则服务返回无结果。如果有可通过匹配度区分的唯一返回值或者通过限定参数得到唯一返回值,则返回该值。
功能介绍
即地址解析,通过对请求的描述性地址进行分拆解析,将描述性地址转换为经纬度坐标。解析的坐标精度越高。
接口名
http://api.careland.com.cn/api/v2/mgeo
HTTP请求方式
post、get
请求参数
  • 参数名称 是否必填 默认值 格式举例 说明
    ak
    用户key
    xytype 0
    坐标类型:
    0为凯立德坐标系
    2为国家加密坐标系
    address
    需要解析的描述性地址,通常包括省、地市、区县等
    city
    如:北京
    再由多条返回且同等匹
    配度的情况下,优先返
    回指定城市的结果
    callback
    回调函数
    callback值是用户定义的函数名称,此参数只在output=json时有效
  • 请求示例
    http://api.careland.com.cn/api/v2/mgeo?ak=<您的密钥>&address=深圳市福田区车公庙创建大厦27楼&city=深圳
    返回结果示例
    {
         "errorCode": 0,
         "errorMessage": "ok",
         "results": [
              {
                   "pcd": {
                        "province": "广东省",
                        "adcode": "440304",
                        "city": "深圳市",
                        "district": "福田区",
                        "city_code": "440300",
                        "province_code": "440000"
                   },
                   "p": {
                        "x": "410816644",
                        "y": "81362472"
                   },
                   "confidence": 1,
                   "range": 0,
                   "matched": [
                        {
                             "level": "GEO_CITY",
                             "name": "深圳市"
                        },
                        {
                             "level": "GEO_COUNTY",
                             "name": "福田区"
                        },
                        {
                             "level": "GEO_TOWN",
                             "name": "沙头街道"
                        },
                        {
                             "xy": {
                                  "x": "410816752",
                                  "y": "81362472"
                             },
                             "level": "GEO_POI",
                             "name": "创建大厦"
                        }
                   ],
                   "formatted_address": "广东省深圳市福田区沙头街道创建大厦",
                   "level_address": "GEO_POI",
                   "precise": true
              }
         ]
    }
    		
    返回参数说明
  • 名称 类型 说明
    errorCode String 错误代码
    errorMessage String 错误代码
    results Object[] 返回的地理编码结果
    p Object 解析描述性地址返回的坐标结果
    x String 经度
    y String 纬度
    range String 坐标精度误差估算
    precise Boolean 是否精确匹配到结果
    pcd Object 返回结果所在的省市区
    adcode String 行政区划代码
    province String 省、直辖市名称
    province_code int 省、直辖市代码
    city_code int 地市代码
    city String 地市名称
    district String 县区名称
    matched Object[]
    name String 当前层级的名称,例如 广东省
    level String 对应GeoLevel的地址分级等级,例如GEO_PROVINCE
    xy Object 当前层级的中心点坐标
    x String 经度
    y String 纬度
    confidence String 匹配度结果,用于筛选、排序
    formatted_address String 结构化地址
    level String 匹配级别,参见GeoLevel对照表