猎鹰基本概念最后更新时间: 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 步：接收请求返回的数据并解析