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

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
常见问题
更新日志
推荐上车点服务

推荐上车点服务是一类Web API接口服务;
用于查询某一位置周边推荐上车点位置分布及与请求位置的距离。

功能介绍
周边上车点推荐

用户可通过该功能检索坐标点周围的上车点。包含名称、坐标、距离(绑路,非直线)信息。

parking1.png


接口功能介绍
http://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
返回结果参数
名称
类型 说明
status
Int 返回结果状态值, 成功返回0,其他值请查看状态码表。
message
string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
recommendstops
name
string 推荐上下车点名称
distance
float 距查找点的距离(m)
baidu_x
float 推荐上车点经度(百度经纬度 bd09ll)
baidu_y
float 推荐上车点纬度(百度经纬度 bd09ll)
gcj02ll_x
float 推荐上车点经度(国测局坐标系 gcj02)
gcj02ll_y
float
推荐上车点纬度(国测局坐标系 gcj02)
服务状态码
状态码 含义
0 成功返回请求结果
1 服务器内部错误
2 参数错误
1001
经纬度非法
1002
坐标类型非法
1003
HTTP Method不支持
1004
HTTP Header非法
1005
引擎转换请求有误
1006
引擎内部错误


使用方法
编码说明

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)

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

服务配额

每个开发者账号每天调用“推荐上车点”API 服务的总次数(即配额)是有限的。

每个开发者账号每天调用“推荐上车点”API 服务的总次数(即并发量)是有限的。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。


配额及默认并发量说明如下(需要更高配额请联系我们

分类 未认证 个人认证 企业认证
日配额(次) 100 100 100
分钟并发数(次/分钟) 10 10 10
服务常见问题
1、返回结果中的distance是直线距离吗?

返回结果中的distance是结合道路信息,绑路计算的距离。非两点之间的直线距离。

2、推荐上车点是按距离进行排序推荐的吗?

不是。距离是一个重要因素,同时还会根据是否跨路,方向等进行综合计算,得出推荐结果。

3、怎样提升服务配额?

推荐上车点服务对普通开发者仅提供试用配额。
配额提升针对合作用户。如果有配额需求,请通过商务合作咨询入口联系我们。
该服务配额提升无法在控制管理平台中申请。

2016年12月21日

V1.0


产品上线

全新推荐上车点服务上线。