提交 fbb44c6d 编写于 作者: taohebin@dcloud.io's avatar taohebin@dcloud.io

update:map.md 增加地图key配置

上级 f249cb8f
......@@ -350,3 +350,56 @@ app平台默认`启动界面`为白色(暗黑模式下为黑色),为了避
```
## uni-map-tencent@uni-map-tencent
在uni-app x客户端,uni-map-tencent是一个独立模块。需要开发者在 manifest.json 中手动配置,并提交云端打包后才能生效。
使用 uni-map-tencent 模块需在 manifest.json 文件中添加如下配置:
### 配置腾讯地图
在 app -> distribute -> modules 下添加 uni-map-tencent 节点:
```json
modules:{
"uni-map-tencent": {}
}
```
### 配置腾讯地图SDK的参数
使用腾讯地图需到 [腾讯位置服务](https://lbs.qq.com/) 官网申请TencentLBSAPIKey,并配置到应用中。
#### iOS平台配置腾讯地图Key @uni-map-tencent-ios-key
需在项目根目录下的 Info.plist配置腾讯地图的 TencentLBSAPIKey,然后 iOS 需要打自定义基座才可以生效。
配置教程参考: [iOS原生配置文件Info.plist文档](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#infoplist)
以下为配置示例:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>TencentLBSAPIKey</key>
<string>腾讯位置服务官网申请的Key</string>
</dict>
</plist>
```
#### Andoird平台配置腾讯地图Key @uni-map-tencent-android-key
在项目根目录下添加 AndroidManifest.xml 文件,详情参考:[Android原生应用清单文件](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html#%E5%BA%94%E7%94%A8%E6%B8%85%E5%8D%95%E6%96%87%E4%BB%B6-androidmanifest-xml)。将申请的 key 配置到项目 AndroidManifest.xml 的 application 节点中,如下:
```xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
>
<application>
<!-- 将申请到的 key 配置在 android:value 属性中 -->
<meta-data android:name="TencentMapSDK" android:value="您申请的Key" />
</application>
</manifest>
```
\ No newline at end of file
......@@ -31,6 +31,17 @@
GS粤(2023)1171号
### Map Key配置
app平台目前还没有可视化界面,需要在manifest的源码视图中配置。
app需要在manifest.json文件中配置`uni-map-tencent`节点,[详见](../collocation/manifest-modules.md#uni-map-tencent)
- iOS平台:需要在info.plist中配置对应的Key,参考[iOS平台配置腾讯地图Key](../collocation/manifest-modules.md#uni-map-tencent-ios-key)
- Android平台:需要在AndroidManifest.xml配置Key, 参考[Andoird平台配置腾讯地图Key](../collocation/manifest-modules.md#uni-map-tencent-android-key)
## Tips
- 在App和Web平台,没有在manifest中配置好图商的sdk key信息,将无法使用地图。某些图商的sdk key,区分Web、Android、iOS,注意别配混了。有些sdk key,会绑定校验web的域名或app的包名和签名证书摘要,都要匹配准确才能使用地图。
- 谷歌地图仅支持 `wgs84` 坐标,中国的各个地图仅支持 `gcj02` 坐标,注意使用定位API获取的位置,需与map组件的图商需求一致,把 wgs84 的坐标显示在中国地图上会导致偏移。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册