开发 地图小程序OPENAPI 开发指南 设备 设备位置上报

上报设备位置 最后更新时间: 2024年12月26日

1、请求地址

请求URL

https://restwia.amap.com/api/v1/wia/map/location/device/upload?parameters

请求方式

POST

请求类型ContenType

application/json

url请求参数

名称

类型

描述

规则

是否必填

key

string

高德key

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

deviceId

string

设备id

三方设备id

bizToken

string

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

bizSign

string

业务签名

签名参数 deviceId参考签名规则

sig

string

数字签名

请参考数字签名获取和使用方法

请求参数

名称

类型

描述

规则

是否必填

deviceId

String

设备id

长度需小于200

必填

reportTime

Number

上报时间

毫秒时间戳

必填

lon

String

精度

GCJ-02坐标系

必填

lat

String

维度

GCJ-02坐标系

必填

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
        String requestUrl = "https://restwia.amap.com/api/v1/wia/map/location/device/upload";
        //url param
        HashMap<String, Object> param1 = Maps.newHashMap();
        param1.put("key", "在高德开放平台申请的key");
        param1.put("deviceId", "设备id");
        param1.put("bizToken", "在高德开放平台申请的bizToken");
        param1.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"deviceId"}));
        //body
        HashMap<String, Object> param2 = Maps.newHashMap();
        param2.put("deviceId","testtesttest");
        param2.put("lon","116.417621");
        param2.put("lat","39.904583");
        param2.put("reportTime", System.currentTimeMillis());


        requestUrl = MyHttpUtils.attachParamsToUrl(requestUrl,param1);
        String s = MyHttpUtils.postApplicationJson(requestUrl, JSONObject.toJSONString(param2));
        System.out.println("s = " + s);
}

返回参数

名称

类型

描述

规则说明

code

Number

返回结果状态

data

Object

返回结果数据

成功true失败false

message

String

返回状态说明

成功时返回Successful,否则返回错误原因

result

Boolean

返回结果状态

true或false

version

String

版本

timestamp

Long

时间戳

requestId

String

请求id

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