diff --git a/docs/api/location/location.md b/docs/api/location/location.md index bc31c676303b81d3d35be8de143a2da692155b77..ad5b1e38c613d9fc32269b782a4cb6640128547f 100644 --- a/docs/api/location/location.md +++ b/docs/api/location/location.md @@ -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:```` 组件默认为国测局坐标gcj02,调用 ``uni.getLocation`` 返回结果传递给 ```` 组件时,需指定 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的注意事项 diff --git a/docs/api/location/map.md b/docs/api/location/map.md index 2fc1ebc5a955c8d0ab0e26177a733f84770b9eab..b08804bb412c6f44ef6391942b657f559d70e473 100644 --- a/docs/api/location/map.md +++ b/docs/api/location/map.md @@ -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)。 - ```` 组件默认为国测局坐标,调用 ``uni.getLocation`` 返回结果传递给 ```` 组件时,需指定 type 为 gcj02。 diff --git a/docs/api/location/open-location.md b/docs/api/location/open-location.md index ce67b24c8e6ec3348522aac45197ae083aaf8cc8..15ddf36bd0c7f3b0ff8ae959e8ae201a335dc5c9 100644 --- a/docs/api/location/open-location.md +++ b/docs/api/location/open-location.md @@ -45,7 +45,7 @@ uni.getLocation({ - 若定位不准,参考[uni.getLocation文档的注意事项](https://uniapp.dcloud.io/api/location/location) - ```` 组件默认为国测局坐标,调用 ``uni.getLocation`` 返回结果传递给 ```` 组件时,需指定 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端是腾讯地图、微信小程序端是腾讯地图、百度小程序是百度地图、阿里小程序是高德地图、字节跳动小程序是高德地图。 diff --git a/docs/collocation/manifest.md b/docs/collocation/manifest.md index b62621899b83a5e7ae3a278b559f6c25e6615c7a..d589f498e4060fac6912b301d3fc347356154601 100644 --- a/docs/collocation/manifest.md +++ b/docs/collocation/manifest.md @@ -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": "" } } diff --git a/docs/component/map.md b/docs/component/map.md index c08ef55269fa200b8b2e2b1bc8b2897f4902c154..9a4c41534ccdd42d958acd549de5fb6c08cae9ee 100644 --- a/docs/component/map.md +++ b/docs/component/map.md @@ -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