Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
11d1adb2
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3178
Star
105
Fork
805
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
68
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
68
合并请求
68
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
11d1adb2
编写于
10月 22, 2024
作者:
雪洛
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: 更新map和chooseLocation文档
上级
eaa7f3d0
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
44 addition
and
2 deletion
+44
-2
docs/api/location/location.md
docs/api/location/location.md
+30
-0
docs/component/map.md
docs/component/map.md
+14
-2
未找到文件。
docs/api/location/location.md
浏览文件 @
11d1adb2
...
@@ -135,10 +135,40 @@ Web平台和App平台,本API之前调用了腾讯地图的gcj02坐标免费,
...
@@ -135,10 +135,40 @@ Web平台和App平台,本API之前调用了腾讯地图的gcj02坐标免费,
|latitude|Number|否|目标地纬度|微信小程序(2.9.0+)、H5-Vue3(3.2.10+)|
|latitude|Number|否|目标地纬度|微信小程序(2.9.0+)、H5-Vue3(3.2.10+)|
|longitude|Number|否|目标地经度|微信小程序(2.9.0+)、H5-Vue3(3.2.10+)|
|longitude|Number|否|目标地经度|微信小程序(2.9.0+)、H5-Vue3(3.2.10+)|
|keyword|String|否|搜索关键字,仅App平台支持||
|keyword|String|否|搜索关键字,仅App平台支持||
|useSecureNetwork|Boolea|否|是否通过安全网络调用地点搜索、逆地址解析,默认false||
|success|Function|是|接口调用成功的回调函数,返回内容详见返回参数说明。||
|success|Function|是|接口调用成功的回调函数,返回内容详见返回参数说明。||
|fail|Function|否|接口调用失败的回调函数(获取定位失败、用户取消等情况下触发)||
|fail|Function|否|接口调用失败的回调函数(获取定位失败、用户取消等情况下触发)||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)||
|complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)||
**腾讯地图服务商说明**
出于安全考虑,安卓、iOS端manifest.json内配置的key仅用来展示地图,uni.chooseLocation所依赖的地点搜索、逆地址解析功能需要通过uniCloud云对象
[
uni-map-co
](
https://ext.dcloud.net.cn/plugin?id=13872
)
来调用,开发者可以通过安全网络来保障服务端api不被他人盗用。
鸿蒙平台由于暂不支持安全网络,所以chooseLocation依然使用manifest.json内配置的key来调用地点搜索、逆地址解析。
默认情况下,uni.chooseLocation不会使用安全网络请求uni-map-co。如果需要使用安全网络请求uni-map-co,需按如下步骤操作:
1.
项目关联uniCloud服务空间
2.
按照
[
uni-map-co
](
https://ext.dcloud.net.cn/plugin?id=13872
)
文档导入uni-map-common插件,并配置好地图的key。
3.
按照
[
安全网络
](
https://doc.dcloud.net.cn/uniCloud/secure-network.html
)
文档,将应用关联到服务空间。
4.
在项目manifest.json中
`安卓/iOS模块配置`
中勾选安全网络模块。
5.
修改uni-map-co入口文件
`index.obj.js`
内添加如下代码,拦截非法请求:
```
javascript
module
.
exports
=
{
_before
:
function
()
{
const
clientInfo
=
this
.
getClientInfo
()
const
methodName
=
this
.
getMethodName
()
const
secretType
=
clientInfo
.
secretType
if
(
methodName
===
'
chooseLocation
'
&&
secretType
!==
'
both
'
&&
secretType
!==
'
request
'
)
{
throw
new
Error
(
'
Unauthorized client
'
)
}
}
}
```
6.
上传uni-map-co云对象、uni-config-center公共模块、uni-map-common公共模块。
7.
调用uni.chooseLocation时,将useSecureNetwork设置为true。
**注意**
**注意**
-
因平台差异,如果SDK配置百度地图,需要设置 keyword,才能显示相关地点
-
因平台差异,如果SDK配置百度地图,需要设置 keyword,才能显示相关地点
-
[
非 weex 编译模式
](
/collocation/manifest.md#app-plus
)
不支持百度地图
-
[
非 weex 编译模式
](
/collocation/manifest.md#app-plus
)
不支持百度地图
...
...
docs/component/map.md
浏览文件 @
11d1adb2
...
@@ -69,9 +69,18 @@
...
@@ -69,9 +69,18 @@
-
谷歌地图使用
`wgs84`
坐标,其他地图使用
`gcj02`
坐标,用错坐标类型会显示偏移。
-
谷歌地图使用
`wgs84`
坐标,其他地图使用
`gcj02`
坐标,用错坐标类型会显示偏移。
-
App平台
`layer-style`
属性需要在地图服务商后台创建,值设置为高德后台申请的字符串,
[
详情
](
https://developer.amap.com/api/android-sdk/guide/create-map/custom
)
。
-
App平台
`layer-style`
属性需要在地图服务商后台创建,值设置为高德后台申请的字符串,
[
详情
](
https://developer.amap.com/api/android-sdk/guide/create-map/custom
)
。
-
H5 端高德地图 include-points 属性仅支持 2 个坐标点,表示显示范围的西南角和东北角。
-
H5 端高德地图 include-points 属性仅支持 2 个坐标点,表示显示范围的西南角和东北角。
-
App平台 腾讯地图使用web方案,在申请key时注意将页面域名白名单设置为空,如下图
!
[](
https://web-ext-storage.dcloud.net.cn/doc/uniapp/component/app-tencent-map-web-service-key.jpg
)
### 腾讯地图服务商说明
**申请及使用key**
App平台(包含iOS、安卓、鸿蒙)腾讯地图使用web方案,在申请key时注意将页面域名白名单设置为空,如下图
![](
https://web-ext-storage.dcloud.net.cn/doc/uniapp/component/app-tencent-map-web-service-key.jpg
)
出于安全考虑,安卓、iOS端manifest.json内配置的key仅用来展示地图,uni.chooseLocation所依赖的地点搜索、逆地址解析功能需要通过uniCloud云对象
[
uni-map-co
](
https://ext.dcloud.net.cn/plugin?id=13872
)
来调用,开发者可以通过安全网络来保障服务端api不被他人盗用,详情参考
[
uni.chooseLocation
](
../api/location/location.md#chooselocation
)
文档。开发者可以将manifest.json内配置的key的所有api额度设置为0,避免key泄露产生额外的资源消耗。
鸿蒙平台由于暂不支持安全网络,所以chooseLocation依然使用manifest.json内配置的key来调用地点搜索、逆地址解析。
### 高德地图审图号
### 高德地图审图号
...
@@ -79,6 +88,9 @@
...
@@ -79,6 +88,9 @@
-
卫星地图:GS (2023)4047号
-
卫星地图:GS (2023)4047号
-
地形图:GS(2021)6352号
-
地形图:GS(2021)6352号
### 腾讯地图审图号
-
普通地图:GS粤(2023)1171号
### 近期新增功能
### 近期新增功能
1.
支持点聚合,适用于marker过多场景。
1.
支持点聚合,适用于marker过多场景。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录