更新记录
1.0.10(2022-11-17) 下载此版本
修复地图不显示的问题
1.0.9(2022-11-16) 下载此版本
处理集成插件后,iOS地图不显示的问题
1.0.8(2022-11-14) 下载此版本
优化iOS高德SDK初始化流程
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.1 - 12.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:12 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
Uni-App原生插件集成文档
简介
集成此原生插件以获得高德导航能力
高德地图导航插件,可以根据传入的出发地址和目的地址查看路线方案;或者直接导航到目的地。 注意:使用此插件需要在HBuilderX的manifest.json中取消勾选高德地图、高德定位
初始化插件
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
地理编码:获取地址详细信息
amapnavi.geocode({"address":"江苏省南京市建邺区信安大厦"}, (ret)=> {
uni.showToast({
title:'结果:' + JSON.stringify(ret),
icon: "none"
})
});
传入参数:
address: 需要转换的地址
回调参数:
{
"message": "", // 错误描述
"data": {
"district": "建邺区", // 区域名称
"city": "南京市", // 城市名
"longitude": 118.732041, // 经度(水平方向)
"formattedAddress": "江苏省南京市建邺区信安大厦", // 格式化地址
"adcode": "320105", // 区域编码
"township": "", // 乡镇街道
"latitude": 31.983861000000001, // 纬度(垂直方向)
"neighborhood": "", // 社区
"building": "", // 楼
"province": "江苏省" // 所在省/直辖市
},
"code": "0" // 结果编码,0表示成功,非0表示调用出错
}
示例:
<template>
<view class="content">
<view class="btn-row">
<button v-if="!hasLogin" type="primary" class="primary" @tap="bindLogin">获取地址详细信息</button>
</view>
</view>
</template>
<script>
import {
mapState,
mapMutations
} from 'vuex'
export default {
computed: {
...mapState(['hasLogin', 'forcedLogin'])
},
methods: {
...mapMutations(['logout']),
bindLogin() {
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
amapnavi.geocode({"address":"江苏省南京市******"}, (ret)=> {
uni.showToast({
title:'结果:' + JSON.stringify(ret),
icon: "none"
}
)
});
}
}
}
</script>
<style>
</style>
计算两点直线距离:
amapnavi.metersBetweenPoints({
"point1":{
"latitude":"43.798544",
"longitude":"87.620998"
},
"point2":{
"latitude":"43.798544",
"longitude":"87.920998"
}
}, (ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
传入参数:
{
"point1": { // 第一个经纬度坐标
"latitude": "43.798544",
"longitude": "87.620998"
},
"point2": { // 第二个经纬度坐标
"latitude": "43.798544",
"longitude": "87.920998"
}
}
回调参数:
{
"message": "", // 错误描述
"distance": 24104.626164252037, // 距离,单位米
"code": "0" // 结果编码,0表示成功,非0表示调用出错
}
示例:
<template>
<view class="content">
<view class="btn-row">
<button v-if="!hasLogin" type="primary" class="primary" @tap="bindLogin">计算两点间距离</button>
</view>
</view>
</template>
<script>
import {
mapState,
mapMutations
} from 'vuex'
export default {
computed: {
...mapState(['hasLogin', 'forcedLogin'])
},
methods: {
...mapMutations(['logout']),
bindLogin() {
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
amapnavi.metersBetweenPoints({
"point1":{
"latitude":"43.798544",
"longitude":"87.620998"
},
"point2":{
"latitude":"43.798544",
"longitude":"87.920998"
}
}, (ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
}
}
}
</script>
<style>
</style>
导航:
amapnavi.startNavigation({
'directly': true,
'startLongitude':'87.620998',
'startLatitude':'43.798544',
'startLocationText':"前进路与健康路交叉口东80米纺织行办家属院",
'endLongitude':'123.805922',
'endLatitude':'48.852599',
'endLocationText':"杜拉尔鄂温克民族乡杜拉尔中心学校"
}, (ret) => {
uni.showToast({
title:'导航成功' + JSON.stringify(ret),
icon: "none"
})
})
传入参数:
directly: true表示默认直接开始导航;false表示默认打开路线选择
startLongitude: 出发地经度
startLatitude: 出发地纬度
startLocationText: 出发地地址
endLongitude: 目的地经度
endLatitude: 目的地纬度
endLocationText: 目的地地址
注意:传入的startLongitude、startLatitude任一为空,默认出发地为当前位置,并且出发地地址会显示未我的位置;startLongitude、startLatitude有值,startLocationText为空,出发地地址会显示起点
回调参数:
type:有五种值start开始导航、navigating导航过程中位置更新、arrived到达目的地、pop组件页面回退、dismiss退出导航组件
code:结果编码,0表示成功,非0表示调用出错
message:错误描述
data:位置数据(只有type为navigating才有)
data格式:
latitude:纬度
longitude:经度
altitude:高度
heading:方向
speed:速度(km/h)
isMatchNaviPath:是否匹配在道路上
注意:不管传入的directly为true、false,退出导航组件的过程中,都会有type为pop、dismiss的回调
示例:
<template>
<view class="content">
<view class="btn-row">
<button v-if="!hasLogin" type="primary" class="primary" @tap="bindLogin">测试步行导航</button>
</view>
</view>
</template>
<script>
import {
mapState,
mapMutations
} from 'vuex'
export default {
computed: {
...mapState(['hasLogin', 'forcedLogin'])
},
methods: {
...mapMutations(['logout']),
bindLogin() {
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
amapnavi.startNavigation({
'directly': true,
'startLongitude':'87.620998',
'startLatitude':'43.798544',
'startLocationText':"前进路与健康路交叉口东80米纺织行办家属院",
'endLongitude':'123.805922',
'endLatitude':'48.852599',
'endLocationText':"杜拉尔鄂温克民族乡杜拉尔中心学校"
}, (ret) => {
uni.showToast({
title:'导航成功' + JSON.stringify(ret),
icon: "none"
})
})
}
}
}
</script>
<style>
</style>
开始持续定位:
amapnavi.startUpdatingLocation((ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
传入参数:
无
回调参数:
{
"message": "", // 错误描述
"data": {
"speed": "1.000000", // 速度,单位:米/秒
"rtm": "1667549221", // GPS时间戳,从1970开始
"longitude": "118.732501", // 经度
"province": "江苏省", // 省名称
"latitude": "31.984040", // 纬度
"street": "白龙江东街", // 街道名称
"address": "江苏省南京市建邺区白龙江东街靠近信安万成", // 地址描述
"city": "南京市", // 城市名称
"course": "-1.000000", // 获取方向角信息,相对于正北
"district": "建邺区", // 城区名称
"accuracy": "65", // 水平方向精确度,单位:米
"altitude": "18", // 海拔高度
"country": "中国" // 国家名称
},
"code": "0" // code:0,非零为对应错误码
}
示例:
<template>
<view class="content">
<view class="btn-row">
<button v-if="!hasLogin" type="primary" class="primary" @tap="bindLogin">测试步行导航</button>
</view>
</view>
</template>
<script>
import {
mapState,
mapMutations
} from 'vuex'
export default {
computed: {
...mapState(['hasLogin', 'forcedLogin'])
},
methods: {
...mapMutations(['logout']),
bindLogin() {
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
amapnavi.startUpdatingLocation((ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
}
}
}
</script>
<style>
</style>
停止定位:
amapnavi.stopUpdatingLocation((ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
传入参数:
无
回调参数:
{
"message": "", // 错误描述
"code": "0" // code:0,非零为对应错误码
}
示例:
<template>
<view class="content">
<view class="btn-row">
<button v-if="!hasLogin" type="primary" class="primary" @tap="bindLogin">测试步行导航</button>
</view>
</view>
</template>
<script>
import {
mapState,
mapMutations
} from 'vuex'
export default {
computed: {
...mapState(['hasLogin', 'forcedLogin'])
},
methods: {
...mapMutations(['logout']),
bindLogin() {
var amapnavi = uni.requireNativePlugin('cgg-amap-navi-navigator');
amapnavi.stopUpdatingLocation((ret) => {
uni.showToast({
title:'结果: ' + JSON.stringify(ret),
icon: "none"
})
})
}
}
}
</script>
<style>
</style>