1. 为什么你的App需要多地图导航集成做Android开发的朋友们尤其是做过出行、外卖、社交这类带位置服务的应用肯定都遇到过这个需求用户点击一个地址咱们得能一键唤起导航。这事儿听起来简单不就是调个第三方地图App嘛。但真上手了坑就来了。最直接的问题就是用户手机里装的是高德地图还是百度地图总不能只支持一个然后对另一半用户说“对不起请先安装XX地图”吧那体验就太差了。我刚开始做这个功能的时候也是想得太简单直接写死了跳转高德地图的Intent。结果上线后客服那边反馈就来了不少用户点了导航没反应或者直接跳应用市场去了。一排查发现很多用户习惯用百度地图手机里根本没装高德。这就尴尬了一个基础功能反而成了槽点。所以一个健壮的、用户友好的导航功能核心就是“无缝切换”优先使用用户已安装的地图App如果都没装再给个友好的引导。这不仅仅是写几行跳转代码那么简单。它背后涉及到几个关键技术点如何准确判断应用是否安装这里还要考虑Android不同版本的存储权限和分区变化、如何构造不同地图App能识别的导航URI、以及最让人头疼的坐标系转换问题。高德和百度用的不是一套坐标系如果你直接把高德获取的坐标扔给百度地图导航目的地可能会偏差几百米那可就闹笑话了。把这些点都处理好封装成一个可靠的工具你的应用在导航这个体验上才算真正过关了。接下来我就结合自己踩过的坑带你一步步实现这个“无缝切换”的完整方案。2. 第一步准确判断地图应用是否已安装判断应用是否安装是咱们整个流程的“守门员”。这一步如果错了后面的跳转全是白搭。网上有很多方法但有些在Android新版本上已经失效了咱们得用一个稳妥的。2.1 避开PackageManager的潜在问题最常见的方法是使用PackageManager.getInstalledPackages来获取所有已安装应用的包名列表然后判断目标包名是否在列表里。这个方法看起来直接但在实际使用中特别是当应用列表很长时会有性能开销。而且它需要声明QUERY_ALL_PACKAGES权限在Android 11及以上或者需要在AndroidManifest.xml的queries标签里声明你要查询的包名否则可能查不到。我更喜欢用另一种更“主动”且高效的方法尝试获取目标应用的PackageInfo。如果能成功获取到说明应用已安装如果抛出NameNotFoundException异常说明没安装。这种方法更直接也避免了遍历整个应用列表。/** * 判断指定包名的应用是否已安装 * param context 上下文 * param packageName 目标应用包名例如高德地图com.autonavi.minimap * return true 已安装false 未安装 */ fun isAppInstalled(context: Context, packageName: String): Boolean { return try { // 尝试获取应用信息如果没安装会抛出异常 context.packageManager.getPackageInfo(packageName, 0) true } catch (e: PackageManager.NameNotFoundException) { false } }在Android 11API 30及以上版本为了能成功查询到其他应用的信息你必须在AndroidManifest.xml文件中添加queries声明。这是很多人做完功能发现不生效最容易忽略的一点。manifest ... queries !-- 声明要查询的高德地图包名 -- package android:namecom.autonavi.minimap / !-- 声明要查询的百度地图包名 -- package android:namecom.baidu.BaiduMap / !-- 如果需要跳转应用市场也需要声明 -- package android:namecom.android.vending / /queries ... /manifest2.2 处理Android 11的存储分区变更你可能还见过一种通过检查/data/data/或/storage/emulated/0/Android/data/目录下是否存在应用文件夹来判断的方法就像原始文章里那样。这种方法在Android 11之前的部分设备上可能有效因为它利用了Android应用沙箱的目录结构。但我强烈不推荐这种方法原因很简单从Android 11开始系统强制实施了存储分区Scoped Storage。应用无法再通过文件路径直接访问其他应用的数据目录。也就是说new File(/data/data/com.autonavi.minimap).exists()这种写法在Android 11及以上的设备上几乎一定会返回false即使高德地图已经安装了。依赖这种方法会导致判断完全失灵。所以请务必使用上面提到的通过PackageManager查询的方式这是官方推荐且版本兼容性最好的做法。3. 第二步掌握地图导航的Intent跳转核心判断完应用是否存在接下来就是重头戏跳转。这里的关键在于构造正确的URI统一资源标识符。你可以把URI理解成一个“导航协议”高德和百度各自定义了一套协议格式我们的Intent就是拿着这个“协议地址”去告诉系统“请用高德地图App打开这个导航请求”。3.1 高德地图导航URI详解高德地图的导航URI格式相对固定参数也比较直观。最常用的是androidamap://route/plan?这个路径。我们来拆解一个完整的例子androidamap://route/plan?sourceApplication我的Appslat39.90469slon116.40717sname我的位置dlat31.23967dlon121.49981dname上海外滩dev0t0sourceApplication你的应用名称随便起个名就行高德地图会显示这个来源。slatslon起点经纬度。这里有个重要技巧如果你不传起点坐标或者传0高德地图会自动使用手机的当前位置作为起点。这对于大多数“从当前位置导航到目的地”的场景非常方便你不需要自己再去获取一次定位。sname起点名称可选。dlatdlon终点经纬度必须提供。dname终点名称必须提供用户在地图App里会看到这个名称。dev是否偏移0为lat和lon是已经加密后的1不需要加密。我们通常传0。t导航类型。0驾车1公交2步行3骑行。根据你的场景选择。在代码中我们这样构造Intentfun startAmapNavigation(context: Context, dlat: Double, dlon: Double, dname: String) { val uriStr StringBuilder(androidamap://route/plan?) .append(sourceApplication我的App) // 不传起点让高德自动使用当前位置 .append(dlat$dlat) .append(dlon$dlon) .append(dname${Uri.encode(dname)}) // 对中文进行编码 .append(dev0) .append(t0) // 驾车 .toString() val intent Intent(Intent.ACTION_VIEW, Uri.parse(uriStr)) // 明确指定包名避免选择器弹窗如果用户只装了高德 intent.setPackage(com.autonavi.minimap) try { context.startActivity(intent) } catch (e: ActivityNotFoundException) { // 理论上不会走到这里因为前面判断过安装。但为保险起见可以提示用户 Toast.makeText(context, 跳转高德地图失败, Toast.LENGTH_SHORT).show() } }3.2 百度地图导航URI详解百度地图的URI格式和高德有所不同参数组织方式也不一样。它的基础路径是baidumap://map/direction?。一个典型的驾车导航URI如下baidumap://map/direction?originlatlng:39.90469,116.40717|name:我的位置destinationlatlng:31.23967,121.49981|name:上海外滩modedrivingcoord_typegcj02origin起点。格式为latlng:纬度,经度|name:名称。注意如果你不设置origin参数百度地图默认也会尝试使用手机当前位置但行为可能不如高德地图那么一致。为了可靠建议获取到定位后传进去或者明确告知用户。destination终点。格式同起点。mode导航模式。driving驾车、transit公交、walking步行、riding骑行。coord_type这个参数极其重要它指定了你传入的坐标是什么坐标系。gcj02表示国测局加密坐标即火星坐标高德、腾讯也用这个bd09ll表示百度经纬度坐标wgs84表示GPS原始坐标。如果你从高德SDK或定位拿到的是火星坐标这里必须传gcj02。我们稍后在坐标转换章节会详细讲。百度地图的跳转代码示例fun startBaiduNavigation(context: Context, dlat: Double, dlon: Double, dname: String) { // 假设起点使用当前位置这里slat, slon需要你通过定位SDK获取 val slat getCurrentLat() // 你的定位纬度 val slon getCurrentLng() // 你的定位经度 val uriStr StringBuilder(baidumap://map/direction?) .append(originlatlng:$slat,$slon|name:我的位置) .append(destinationlatlng:$dlat,$dlon|name:${Uri.encode(dname)}) .append(modedriving) .append(coord_typegcj02) // 关键参数 .toString() val intent Intent(Intent.ACTION_VIEW, Uri.parse(uriStr)) intent.setPackage(com.baidu.BaiduMap) try { context.startActivity(intent) } catch (e: ActivityNotFoundException) { Toast.makeText(context, 跳转百度地图失败, Toast.LENGTH_SHORT).show() } }4. 第三步搞定坐标系转换这个“大坑”这是多地图集成中最容易出错也最致命的一个环节。简单来说地球上的同一个点在高德地图、百度地图、手机GPS眼里经纬度数值可能是不一样的。如果不做转换直接混用就会导致“图钉飘移”导航去错地方。4.1 三大坐标系是什么WGS-84 (GPS标准坐标系)这是最原始、全球通用的坐标系。你的手机GPS硬件直接吐出来的数据就是这个。谷歌地球、谷歌地图国外版也用这个。GCJ-02 (火星坐标系)这是中国国家测绘局制定的地理信息系统加密算法会在WGS-84坐标基础上加入随机的偏移。高德地图、腾讯地图、以及国内大部分地图服务包括苹果地图中国区都使用这个坐标系。所以从高德SDK获取的定位坐标就是GCJ-02坐标。BD-09 (百度坐标系)这是百度在GCJ-02的基础上又加了一层自己的加密算法后得到的坐标系。百度地图独家使用。它们的关系可以理解为WGS-84- (加密) -GCJ-02- (再加密) -BD-09。所以当你从高德GCJ-02跳转到百度地图时必须把坐标从GCJ-02转换成BD-09。4.2 手把手实现坐标转换算法网上有很多现成的转换算法但质量参差不齐。我经过多次实测下面这个工具类里的转换方法非常准确你可以直接拿去用。object CoordinateConverter { private const val PI 3.1415926535897932384626 private const val A 6378245.0 // 长半轴 private const val EE 0.00669342162296594323 // 扁率 /** * GCJ-02 转 BD-09 * 高德/腾讯 转 百度 */ fun gcj02ToBd09(lat: Double, lon: Double): DoubleArray { val z sqrt(lon * lon lat * lat) 0.00002 * sin(lat * PI * 3000.0 / 180.0) val theta atan2(lat, lon) 0.000003 * cos(lon * PI * 3000.0 / 180.0) val bdLon z * cos(theta) 0.0065 val bdLat z * sin(theta) 0.006 return doubleArrayOf(bdLat, bdLon) } /** * BD-09 转 GCJ-02 * 百度 转 高德/腾讯 */ fun bd09ToGcj02(lat: Double, lon: Double): DoubleArray { val x lon - 0.0065 val y lat - 0.006 val z sqrt(x * x y * y) - 0.00002 * sin(y * PI * 3000.0 / 180.0) val theta atan2(y, x) - 0.000003 * cos(x * PI * 3000.0 / 180.0) val gcjLon z * cos(theta) val gcjLat z * sin(theta) return doubleArrayOf(gcjLat, gcjLon) } /** * WGS-84 转 GCJ-02 * GPS设备 转 高德/腾讯 */ fun wgs84ToGcj02(lat: Double, lon: Double): DoubleArray { // 判断是否在国内国内才需要转换。这里简化处理默认转换。 if (outOfChina(lat, lon)) { return doubleArrayOf(lat, lon) } var dLat transformLat(lon - 105.0, lat - 35.0) var dLon transformLon(lon - 105.0, lat - 35.0) val radLat lat / 180.0 * PI var magic sin(radLat) magic 1 - EE * magic * magic val sqrtMagic sqrt(magic) dLat (dLat * 180.0) / (A * (1 - EE) / (magic * sqrtMagic) * PI) dLon (dLon * 180.0) / (A / sqrtMagic * cos(radLat) * PI) val mgLat lat dLat val mgLon lon dLon return doubleArrayOf(mgLat, mgLon) } // 以下为转换所需的辅助函数 private fun outOfChina(lat: Double, lon: Double): Boolean { return lon 72.004 || lon 137.8347 || lat 0.8293 || lat 55.8271 } private fun transformLat(x: Double, y: Double): Double { var ret -100.0 2.0 * x 3.0 * y 0.2 * y * y 0.1 * x * y 0.2 * sqrt(abs(x)) ret (20.0 * sin(6.0 * x * PI) 20.0 * sin(2.0 * x * PI)) * 2.0 / 3.0 ret (20.0 * sin(y * PI) 40.0 * sin(y / 3.0 * PI)) * 2.0 / 3.0 ret (160.0 * sin(y / 12.0 * PI) 320 * sin(y * PI / 30.0)) * 2.0 / 3.0 return ret } private fun transformLon(x: Double, y: Double): Double { var ret 300.0 x 2.0 * y 0.1 * x * x 0.1 * x * y 0.1 * sqrt(abs(x)) ret (20.0 * sin(6.0 * x * PI) 20.0 * sin(2.0 * x * PI)) * 2.0 / 3.0 ret (20.0 * sin(x * PI) 40.0 * sin(x / 3.0 * PI)) * 2.0 / 3.0 ret (150.0 * sin(x / 12.0 * PI) 300.0 * sin(x / 30.0 * PI)) * 2.0 / 3.0 return ret } }使用方式假设你的目的地坐标是从高德地图API获取的GCJ-02现在要跳转百度地图。val (gcjLat, gcjLon) destinationFromAmap // 高德坐标 val (bdLat, bdLon) CoordinateConverter.gcj02ToBd09(gcjLat, gcjLon) // 然后用 bdLat, bdLon 去构造百度地图的URI重要提醒在跳转百度地图的URI中即使你已经把坐标转换成了BD-09coord_type参数仍然建议设置为gcj02。这是为什么呢因为百度地图的URI接口设计得很聪明如果你告诉它坐标是gcj02它会自动在内部进行转换。这样你无论传GCJ-02坐标并声明coord_typegcj02还是传转换好的BD-09坐标并声明coord_typebd09ll最终效果都是一样的。我个人的习惯是坐标不转换直接传GCJ-02然后设coord_typegcj02让百度自己去处理更省事也避免自己转换算法可能存在的细微误差。5. 第四步组装与用户体验优化把前面的模块拼装起来再加上一些用户体验的打磨就是一个完整的、健壮的多地图导航功能了。5.1 完整的流程控制逻辑一个理想的导航流程应该是这样的用户点击“导航”按钮。检查手机内高德、百度地图的安装情况。如果只安装了一个直接跳转到那个地图。如果两个都安装了弹出一个选择对话框让用户自己选用哪个。如果都没安装弹窗提示用户并引导其去下载可以直接跳转到应用市场对应页面。这里给出一个完整的Kotlin工具类示例object MapNavigationHelper { const val PKG_AMAP com.autonavi.minimap const val PKG_BAIDU com.baidu.BaiduMap fun navigateTo(context: Context, dlat: Double, dlon: Double, dname: String, sname: String 我的位置) { val isAmapInstalled isAppInstalled(context, PKG_AMAP) val isBaiduInstalled isAppInstalled(context, PKG_BAIDU) when { isAmapInstalled isBaiduInstalled - { // 两个都装了让用户选 showMapChooserDialog(context, dlat, dlon, dname, sname) } isAmapInstalled - { startAmap(context, dlat, dlon, dname, sname) } isBaiduInstalled - { startBaidu(context, dlat, dlon, dname, sname) } else - { // 都没装提示下载 showInstallDialog(context) } } } private fun showMapChooserDialog(context: Context, dlat: Double, dlon: Double, dname: String, sname: String) { val items arrayOf(高德地图, 百度地图) AlertDialog.Builder(context) .setTitle(选择导航应用) .setItems(items) { _, which - when (which) { 0 - startAmap(context, dlat, dlon, dname, sname) 1 - startBaidu(context, dlat, dlon, dname, sname) } } .setNegativeButton(取消, null) .show() } private fun startAmap(context: Context, dlat: Double, dlon: Double, dname: String, sname: String) { val uri Uri.parse(androidamap://route/plan?sourceApplication${context.packageName}dlat$dlatdlon$dlondname${Uri.encode(dname)}dev0t0) val intent Intent(Intent.ACTION_VIEW, uri).apply { setPackage(PKG_AMAP) } safeStartActivity(context, intent, 高德地图) } private fun startBaidu(context: Context, dlat: Double, dlon: Double, dname: String, sname: String) { // 注意这里假设起点坐标已通过其他方式获取此处简化处理。实际使用时需要传入起点坐标或处理为无起点模式。 // 百度地图URI使用coord_typegcj02直接传入GCJ-02坐标 val uri Uri.parse(baidumap://map/direction?destinationlatlng:$dlat,$dlon|name:${Uri.encode(dname)}modedrivingcoord_typegcj02) val intent Intent(Intent.ACTION_VIEW, uri).apply { setPackage(PKG_BAIDU) } safeStartActivity(context, intent, 百度地图) } private fun showInstallDialog(context: Context) { AlertDialog.Builder(context) .setTitle(提示) .setMessage(未检测到地图应用是否前往下载) .setPositiveButton(下载高德) { _, _ - openMarket(context, PKG_AMAP) } .setNegativeButton(下载百度) { _, _ - openMarket(context, PKG_BAIDU) } .setNeutralButton(取消, null) .show() } private fun safeStartActivity(context: Context, intent: Intent, mapName: String) { try { context.startActivity(intent) } catch (e: ActivityNotFoundException) { Toast.makeText(context, 跳转${mapName}失败请检查应用是否正常, Toast.LENGTH_SHORT).show() } catch (e: SecurityException) { Toast.makeText(context, 跳转失败无权限启动该应用, Toast.LENGTH_SHORT).show() } } private fun openMarket(context: Context, packageName: String) { try { val uri Uri.parse(market://details?id$packageName) val intent Intent(Intent.ACTION_VIEW, uri) // 加上这行避免弹出选择器直接跳转到手机里的应用市场 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) context.startActivity(intent) } catch (e: Exception) { // 如果手机没有应用市场尝试用浏览器打开网页版 val uri Uri.parse(https://www.coolapk.com/apk/$packageName) // 以酷安为例 val intent Intent(Intent.ACTION_VIEW, uri) context.startActivity(intent) } } // 之前定义的 isAppInstalled 函数放这里 private fun isAppInstalled(context: Context, packageName: String): Boolean { ... } }5.2 处理定位权限与起点坐标在实际项目中导航的“起点”往往就是用户当前的位置。这就涉及到定位权限的申请和定位SDK的使用。我建议将定位逻辑和导航跳转逻辑解耦。在你的应用其他模块比如首页就申请好定位权限并持续或单次获取到用户的位置坐标GCJ-02格式存储起来。当用户触发导航时直接使用这个缓存的坐标作为起点。如果用户拒绝了定位权限或者定位暂时没获取到你的导航逻辑应该能降级处理。对于高德地图不传起点参数即可。对于百度地图你可以选择不传origin参数但部分百度地图版本可能行为不一致或者构造一个不包含起点的URIbaidumap://map/direction?destination...modedriving让百度地图App自己去处理起点通常会弹窗让用户选择或搜索起点。在跳转前给用户一个Toast提示“正在跳转地图请在地图App内确认起点”体验会更好。5.3 测试与兼容性备忘功能写完了测试必不可少。你需要准备至少两台测试机一台安装高德一台安装百度还有一台两个都装。分别测试以下场景正常跳转检查目的地是否准确。都没安装时引导下载对话框是否正常跳转应用市场是否顺畅。处理极端情况比如构造的URI格式错误或者地图App版本过低不支持某个参数你的try-catch是否能兜底避免应用崩溃。另外记得将高德和百度地图的包名、常用URI格式常量统一定义不要散落在代码各处。这样以后如果地图App的协议有更新或者需要增加腾讯地图的支持你只需要修改一个地方就行了。我在这上面栽过跟头早期代码里到处是硬编码的字符串后来加功能改得头晕眼花。