my.openlocation(object object)
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
使用支付宝内置地图显示指定经纬度位置。
内置地图为高德地图，地图相关接口使用的经纬度坐标格式为 gcj-02（俗称“火星坐标系”）。暂无境外地图数据，在中国内地以外地区（含港澳台）可能无法正常调用此 api。
效果示例
my.openlocation 效果示例图
默认标题0
类目审核
自 2023 年 11 月 15 日 起，位置类接口仅对符合要求的小程序主营行业开放，在使用前请查看 端权限接口使用类目说明，否则小程序上线审核将会被驳回。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| longitude | number | - | 是 | 经度，范围为 -180~180，负数表示西经 |
| latitude | number | - | 是 | 纬度，范围为 -90~90，负数表示南纬 |
| name | string | - | 是 | 位置名称 |
| address | string | - | 是 | 地址的详细说明 |
| scale | number | 15 | 否 | 地图缩放比例，范围 3~19 |
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 2 | 缺少必要参数(经纬度，位置名称和位置描述)。 |
经度、纬度、位置名称、位置描述为必选，请检查。 |
代码示例
扫码体验
my.openlocation(object object)
fail 参数
my.openlocation({
longitude: 120.126293,
latitude: 30.274653,
name: '黄龙万科中心',
address: '学院路77号',
success: res => {
console.log(res);
},
fail: res => {
console.log(res);
},
});
{
"error": 2,
"errormessage": "缺少必要参数(经纬度，位置名称和位置描述)"
}
q：是否有 api 可以直接唤起高德地图客户端做导航？
a：
my.openlocation 暂不支持直接唤起高德做导航，如果想要直接唤起高德，可通过订购，调用插件的 navigatetoamapnavi 方法实现。
q：能否在小程序内直接实现导航？
a：
小程序不提供实时导航能力。如需要计算路径，可使用 my.calculateroute。