推荐上车点服务是一类Web API接口服务;
用于查询某一位置周边推荐上车点位置分布及与请求位置的距离。
用户可通过该功能检索坐标点周围的上车点。包含名称、坐标、距离(绑路,非直线)信息。
https://api.map.baidu.com/parking/search?location=116.313064,40.048541&coordtype=bd09ll&ak=你的ak //GET请求
参数名称 | 含义 | 类型 | 举例 | 默认值 | 是否必须 |
---|---|---|---|---|---|
location | 需查询周边推荐上车点的位置坐标 (经度、纬度) |
float | 116.387,39.934 |
无 | 是 |
coordtype | 请求参数中坐标的类型 wgs84ll即GPS经纬度 gcj02ll即国测局经纬度坐标 bd09ll即百度经纬度坐标 bd09mc即百度米制坐标 |
string | bd09ll |
bd09ll |
否 |
ak | 密钥 申请AK |
string | E4805d16520de693a3fe707cdc962045 |
无 | 否 |
sn | 若用户所用AK的校验方式为SN校验时该参数必须。 SN生成 |
string | |
无 | 否 |
station_info | 是否需要展示场站层级信息 若设置为是,当请求点在机场或火车站时,会返回场站内所有上车点及上车点所对应的场站层级信息;若设置为否,则最多返回3个上车点 |
int | 0-否 1-是 |
0 | 否 |
名称 |
类型 | 说明 | ||
---|---|---|---|---|
status |
int | 返回结果状态值, 成功返回0,其他值请查看状态码表。 | ||
message |
string | 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。 | ||
station_info |
array |
[场站名称,大区域名称,小区域名称] | ||
station_name |
string |
仅输入station_info=1时有此字段 | ||
recommendstops | ||||
name |
string | 推荐上下车点名称 | ||
address |
string | 上车点地址,可能为空 | ||
distance |
float | 距查找点的距离(m) | ||
bd09ll_x |
float | 推荐上车点经度(百度经纬度 bd09ll) | ||
bd09ll_y |
float | 推荐上车点纬度(百度经纬度 bd09ll) | ||
gcj02ll_x |
float | 推荐上车点经度(国测局坐标系 gcj02ll) | ||
gcj02ll_y |
float |
推荐上车点纬度(国测局坐标系 gcj02ll) |
状态码 | 含义 |
0 | 成功返回请求结果 |
1 | 服务器内部错误 |
2 | 参数错误 |
1002 |
参数类型错误 |
1006 |
引擎内部错误 |
3 |
location缺省 |
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表示百度墨卡托米制坐标
推荐上车点服务默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)
注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
返回结果中的distance是结合道路信息,绑路计算的距离。非两点之间的直线距离。
不是。距离是一个重要因素,同时还会根据是否跨路,方向等进行综合计算,得出推荐结果。
推荐上车点服务对普通开发者仅提供试用配额。
配额提升针对合作用户。如果有配额需求,请在线反馈给我们。
该服务配额提升无法在控制管理平台中申请。
2016年12月21日
V1.0
全新推荐上车点服务上线。