更新记录

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

原生插件通用使用流程：

  1. 购买插件，选择该插件绑定的项目。
  2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
  4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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>

隐私、权限声明

1. 本插件需要申请的系统权限列表：

定位权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件使用的高德导航SDK会采集数据，详情可参考：https://developer.amap.com/product/navigation#/

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

作者未提供license.md
评论列表 撰写评论
加载更多...
插件问答 我要提问

使用中有什么不明白的地方，就向插件作者提问吧~ 我要提问

加载更多...