第1章：车载导航框架入门 — CarNavigation接口、导航状态管理、地图集成与路线规划
各位好，我是老张。在Android Automotive这个领域摸爬滚打了五六年，踩过的坑比走过的路还多。今天咱们聊聊车载导航框架，这是车载应用里最核心、也最容易出问题的一块。
说实话，我第一次接触CarNavigation接口时，也被它绕晕过。但搞明白之后，你会发现它其实挺优雅的。来，咱们一步步拆解。
1.1 CarNavigation接口 — 车载导航的“总开关”
CarNavigation接口是Android Automotive提供给导航应用的系统级API。说白了，它就是车载系统和导航App之间的通信桥梁。
我个人习惯把CarNavigation理解成一个“状态机”。它管理着导航的启动、停止、路线计算、引导提示等核心行为。你想想看，没有这个接口，导航App怎么知道什么时候该播报“前方300米右转”？
核心接口方法一览：
onStartNavigation()— 开始导航onStopNavigation()— 停止导航onRouteUpdate()— 路线更新回调onManeuverEvent()— 驾驶操作事件（转弯、变道等）onDestinationReached()— 到达目的地
我在项目中遇到过一个问题：某款车型在导航过程中频繁调用onRouteUpdate()，导致界面卡顿。后来发现是路线刷新频率设置得太高。嗯，这里要注意，不要每条路线变化都通知UI，加个节流阀会好很多。
1.2 导航状态管理 — 别让状态“飞”了
导航状态管理，说白了就是跟踪“现在导航在干什么”。是空闲？在规划路线？正在导航？还是已经到达？
我建议用枚举来定义状态，清晰又安全：
public enum NavigationState {
IDLE, // 空闲
ROUTING, // 路线规划中
NAVIGATING, // 导航中
REROUTING, // 重新规划路线
ARRIVED // 已到达
}为什么要单独搞一个状态管理？因为车载导航的交互场景比手机复杂得多。举个例子：用户正在导航，突然来了个电话，导航需要暂停语音播报但保持路线显示。这时候状态机就派上用场了。
我的经验：状态切换时一定要做边界检查。我曾经因为没处理IDLE到REROUTING的直接跳转，导致导航在高速上突然崩溃。从那以后，我强制所有状态转换都必须经过NAVIGATING。
1.3 地图集成（Google Maps） — 不只是显示地图
Google Maps在Android Automotive上的集成，和手机端有本质区别。车载环境对安全要求极高，所以Google Maps Automotive SDK做了很多限制。
核心集成步骤：
- 在Google Cloud Console中启用Maps SDK for Automotive
- 在AndroidManifest中配置API密钥和汽车相关权限
- 使用
SupportMapFragment或MapView嵌入地图 - 通过
GoogleMap对象控制地图行为
这里有个坑：车载地图的缩放级别和手机不一样。因为屏幕距离驾驶员更远，所以默认缩放级别要比手机大1-2级。我刚开始做的时候没注意，结果地图显示范围太大，用户根本看不清细节。
// 设置合适的缩放级别
googleMap.setMinZoomPreference(5.0f); // 城市级别
googleMap.setMaxZoomPreference(18.0f); // 街道级别
// 初始缩放建议设为14-15
googleMap.moveCamera(CameraUpdateFactory.zoomTo(14.5f));注意：Google Maps Automotive SDK要求应用必须声明android:isAutomotive="true"，否则地图无法在车载模式下正常渲染。这个坑我帮好几个同事排查过。
1.4 路线规划与引导 — 让车“知道”怎么走
路线规划是导航的灵魂。在Android Automotive中，路线规划主要通过Directions API或Routing API实现。但车载场景下，有几个特殊点需要处理。
首先是路线偏好。手机导航可能默认“最快路线”，但车载导航要考虑更多：
- 避开限高路段（货车专用）
- 避开拥堵（实时交通信息）
- 偏好高速（长途驾驶）
- 偏好充电站/加油站（电动车/燃油车）
其次是引导提示。车载导航的语音播报和视觉提示必须同步。我见过一个案例：语音说“前方500米右转”，但地图上显示的却是“300米”。这种不一致会让驾驶员非常困惑。
// 路线规划请求示例
RoutingRequest request = new RoutingRequest.Builder()
.setOrigin(currentLocation)
.setDestination(destination)
.setTravelMode(TravelMode.DRIVING)
.setAvoidTolls(true) // 避开收费站
.setAvoidHighways(false) // 允许高速
.setUnits(Units.METRIC)
.build();
// 异步获取路线
routingClient.getRoutes(request).addOnSuccessListener(response -> {
List<Route> routes = response.getRoutes();
// 选择第一条路线作为默认路线
Route primaryRoute = routes.get(0);
// 显示路线并开始导航
navigationManager.startNavigation(primaryRoute);
});避坑指南：我曾经在路线规划时忘记处理无路线结果的情况。结果用户输入了一个孤岛上的地址，App直接崩溃。现在我的代码里一定会加addOnFailureListener，并提示用户“无法规划路线”。
知识体系总览
下面这张图是我自己整理的，把本章的核心知识点串在了一起。你看一眼就能明白各个模块之间的关系。
实战要点总结
| 模块 | 核心要点 | 常见坑 |
|---|---|---|
| CarNavigation接口 | 状态机设计、回调管理 | 回调频率过高导致UI卡顿 |
| 导航状态管理 | 枚举定义、状态转换边界 | 状态跳转未做校验 |
| 地图集成 | SDK配置、缩放级别适配 | 忘记声明automotive属性 |
| 路线规划与引导 | 路线偏好、语音与视觉同步 | 未处理无路线结果 |
好了，这一章的内容就到这里。车载导航框架说复杂也复杂，说简单也简单。核心就是理解CarNavigation接口这个“总开关”，然后围绕它把状态管理、地图、路线规划串起来。下一章我们会深入代码，手把手搭建一个完整的导航应用。
我的建议：刚开始做车载导航时，先别急着写代码。拿张纸，把状态机画出来，把每个状态之间的转换条件写清楚。这一步做好了，后面写代码就是填空。