请求地址:
http://api.map.baidu.com/geocoder/v2/?callback=renderReverse&location=35.658651,139.745415&output=json&pois=1&ak=您的ak密匙 //GET请求 直接放浏览器执行请求就能看到返回结果
因为直接放浏览器执行请求就能看到返回结果,因此在这不在举例,如果实在不知道可以搜一下如何发送http请求。
一般这个例子的请求参数就够了,如需更多参数参考下面:
请求参数
参数名 | 参数含义 | 类型 | 举例 | 默认值 | 是否必须 |
---|---|---|---|---|---|
location | 根据经纬度坐标获取地址。支持批量,多组坐标间用|分隔,单次请求最多解析20组坐标。超过20组取前20组解析。批量解析需使用batch参数。批量解析仅召回行政区划数据。 | float | 38.76623,116.43213 lat<纬度>,lng<经度> | 无 | 是 |
coordtype | 坐标的类型,目前支持的坐标类型包括:bd09ll(百度经纬度坐标)、bd09mc(百度米制坐标)、gcj02ll(国测局经纬度坐标,仅限中国)、wgs84ll( GPS经纬度) 坐标系说明 | string | bd09ll、gcj02ll | bd09ll | 否 |
ret_coordtype | 可选参数,添加后返回国测局经纬度坐标或百度米制坐标 坐标系说明 | string | gcj02ll(国测局坐标,仅限中国)、bd09mc(百度墨卡托坐标) | bd09ll(百度经纬度坐标) | 否 |
batch | 请求为批量时必须,batch=true;若batch=false或为空,请求只解析第一组坐标。 | string | true、false | false | 否 |
pois | 是否召回传入坐标周边的poi,0为不召回,1为召回。当值为1时,默认显示周边1000米内的poi。 注意:若需召回国外POI,需单独申请权限 | int | 0 | 0 | 否 |
radius | poi召回半径,允许设置区间为0-1000米,超过1000米按1000米召回。 | int | 500 | 1000 | 否 |
ak | 用户申请注册的key,自v2开始参数修改为“ak”,之前版本参数为“key” 申请ak | string | E4805d16520de693a3fe70 | 无 | 是 |
sn | 若用户所用ak的校验方式为sn校验时该参数必须 sn生成 | string | 无 | 否 | |
output | 输出格式为json或者xml | string | json或xml | xml | 否 |
callback | 将json格式的返回值通过callback函数返回以实现jsonp功能 | string | callback=showLocation(JavaScript函数名) | 无 | 否 |
extensions_poi | 区别于pois参数,pois=0,不召回pois数据,但后端仍访问poi相应服务;extensions_poi=null时,后端不调用poi相关服务,可减少服务访问时延。 注意:若需召回国外POI,需单独申请权限 | string | null | 无 | 否 |
extensions_road | 当取值为true时,召回坐标周围最近的3条道路数据。区别于行政区划中的street参数(street参数为行政区划中的街道,和普通道路不对应)。 | string | false、true | false | 否 |
extensions_town | 当取值为true时,行政区划返回乡镇级数据(仅国内召回乡镇数据)。默认不访问。 | string | true | 无 | 否 |
language | 指定召回的新政区划语言类型。 召回行政区划语言list(全量支持的语言见下方附录)。 当language=local时,根据请求中坐标所对应国家的母语类型,自动选择对应语言类型的行政区划召回。 目前支持多语言的行政区划区划包含country、provence、city、district 使用该参数需单独申请权限 | string | zh-CN、local | en,国内默认zh-CN | 否 |
language_auto | 是否自动填充行政区划。 1填充,0不填充。 填充:当服务按某种语言类别召回时,若某一行政区划层级数据未覆盖,则按照“英文→中文→本地语言”类别行政区划数据对该层级行政区划进行填充,保证行政区划数据召回完整性。 使用该参数需单独申请权限 | int | 0、1 | 无 | 否 |
latest_admin | 是否访问最新版行政区划数据(仅对中国数据生效),1(访问),0(不访问) | int | 0、1 | 0 | 否 |
*返回的结果呢也是一看便知,各取所需,如果不够自己吃请看下面的结果参数。
返回结果参数
名称 | 含义 | 类型 | |
---|---|---|---|
status | 返回结果状态值, 成功返回0,其他值请查看下方返回码状态表。 | int | |
location | 经纬度坐标 | object | |
lat | 纬度值 | float | |
lng | 经度值 | float | |
formatted_address | 结构化地址信息 | int | |
confidence | 可信度,描述打点准确度。[0,100],大于80表示误差低于100m | int | |
business | 坐标所在商圈信息,如 "人民大学,中关村,苏州街"。最多返回3个。 | string | |
addressComponent (注意,国外行政区划,字段仅代表层级) | country | 国家 | string |
province | 省名 | string | |
city | 城市名 | string | |
district | 区县名 | string | |
town | 乡镇名 | string | |
street | 街道名(行政区划中的街道层级) | string | |
street_number | 街道门牌号 | string | |
adcode | 行政区划代码 adcode映射表 | int | |
country_code | 国家代码 | int | |
direction | 相对当前坐标点的方向,当有门牌号的时候返回数据 | string | |
distance | 相对当前坐标点的距离,当有门牌号的时候返回数据 | string | |
pois(周边poi数组) | addr | 地址信息 | string |
cp | 数据来源(已废弃) | string | |
direction | 和当前坐标点的方向 | string | |
distance | 离坐标点距离 | int | |
name | poi名称 | string | |
poiType | poi类型,如’ 办公大厦,商务大厦’ | string | |
point | poi坐标{x,y} | float | |
tel | 电话 | int | |
uid | poi唯一标识 | string | |
zip | 邮编 | int | |
parent_poi | poi对应的主点poi(如,海底捞的主点为上地华联,该字段则为上地华联的poi信息。如无,该字段为空),包含子字段和pois基础召回字段相同。 | ||
poiRegions | direction_desc | 请求中的坐标与所归属区域面的相对位置关系 | string |
name | 归属区域面名称 | string | |
tag | 归属区域面类型 | string | |
sematic_description | 当前位置结合POI的语义化结果描述。 | string | |
cityCode | 城市id(不再更新) | int |