文档信息

文档用于记录开放平台接口常见问题

常见问题

接入数据的获取

问题1:key，bizToken，bizSecret等参数的获取

参照平台接入流程文档 https://lbs.amap.com/api/wia-openapi/quick/access

接口调用常见失败返回

1、平台异常类型

{
    "status": "0",
    "info": "INVALID_USER_KEY",
    "infocode": "10001"
}

当接口返回平台异常一类型，请参考通用错误码说明文档 https://lbs.amap.com/api/wia-openapi/tools/code

2、接口业务异常返回

①计算解密字符错误

{
    "data": null,
    "code": 100015,
    "message": "计算解密字符错误",
    "result": false,
    "version": "1.0",
    "timestamp": 1716462326839,
    "requestId": "21050b8317164623268282984d1b90"
}

可能是入参中的workMapId，openId等相关参数传错了，请检查openId、workMapId等参数是否错传

② biz sign error

{
    "data": null,
    "code": 100010,
    "message": "biz sign error",
    "result": false,
    "version": "1.0",
    "timestamp": 1716462497332,
    "requestId": "21050b8317164624973143090d1b90"
}

bizSign签名参数错误，请检查是否按照接口文档中给出的规则计算了bizSign签名参数，参数及顺序都要与文档给出的规则一致

计算方法参照：https://lbs.amap.com/api/wia-openapi/tools/biz-token-sign  章节2.2bizSign签名参数

③非群内成员\workMapId 不属于此组织\资源id和地图id关系不一致 等类似提示

多个小程序之间的组织、地图、资源、成员等数据是不能通用的，当出现类似提示时，请检查接口入参中bizToken\openId\workMapId\resourceId 等是否存在相互关系

更多业务异常 其他请参照 https://lbs.amap.com/api/wia-openapi/tools/code 业务类异常码对照表

接口的常见问题

1、地图任务相关接口

问题1：创建地图任务两个接口区别

doCreate接口新增了设置电子围栏范围的入参（fenceSwitch、fenceScope），使用电子围栏可以限制任务执行人执行任务的范围，效果见下图。推荐使用doCreate接口

问题2：设置任务提醒的作用

设置任务提醒后，会设置的提醒规则，在小程序中对任务相关人进行通知，效果见下图

问题3: 任务周期重复作用

按照用户设置的参数（详细的周期重复参数请参照任务创建接口文档），周期性的进行任务下发。例如，创建任务时设置周期重复参数为每周一重复，小程序会在每周一（不包括本周）创建一个同名任务

问题4: 任务资源列表中的开始结束时间的作用

任务规则完成时 的时间校验 及通知等

2、路线相关接口

问题1：途径点集合只传一个点信息，会不会创建出一条路线

不会，使用一个点创建路线，最终生成的路线只有一个点，效果如下图

3、驾车算路接口

问题1：终点的传参位置

接口body入参"destination"为目的地信息，不能将终点信息作为途径点（参数名：subPoints）的最后一个点

4、地图成员管理接口

问题1:如何使用移除地图成员接口，从地图中删除成员

需要“被删除人”调用移除地图成员接口，主动移除相关地图，按照下图规则进行传参

问题2:为什么从地图中将成员移除后，团队成员页面仍显示被移除的成员？

因为地图成员与团队成员不是一个概念，地图成员是地图下的所有人，团队成员是组织下的所有人，移除地图成员不会影响组织成员。如需删除组织成员请调用移除组织成员接口

5、账号同步接口

问题1:（限渠道用户）使用不同手机号调用账号同步接口，返回的orgId是不同的，需要给每一个org都注册回调地址吗？

渠道客户根据渠道进行回调，找对接人配置好回调地址即可，不需要给org注册

问题2: 每次调用都会创建新的地图吗？

接口调用时不填写workMapId，会使用企业管理员帐号新创建一个地图，填写workMapId时不会创建新地图。所以地图要重复使用时，请记录好workMapId。

问题3:首次调用账号同步接口失败

在调用账号同步接口之前，确保已经在公网配置superUid，向对接人提供注册过高德账号的手机号作为超管手机号

6、货车算路接口

问题1:影响货车算路响应时间的因素

货车算路接口响应时间的印象因素较多，与里程、车参（长、宽、高、载重等）有关，与具体的路线也有关。当调用接口计算里程较长的路程时，接口提示“timeout is 3000”时，请缩短算路里程重试

7、企业组织生产接口

问题1:如何移除组织成员

使用被移除人在组织中的openId进行接口调用，规则如下图

问题2:如何获取在其他组织中的openId

使用获取开放账户接口，入参使用A用户的手机号，B用户组织的bizToken，可以得到A用户在B用户组织下的openId