服务管理 最后更新时间: 2021年01月22日
简介
本篇介绍用户如何创建一个轨迹服务。使用猎鹰对轨迹进行管理时，首先需要创建一个轨迹服务。
使用限制
服务调用量的限制请点击这里查阅。
创建服务
- 接口说明
可以通过此请求，在对应的 Key 下增加 1 个 Service，Service 增加成功后会返回 Service 的 id。每个 Key 下最多注册15个 Service。
- 服务地址
URL | https://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 | https://tsapi.amap.com/v1/track/service/delete |
请求方式 | POST |
- 请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 | |
|---|---|---|---|---|---|
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 | |
sid | 服务的唯一编号 | 不可修改，此参数用于查找service 即便填入此参数，用户也不可修改sid。 | 必填 | 无 | |
- 返回结果
名称 | 含义 | 字段类型 | |
|---|---|---|---|
errcode | 结果状态码 | 数值 | |
errmsg | 返回结果状态码描述 | String | |
errdetail | 错误细节 | String | |
修改服务
- 接口说明
用户可以对某个 Service 的名字、描述进行修改。
- 服务地址
URL | https://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 | https://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 | |||
