距离计算 API

经纬度坐标之间的距离计算。

1 概述

提供融合定位等接口。协议默认规格有：

1、时间戳为int64，采用unix 时间戳（Unix epoch），单位为毫秒；

2、字符串都为UTF8 格式；

鉴权方式：

采用access_key 的方式，在URL 的Query Param 中添加access_key。

2 计算地理坐标之间的距离接口

2.1请求参数

搜索结果的获取，通过GET 请求下面的URL :

https://api.newayz.com/location/scenario/v1/distance

查询params 参数含义：

参数 类型 必填 说明
access_key string 是 申请的应用 KEY，访问接口权限
origins string 是 原始位置的经纬度，多个经纬度之间使用"|"分隔，经度和 维度之间用","分隔
destination string 是 目标位置的经纬度，经纬度之间使用","分隔

请求示例：

https://api.newayz.com/location/scenario/v1/distance? access key=your ak&origins=116.481028,39.989643|114.481028,39.989643|115.481028,39.989643&destination=114.465302,40.004717

2.2响应数据

字段名称 类型 说明
status 整数 状态码，1表示成功
info 字符串 返回信息
results 数组 返回源位置和目标位置间的距离数组，单位为米

响应示例

json { "status": 1, "info": "OK", "results": [ 171711.66780013096, 2145.6968082395083, 86539.13856693133 ] }

注意事项

  • distances数组中的每个元素对应的是origins参数中相同索引的源位置到destination的距离。

  • 所有的经纬度格式必须是十进制度数，例如116.481028，39.989643。

  • 返回的距离值单位为米，并且为直线距离，不代表实际行驶距离。