2.1 功能介绍

地理/逆地理编码API是一类简单的HTTP接口,用于提供从地址到经纬度坐标或者从经纬度坐标到地址的转换服务。

该套API免费对外开放,使用之前请先登录然后申请密钥获取使用该组API的key。

地理编码:即地址解析,通过对请求的描述性地址进行分拆解析,将描述性地址转换为经纬度坐标。

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

2.2 使用限制

企业开发者:单个key支持20万次/天,1万次/分钟调用。

个人开发者:单个key支持2000次/天,2000次/分钟调用。

2.3 地理编码

服务地址:http://api.careland.com.cn/api/v1/geo?param

param代表的参数包括必填参数和可选参数,所有参数均使用(&)进行分隔。各参数的使用说明请参照下表。

请求参数:

参数名称是否必填默认值格式举例说明
ak 用户key
xytype 0 坐标类型:
0为凯立德坐标系
2为国家加密坐标系
address 河北省石家庄市正定县 需要解析的描述性地址,通常包括省、地市、区县等。
city 默认为全国 city=北京
city=110000
查询城市
可输入城市名或行政区划分代码(adcode),指定此参数表示在指定的城市查询
output json json 输出格式为json或者xml(目前暂不支持xml)
callback 回调函数
callback值是用户定义的函数名称,此参数只在output=json时有效

请求示例:

http://api.careland.com.cn/api/v1/geo?address=深圳市福田区车公庙创建大厦26楼&city=深圳&restricted=true&ak=<您的密匙>

返回结果示例:

{
  "errorCode": 0,
  "errorMessage": "ok",
  "results": [
    {
      "p": {
        "x": 410817124,
        "y": 81363362
      },
      "range": "300",
      "precise": true,
      "pcd": {
        "adcode": 440304,
        "province": "广东省",
        "city": "深圳市",
        "district": "福田区"
      },
      "matched": [
        {
          "name": "深圳市",
          "level": "GEO_CITY"
        },
        {
          "name": "福田区",
          "level": "GEO_COUNTY"
        },
        {
          "name": "车公庙",
          "level": "GEO_AREA"
          "xy": {
            "x": 410810781,
            "y": 81357962
          }         },
        {
          "name": "创建大厦",
          "level": "GEO_POI"
          "xy": {
            "x": 410816998,
            "y": 81363492
          }         },
        {
          "name": "26楼",
          "level": "GEO_NUMBER"
          "xy": {
            "x": 410817124,
            "y": 81363362
          }         }
      ],
      "confidence": 1
    }
  ]
}

返回参数说明:

名称 类型 说明
errorCode String 错误代码
errorMessage String 错误描述
results Object[] 返回的地理编码结果
  p Object 解析描述性地址返回的坐标结果
  x String 经度
y String 纬度
range String 坐标精度误差估算
precise Boolean 是否精确匹配到结果
pcd Object 返回结果所在的省市区
  adcode String 行政区划代码
province String 省、直辖市名称
city String 地市名称
district String 县区名称
matched Object[]  
  name String 当前层级的名称,例如 广东省
level String 对应GeoLevel的地址分级等级,例如GEO_PROVINCE
xy Object 当前层级的中心点坐标
  x String 经度
y String 纬度
shapes Object 后匹配到结果的点线面形状数据集合。
  base Object 基准点经纬度坐标。
  x_diff String 较上一个坐标点的经度差值
y_diff String 较上一个坐标点的纬度差值。
confidence String 匹配度结果,用于筛选、排序。

2.4 逆地理编码

服务地址:http://api.careland.com.cn/api/v1/rgeo?param

param代表的参数包括必填参数和可选参数,所有参数均使用(&)进行分隔。各参数的使用说明请参照下表。

请求参数:

参数名称是否必填默认值格式举例说明
ak 用户key
xytype 0 坐标类型:
0为凯立德坐标系
2为国家加密坐标系
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米
output json json 输出格式为json或者xml(目前暂不支持xml)
callback 回调函数
callback值是用户定义的函数名称,此参数只在output=json时有效

请求示例:

http://api.careland.com.cn/api/v1/rgeo?pn=1&range=10&p=410817100,81363000&ak=<您的密匙>

返回结果示例:

{
  "errorCode": 0,
  "errorMessage": "ok",
  "results": [
    {
      "pcd": {
        "adcode": 440304,
        "province": "广东省",
        "city": "深圳市",
        "district": "福田区"
      },
      "address": "",
      "xy": {
        "x": 410817099,
        "y": 81362998
      },
      "locations": [
        {
          "name": "沙尾街道",
          "level": "GEO_TOWN"
        },
        {
          "name": "泰然社区",
          "level": "GEO_VILLAGE"
        },
        {
          "name": "车公庙",
          "level": "GEO_AREA"
        },
        {
          "name": "深南大道",
          "level": "GEO_ROAD"
          "xy": {
            "x": 410816696,
            "y": 81365385
          }         },
        {
          "name": "6023号",
          "level": "GEO_NUMBER"
        },
        {
          "name": "创建大厦",
          "level": "GEO_AOI"
        }       ],
      "pois": [
        {
          "id": "16963280",
          "name": "西南证券",
          "address": "广东省深圳市福田区车公庙深南大道6023号创建大厦1楼",
          "haspcd": true,
          "pcd":{
            "adcode": 440304,
            "province": "广东省",
            "city": "深圳市",
            "district": "福田区"
          },
          "tel_num": [],
          "hasxy": true,
          "xy": {
            "x": 410817070,
            "y": 81363304
          }           "type_code": 0,
          "type_name": "",
          "road_id": 0,
          "distance": 9,
          "preferred": false,
          "shapes_flag": false,
          "hassubpois": false,
          "hasdeepinfo": false,
          "routingpointscount": 0,
          "hasshapes": false
        }       ]
    }
  ]
}

返回参数说明:

名称 类型 说明
errorCode String 错误代码
errorMessage String 错误描述
results Object[] 返回的地理编码结果
  pcd Object 返回结果所在的省市区
  adcode String 行政区划代码
province String 省、直辖市名称
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 纬度
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号