uni-app（位置1）

程楠楠&M2025-02-22 15:33

文章目录

一、获取当前的地理位置、速度 uni.getLocation(OBJECT)

  • App平台 manifest中配置好自己的地图厂商key，在地图厂商的后台，填写正确包名和证书摘要。地图厂商的sdk会在运行时校验key、包名、证书的一致性
  • Web平台 manifest中配置好自己的地图厂商key，使用web接口如涉及白名单，需确保自己的域名在地图厂商那里正确配置了域名白名单
  • 确保在地图厂商那里配额足够
  • 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
  • 如果运行在微信浏览器中，可以使用微信的jssdk的定位能力。这个是微信向腾讯地图申请的key，开发者无需配置自己的key。

  1. OBJECT 参数说明

    参数名 类型 必填 说明 平台差异说明
    type String 否 默认为 wgs84 返回 gps 坐标，gcj02 返回国测局坐标，可用于 uni.openLocation 和 map 组件坐标，App 和 H5 需配置定位 SDK 信息才可支持 gcj02。
    altitude Boolean 否 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度 抖音小程序、飞书小程序、支付宝小程序不支持
    geocode Boolean 否 默认false，是否解析地址信息 仅App平台支持（安卓需指定 type 为 gcj02 并配置三方定位SDK）
    highAccuracyExpireTime Number 否 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果 App (3.2.11+)、H5 (3.2.11+)、微信小程序 (基础库 2.9.0+)
    timeout String 否 默认为 5，定位超时时间，单位秒 仅飞书小程序支持
    cacheTimeout Number 否 定位缓存超时时间，单位秒；每次定位缓存当前定位数据，并记下时间戳，当下次调用在cacheTimeout之内时，返回缓存数据 仅飞书小程序、支付宝小程序支持
    accuracy String 否 默默认为 high，指定期望精度，支持 high，best。当指定 high 时，期望精度值为100m，当指定 best 时期望精度值为20m。当定位得到的精度不符合条件时，在timeout之前会继续定位，尝试拿到符合要求的定位结果 仅飞书小程序支持
    isHighAccuracy Boolean 否 开启高精度定位 App (3.4.0+)、H5 (3.4.0+)、微信小程序 (基础库 2.9.0+)
    success Function 是 接口调用成功的回调函数，返回内容详见返回参数说明。
    fail Function 否 接口调用失败的回调函数
    complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）

  2. success 返回参数说明

    参数 说明
    latitude 纬度，浮点数，范围为-90~90，负数表示南纬
    longitude 经度，浮点数，范围为-180~180，负数表示西经
    speed 速度，浮点数，单位m/s
    accuracy 位置的精确度
    altitude 高度，单位 m
    verticalAccuracy 垂直精度，单位 m（Android 无法获取，返回 0）
    horizontalAccuracy 水平精度，单位 m
    address 地址信息（仅App端支持，需配置geocode为true）
    javascript 复制代码 
    <template>
	<view style="padding: 20px;">
		<button @click="getLocation">获取地理位置</button>
	</view>
</template>

<script>
export default {
	data() {
		return {
		};
	},
	onLoad() {
	  
	},
	methods: {
		getLocation() {
			uni.getLocation({
				type: 'wgs84',
				success: function (res) {
					console.log(res)
					console.log('当前位置的经度：' + res.longitude);
					console.log('当前位置的纬度：' + res.latitude);
				}
			})
		}
	},
};	
</script>


    需要配置权限，若没有配置会有弹窗提示

    若没有配置会有弹窗提示

    配置完，需要点击允许

二、打开地图选择位置 uni.chooseLocation(OBJECT)

  • 如果是cli或离线打包，需要配套升级cli和离线sdk
  • manifest中配置好自己的地图厂商key。web和app都需要。一般标准基座正常，自定义基座和打包后异常，都是这个原因
  • 确保在地图厂商那里配额足够
  • 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
  • web平台确保自己的域名在地图厂商那里正确配置了域名白名单
    可使用差异：App，H5，微信小程序，支付宝小程序，百度小程序，抖音小程序、飞书小程序，QQ小程序

  1. OBJECT 参数说明

    参数名 类型 必填 说明 平台差异说明
    latitude Number 否 目标地纬度 微信小程序（2.9.0+）、H5-Vue3（3.2.10+）
    longitude Number 否 目标地经度 微信小程序（2.9.0+）、H5-Vue3（3.2.10+）
    keyword String 否 搜索关键字，仅App平台支持
    useSecureNetwork Boolean 否 是否通过安全网络调用地点搜索、逆地址解析，默认false
    success Function 是 接口调用成功的回调函数，返回内容详见返回参数说明。
    fail Function 否 接口调用失败的回调函数（获取定位失败、用户取消等情况下触发）
    complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）

  2. success 返回参数说明

    参数 说明
    name 位置名称
    address 详细地址
    latitude 纬度，浮点数，范围为-90~90，负数表示南纬，使用 gcj02 国测局坐标系。
    longitude 经度，浮点数，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系。
    javascript 复制代码 
    <template>
	<view style="padding: 20px;">
		<button @click="getLocation">获取地理位置</button>
	</view>
