外观
第三方服务 token 配置问题
约 830 字
问题的现象
使用第 3 方服务相关功能时,通过 F12 可以看到提示超流量或 403 等错误,造成功能无法正常使用。
问题的原因
百度、高德、天地图等第 3 方服务需要 token 才能访问。目前平台内置的是我们申请的演示 token,但由于平台使用用户较多,访问量容易超出限额,或被误判为爬虫而封禁。 目前涉及以下第 3 方服务(并非必须,视项目选用的功能而定):
- 百度 POI 等服务,token 申请地址:http://lbsyun.baidu.com/apiconsole/key,申请时应用类别选择:服务端
- 高德 POI 等服务,token 申请地址:https://console.amap.com/dev/key/app,申请时服务平台类型选择:Web服务
- 天地图底图等服务,token 申请地址:http://lbs.tianditu.gov.cn/authorization/authorization.html,申请时应用类型选择:浏览器端
- Cesium 官方的 Ion 服务,token 申请地址:https://cesium.com/ion/signin/
- Mapbox 地图,token 申请地址:https://account.mapbox.com
- 微软 Bing 地图,token 申请地址:https://www.bingmapsportal.com/Application
解决方法及步骤
请在自己的项目中根据实际用到的服务情况,申请自己的 key 或 token 后进行修改替换,主要涉及以下 2 类修改:
目前所有涉及 token 的第 3 方相关类均支持传入 key 或 token 参数进行设置。如果未传入参数,平台将使用内置的 mars3d.Token.* 默认值。
1. 覆盖 mars3d.Token 中的默认值
此方式适合所有类都未传入 key 或 token 参数的情况,修改一处即可全局生效,建议项目中按此方式处理。
(1)如果 map 是通过 config.json 构造的,可以按下面示例增加 token 配置。
{
"scene":{},//已忽略其他参数值
"method":{ //method是V3.7及之后版本存在,V3.6及之前去掉method这一层
"token":{
"tianditu":"e5c3984ced09bc1f55e8e1107fdc5a6b",
"baidu":"jTqhUqeeRirqd8musUiYmthqdHDHsiB2",
"gaode":"ee24b622294b5bc659fb92fe81084776",
"ion":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2NjkxN2Y5Ni0wZjgyLTQyZDEtODEzNS0zYTlkN2UwMmU3OTciLCJpZCI6NTM1NDIsImlhdCI6MTYxOTIzMDkzMH0.S3x2FMdIx98KuCq8vN_gkC_PArveXJ5bPBNZ3CEYgtc",
"mapbox":"pk.eyJ1IjoiY25zdW55b3VyIiwiYSI6ImNsMmN5Y2ppaDB0ZGYzam8yZmF2MjVqb3cifQ.FYxirkiZsriqaFw_x0IyAw",
"bing":"Am5SdKm6pNdkP1P5zuUOMZwleCHeA7GD5vuQgZ3xBUbEMBeQ5cQ1WN4B8xqqV1Vt"
}
},
"terrain": {},//已忽略其他参数值
"basemaps": [],
"layers": []
}(2)如果 mars3d.Map 是通过代码传参构造的,可以按下面示例增加 token 参数。
const map = new mars3d.Map("mars3dContainer", {
// 已忽略其他参数
method: {// method是V3.7及之后版本存在,V3.6及之前去掉method这一层
token: {
tianditu: "e5c3984ced09bc1f55e8e1107fdc5a6b",
baidu: "jTqhUqeeRirqd8musUiYmthqdHDHsiB2",
gaode: "ee24b622294b5bc659fb92fe81084776",
ion: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2NjkxN2Y5Ni0wZjgyLTQyZDEtODEzNS0zYTlkN2UwMmU3OTciLCJpZCI6NTM1NDIsImlhdCI6MTYxOTIzMDkzMH0.S3x2FMdIx98KuCq8vN_gkC_PArveXJ5bPBNZ3CEYgtc",
mapbox: "pk.eyJ1IjoiY25zdW55b3VyIiwiYSI6ImNsMmN5Y2ppaDB0ZGYzam8yZmF2MjVqb3cifQ.FYxirkiZsriqaFw_x0IyAw",
bing: "Am5SdKm6pNdkP1P5zuUOMZwleCHeA7GD5vuQgZ3xBUbEMBeQ5cQ1WN4B8xqqV1Vt",
},
},
});2. 批量替换修改 key 参数值
如果相关配置或代码中使用了 key 参数,就需要进行全局批量替换:复制已有的 key 值,打开项目后按全字匹配全局查找,然后批量替换。
(1)我们以天地图 key 为例,假设:
- 原有示例中的 key 为
789e558be762ff832392a0393fd8a4f1 - 自己申请的 key 为
d083e4cf30bfc438ef93436c10c2c20a
可以将 789e558be762ff832392a0393fd8a4f1 批量替换为 d083e4cf30bfc438ef93436c10c2c20a
{
"scene": {},
"terrain": {},//已忽略其他参数
"basemaps":[
{
"name": "天地图影像",
"type": "group",
"layers": [
{
"name": "底图",
"type": "tdt",
"layer": "img_d",
"key": ["d083e4cf30bfc438ef93436c10c2c20a"]
},
{
"name": "注记",
"type": "tdt",
"layer": "img_z",
"key": ["d083e4cf30bfc438ef93436c10c2c20a"]
}
],
"show": true
}
],
"layers":[]
}(2)如果是 JS 代码,比如下面的 GaodeRoute 类 的使用代码,可以将 ae29a37307840c7ae4a785ac905927e0 批量替换为 ee24b622294b5bc659fb92fe81084776
- 在使用的类中参考 API 增加 key 参数:
gaodeRoute = new mars3d.query.QueryRoute({
key: ["ae29a37307840c7ae4a785ac905927e0"],
});
// 未传入key参数,内部使用了默认值。如果未解决 也可以按需修改代码,增加key值。
gaodeRoute = new mars3d.query.QueryRoute();