示例中心
功能在线体验
控制台

高德 开发 猎鹰轨迹服务 开发指南 API文档 轨迹自定义字段

更新时间:2018年09月04日

简介

本篇介绍如何对终端下的轨迹自定义字段进行管理。

使用限制

 服务调用量的限制请点击这里查阅。  

增加轨迹的自定义字段

  • 接口说明

增加自定义字段后,所有属于当前 service 的终端轨迹都可以使用此自定义字段。 最多创建10个轨迹自定义字段。

  • 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


查询轨迹的自定义字段

  • 接口说明

用户可以通过该接口查询已经创建的轨迹自定义字段。

请注意,该接口需要使用Get形式请求。

  • 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



示例中心 功能
在线体验
常见问题