| 第1行： | 第1行： | ||
{{car-sidebar}} | {{car-sidebar}} | ||
| − | ==接口说明== | + | |
| + | == 接口说明 == | ||
| + | <span style="color:red;"> 车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起，车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响，请已使用了各种车联网API服务的开发者，尽快升级服务到Web API中使用。</span> | ||
测量多点之间的直线距离 | 测量多点之间的直线距离 | ||
| − | ==接口示例== | + | == 接口示例 == |
| − | http://api.map.baidu.com/telematics/v3/distance?waypoints=118.77147503233,32.054128923368;116.3521416286,39.965780080447;116.28215586757,39.965780080447&ak=E4805d16520de693a3fe707cdc962045 | + | [http://api.map.baidu.com/telematics/v3/distance?waypoints=118.77147503233,32.054128923368;116.3521416286,39.965780080447;116.28215586757,39.965780080447&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/distance?waypoints=118.77147503233,32.054128923368;116.3521416286,39.965780080447;116.28215586757,39.965780080447&ak=E4805d16520de693a3fe707cdc962045] |
| − | ==接口的参数设置== | + | == 接口的参数设置 == |
{| | {| | ||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | ! width="100" | 参数类型 |
| − | | | + | ! width="100" | 参数名称 |
| − | | | + | ! width="100" | 是否必须 |
| − | + | ! 具体描述 | |
|- | |- | ||
| − | |String | + | | String |
| − | | | + | | ak |
| − | | | + | | true |
| − | | | + | | 开发者密钥 |
|- | |- | ||
| − | |String | + | | String |
| − | | | + | | sn |
| − | | | + | | false |
| − | | | + | | 若用户所用ak的校验方式为sn校验时该参数必须。 （[http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法]） |
|- | |- | ||
| − | |String | + | | String |
| − | | | + | | waypoints |
| − | | | + | | true |
| − | | | + | | 需要测距的点的经纬度坐标；需传入两个或更多的点。两个点之间用 “; ”进行分割开，单个点的经纬度用“,”分隔开；例如： waypoints=118.77147503233,32.054128923368;116.3521416286, 39.965780080447;116.28215586757,39.965780080447 |
|- | |- | ||
| − | |String | + | | String |
| − | | | + | | output |
| − | |false | + | | false |
| − | | | + | | 输出的数据格式，默认为xml格式，当output设置为’json’时，输出的为json格式的数据; |
|- | |- | ||
| − | |String | + | | String |
| − | |callback | + | | coord_type |
| − | |false | + | | false |
| − | |将json格式的返回值通过callback函数返回以实现jsonp功能。举例：callback=showLocation(JavaScript函数名)。 | + | | 请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。 |
| + | |- | ||
| + | | String | ||
| + | | callback | ||
| + | | false | ||
| + | | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例：callback=showLocation(JavaScript函数名)。 | ||
|} | |} | ||
| − | ==返回结果== | + | == 返回结果 == |
| − | ==返回xml格式的数据== | + | == 返回xml格式的数据 == |
| − | + | <pre><DistanceResponse> | |
| − | <pre> | + | |
| − | <DistanceResponse> | + | |
<status>Success</status> | <status>Success</status> | ||
<results> | <results> | ||
| 第61行： | 第62行： | ||
</pre> | </pre> | ||
| − | ==返回json格式的数据== | + | == 返回json格式的数据 == |
| − | + | <pre>{ | |
| − | <pre> | + | |
| − | { | + | |
"message":"Success", | "message":"Success", | ||
"content":[ | "content":[ | ||
2020年1月14日 (二) 16:28的最后版本
接口说明
车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起，车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响，请已使用了各种车联网API服务的开发者，尽快升级服务到Web API中使用。
测量多点之间的直线距离
接口示例
http://api.map.baidu.com/telematics/v3/distance?waypoints=118.77147503233,32.054128923368;116.3521416286,39.965780080447;116.28215586757,39.965780080447&ak=E4805d16520de693a3fe707cdc962045
接口的参数设置
| 参数类型 | 参数名称 | 是否必须 | 具体描述 |
|---|---|---|---|
| String | ak | true | 开发者密钥 |
| String | sn | false | 若用户所用ak的校验方式为sn校验时该参数必须。 （sn生成算法） |
| String | waypoints | true | 需要测距的点的经纬度坐标；需传入两个或更多的点。两个点之间用 “; ”进行分割开，单个点的经纬度用“,”分隔开；例如： waypoints=118.77147503233,32.054128923368;116.3521416286, 39.965780080447;116.28215586757,39.965780080447 |
| String | output | false | 输出的数据格式，默认为xml格式，当output设置为’json’时，输出的为json格式的数据; |
| String | coord_type | false | 请求参数坐标类型，默认为gcj02经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标。wgs84表示gps获取的坐标。 |
| String | callback | false | 将json格式的返回值通过callback函数返回以实现jsonp功能。举例：callback=showLocation(JavaScript函数名)。 |
返回结果
返回xml格式的数据
<DistanceResponse> <status>Success</status> <results> <result>906141.08502603</result> // 返回的第一个点和第二个点之间的距离，单位为米； <result>5964.3883866308</result> // 返回的第二个点和第三个点之间的距离，单位为米； </results> </DistanceResponse>
返回json格式的数据
{
"message":"Success",
"content":[
906141.08502603, // 返回的第一个点和第二个点之间的距离，单位为米；
5964.3883866308 // 返回的第二个点和第三个点之间的距离，单位为米；
]
}