轨迹自定义字段 最后更新时间: 2021年01月22日
简介
本篇介绍如何对终端下的轨迹自定义字段进行管理。
使用限制
服务调用量的限制请点击这里查阅。
增加轨迹的自定义字段
- 接口说明
增加自定义字段后,所有属于当前 service 的终端轨迹都可以使用此自定义字段。 最多创建5个轨迹自定义字段。
- 服务地址
URL | http://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 | http://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 | http://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 | http://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 |