uni.openLocation(OBJECT)

# uni.openLocation(OBJECT)

使用应用内置地图查看位置。

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	QQ小程序	快手小程序	京东小程序
√	√	√	√	√	√	x	x	x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.25

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	否	接口调用结束的回调函数（调用成功、失败都会执行）

示例

uni.getLocation({
	type: 'gcj02', //返回可以用于uni.openLocation的经纬度
	success: function (res) {
		const latitude = res.latitude;
		const longitude = res.longitude;
		uni.openLocation({
			latitude: latitude,
			longitude: longitude,
			success: function () {
				console.log('success');
			}
		});
	}
});

Tips

本API是一个非原子的封装界面，开发者如有定制需求，可自己做页面实现类似功能。
若定位不准，参考uni.getLocation文档的注意事项
<map> 组件默认为国测局坐标，调用 uni.getLocation 返回结果传递给 <map> 组件时，需指定 type 为 gcj02。
App 端使用地图组件需要向高德等三方服务商申请SDK资质，获取AppKey，打包时需要在manifest的SDK配置中填写Appkey。在manifest可视化界面有详细申请指南，详见：https://ask.dcloud.net.cn/article/29。
H5 端使用地图和定位相关，需要在 manifest.json 内配置腾讯或谷歌等三方地图服务商申请的秘钥（key）。
iOS端如需使用第三方地图进行导航，需要在 manifest.json 文件内增加 urlschemewhitelist 节点，在线打包即可
不同平台打开的地图不一样，App端是高德地图（不支持百度地图）、H5端是腾讯地图或谷歌地图、微信小程序端是腾讯地图、百度小程序是百度地图、阿里小程序是高德地图、抖音小程序是高德地图。

{
    "app-plus": {
        "distribute": {
            "ios": {
                "urlschemewhitelist": [
                    "baidumap",
                    "iosamap",
                    "qqmap"
                ]
            }
        }
    }
}