地图任务 最后更新时间: 2024年08月30日
产品介绍
地图任务 API 是通过 HTTPS 协议访问远程服务的接口，提供新建/查询地图的能力。
适用场景
- 父任务创建：创建地图任务
- 父任务删除
- 任务查询
- 父任务列表查询
- 任务中心列表查询
- 父任务资源查询
- 子任务详情查询
使用限制
详细的服务调用量限制可点我查阅。
使用说明
接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。
如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1. 任务创建
请求地址
parameters代表的参数为“url 请求参数”，包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码（以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) {
Strin requestUrl = "https://restwia.amap.com/api/v1/wia/task/center/create";
//封装入参
Map<String, Object> params = new HashMap<>();
//params.put("key", key);//高德应用key，线上环境需要传
params.put("bizToken","在高德开放平台申请的bizToken");
params.put("openId", "当前操作人的openId");//当前操作人
params.put("workMapId","工作地图id");//地图id
params.put("workTaskCenterName","任务名称");//任务名字
params.put("workTaskCenterExecutorId", "执行者openId");//任务执行者id
params.put("workTaskCenterBeginTime","开始时间戳");//工作开始时间
params.put("workTaskCenterEndTime","结束时间戳" );//工作结束时间
params.put("workTaskCenterType",1);//1- 普通任务 2-周期任务
//params.put("workTaskCenterPeriod", );//任务周期提醒
//params.put("workTaskCenterNotify", );//任务提醒类型
params.put("resourceIdList","2003003712445027");//资源点入参 需要String类型，多个之间，隔开， 例如 "123，456"
params.put("workTaskCenterSceneType",1);//任务场景类型
//计算bizSign
String[] signArgs = new String[]{"操作人openId","在高德开放平台申请的bizToken"};//获取业务参数，用于签名计算
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", signArgs));//业务签名
String response = MyHttpUtils.postFormUrlencoded(requestUrl, params);
}
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明：
2、任务创建（新增电子围栏）
请求地址：
url 请求参数
body请求参数
示例代码（以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) {
Strin requestUrl = "https://restwia.amap.com/api/v1/wia/task/center/doCreate";
//url request param
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","当前操作用户的openId");
param1.put("bizSign",SignatureHelper.calcSign(env.getBizSecret(),new String[]{"openId","bizToken"}));
//body param
long beginTime = System.currentTimeMillis(); //开始时间
long endTime = System.currentTimeMillis()+24*60*60*1000;//结束时间
HashMap<String, Object> param2 = Maps.newHashMap();
param2.put("workMapId",env.getWorkMapId());
param2.put("workTaskCenterName","测试任务051303");
param2.put("workTaskCenterDesc","test data");
param2.put("workTaskCenterExecutorId",env.getOpenId());//执行人openId
param2.put("workTaskCenterBeginType",1);//1-自动开始，2-手动开始
param2.put("workTaskCenterBeginTime",beginTime);//当任务开始类型为"自动开始时",需要填写开始时间
param2.put("workTaskCenterEndTime",endTime);//结束时间，当workTaskCenterNotify = 6 时必填
param2.put("workTaskCenterType",1);//1-普通任务，2-周期任务
//任务周期重复
HashMap<String, Object> periodMap = Maps.newHashMap();
periodMap.put("periodType",5);//
periodMap.put("periodFreq",2);//
periodMap.put("periodInterval",1);
periodMap.put("periodNum",1);
periodMap.put("skipHoliday",2);
periodMap.put("skipWeekend",2);
periodMap.put("endType",1);
// periodMap.put("endCount",2);//结束次数
// periodMap.put("endTime");//结束时间
param2.put("workTaskCenterPeriod",JSONObject.toJSONString(periodMap));
//任务提醒
ArrayList<Map<String,Object>> notifyList = Lists.newArrayList();
HashMap<String, Object> notifyMap = Maps.newHashMap();
notifyMap.put("workTaskNotifyType",3);
notifyList.add(notifyMap);
param2.put("workTaskCenterNotify",JSONObject.toJSONString(notifyList));
//资源列表
ArrayList<Map<String,Object>> resourceList = Lists.newArrayList();
HashMap<String, Object> resourceMap01 = Maps.newHashMap();
resourceMap01.put("resourceId", "资源点1id");
resourceMap01.put("beginTime",beginTime);
resourceMap01.put("endTime",endTime);
HashMap<String, Object> resourceMap02 = Maps.newHashMap();
resourceMap02.put("resourceId", "资源点2id");
resourceMap02.put("beginTime",beginTime);
resourceMap02.put("endTime",endTime);
resourceList.add(resourceMap01);
resourceList.add(resourceMap02);
param2.put("resourceListStr",JSONObject.toJSONString(resourceList));
//规则列表
ArrayList<Map<String,Object>> ruleList = Lists.newArrayList();
HashMap<String, Object> ruleMap01 = Maps.newHashMap();
ruleMap01.put("workTaskRuleType", 1);
ruleMap01.put("workTaskRuleRemark","签到打卡");
ArrayList<Map<String,Object>> subRuleList = Lists.newArrayList();
HashMap<String, Object> subRuleMap01 = Maps.newHashMap();
subRuleMap01.put("workTaskSubRuleId",1);
subRuleList.add(subRuleMap01);
ruleMap01.put("subRuleList",subRuleList);
ruleList.add(ruleMap01);
param2.put("workTaskCenterRuleList",JSONObject.toJSONString(ruleList));
param2.put("workTaskCenterSceneType",1);
param2.put("fenceSwitch",2);//1-关闭 2-打开
param2.put("fenceScope",100);
// param2.put("imageUrls",);
requestUrl = MyHttpUtils.attachParamsToUrl(requestUrl,param1);
String s = MyHttpUtils.postFormUrlencoded(requestUrl, param2);
System.out.println("s = " + s);
}
返回参数
响应结果的格式为 JSON 形式，以下是参数说明
返回示例
{
"data": {
"workTaskCenterId":"500820330871010",
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1701142286019,
"requestId": "1eb5d12017011422856761177d14ca"
}3. 父任务删除
请求地址
请求参数
示例代码（以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/task/center/delete";
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","当前操作用户的openId");
param1.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"工作id","操作人openId"}));
param1.put("workMapId","工作地图id");
param1.put("workTaskCenterIds","5003003711035062,5003003711034899");//任务之间用逗号分隔
String s1 = MyHttpUtils.postFormUrlencoded(requestUrl, param1);
System.out.println("s1 = " + s1);
}返回参数
附表
4. 父任务详情
请求地址
parameters代表的参数为“url 请求参数”，包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码（以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) {
Strin requestUrl = "https://restwia.amap.com/api/v1/wia/task/center/detail";
//封装请求参数
Map<String, Object> params = new HashMap<>();
params.put("bizToken","在高德开放平台申请的bizToken");
params.put("openId", "当前操作人openId");//当前操作人
params.put("workMapId","工作地图id");//地图id
params.put("workTaskCenterId","任务id");
params.put("key","在高德开放平台申请的key");
//计算业务签名
String[] signArgs = new String[]{openId,bizToken};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs ));//业务签名
String response = MyHttpUtils.postFormUrlencoded(requestUrl, params);
}返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明：
5. 任务中心列表
请求地址
parameters代表的参数为“url 请求参数”，包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码（以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/task/center/list";
//url 参数
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","操作人openId");
param1.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"操作人openId","在高德开放平台申请的bizToken"}));
param1.put("workMapId","工作地图id");
param1.put("queryType",1);//1-我执行的
param1.put("taskStatusList","0,1");//0-执行中，1-完成，状态之间用逗号隔开
param1.put("memberIds","openId1");//成员ids
// param1.put("dataTimeType",1);
// param1.put("startTime","时间戳");
// param1.put("endTime","时间戳");
param1.put("sortType",1);
param1.put("size",10);
String s1 = MyHttpUtils.postFormUrlencoded(requestUrl, param1);
System.out.println("s1 = " + s1);
}返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明：
6. 父任务资源列表
请求地址
parameters代表的参数为“url 请求参数”，包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/task/center/resource/list";
Map<String,Object> postParams = new HashMap<>();
String[] signArgs = new String[]{openId, bizToken};
postParams.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
postParams.put("bizToken","在高德开放平台申请的bizToken");
postParams.put("openId","当前操作人openId");
postParams.put("workMapId","工作地图id");
postParams.put("workTaskCenterId","任务id");
postParams.put("pageNumber",1);
postParams.put("pageSize",50);
postParams.put("key","在高德开放平台申请的key");
String response = MyHttpUtils.postFormUrlencoded(url, postParams);
}返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明：
7. 子任务内容详情
请求地址
parameters代表的参数为“url 请求参数”，包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码（以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 url = "https://restwia.amap.com/api/v1/wia/task/content/detail";
Map<String,Object> postParams = new HashMap<>();
String[] signArgs = new String[]{openId, bizToken};
postParams.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
postParams.put("bizToken","在高德开放平台申请的bizToken");
postParams.put("openId","当前操作人openId");
postParams.put("workMapId","工作地图id");
postParams.put("workTaskId","子任务id");
postParams.put("key","在高德开放平台申请的key");
String response = MyHttpUtils.postFormUrlencoded(url, postParams);
}返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明：
8、查询任务资源快照信息
请求地址：
url 请求参数
body请求参数
示例代码（以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/task/center/query/resource/snapshot";
//url 参数
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","当前操作人openId");
param1.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"操作人openId","bizToken"});
HashMap<String, Object> param2 = Maps.newHashMap();
param2.put("workMapId","工作地图id");
param2.put("workTaskCenterId","任务id");
param2.put("pageNum",1);
param2.put("pageSize",50);
String s = MyHttpUtils.attachParamsToUrl(requestUrl, param1);
String s1 = MyHttpUtils.postApplicationJson(s, JSONObject.toJSONString(param2));
System.out.println("s1 = " + s1);
}返回参数
响应结果的格式为 JSON 形式，以下是参数说明
返回示例
{
"data": {
"resourceCommentList": [
{
"workTaskCenterId": "500300371824006",
"workTaskId": "4003003711050007",
"resourceId": null,
"commentId": "7f209bd7cd70300371",
"content": "编辑了位置「测试资源点231215」",
"imageUrlList": null,
"commentUserId": "70300371",
"commentUserNickName": "陆小果",
"commentUserAvatar": "http://img-cdn-test.amap.com/pp/avatar/b2f/3a/e3/70300371.jpeg?ver=1698826935&imgoss=1",
"commentTime": 1702620006022,
"commentTypeDesc": "编辑位置",
"commentType": 6
}
],
"currentPage": 1,
"hasMore": 0
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1702620049500,
"requestId": "0b7b2fe417026200491857203d2269"
}9、查询任务评论信息
请求地址：
url 请求参数
body请求参数
示例代码（以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/task/center/query/resource/comments";
//url 参数
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","当前操作人openId");
param1.put("bizSign",SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"操作人openId","bizToken"});
HashMap<String, Object> param2 = Maps.newHashMap();
param2.put("workMapId","工作地图id");
param2.put("workTaskCenterId","任务id");
param2.put("pageNum",1);
param2.put("pageSize",50);
String s = MyHttpUtils.attachParamsToUrl(requestUrl, param1);
String s1 = MyHttpUtils.postApplicationJson(s, JSONObject.toJSONString(param2));
System.out.println("s1 = " + s1);
}返回参数
响应结果的格式为 JSON 形式，以下是参数说明
返回示例
{
"data": {
"resourceSnapshotList": [
{
"workTaskCenterId": "500300371824006",
"workTaskId": "4003003711050007",
"resourceId": "2003003712445027",
"gmtCreate": 1702610897000,
"resourceGmtCreate": 1699251449067,
"resourceCreateUid": "70300371",
"resourceCreateNickName": "陆小果",
"resourceGmtModified": 1699251449067,
"resourceModifiedUid": "70300371",
"resourceModifiedNickName": "陆小果",
"lon": "116.43144384026526",
"lat": "40.022614531933975",
"address": "北京市朝阳区来广营西路99号"
}
],
"currentPage": 1,
"hasMore": 0
},
"code": 1,
"message": "Successful",
"result": true,
"version": "1.0",
"timestamp": 1702611474016,
"requestId": "1eb5d10417026114736441004d18c9"
}10、任务反馈表单查询
请求地址
url请求参数
请求参数
示例代码（以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/task/feedback/template/list";
HashMap<String, Object> param1 = Maps.newHashMap();
param1.put("key","在高德开放平台申请的key");
param1.put("bizToken","在高德开放平台申请的bizToken");
param1.put("openId","当前操作人openId");
param1.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",new String[]{"workMapId","openId"}));
param1.put("workMapId","工作地图id");
HashMap<String, Object> param2 = Maps.newHashMap();
param2.put("pageNum","1");
param2.put("pageSize","20");
String s = MyHttpUtils.attachParamsToUrl(requestUrl, param1);
String s1 = MyHttpUtils.postApplicationJson(s, JSONObject.toJSONString(param2));
System.out.println("s1 = " + s1);
}