开发 猎鹰轨迹服务 猎鹰基本概念

猎鹰基本概念 最后更新时间: 2021年01月22日

以下内容包含猎鹰轨迹服务的基础名词解释、服务结构、接口列表以及接口的通用接入流程。

名词解释

  • Service

即猎鹰轨迹服务。一个service对应一个轨迹管理系统,通过一个service可管理多个终端设备(即terminal),service的唯一标识符是sid。举例说明,针对某网约车公司的轨迹管理系统,可以创建一个service,在创建的service中管理所有营运车辆的轨迹。

  • Terminal

一个terminal代表现实中一个终端设备,它可以是个体、也可以是一辆车或者任何运动的物体。在同一个service中,terminal以tid作为唯一标识。

  • Terminal column

terminal的自定义属性字段,由开发者管理,用以描述终端设备,对于车辆可以是车牌号、载重等。开发者可以自定义最多5个属性字段。

  • Trace

terminal移动所产生的点数据组成的连续轨迹被称为trace,trace由一系列点(point)组成。

  • trname

trname即轨迹名称,支持开发者自主添加命名,以方便开发者在轨迹查询、分析时更具有辨识度。

  • Trace column

除坐标、速度、方向、定位时间等轨迹点的系统字段外,支持开发者针对轨迹点添加自定义字段。如设备采点时的所在高度(海拔)、冷链运输过程中的车厢内温度。开发者可以自定义最多10个属性字段。 

服务结构

一个高德 Key 下最多可创建15个 Service 。对 Service 的增删改查需要通过 API 接口完成。一个 Service 最多创建10万个 terminal 。 单个 terminal 下轨迹点数量没有限制,限定了可创建的trace条数为50万条。 其服务结构如下图所示:

接口列表

接口类目

功能

具体URL

service管理

增加service

https://tsapi.amap.com/v1/track/service/add

删除service

https://tsapi.amap.com/v1/track/service/delete

修改service

https://tsapi.amap.com/v1/track/service/update

查询service

https://tsapi.amap.com/v1/track/service/list

终端管理

增加终端

https://tsapi.amap.com/v1/track/terminal/add

删除终端

https://tsapi.amap.com/v1/track/terminal/delete

修改终端

https://tsapi.amap.com/v1/track/terminal/update

查询终端

https://tsapi.amap.com/v1/track/terminal/list

终端搜索

关键字搜索终端

https://tsapi.amap.com/v1/track/terminal/search

周边搜索终端

https://tsapi.amap.com/v1/track/terminal/aroundsearch

多边形内搜索终端

https://tsapi.amap.com/v1/track/terminal/polygonsearch

行政区域内搜索终端

https://tsapi.amap.com/v1/track/terminal/districtsearch

轨迹管理

增加轨迹

https://tsapi.amap.com/v1/track/trace/add

删除轨迹

https://tsapi.amap.com/v1/track/trace/delete

轨迹点上传

https://tsapi.amap.com/v1/track/point/upload

轨迹纠偏和里程查询

实时查询某终端位置

https://tsapi.amap.com/v1/track/terminal/lastpoint

查询某终端某几条轨迹信息

https://tsapi.amap.com/v1/track/terminal/trsearch

终端自定义字段管理

终端自定义字段的增加

https://tsapi.amap.com/v1/track/terminal/column/add

终端自定义字段的删除

https://tsapi.amap.com/v1/track/terminal/column/delete

终端自定义字段的修改

https://tsapi.amap.com/v1/track/terminal/column/update

终端自定义字段的查询

https://tsapi.amap.com/v1/track/terminal/column/list

轨迹自定义字段管理

轨迹自定义字段的增加

https://tsapi.amap.com/v1/track/point/column/add

轨迹自定义字段的删除

https://tsapi.amap.com/v1/track/point/column/delete

轨迹自定义字段的修改

https://tsapi.amap.com/v1/track/point/column/update

轨迹自定义字段的查询

https://tsapi.amap.com/v1/track/point/column/list

接口通用接入流程

第 1 步:申请”Web服务API”密钥(key)

点我获取Key>>

第 2 步:拼接请求URL

需要注意以下几点:

  • 如无特殊声明,接口的输入和输出数据编码全部为UTF-8。 
  • 大部分接口采用Post方式进行请求,部分接口需要使用Get方式进行请求,使用Get请求的接口会标示出来。
  • 第1步申请的key需作为必填参数一同发送。
  • 请参考猎鹰轨迹服务的开发指南内容获取详细的接口文档,以及入参说明。
  • 请求方式支持Http和Https两种。

第 3 步:接收请求返回的数据并解析

需要注意以下几点:

  • 请参考猎鹰轨迹服务的开发指南内容获取详细的接口文档,以及返回参数说明。

注意事项

  • 同一账号下的 Key ,可以无差别访问和处理同账号下所有 Service 。
  • 猎鹰轨迹服务暂未提供轨迹管理台,如果您有强烈诉求,请通过工单联系我们。
  • 驾驶行为分析、停留点分析、轨迹围栏等能力的开放使用您可以通过工单联系我们。



返回顶部 示例中心 常见问题 智能客服 公众号
二维码