物联网开发平台
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 物联网开发平台 > 应用端开发指南 > 应用端 API > 位置服务 > 获取设备当前位置

获取设备当前位置

最近更新时间：2023-07-14 16:46:21

我的收藏

本页目录：

1. 接口描述

接口请求域名：iot.cloud.tencent.com/api/exploreropen/tokenapi。 本接口（AppGetDeviceLocation）用于获取蜂窝网络设备的当前位置。

2. 输入参数

名称
类型
必选
描述
AccessToken
String
是
公共参数，用户通过微信号、手机或邮箱账号登录成功后，获取的访问 Token。
RequestId
String
是
公共参数，唯一请求 ID，可自行生成，推荐使用 uuid。定位问题时，需提供该次请求的 RequestId。
Action
String
是
公共参数，本接口取值：AppGetDeviceLocation。
DeviceId
String
是
设备 ID，由 ProductId/DeviceName 拼接组成。
CoordType
int
否
坐标系：
1：代表百度地图坐标系。
2：代表高德地图或腾讯地图坐标系。
3：代表 wgs84 坐标系。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数，唯一请求 ID，与入参相同。
Data
Object of Position
位置详情。

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json 
{
    "RequestId": "req_1",
    "Action": "AppGetDeviceLocation",
    "DeviceId": "QDA******B/de******01",
    "CoordType": 3
    "AccessToken": "8b4a70dd16105f******************18edd4e78a3bb8ec"
}
输出示例: 成功
{
  "Response": {
    "Data": {
      "Ret": 0,
      "ErrMsg": "",
      "CreateTime": 15990136840000****0,
      "Longitude": 102.83191,
      "Latitude": 24.325504
    },
    "RequestId": "req_1"
  }
}

5. 错误码

错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。

中国站