地理转换

  • 接口介绍
  • 接口文档
  • 使用指南
  • 资源下载
  • 更新日志
将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。

地理编码 API 服务地址:

  • 接口地址:https://www.oneapi.cn/mapapi/geo

  • 请求方式:get


请求参数:

    参数名 含义 规则说明 是否必须
    app_key 非常第一数据app_key
    用户申请数据时生成的app_key
    address 结构化地址信息 规则遵循:国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦,如:北京市朝阳区阜通东大街6号。
    city 指定查询的城市
    可选输入内容包括:指定城市的中文(如北京)、指定城市的中文全拼(beijing)、citycode(010)、adcode(110000),不支持县级市。当指定城市查询内容为空时,会进行全国范围内的地址转换检索。 可选
    app_id 非常第一数据app_id 我的数据中的app_id
    time
    当前时间 请求API时的时间戳
    sign
    数字签名 请参考数字签名获取和使用方法



例如:

https://www.oneapi.cn/mapapi/geo?address=广西南宁市&app_id=10001&sign=1605a4fe0c36625666d702998a2206207bd104def60b741e5134426d2454af2c&app_key=23171e509b1ceddbf66669eebf94f7f39c117e26&time=1530888283


返回结果参数说明:


名称

含义

规则说明

status

返回结果状态值

返回值为 0 或 1,0 表示请求失败;1 表示请求成功。

count

返回结果数目

返回结果的个数。

info

返回状态说明

当 status 为 0 时,info 会返回具体错误原因,否则返回“OK”。详情可以参阅info状态表

geocodes

地理编码信息列表

结果对象列表,包括下述字段:

formatted_address

结构化地址信息

省份+城市+区县+城镇+乡村+街道+门牌号码

province

地址所在的省份名

例如:北京市。此处需要注意的是,中国的四大直辖市也算作省级单位。

city

地址所在的城市名

例如:北京市

citycode

城市编码

例如:010

district

地址所在的区

例如:朝阳区

township

地址所在的乡镇

例如:庞各庄镇

street

街道

例如:阜通东大街

number

门牌

例如:6号

adcode

区域编码

例如:110101

location

坐标点

经度,纬度

level

匹配级别

参见地理编码匹配级别列表


结构化地址的定义: 首先,地址肯定是一串字符,内含国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦等建筑物名称。按照由大区域名称到小区域名称组合在一起的字符。一个有效的地址应该是独一无二的。注意:针对大陆、港、澳地区的地理编码转换时可以将国家信息选择性的忽略,但省、市、城镇等级别的地址构成是不能忽略的。


  • 地理编码匹配级别列表

匹配级别

示例说明

国家

中国

河北省、北京市

宁波市

区县

北京市朝阳区

开发区

亦庄经济开发区

乡镇

回龙观镇

村庄

三元村

热点商圈

上海市黄浦区老西门

兴趣点

北京市朝阳区奥林匹克公园(南门)

门牌号

朝阳区阜通东大街6号

单元号

望京西园四区5号楼2单元

道路

北京市朝阳区阜通东大街

道路交叉路口

北四环西路辅路/善缘街

公交站台、地铁站

海淀黄庄站A1西北口

未知

未确认级别的POI


更新日志:

                API v1.0 2018/10/08