轨迹自定义字段 最后更新时间: 2021年01月22日
简介
本篇介绍如何对终端下的轨迹自定义字段进行管理。
使用限制
服务调用量的限制请点击这里查阅。
增加轨迹的自定义字段
- 接口说明
增加自定义字段后，所有属于当前 service 的终端轨迹都可以使用此自定义字段。 最多创建5个轨迹自定义字段。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/point/column/add |
|
请求方式 |
POST |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求服务权限标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务的唯一编号 |
此参数用于查找service |
必填 |
无 |
|
|
column |
自定义字段名字 |
用户针对轨迹的自定义字段的名字，最多5个自定义字段 必须先在“轨迹自定义字段”中进行创建字段。 在同一个service下不能出现名称一样的自定义字段。 需要按照定义的类型上传数据，例如定义为int，则仅上传数字。 名字仅支持中文、英文大小字母、英文下划线”_”、英文横线”-“和数字 名字最长不得超过128字符,不能以”_”开头 |
必填 |
无 |
|
|
type |
自定义字段类型 |
此自定义字段的类别 string double int |
必填 |
无 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
说明 |
|
|---|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
||
|
errmsg |
返回结果状态码描述 |
String |
||
|
errdetail |
错误细节 |
String |
||
删除轨迹的自定义字段
- 接口说明
删除自定义字段后，所有属于用户指定service的终端轨迹的对应字段均会被删除，并且数据内容也都会被删除。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/point/column/delete |
|
请求方式 |
POST |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求服务权限标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务的唯一编号 |
此参数用于查找service |
必填 |
无 |
|
|
column |
自定义字段名字 |
用户针对轨迹的自定义字段的名字，最多5个自定义字段 必须先在“轨迹自定义字段”中进行创建字段。 在同一个service下不能出现名称一样的自定义字段。 需要按照定义的类型上传数据，例如定义为int，则仅上传数字。 名字仅支持中文、英文大小字母、英文下划线”_”、英文横线”-“和数字 名字最长不得超过128字符,不能以”_”开头 |
必填 |
无 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
说明 |
|
|---|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
||
|
errmsg |
返回结果状态码描述 |
String |
||
|
errdetail |
错误细节 |
String |
||
修改轨迹的自定义字段
- 接口说明
修改自定义字段后，所有属于用户所指定service的终端轨迹对应字段都会受到影响。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/point/column/update |
|
请求方式 |
POST |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求服务权限标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务的唯一编号 |
此参数用于查找service |
必填 |
无 |
|
|
column |
自定义字段名字 |
用户针对轨迹的自定义字段的名字，最多5个自定义字段 必须先在“轨迹自定义字段”中进行创建字段。 在同一个service下不能出现名称一样的自定义字段。 需要按照定义的类型上传数据，例如定义为int，则仅上传数字。 名字仅支持中文、英文大小字母、英文下划线”_”、英文横线”-“和数字 名字最长不得超过128字符,不能以”_”开头 |
必填 |
无 |
|
|
newcolumn |
新自定义名字 |
同上 |
必填 |
无 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
说明 |
|
|---|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
||
|
errmsg |
返回结果状态码描述 |
String |
||
|
errdetail |
错误细节 |
String |
||
查询轨迹的自定义字段
- 接口说明
用户可以通过该接口查询已经创建的轨迹自定义字段。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/point/column/list |
|
请求方式 |
GET |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求服务权限标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务的唯一编号 |
此参数用于查找service |
必填 |
无 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
说明 |
||
|---|---|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
|||
|
errmsg |
返回结果状态码描述 |
String |
|||
|
errdetail |
错误细节 |
String |
|||
|
data |
数据结果 |
对象 |
|||
|
results |
里面包含具体结果 |
数组 |
|||
|
column |
自定义字段的名字 |
String |
|||
|
type |
自定义字段的类别 |
String |
|||