浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
服务介绍
服务文档
使用指南
常见问题
更新日志
云逆地理编码服务

云逆地理编码是一类Web API接口服务;
结合地理编码服务和LBS.云存储服务,通过使用自定义的POI数据,对坐标进行个性化位置描述。

功能介绍
自定义业务地点的位置描述

普通逆地理编码服务中,解析坐标所在行政区划,同时召回周边权重较高的POI数据用于位置描述。
云逆地理编码服务中,用户可使用在云存储中管理的自定义地点数据,对坐标进行个性化的位置描述。

geoRGC1.png

接口功能介绍
http://api.map.baidu.com/cloudrgc/v1?location=40.055,116.308&geotable_id=135675&coord_type=bd09ll&ak=你的ak //GET请求
请求参数
参数名 参数含义 类型 举例 默认值 是否必须
location 待解析的坐标,格式:纬度,经度。
float 40.047,116.313
geotable_id 用户使用云存储服务,存储自定义数据时生成的数据表ID。与ak配合鉴权。
使用个性化逆地理编码服务必须(使用指定geotable_id数据表中地理数据对坐标进行位置描述)
自定义数据的管理与维护介绍
int 144316
extensions
扩展信息控制。
是否返回扩展信息:默认不返回,extensions=pois时返回pois和custom_pois
string pois
coord_type
输入坐标的坐标系:
bd09ll(百度经纬度坐标)、gcj02ll(国测局经纬度坐标)、wgs84ll(wgs84经纬度坐标)
string gcj02ll
bd09ll

ak 用户申请注册的key(服务鉴权秘钥) 申请ak string E4805d16520de693a3fe70
sn 若用户所用ak的校验方式为sn校验时该参数必须 
sn生成
string

timestamp 鉴权时间戳,配合ak鉴权 string

返回结果参数
名称
含义 类型
status
返回结果状态值, 成功返回0 int
location lat
纬度
float

lng
经度
float
address_component
country
国家
string

province

string

city
城市
string

district
区、县
string

street
街道
string

street_number
街道门牌号
string

admin_area_code
行政区划代码
int

country_code
国家代码
int
formatted_address
地址结构化描述
string
pois
name
名称
string

id
百度地图POI ID
string

address
地址 string

tag 分类标签 string

location
坐标
float

direction
请求点相对于返回点的方向
string

distance
与位置点的距离
int
custom_pois
name
名称
string

address
地址
string

tag
分类标签
string

location
坐标
float

direction
请求点相对于返回点的方向
string

distance
与位置点的距离
int
custom_location_description
用户定义位置描述
string
recommended_location_description
推荐的位置描述(结合custom_pois和pois计算推荐结果) float
使用方法
1申请百度账号
百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 点此申请
2申请成为百度开发者
登录百度账号后,请申请百度地图开放平台开发者,即可开始使用相关服务。 点此申请
3获取服务密钥(ak)
发送服务请求,需使用ak参数进行鉴权(必须)。发送服务请求前需先创建ak。 点此创建
4使用云存储服务,创建位置数据表
使用云地理编码解析自定义地理数据,首先需使用云存储服务,创建位置数据表,编辑自定义地址数据。创建数据表成功,获取位置数据表id(geotable_id)
5拼写请求URL,使用服务获取结果
拼写请求URL,使用geotable_id,解析位置数据表中的自定义地址数据。
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标

云逆地理编码服务V3版默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)

注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

服务使用限制
服务相关配额及并发请求限制请访问开发者权益页面查看。
服务常见问题
1、云逆地理编码服务可以进行点面判断位置描述吗?

目前仅支持判断坐标点是否在百度母库某面状位置数据中(同普通逆地理编码服务)。暂时不支持自定义面状数据点面判断。我们有计划在17年末单独推出基于云存储V4服务的点面判断服务,请留意平台动态。

2、云逆地理编码支持自定义行政区划数据描述吗?

不支持。目前仅支持与自定义位置数据关联,实现坐标周边自定义POI位置描述场景需求。

2016年3月20日

V1.0


产品上线
全新云逆地理编码服务V1.0发布。
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消