开发 猎鹰轨迹服务 开发指南 API文档 服务管理

服务管理 最后更新时间: 2021年01月22日

简介

本篇介绍用户如何创建一个轨迹服务。使用猎鹰对轨迹进行管理时,首先需要创建一个轨迹服务。

使用限制

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

创建服务

  • 接口说明

可以通过此请求,在对应的 Key 下增加 1 个 Service,Service 增加成功后会返回 Service 的 id。每个 Key 下最多注册15个 Service。

  • 服务地址

URL

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

请求方式

POST

注意:用Postman请求接口时,需要使用x-www-form-urlencoded方式传输。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

name

服务名称

Service 的名字,名字在同一个 Key 下不可重复,不可为空。

命名规则:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字,不能以"_"开头,最长不得超过128个字符。

必填

无  

desc

服务描述

针对此 Service 的文字描述,方便用户对 Service 进行记忆。

命名规则:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字, 不能以"_"开头,最长不得超过128个字符。

非必填 

无  

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

data



sid

服务的唯一ID

数值

name

服务名称

String

删除服务

  • 接口说明

可以针对 Key 下面的 Service 进行删除。一旦删除 Service 将会删除 Service 内的所有信息。

  • 服务地址

URL

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

请求方式

POST

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

sid

服务的唯一编号

不可修改,此参数用于查找service

即便填入此参数,用户也不可修改sid。

必填 

无 

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

修改服务

  • 接口说明

用户可以对某个 Service 的名字、描述进行修改。 

  • 服务地址

URL

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

请求方式

POST

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

sid

服务的唯一编号

不可修改,此参数用于查找 Service

即便填入此参数,用户也不可修改sid。

必填 

无 

name

服务名称

可以修改

若指定此字段,但是没有填写内容则会将描述清空。

若创建的时候没有描述,则会增加描述并按照用户填入信息

存储。 

非必填

无  

desc

服务描述

可以修改

若指定此字段,但是没有填写内容则会将描述清空。

若创建的时候没有描述,则会增加描述并按照用户填入信息

存储。 

非必填 

无  

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

data



sid

服务的唯一ID

数值

name

修改前的服务名称

String

查询服务

  • 接口说明

通过此接口可以查询当前账号下的所有 Service 详细信息。

  • 服务地址

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

data

里面包含具体结果信息


results

里面包含具体信息

数组


sid

服务的唯一ID

数值

name

服务的名字

String

desc

服务的描述

String


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