# 变更记录 | 产品版本 | 更新内容 | 更新日期 | | --- | --- | --- | | V6.0.1 | 新增地图服务配置说明 | 2023-11-03 | | V7.0.1 | 1、增加了地图服务的google地图选项，满足国际化客户的场景需求
2、增加了注意事项 | 2024-10-24 | # 背景介绍 为支持不同客户可以集成不同类型地图的需求，苍穹平台推出了“地图服务”功能，本文主要对该功能的相关配置参数及其使用做详细说明。 # 适用版本 金蝶云苍穹BOS_V6.0.1及以上 # 注意事项 1、百度和高德等地图密钥在网络请求中是非加密传输的，为了防止其他人获取后非法使用，建议采取配置白名单（在地图控制台）等措施 # 配置入口 路径：【第三方服务配置】 → 【地图服务】 (配置界面可能根据业务需要做调整，请以实际为准) # 默认地图 ## 配置界面  ## 配置参数说明 默认地图无需配置，开箱即用（但提供的功能API及其调用量都有限） # 高德地图 ## 配置界面  ## 配置参数说明 高德地图密钥申请路径：(高德地图) 【控制台】 → 【应用管理】 → 【我的应用】 ### (1) Web端(JS API)密钥 "Web端(JS API)"类型的KEY，用于加载地图，使用JavaScript API等 介绍链接：[/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fjavascript-api%2Fguide%2Fabc%2Fprepare](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fjavascript-api%2Fguide%2Fabc%2Fprepare) ### (2) 安全密钥 申请"Web端(JS API)密钥"时自动生成的配对的安全密钥（自2021年12月02日升级，升级之后所申请的KEY必须配备安全密钥一起使用） 介绍链接：[/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fjavascript-api%2Fguide%2Fabc%2Fprepare](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fjavascript-api%2Fguide%2Fabc%2Fprepare) ### (3) Web服务API密钥 "Web服务"类型的KEY，用于访问地图Web服务，比如坐标转换，地理/逆地理编码等 介绍链接：[/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fwebservice%2Fgettingstarted](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fwebservice%2Fgettingstarted) ## 验证 “**连接测试**“按钮，用于验证“Web服务API密钥”是否可以正常使用 ## 错误码说明([高德官方说明](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fapi%2Fwebservice%2Fguide%2Ftools%2Finfo)) | **infocode** | **info返回值** | **状态描述** | **问题排查策略** | | --- | --- | --- | --- | | 10000 | OK | 请求正常 | 请求正常 | | 10001 | INVALID_USER_KEY | key不正确或过期 | 开发者发起请求时，传入的key不正确或者过期 | | 10002 | SERVICE_NOT_AVAILABLE | 没有权限使用相应的服务或者请求接口的路径拼写错误 | 1.开发者没有权限使用相应的服务，例如：开发者申请了WEB定位功能的key，却使用该key访问逆地理编码功能时，就会返回该错误。反之亦然。
2.开发者请求接口的路径拼写错误。例如：正确的https://restapi.amap.com/**v3**/ip在程序中被拼装写了https://restapi.amap.com/**vv3**/ip" | | 10003 | DAILY_QUERY_OVER_LIMIT | 访问已超出日访问量 | 开发者的日访问量超限，被系统自动封停，第二天0:00会自动解封。 | | 10004 | ACCESS_TOO_FREQUENT | 单位时间内访问过于频繁 | 开发者的单位时间内（1分钟）访问量超限，被系统自动封停，下一分钟自动解封。 | | 10005 | INVALID_USER_IP | IP白名单出错，发送请求的服务器IP不在IP白名单内 | 开发者在LBS官网控制台设置的IP白名单不正确。白名单中未添加对应服务器的出口IP。可到["控制台>配置" ](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fdev%2F) 中设定IP白名单。 | | 10006 | INVALID_USER_DOMAIN | 绑定域名无效 | 开发者绑定的域名无效，需要在官网控制台重新设置 | | 10007 | INVALID_USER_SIGNATURE | 数字签名未通过验证 | 开发者签名未通过开发者在key控制台中，开启了“数字签名”功能，但没有按照指定算法生成“数字签名”。 | | 10008 | INVALID_USER_SCODE | MD5安全码未通过验证 | 需要开发者判定key绑定的SHA1,package是否与sdk包里的一致 | | 10009 | USERKEY_PLAT_NOMATCH | 请求key与绑定平台不符 | 请求中使用的key与绑定平台不符，例如：开发者申请的是js api的key，却用来调web服务接口 | | 10010 | IP_QUERY_OVER_LIMIT | IP访问超限 | 未设定IP白名单的开发者使用key发起请求，从单个IP向服务器发送的请求次数超出限制，被系统自动封停。封停后无法自动恢复，需要提交[工单](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fdev%2Fticket%2Fcreate%2F24)联系我们。 | | 10011 | NOT_SUPPORT_HTTPS | 服务不支持https请求 | 服务不支持https请求，如果需要申请支持，请提交[工单](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fdev%2Fticket%2Fcreate%2F24)联系我们 | | 10012 | INSUFFICIENT_PRIVILEGES | 权限不足，服务请求被拒绝 | 由于不具备请求该服务的权限，所以服务被拒绝。 | | 10013 | USER_KEY_RECYCLED | Key被删除 | 开发者删除了key，key被删除后无法正常使用 | | 10014 | QPS_HAS_EXCEEDED_THE_LIMIT | 云图服务QPS超限 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10015 | GATEWAY_TIMEOUT | 受单机QPS限流限制 | 受单机QPS限流限制时出现该问题，建议降低请求的QPS或在控制台提工单联系我们 | | 10016 | SERVER_IS_BUSY | 服务器负载过高 | 服务器负载过高，请稍后再试 | | 10017 | RESOURCE_UNAVAILABLE | 所请求的资源不可用 | 所请求的资源不可用 | | 10019 | CQPS_HAS_EXCEEDED_THE_LIMIT | 使用的某个服务总QPS超限 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10020 | CKQPS_HAS_EXCEEDED_THE_LIMIT | 某个Key使用某个服务接口QPS超出限制 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10021 | CUQPS_HAS_EXCEEDED_THE_LIMIT | 账号使用某个服务接口QPS超出限制 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10026 | INVALID_REQUEST | 账号处于被封禁状态 | 由于违规行为账号被封禁不可用，如有异议请登录[控制台](/tolink?target=https%3A%2F%2Fconsole.amap.com%2Fdev%2Findex)提交工单进行申诉 | | 10029 | ABROAD_DAILY_QUERY_OVER_LIMIT | 某个Key的QPS超出限制 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10041 | NO_EFFECTIVE_INTERFACE | 请求的接口权限过期 | 开发者发起请求时，请求的接口权限过期。请提交[工单](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fdev%2Fticket%2Fcreate%2F24)联系我们 | | 10044 | USER_DAILY_QUERY_OVER_LIMIT | 账号维度日调用量超出限制 | 账号维度日调用量超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10045 | USER_ABROAD_DAILY_QUERY_OVER_LIMIT | 账号维度海外服务日调用量超出限制 | 账号维度海外服务接口日调用量超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 20000 | INVALID_PARAMS | 请求参数非法 | 请求参数的值没有按照规范要求填写。例如，某参数值域范围为[1,3],开发者误填了’4’ | | 20001 | MISSING_REQUIRED_PARAMS | 缺少必填参数 | 缺少接口中要求的必填参数 | | 20002 | ILLEGAL_REQUEST | 请求协议非法 | 请求协议非法
比如某接口仅支持get请求，结果用了POST方式 | | 20003 | UNKNOWN_ERROR | 其他未知错误 | 其他未知错误 | | 20011 | INSUFFICIENT_ABROAD_PRIVILEGES | 查询坐标或规划点（包括起点、终点、途经点）在海外，但没有海外地图权限 | 使用逆地理编码接口、输入提示接口、周边搜索接口、路径规划接口时可能出现该问题，规划点（包括起点、终点、途经点）不在中国陆地范围内 | | 20012 | ILLEGAL_CONTENT | 查询信息存在非法内容 | 使用搜索接口时可能出现该问题，通常是由于查询内容非法导致 | | 20800 | OUT_OF_SERVICE | 规划点（包括起点、终点、途经点）不在中国陆地范围内 | 使用路径规划服务接口时可能出现该问题，规划点（包括起点、终点、途经点）不在中国大陆陆地范围内 | | 20801 | NO_ROADS_NEARBY | 划点（起点、终点、途经点）附近搜不到路 | 使用路径规划服务接口时可能出现该问题，划点（起点、终点、途经点）附近搜不到路 | | 20802 | ROUTE_FAIL | 路线计算失败，通常是由于道路连通关系导致 | 使用路径规划服务接口时可能出现该问题，路线计算失败，通常是由于道路连通关系导致 | | 20803 | OVER_DIRECTION_RANGE | 起点终点距离过长。 | 使用路径规划服务接口时可能出现该问题，路线计算失败，通常是由于道路起点和终点距离过长导致。 | | 300** | ENGINE_RESPONSE_DATA_ERROR | 服务响应失败。 | 出现3开头的错误码，建议先检查传入参数是否正确，若无法解决，请详细描述错误复现信息，提[工单](/tolink?target=https%3A%2F%2Flbs.amap.com%2Fdev%2Fticket%2Fcreate%2F24)给我们。（大数据接口请直接跟负责商务反馈）
如，30001、30002、30003、32000、32001、32002、32003、32200、32201、32202、32203。 | | 40000 | QUOTA_PLAN_RUN_OUT | 余额耗尽 | 所购买服务的余额耗尽，无法继续使用服务 | | 40001 | GEOFENCE_MAX_COUNT_REACHED | 围栏个数达到上限 | Key可创建的地理围栏的数量，已达上限。 | | 40002 | SERVICE_EXPIRED | 购买服务到期 | 所购买的服务期限已到，无法继续使用 | | 40003 | ABROAD_QUOTA_PLAN_RUN_OUT | 海外服务余额耗尽 | 所购买服务的海外余额耗尽，无法继续使用服务 | # 百度地图 ## 配置界面  ## 配置参数说明 百度地图密钥申请路径：(百度地图)【控制台】 → 【应用管理】 → 【我的应用】 ### (1) 浏览器端密钥 浏览器端类型的AK密钥，用于加载地图，使用JavaScript API等 介绍链接：[/tolink?target=https%3A%2F%2Flbsyun.baidu.com%2Findex.php%3Ftitle%3DjspopularGL%2Fguide%2Fgetkey](/tolink?target=https%3A%2F%2Flbsyun.baidu.com%2Findex.php%3Ftitle%3DjspopularGL%2Fguide%2Fgetkey) ### (2) 服务端密钥 服务端类型的AK密钥，用于访问地图Web服务，比如坐标转换，正逆地址编码等 介绍链接：[/tolink?target=https%3A%2F%2Flbsyun.baidu.com%2Ffaq%2Fapi%3Ftitle%3Dwebapi](/tolink?target=https%3A%2F%2Flbsyun.baidu.com%2Ffaq%2Fapi%3Ftitle%3Dwebapi) ## 验证 “**连接测试**“按钮，用于验证“服务端密钥”是否可以正常使用 ## 错误码说明([百度官方说明](/tolink?target=https%3A%2F%2Flbsyun.baidu.com%2Ffaq%2Fapi%3Ftitle%3Dwebapi%2Fguide%2Fwebservice-geocoding-base%23%25E6%259C%258D%25E5%258A%25A1%25E7%258A%25B6%25E6%2580%2581%25E7%25A0%2581)) | **返回码** | **英文描述** | **定义** | **常见原因** | | --- | --- | --- | --- | | 0 | OK | 正常状态 | 服务请求正常召回 | | 1 | | 服务器内部错误 | | | 2 | Parameter Invalid | 请求参数非法 | 必要参数拼写错误或漏传（如query和tag请求中均未传入） | | 3 | Verify Failure | 权限校验失败 | 服务请求正常召回 | | 4 | Quota Failure | 配额校验失败 | 服务当日调用次数已超限，请前往[API控制台](/tolink?target=https%3A%2F%2Flbs.baidu.com%2Fapiconsole%2Fquota)提升（请优先进行[开发者认证](/tolink?target=https%3A%2F%2Flbs.baidu.com%2Fapiconsole%2Fauth)） | | 5 | AK Failure | ak不存在或者非法 | 未传入ak参数；ak已被删除（可前往[回收站](/tolink?target=http%3A%2F%2Flbs.baidu.com%2Fapiconsole%2Fkey%2Frecycle)恢复） | | 101 | | 服务禁用 | 请到[控制台](/tolink?target=http%3A%2F%2Flbs.baidu.com%2Fapiconsole%2Fkey)检验您的AK是否有该服务权限 | | 102 | | 不通过白名单或者安全码不对 | | | 2xx | | 无权限 | | | 3xx | | 配额错误 | | # 谷歌地图 ## 配置界面  ## 配置参数说明 谷歌地图密钥申请路径：(谷歌地图)【控制台】 →（新建或选中一个已有项目）【API 服务】→【凭据】 → 创建凭据（选"API密钥"类型） 【控制台】：[/tolink?target=https%3A%2F%2Fconsole.cloud.google.com%2F](/tolink?target=https%3A%2F%2Fconsole.cloud.google.com%2F) ### (1) 密钥 API密钥用于加载地图，访问JavaScript API服务接口等（通过密钥访问地图服务接口，有一定的免费额度，超过了则需要付费） 介绍链接：https://cloud.google.com/docs/authentication/api-keys **备注：谷歌地图推荐海外客户使用，中国大陆地区更适用于百度和高德地图**