您当前的位置: Web服务API > 推荐上车点 API
推荐上车点 API

产品介绍

推荐上车点API是一类接口服务,用于查询某一位置周边推荐上车点位置分布及与请求位置的距离(目前暂时只支持北京)。
服务已全面支持HTTP/HTTPS两种请求形式。后文介绍中以HTTP请求为例。

坐标系说明

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


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


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


推荐上车点 API默认输入坐标类型为百度坐标(BD09),同时可通过参数("coord_type")控制输入坐标类型,输入坐标支持以上三种坐标系。

推荐上车点同时返回百度坐标(BD09)和国测局坐标(GCJ02)两类坐标点数据。


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

功能介绍

推荐上车点 API 提供位置点周围推荐上车点查询服务。

查询坐标点周边推荐上车点位置。

计算查询的坐标点与推荐上车点之间的距离。

使用限制

使用推荐上车点API服务前,首先需要登录API控制台申请密钥ak。

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

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

若需更高配额和并发量,请申请商务合作

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

默认配额及并发量说明如下:

分类 未认证 个人认证 企业认证
日配额(次) 100 100 100
分钟并发量(次/分钟) 10 10 10

使用方法

第一步,申请密钥(ak),作为访问服务的依据;

第二步,按照请求参数说明拼写发送HTTP/HTTPS请求的url,注意需使用第一步申请的ak;

第三步,接收HTTP/HTTPS请求返回的数据(json格式);

Hello, World示例:

查询位置坐标为116.313064,40.048541周边的推荐上车点,该坐标为百度经纬度坐标:

http://api.map.baidu.com/parking/search?ak=你的ak&location=116.313064,40.048541&coordtype=bd09ll

服务地址

http://api.map.baidu.com/parking/search?

组成说明:

域名:api.map.baidu.com

服务名:parking

服务请求参数说明

参数 是否必须 默认值 示例 含义
location 116.387,39.934 需查询周边推荐上车点的位置坐标(经度、纬度)
coordtype 百度经纬度坐标 bd09ll 请求参数中坐标的类型,
wgs84ll即GPS经纬度,
gcj02ll即国测局经纬度坐标,
bd09ll即百度经纬度坐标,
bd09mc即百度米制坐标
ak 服务鉴权密钥
sn 若用户所用ak的校验方式为sn校验时该参数必须。

返回结果说明

参数名 参数名 类型 示例 说明
status constant 0 返回结果状态值, 成功返回0,其他值请查看状态码表。
message string OK
recommendstops distance float 7 距查找点的距离(m)
name string 北京市广播电视大学昌平分校(西门) 推荐上下车点名称
baidu_x float 114.2253 上下车点的经纬度(百度坐标系)
baidu_y float 29.5815
gcj02ll_x float 114.2189 上下车点的经纬度(google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标,国测局坐标

gcj02ll_y float 29.5754

使用示例

请求示例:


http://api.map.baidu.com/parking/search?ak=你的ak&location=116.313064,40.048541&coordtype=bd09ll


该请求表示: 请求调用百度推荐上车点服务。需查询的位置坐标为116.313064,40.048541,该坐标为百度经纬度坐标。


返回结果示例:


{

    status: 0,

    message: "OK",

    recommendStops: [

                   {

                      name: "奎科科技大厦(东北门)",

                      distance: 77.17832947,

                      bd09ll_x: 116.31374724317838,

                      bd09ll_y: 40.04809020343263,

                      gcj02ll_x: 116.30728151461888,

                      gcj02ll_y: 40.042046468566646

                   }
    ]

}


该返回结果表示: 请求中的坐标点周边推荐上车点名称为:奎科科技大厦(东北门),与请求坐标点的距离为77.17832947m
该上车点对应的百度坐标为"116.31374724317838,40.04809020343263",
对应的国测局坐标为"116.30728151461888,40.042046468566646"

状态码说明

状态码 含义
0 成功返回请求结果
1 服务器内部错误
2 参数错误
1001 经纬度非法
1002 坐标类型非法
1003 HTTP Method不支持
1004 HTTP Header非法
1005 引擎转换请求有误
1006 引擎内部错误