产品介绍
云逆地理编码,是以逆地理编码服务为基础,开放的一套个性化位置描述服务。开发者可自定义用于进行逆地理编码计算的地理数据,以训练出最适用于真实业务场景的位置描述服务。如:坐标“40.055743,116.308243” 逆地理编码推荐结果为真实地物“百度大厦”,通过云逆地理编码服务,可将该坐标定义为“百度班车上车点”、“西二旗快递集中收发处”等更个性化的位置描述。
云逆地理编码已全面支持HTTP/HTTPS两种请求形式。后文介绍中以HTTP请求为例。
坐标系说明
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
云逆地理编码 API默认输入坐标类型为百度坐标(BD09),同时可通过参数("coord_type")控制输入坐标类型,输入坐标支持以上三种坐标系。
注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
使用说明
请求URL
http://api.map.baidu.com/cloudrgc/v1
HTTP请求方式
GET
请求接口参数
参数名称 | 含义 | 是否必须 | 默认值 | 格式举例 | 说明 |
---|---|---|---|---|---|
location | 坐标 | 是 | 无 | 40.047,116.313 | 格式:纬度,经度 |
geotable_id | 位置表id | 是 | 无 | 与ak配合鉴权 | |
extensions | 扩展信息控制 | 否 | 无 | pois | 是否返回扩展信息:默认不返回,extensions=pois时返回pois和custom_pois |
coord_type | 坐标系 | 否 | bd09ll | gcj02ll | bd09ll(百度经纬度坐标)、gcj02ll(国测局经纬度坐标)、wgs84ll(wgs84经纬度坐标) |
ak | 鉴权密钥 | 是 | 无 | 可在API控制台中创建 | |
sn | 权限签名 | 否 | 无 | ||
timestamp | 鉴权时间戳 | 否 | 无 | 配合sn鉴权 |
返回结果字段
状态字段
字段 | 含义 | 说明 |
---|---|---|
status | 状态码 | 0代表成功,如果失败则返回其他数字 |
message | 状态码描述 |
结果字段
字段 | 含义 | 说明 | |
---|---|---|---|
location | lat | 纬度 | |
lng | 经度 | ||
address_component | country | 国家 | |
province | 省 | ||
city | 城市 | ||
district | 区、县 | ||
street | 街道 | ||
street_number | 街道门牌号 | ||
admin_area_code | 行政区划代码 | ||
country_code | 国家代码 | ||
formatted_address | 地址结构化描述 | ||
pois | name | 名称 | |
id | 百度地图POI ID | ||
address | 地址 | ||
tag | 分类标签 | ||
location | 坐标 | ||
direction | 请求点相对于返回点的方向 | ||
distance | 与位置点的距离 | ||
custom_pois | name | 名称 | |
address | 地址 | ||
tag | 分类标签 | ||
location | 坐标 | ||
direction | 请求点相对于返回点的方向 | ||
distance | 与位置点的距离 | ||
custom_location_description | 用户定义位置描述 | ||
recommended_location_description | 推荐的位置描述 | 结合custom_pois和pois计算推荐结果 |
使用示例
服务的使用分两个步骤:
步骤一:在位置表中新建POI数据(位置表的新建和管理详见云存储)
步骤二:请求云逆地理编码API,并在请求参数中填写位置表ID(geotable_id)
http://api.map.baidu.com/cloudrgc/v1?location=40.055,116.308&geotable_id=135675&coord_type=bd09ll&ak=QPTtujW7FzsUjbGlilkpw6D5