</template>

<script>
export default {
	data() {
		return {
		};
	},
	onLoad() {},
	methods: {
		getLocation() {
			uni.chooseLocation({
				success: function (res) {
					console.log(res)
					console.log('位置名称：' + res.name);
					console.log('详细地址：' + res.address);
					console.log('纬度：' + res.latitude);
					console.log('经度：' + res.longitude);
				}
			});
		}
	},
};	
</script>


    点击确认后打印的位置

    注意：

    • 不同端，使用地图选择时基于的底层地图引擎不一样，详见地图map组件的地图服务商支持。
      • app 中也可以使用百度定位，在 manifest 中配置，打包后生效。
      • app-nvue 里只能用高德定位和Google地图(3.4+)，不能用百度地图。另外选择地图、查看地图位置的API也仅支持高德地图和Google地图(3.4+)。所以App端如无特殊必要，建议使用高德地图。
    • H5 端 使用地图和定位相关，需要在 manifest.json 内配置腾讯或谷歌等三方地图服务商申请的秘钥（key）。
    • 微信内置浏览器 中可使用微信js sdk，详见
    • chooseLocation 属于封装型API，开发者若觉得不够灵活，可自行基于原始的 map 组件进行封装。插件市场已经有各种封装样例了。
    • 若 Android App端 位置不准，见上文 uni.getLocation 的注意事项
    • 微信小程序在2023年10月17日之后，使用API需要配置隐私协议

三、使用应用内置地图查看位置。uni.openLocation(OBJECT)

可使用差异：App，H5，微信小程序，支付宝小程序， 百度小程序 ，抖音小程序、飞书小程序，元服务 小红书小程序

  1. OBJECT 参数说明
参数名 类型 必填 说明 平台差异说明
latitude Float 是 纬度，范围为-90~90，负数表示南纬，使用 gcj02 国测局坐标系
longitude Float 是 经度，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系
scale Int 否 缩放比例，范围5~18，默认为18 微信小程序
name String 否 位置名 支付宝必填
address String 否 地址的详细说明 支付宝必填
success Function 是 接口调用成功的回调函数
fail Function 否 接口调用失败的回调函数
complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）
javascript 复制代码 
<template>
	<view style="padding: 20px;">
		<button @click="getLocation">获取地理位置</button>
	</view>
</template>

<script>
export default {
	data() {
		return {};
	},
	onLoad() {},
	methods: {
		getLocation() {
			uni.getLocation({
				type: 'gcj02', //返回可以用于uni.openLocation的经纬度
				success: function (res) {
					console.log(res)
					const latitude = res.latitude;
					const longitude = res.longitude;
					uni.openLocation({
						latitude: latitude,
						longitude: longitude,
						success: function (succ) {
							console.log(succ, 'success');
						}
					});
				}
			});
		}
	},
};	
</script>


相关推荐
祈澈菇凉33 分钟前
Webpack的基本功能有哪些
前端·javascript·vue.js
小纯洁w40 分钟前
Webpack 的 require.context 和 Vite 的 import.meta.glob 的详细介绍和使用
前端·webpack·node.js
想睡好1 小时前
css文本属性
前端·css
qianmoQ1 小时前
第三章：组件开发实战 - 第五节 - Tailwind CSS 响应式导航栏实现
前端·css
记得早睡~1 小时前
leetcode150-逆波兰表达式求值
javascript·算法·leetcode
zhoupenghui1682 小时前
golang时间相关函数总结
服务器·前端·golang·time
White graces2 小时前
正则表达式效验邮箱格式, 手机号格式, 密码长度
前端·spring boot·spring·正则表达式·java-ee·maven·intellij-idea
庸俗今天不摸鱼2 小时前
Canvas进阶-4、边界检测（流光，鼠标拖尾）
开发语言·前端·javascript·计算机外设
熬夜不洗澡2 小时前
Node.js中不支持require和import两种导入模块的混用
node.js
bubusa~>_<2 小时前
解决npm install 出现error,比如:ERR_SSL_CIPHER_OPERATION_FAILED
前端·npm·node.js
热门推荐
01太炸裂了！清华大学deepseek从入门到精通使用手册又出第三版了，《普通人如何抓住DeepSeek红利》（无套路，直接下载）02如何在WPS和Word/Excel中直接使用DeepSeek功能03DeepSeek本地部署详细指南04DeepSeek各版本说明与优缺点分析05本地部署DeepSeek教程（Mac版本）06DeepSeek r1本地安装全指南07本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程08DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具09在Windows下安装Ollama并体验DeepSeek r1大模型10本地部署DeepSeek后的调用与删除全攻略