Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
it&s me
unidocs-zh
提交
a60c4e97
U
unidocs-zh
项目概览
it&s me
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录