简体中文
简体中文
# uni.openLocation(options)
注意
Android 和 iOS 需 HBuilderX 4.41+
Harmony 需 HBuilderX 4.61+
App端的 openlocation 是一个独立的UTS插件，以满足自定义需求，请前往插件市场导入插件 uni-openlocation 插件地址
在使用 uni-openlocation 插件后，无论是在Web端还是App端，通过 uni.openlocation 打开的页面会以 dialogPage 的形式呈现。此时，当你执行 getDialogPages 方法时，会发现由 openlocation 打开的页面也包含在返回的页面数组中，这属于正常现象
HarmonyOS平台调用此 API 需要申请定位权限ohos.permission.APPROXIMATELY_LOCATION、ohos.permission.LOCATION，需自行在项目中配置权限。
使用地图查看位置
# openLocation 兼容性
| Web | 微信小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|
| 4.0 | 4.41 | 4.41 | 4.41 | 4.61 |
# 参数
| 名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| options | OpenLocationOptions | 是 | - | - | uni.openLocation | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
# OpenLocationSuccess 的属性值
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|---|---|---|---|---|
| errMsg | string | 否 | - | 错误信息 |
# OpenLocationFail 的属性值
| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
|---|---|---|---|---|---|
| errCode | number | 是 | - | - | |
| errMsg | string | 否 | - | 错误信息 | |
| errSubject | string | 是 | - | - | 统一错误主题（模块）名称 |
| data | any | 否 | - | - | 错误信息中包含的数据 |
| cause | Error | 否 | - | - | 源错误信息，可以包含多个错误，详见SourceError |
# 示例
示例为hello uni-app x alpha分支，与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例另见
示例
<template>
<view>
<page-head :title="title"></page-head>
<view class="uni-common-mt">
<form @submit="openLocation">
<view class="uni-list">
<view class="uni-list-cell">
<view class="uni-list-cell-left">
<view class="uni-label">经度</view>
</view>
<view class="uni-list-cell-db">
<input v-model.number="longitude" class="uni-input" type="text" :disabled="true" />
</view>
</view>
<view class="uni-list-cell">
<view class="uni-list-cell-left">
<view class="uni-label">纬度</view>
</view>
<view class="uni-list-cell-db">
<input v-model.number="latitude" class="uni-input" type="text" :disabled="true" />
</view>
</view>
<view class="uni-list-cell">
<view class="uni-list-cell-left">
<view class="uni-label">位置名称</view>
</view>
<view class="uni-list-cell-db">
<input v-model="name" class="uni-input" type="text" :disabled="true" />
</view>
</view>
<view class="uni-list-cell">
<view class="uni-list-cell-left">
<view class="uni-label">详细位置</view>
</view>
<view class="uni-list-cell-db">
<input v-model="address" class="uni-input" type="text" :disabled="true" />
</view>
</view>
</view>
<view class="uni-padding-wrap">
<view class="tips">注意：需要正确配置地图服务商的Key才能正常显示位置</view>
<view class="uni-btn-v uni-common-mt">
<button type="primary" formType="submit">查看位置</button>
</view>
</view>
</form>
</view>
</view>
</template>
<script lang="uts">
import {
state,
setLifeCycleNum
} from '@/store/index.uts'
export default {
data() {
return {
title: 'openLocation',
longitude: 116.39747,
latitude: 39.9085,
name: '天安门',
address: '北京市东城区东长安街',
// 自动化测试
dialogPagesNum: -1,
}
},
onShow() {
console.log("Page Show");
// 自动化测试
setLifeCycleNum(state.lifeCycleNum + 1)
},
onHide() {
console.log("Page Hide");
// 自动化测试
setLifeCycleNum(state.lifeCycleNum - 1)
},
methods: {
openLocation: function () {
uni.openLocation({
longitude: this.longitude,
latitude: this.latitude,
name: this.name,
address: this.address
})
// 自动化测试
setTimeout(() => {
this.test()
}, 500)
},
// 自动化测试
test() {
const pages = getCurrentPages()
const page = pages[pages.length - 1]
// #ifdef APP || WEB
const dialogPages = page.getDialogPages()
this.dialogPagesNum = dialogPages.length
// #endif
},
// 自动化测试
setLifeCycleNum(value : number) {
setLifeCycleNum(value)
},
// 自动化测试
getLifeCycleNum() : number {
return state.lifeCycleNum
},
}
}
</script>
<style>
.uni-list-cell-left {
padding: 0 15px;
}
.tips {
font-size: 12px;
margin-top: 15px;
opacity: .8;
}
</style>
