腾讯位置商业授权未来驾车ETA(批量)
概述
批量计算未来驾车用时,各个时间点路线的用时。
注:本接搭配驾车路线规划使用,需要先计算驾车路线,再通过本接口,计算该路线不同时段的预估到达时间
注:
本服务属于高级付费服务,如需试用请提交商务合作开通服务试用。
请求URL
该请求为GET请求
https://apis.map.qq.com/ws/traffic_status/future_eta
Method:GET
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
route_id | 是 | 指定要计算未来ETA的route_id(路线ID) 该值需要先调用驾车路线规划算API计算路线并获取route_id,需要在请求驾车路线规划时增加参数:&added_fields=route_id&is_cache=1获取route_id字段值,及缓存算路结果 | |
departure_times | 是 | 未来时间点 支持一次最多计算12个未来时间点的预计到达时间及路况信息,Unix时间戳,多个时间点之间用英文(半角)逗号分隔,建议各时间点间隔>=10分钟(间隔时间过短可能路况变化较小,达不到应用效果) | departure_times=1684910980,1684910996… |
key | 是 | 开发key | key=OB4BZ-D4W3U-***** |
callback | 否 | 回调函数 | callback=cb |
output | 否 | 返回值类型:json、jsonp | output=json |
响应结果
名称 | 类型 | 必有 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常,其它为异常,详细请参阅状态码说明 | ||
message | string | 是 | 对status的描述 | ||
result | object | 是 | 计算结果 | ||
future_eta | array | 是 | 每一个数组元素 为 一个未来时间的路线预估耗时及路况信息(与输入顺序一致 | ||
departure_time | number | 是 | 出发时间,时间戳,与输入对应 | ||
duration | number | 是 | 预估到达时间 |
调用示例
// GET请求,注意参数值要进行URL编码
https://apis.map.qq.com/ws/traffic_status/future_eta?route_id=5438924291813040682&departure_times=1684910980,1684910996&key=OB4BZ-D4W3U-*****
前往示例中心 在线体验 ➤
资料来源:
腾讯地图代理商-腾讯地图授权sdk商业版-腾讯商业授权-腾讯位置服务代理商