uni.openLocation(OBJECT)

# uni.openLocation(OBJECT)

使用应用内置地图查看位置。openLocation会使用项目配置的地图服务商来展示地图，地图服务商支持情况参考：map组件。

Platform difference description

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

# openLocation 兼容性

HarmonyOS
HBuilderX 4.25

地图服务商说明

点击查看地图服务商兼容性

OBJECT parameter description

Parameter name	Type	Required	Instruction	Platform difference description
latitude	Float	Yes	Latitude, from -90 to 90. Negative number indicates south latitude, using gcj02 coordinate of State Bureau of Surveying and Mapping of China
longitude	Float	是	经度，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系
scale	Int	否	缩放比例，范围5~18，默认为18	微信小程序、支付宝小程序
name	String	No	Location Name	Alipay Required
address	String	No	Detailed description of the address	Alipay required
success	Function	No	Callback function for successful interface calling
fail	Function	No	Callback function for failed interface calling
complete	Function	No	Callback function for closed interface calling (available both for successful and failed calling)

Example

uni.getLocation({
	success: function (res) {
		const latitude = res.latitude;
		const longitude = res.longitude;
		uni.openLocation({
			latitude: latitude,
			longitude: longitude,
			success: function () {
				console.log('success');
			}
		});
	}
});

Tips

This API is a non-atomic packaging interface. Developers can make their own pages to achieve similar functions for customization.
In case of inaccurate localization, refer to Matters needing attention in the uni.getLocation document
<map> component is defaulted to the coordinates of the State Bureau of Surveying and Mapping of China. When calling uni.getLocation return result and passing it to the <map> component, the type must be specified as 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"
                ]
            }
        }
    }
}