地图服务 —— 配置说明

# 变更记录 | 产品版本 | 更新内容 | 更新日期 | | --- | --- | --- | | 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等 介绍链接：[https://lbs.amap.com/api/javascript-api/guide/abc/prepare](https://lbs.amap.com/api/javascript-api/guide/abc/prepare) ### (2) 安全密钥 申请"Web端(JS API)密钥"时自动生成的配对的安全密钥（自2021年12月02日升级，升级之后所申请的KEY必须配备安全密钥一起使用） 介绍链接：[https://lbs.amap.com/api/javascript-api/guide/abc/prepare](https://lbs.amap.com/api/javascript-api/guide/abc/prepare) ### (3) Web服务API密钥 "Web服务"类型的KEY，用于访问地图Web服务，比如坐标转换，地理/逆地理编码等 介绍链接：[https://lbs.amap.com/api/webservice/gettingstarted](https://lbs.amap.com/api/webservice/gettingstarted) ## 验证 “**连接测试**“按钮，用于验证“Web服务API密钥”是否可以正常使用 ## 错误码说明([高德官方说明](https://lbs.amap.com/api/webservice/guide/tools/info)) | **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。可到["控制台>配置" ](https://lbs.amap.com/dev/) 中设定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向服务器发送的请求次数超出限制，被系统自动封停。封停后无法自动恢复，需要提交[工单](https://lbs.amap.com/dev/ticket/create/24)联系我们。 | | 10011 | NOT_SUPPORT_HTTPS | 服务不支持https请求 | 服务不支持https请求，如果需要申请支持，请提交[工单](https://lbs.amap.com/dev/ticket/create/24)联系我们 | | 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 | 账号处于被封禁状态 | 由于违规行为账号被封禁不可用，如有异议请登录[控制台](https://console.amap.com/dev/index)提交工单进行申诉 | | 10029 | ABROAD_DAILY_QUERY_OVER_LIMIT | 某个Key的QPS超出限制 | QPS超出限制，超出部分的请求被拒绝。限流阈值内的请求依旧会正常返回 | | 10041 | NO_EFFECTIVE_INTERFACE | 请求的接口权限过期 | 开发者发起请求时，请求的接口权限过期。请提交[工单](https://lbs.amap.com/dev/ticket/create/24)联系我们 | | 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_