地理距离

  • 接口介绍
  • 接口文档
  • 使用指南
  • 资源下载
  • 更新日志
地理距离,用于查询A地到B地之间的距离。

地理距离 API 服务地址:

  • 接口地址:https://www.oneapi.cn/mapapi/distance

  • 请求方式:get


请求参数:

    参数名 含义 规则说明 是否必须
    app_key 非常第一数据app_key
    用户申请数据时生成的app_key
    origins 出发点 经度和纬度用","分隔
    destination 目的地 经度和纬度用","分隔
    type 路径计算的方式和方法

    0:直线距离

    1:驾车导航距离(仅支持国内坐标)。

    必须指出,当为1时会考虑路况,故在不同时间请求返回结果可能不同。

    此策略和驾车路径规划接口的 strategy=4策略基本一致,策略为“ 躲避拥堵的路线,但是可能会存在绕路的情况,耗时可能较长 ”

    若需要实现高德地图客户端效果,可以考虑使用驾车路径规划接口

    2:公交规划距离(仅支持同城坐标,QPS不可超过1,否则可能导致意外)

    3:步行规划距离(仅支持5km之间的距离)

    否,可选,默认0
    app_id 非常第一数据app_id 我的数据中的app_id
    time
    当前时间戳 请求API时的时间戳
    sign
    数字签名 请参考数字签名获取和使用方法


例如:

https://www.oneapi.cn/mapapi/distance?origins=108.330988,22.845178&destination=108.916725,22.790989&app_id=10001&app_key=255588ed05b5030d86482d65091585cf23da837f&sign=96fd4f00ecea3019b4ae6bc04744bb40022ee09ff4c5a8db778aef4870c93c80&time=1531148586&type=1


返回结果参数说明:


名称

说明

status

返回结果状态值,值为0或1,0表示请求失败;1表示请求成功

info

返回状态说明,status为0时,info返回错误原因;否则返回“OK”。

results

距离信息列表

result

距离信息

origin_id

起点坐标,起点坐标序列号(从1开始)

dest_id

终点坐标,终点坐标序列号(从1开始) 

distance

路径距离,单位:米 

duration

预计行驶时间,单位:秒 

info

仅在出错的时候显示该字段。大部分显示“未知错误”

由于此接口支持批量请求,建议不论批量与否用此字段判断请求是否成功

code

仅在出错的时候显示此字段。

在驾车模式下:

1,指定地点之间没有可以行车的道路

2,起点/终点 距离所有道路均距离过远(例如在海洋/矿业)

3,起点/终点不在中国境内



更新日志:

                API v1.0 2018/10/08