Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
a60c4e97
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3039
Star
102
Fork
763
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
87
列表
看板
标记
里程碑
合并请求
59
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
87
Issue
87
列表
看板
标记
里程碑
合并请求
59
合并请求
59
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
a60c4e97
编写于
9月 28, 2021
作者:
Q
qiang
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: update maps key
上级
da1c6d24
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
23 addition
and
17 deletion
+23
-17
docs/api/location/location.md
docs/api/location/location.md
+2
-1
docs/api/location/map.md
docs/api/location/map.md
+1
-0
docs/api/location/open-location.md
docs/api/location/open-location.md
+1
-1
docs/collocation/manifest.md
docs/collocation/manifest.md
+5
-1
docs/component/map.md
docs/component/map.md
+14
-14
未找到文件。
docs/api/location/location.md
浏览文件 @
a60c4e97
...
...
@@ -60,7 +60,7 @@ uni.getLocation({
-
H5:PC 设备使用 Chrome 浏览器的时候,位置信息是连接谷歌服务器获取的,国内用户可能获取位置信息失败。
-
H5:使用地图和定位相关需要在
[
腾讯地图开放平台
](
https://lbs.qq.com/dev/console/key/manage
)
申请密钥,填写在
[
manifest.json
](
https://uniapp.dcloud.io/collocation/manifest?id=h5sdkconfig
)
中。
-
H5:微信公众号可使用微信js sdk,
[
详见
](
https://ask.dcloud.net.cn/article/35380
)
-
H5:2.9.9
alpha升级,优化 uni.getLocation 支持通过 IP 定位。默认通过getLocation获取,如果获取失败,备选方案是通过 IP 定位获取,用的是内置公共的key,如果你想正确使用,就填写正常的key。如果你不想使用,就填写错误的key即可
。key配置:manifest.json ---> H5配置 ---> 定位和地图 ---> key。
-
H5:2.9.9
版本以上,优化 uni.getLocation 支持通过 IP 定位。默认通过 GPS 获取,如果获取失败,备选方案是通过 IP 定位获取,需填写地图服务平台的秘钥(key)
。key配置:manifest.json ---> H5配置 ---> 定位和地图 ---> key。
-
App:Android由于谷歌服务被墙,或者手机上没有GMS,想正常定位就需要向高德等三方服务商申请SDK资质,获取AppKey。否则打包后定位就会不准。云打包时需要在manifest的SDK配置中填写Appkey。在manifest可视化界面有详细申请指南,详见:
[
https://ask.dcloud.net.cn/article/29
](
https://ask.dcloud.net.cn/article/29
)
。离线打包自行在原生工程中配置。注意包名、appkey、证书信息必须匹配。真机运行可以正常定位,是因为真机运行基座使用了DCloud向高德申请的sdk配置,打包后必须由开发者自己申请。如果手机自带GMS且网络环境可以正常访问google定位服务器,此时无需在manifest填写高德定位的sdk配置。
-
App:
``<map>``
组件默认为国测局坐标gcj02,调用
``uni.getLocation``
返回结果传递给
``<map>``
组件时,需指定 type 为 gcj02。
-
App:定位和map是2个东西。通过
`getLocation`
得到位置坐标后,可以在任意map地图上展示,比如定位使用高德,地图使用google的webview版地图。如果坐标系不同时,注意转换坐标系。
...
...
@@ -121,6 +121,7 @@ uni.chooseLocation({
**注意**
-
不同端,使用地图选择时基于的底层地图引擎不一样,如微信小程序和H5是腾讯地图,App和阿里小程序是高德地图,百度小程序是百度地图,详见地图map组件的使用注意事项。app中也可以使用百度定位,在manifest中配置,打包后生效。但app-nvue里只能用高德定位,不能用百度地图。另外选择地图、查看地图位置的API也仅支持高德地图。所以App端如无特殊必要,建议使用高德地图。
-
H5 端使用地图和定位相关,需要在 (manifest.json)[/collocation/manifest?id=h5sdkconfig] 内配置腾讯或谷歌等三方地图服务商申请的秘钥(key)。
-
微信内置浏览器中可使用微信js sdk,
[
详见
](
https://ask.dcloud.net.cn/article/35380
)
-
chooseLocation属于封装型API,开发者若觉得不够灵活,可自行基于原始的map组件进行封装。插件市场已经有各种封装样例了。
-
若Android App端位置不准,见上文uni.getLocation的注意事项
docs/api/location/map.md
浏览文件 @
a60c4e97
...
...
@@ -268,4 +268,5 @@ address|String|地址
-
H5 端获取定位信息,需要部署在
**https**
服务上,本地预览(localhost)仍然可以使用 http 协议。
-
无 GPS 模块的 PC 设备使用 Chrome 浏览器的时候,位置信息是连接谷歌服务器获取的,国内用户可能获取位置信息失败。
-
App 端使用地图组件需要向高德或百度等三方服务商申请SDK资质,获取AppKey,打包时需要在manifest的SDK配置中填写Appkey。在manifest可视化界面有详细申请指南,详见:
[
https://ask.dcloud.net.cn/article/29
](
https://ask.dcloud.net.cn/article/29
)
-
H5 端使用地图和定位相关,需要在 (manifest.json)[/collocation/manifest?id=h5sdkconfig] 内配置腾讯或谷歌等三方地图服务商申请的秘钥(key)。
-
``<map>``
组件默认为国测局坐标,调用
``uni.getLocation``
返回结果传递给
``<map>``
组件时,需指定 type 为 gcj02。
docs/api/location/open-location.md
浏览文件 @
a60c4e97
...
...
@@ -45,7 +45,7 @@ uni.getLocation({
-
若定位不准,参考
[
uni.getLocation文档的注意事项
](
https://uniapp.dcloud.io/api/location/location
)
-
``<map>``
组件默认为国测局坐标,调用
``uni.getLocation``
返回结果传递给
``<map>``
组件时,需指定 type 为 gcj02。
-
App 端使用地图组件需要向高德等三方服务商申请SDK资质,获取AppKey,打包时需要在manifest的SDK配置中填写Appkey。在manifest可视化界面有详细申请指南,详见:
[
https://ask.dcloud.net.cn/article/29
](
https://ask.dcloud.net.cn/article/29
)
。
-
H5 端使用地图和定位相关
需要在
[
腾讯地图开放平台
](
https://lbs.qq.com/dev/console/key/manage
)
申请密钥,填写在
[
manifest.json
](
https://uniapp.dcloud.io/collocation/manifest?id=h5sdkconfig
)
中
。
-
H5 端使用地图和定位相关
,需要在 (manifest.json)[/collocation/manifest?id=h5sdkconfig] 内配置腾讯或谷歌等三方地图服务商申请的秘钥(key)
。
-
iOS端 如需使用第三方地图进行导航,需要在 manifest.json 文件内增加
``urlschemewhitelist``
节点,在线打包即可
-
不同平台打开的地图不一样,App端是高德地图(不支持百度地图)、H5端是腾讯地图、微信小程序端是腾讯地图、百度小程序是百度地图、阿里小程序是高德地图、字节跳动小程序是高德地图。
...
...
docs/collocation/manifest.md
浏览文件 @
a60c4e97
...
...
@@ -304,7 +304,11 @@ Tips:`uni-app` 中 `manifest.json->h5->devServer` 实际上对应 `webpack`
"sdkConfigs"
:
{
"maps"
:
{
"qqmap"
:
{
//
腾讯地图秘钥(key)https://lbs.qq.com/dev/console/key/manage
//
腾讯地图秘钥
https://lbs.qq.com/dev/console/key/manage
"key"
:
""
},
"google"
:
{
//
谷歌地图秘钥(HBuilderX
3.2
.
10
+)https://developers.google.com/maps/documentation/javascript/get-api-key
"key"
:
""
}
}
...
...
docs/component/map.md
浏览文件 @
a60c4e97
...
...
@@ -54,11 +54,11 @@
-
`uni-app`
只支持
`gcj02`
坐标
-
App平台
`layer-style`
属性需要在地图服务商后台创建,值设置为高德后台申请的字符串,
[
详情
](
https://developer.amap.com/api/android-sdk/guide/create-map/custom
)
### 近期新增功能
1.
支持点聚合,适用于marker过多场景。
2.
支持彩虹蚯蚓线,常用于路线规划场景。
3.
覆盖物支持调整与其它地图元素的压盖关系。
4.
支持marker(小车)平移动画,适用于轨迹回放场景。
### 近期新增功能
1.
支持点聚合,适用于marker过多场景。
2.
支持彩虹蚯蚓线,常用于路线规划场景。
3.
覆盖物支持调整与其它地图元素的压盖关系。
4.
支持marker(小车)平移动画,适用于轨迹回放场景。
**markers**
...
...
@@ -114,15 +114,15 @@
|aria-label|无障碍访问,(属性)元素的额外描述|String|App-nvue 3.1.0+、微信小程序|
|joinCluster|是否参与点聚合|Boolean|App-nvue 3.1.0+、微信小程序|
### 点聚合
### 点聚合
当地图上需要展示的标记点 marker 过多时,可能会导致界面上 marker 出现压盖,展示不全,并导致整体性能变差。针对此类问题,推出点聚合能力。
使用流程如下:
[
MapContext.initMarkerCluster
](
api/location/map?id=createmapcontext
)
对聚合点进行初始化配置(可选);
[
MapContext.addMarkers
](
api/location/map?id=createmapcontext
)
指定参与聚合的 marker;
MapContext.on('markerClusterCreate', callback) 触发时,通过
[
MapContext.addMarkers
](
api/location/map?id=createmapcontext
)
更新聚合簇的样式 (可选);
当地图上需要展示的标记点 marker 过多时,可能会导致界面上 marker 出现压盖,展示不全,并导致整体性能变差。针对此类问题,推出点聚合能力。
使用流程如下:
[
MapContext.initMarkerCluster
](
api/location/map?id=createmapcontext
)
对聚合点进行初始化配置(可选);
[
MapContext.addMarkers
](
api/location/map?id=createmapcontext
)
指定参与聚合的 marker;
MapContext.on('markerClusterCreate', callback) 触发时,通过
[
MapContext.addMarkers
](
api/location/map?id=createmapcontext
)
更新聚合簇的样式 (可选);
[
MapContext.removeMarkers
](
api/location/map?id=createmapcontext
)
移除参与聚合的 marker;
...
...
@@ -247,7 +247,7 @@ nvue map 更换箭头图标格式参考: [https://ask.dcloud.net.cn/article/3790
-
H5 端获取定位信息,需要部署在
**https**
服务上,本地预览(localhost)仍然可以使用 http 协议。
-
无GPS模块或GPS无信号的 PC 设备使用 Chrome 浏览器的时候,位置信息是连接谷歌服务器获取的,国内用户可能获取位置信息失败。
-
App 端使用地图组件需要
**向高德或百度等三方服务商申请SDK资质,获取AppKey,打包时需要在manifest文件中勾选相应模块,在SDK配置中填写Appkey。注意申请包名和打包时的包名需匹配一致,证书信息匹配**
。在manifest可视化界面有详细申请指南。
-
H5 端使用地图和定位相关
需要在
[
腾讯地图开放平台
](
https://lbs.qq.com/dev/console/key/manage
)
申请密钥,填写在
[
manifest.json
](
https://uniapp.dcloud.io/collocation/manifest?id=h5sdkconfig
)
中
。
-
H5 端使用地图和定位相关
,需要在 (manifest.json)[/collocation/manifest?id=h5sdkconfig] 内配置腾讯或谷歌等三方地图服务商申请的秘钥(key)
。
-
ios nvue Color 不支持 ARGB 十六进制,使用 rgba(r,g,b,a) 代替
##### FAQ
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录