Google 的地图,我的摄像头,一个应用
我在车机屏幕上只想要一样东西。Google 的地图、Google 的路况、Google 的逐向导航,上面叠加我自己的测速摄像头数据,并且只在摄像头真正对着我这一侧道路时才提醒我。
我在 Android Auto 上找不到任何能做到这一点的东西。Google 地图有地图和路线规划,但没有办法把你自己的摄像头数据库加载进去。所以我自己来做。
它叫 AutoNavAlerts。这是一款基于 Google Navigation SDK 的 Android Auto 导航应用,上面写了一套摄像头和兴趣点提醒系统。第一个摄像头数据源是 PocketGPSWorld,用的是我自己付费的订阅。代码以 Apache License 2.01 公开在 github.com/damo2929/AutoNavAlerts。
这是一个系列的第一部分。它讲这个应用做什么,Google 会让、不会让第三方应用在车机屏幕上做什么,以及它是怎么做出来的,因为几乎每一行代码都是 Claude(Anthropic 的 AI 模型)写的,由我定规则、做测试、对结果负责。最后这一点本身就是个故事。
它是 0.1.0 版。它是侧载安装的,不在 Play Store 上,只真正上路开过一次。把它当作开发日志来读,不是产品发布。
它现在能做什么
测试版里有这些东西,以及每一部分是干什么用的:
| 方面 | 它做什么 |
|---|---|
| 导航 | 带路况的 Google 地图、地点搜索、带预计到达时间的路线预览,车机屏幕、侧栏和仪表显示屏上的逐向导航 |
| 导航到联系人 | 说出或输入一个名字,联系人保存的地址会出现在 Places 结果上方。只有你选中的那个地址会发给 Google |
| 与音乐共存 | 只用导航模板,所以分屏时音乐保留自己的卡片。提醒语音会压低音乐,从不暂停它 |
| 摄像头提醒 | 每个摄像头分三个阶段,只针对朝向你行驶方向、在你所在道路上的摄像头 |
| 区间测速 | 只有前方还有另一个限速相同的摄像头时区间才开始,在最后一个摄像头处结束 |
| 速度面板 | 你的车速和道路限速,始终并排显示在右下角 |
| 离线限速 | 一次性下载英国的 OpenStreetMap 限速数据:手机上 29 MB 存 1,326,619 条道路。开车时不做任何查询 |
| 电动车路线 | 最快路线和 Google 的节能路线并排显示,由你选 |
| 摄像头数据 | 你自己的 PocketGPSWorld 订阅,每天检查一次,导航途中绝不替换。也可以导入 iGO、KML、GPX、OV2 或 CSV 文件 |
| 上报摄像头 | 在车上点一下,保存位置、朝向和限速,可附一段语音备注。审核和发送都在手机上做,绝不在开车时做 |
摄像头提醒是这个应用存在的理由,所以下一节专门讲它。
摄像头只有朝着你才算数
一个对着对向车道响起来的测速提醒,比没有提醒还糟。它会把你训练成对这东西充耳不闻。所以设计里第一条硬规则就是:摄像头只有朝向你的行驶方向时才提醒。这条规则绝不放宽,绝不靠默认值绕过,也绝不因为数据不好处理就丢掉。
引擎在每次定位时运行,每秒最多十次。对附近的每个摄像头,它按顺序问四个问题:
| 检查 | 何时通过 | 为什么要有它 |
|---|---|---|
| 够近 | 在触发距离加 200 m 以内,上限 3 km | 不在几英里外的摄像头上浪费功夫 |
| 在你前方 | 指向摄像头的方位与你的航向相差 45° 以内 | 身后的摄像头已经过去了 |
| 朝向你 | 摄像头的方位与你的航向相差 45° 以内,弯道上则与指向摄像头的方位比 | 对向车道保持安静 |
| 在你的路上 | 距前方路线 50 m 以内;自由行驶时则是一条随距离变宽的 40 m 走廊 | 平行道路保持安静 |
45° 并不宽松。PocketGPSWorld 的 TomTom 文件只用八个罗盘方位给出摄像头方向,所以还没算别的,22.5° 就已经被数据吃掉了。GPS 航向再吃掉几度,道路弯曲再吃掉几度。这就是为什么别的东西一概不许再往里挤。
方向检查不过的摄像头仍会画在地图上,颜色调暗,带一个箭头标出它朝哪边。你看得到它。它只是不跟你说话。
各阶段是按时间算的,不是固定距离。第一次提醒在以当前车速还有 15 秒到达时响起,第二次在一半时间处,两者都有下限,所以绝不会挤到第三次上。第三次固定在 100 码,只要开着声音就是强制的。接近过程中触发距离只会变大,所以急刹车不会缩短你本该得到的提醒。
Google 允许应用在车机屏幕上做什么
有意思的地方就在这里,因为 Android Auto 上的第三方应用不是 Google 地图。它运行在 Android Auto 的 Car App Library 定下的规则里,这个库给应用提供“a set of visual templates approved for driver safety”2,同时也受限于 Navigation SDK 愿意开放的东西。
有三个缺口对这个应用的塑造,比我自己选择做的任何东西都大:
| 什么 | 车上的 Google 地图 | 基于 Navigation SDK 的应用 |
|---|---|---|
| 上报事故、警察或道路施工 | 内置 | 不提供。Google 自己的文档:“real-time disruptions are not available on Android Auto”3 |
| 道路限速 | 显示 | 只给你超出的百分比,而且只在你超速时给4 |
| 触摸 SDK 自己的地图控件 | 不适用 | 不行。Android Auto “limits screen surface interaction to a series of SurfaceCallback methods”2 |
就拿限速来说。Google 知道限速。Google 会告诉应用你超了多少,以百分比和严重程度的形式,而你没超速时什么都不说。能问一句,为什么司机只有在已经违规之后才被允许知道限速?这个问题我不会得到答案,所以应用自己绕过去。你超速时,它从你的车速和那个百分比反推出限速。没超速时,它用你正在接近的摄像头,再用 OpenStreetMap 下载的数据;实在没有限速时,它显示一个横杠,而不是什么都不显示。
事件上报也是同样的情形。上报 API 在手机的导航视图上有,在车机上没有。已经有人向 Google 提过这个需求5,至今仍未关闭。应用在运行时检查这些 API,所以如果以后的 SDK 加上了它们,Google 的上报按钮会直接出现,我的代码一行不用改。一个 GitHub Actions 任务每季度检查一次,出现的当天就开一个 issue。
触摸规则可把我坑惨了。SDK 的车机地图会画自己的到达卡片、顶栏、重新居中按钮、速度表和行程栏。它们一个都点不了,因为触摸根本到不了 SDK 的视图。它们看着像按钮,实际上屁用没有。所以它们全被关掉了,应用在点击真正能生效的地方画自己的控件。
自带密钥,自带数据
有两个决定让这个应用在钱和许可证上保持老实,两个都是有意为之。
没有内置的 Maps 密钥。 Google Maps Platform 需要“a billing-enabled Cloud project”6,Navigation SDK 需要一个启用了它的项目7。如果我在应用里附带一个密钥,所有人开车的费用都会记到我头上,或者密钥泄露出去,费用照样记到我头上。所以每个用户都在自己的 Google Cloud 账号里自带密钥。手机应用可以用你自己的 Google 账号创建一个,或者你粘贴一个进去。它在手机上加密保存。没有任何形式的后备,在你的密钥填进去之前,应用一次 SDK 调用都不会发。
应用里没有摄像头数据。 PocketGPSWorld 的数据库授权给个人使用,每次下载都给会员打上水印,并禁止把它放到购买者以外任何人能拿到的地方。所以应用从不附带它、从不托管它,也从不在手机之间同步它。你用自己的订阅登录,手机把你自己那份带水印的副本下载到不参与备份的私有存储里。在测试台上,那是 33 组共 19,826 个摄像头,每个文件一组,从不合并。
自动同步在这件事上很有分寸。它每天读一次 PocketGPSWorld 的公开 RSS 源8,只有出了新版本才登录。导航途中它绝不替换摄像头数据。
他们许可证里有一条并没有因此完全解决,就是关于把数据并入应用程序的那一条。我自己用,我接受这一点。在应用交给别人之前,我会给 PocketGPSWorld 发邮件问清楚。
两天,87 个 commit,先写设计文档
现在是大家会吵起来的部分。这些代码不是我敲的。是 Claude 通过 Claude Code 写的,用了两个模型,Claude Fable 和 Claude Opus。需求是我写的,每个决定是我做的,测试台是我跑的,车是我开的,回来的东西是我审的。每个含有 AI 写的改动的 commit 都带着一行注明这一点的 trailer,README 里也写了。
以下数字直接从仓库里读出来:
| 指标 | 数值 |
|---|---|
| Commit | 87 个,从 2026年10月11日 22:10 到 10月13日 12:44 |
| 带 Claude 合著者行的 commit | 83 个(Fable 56 个,Opus 27 个) |
| 应用及其核心库中的 Kotlin | 15,334 行 |
| 单元测试 | 211 个,共 3,464 行 |
DESIGN.md,规格说明 | 1,763 行,在写任何代码之前写成 |
设计文档先行,这是我能告诉任何做这件事的人最有用的一句话。它的第一行就说,在它获批之前不写任何代码,之后的任何改动都先在它里面改。每个类都写明了它的职责。每个阈值都有理由。我定的每条规则都标明是我定的,并注明日期。
这很重要,因为模型会忘事。一段长会话会被压缩成摘要,摘要留下大意、丢掉细节,而 bug 恰恰藏在细节里。仓库自己的 AGENTS.md 说得很直白:不要依赖凭记忆或上一次会话得来的这些文件的摘要。代理要回去读文档。每一次都是。
第二阶段还有两个代理并行工作,一个负责导航引导、地图和界面,另一个负责定位、提醒、语音和地图标记。每个代理拥有一份写明的文件清单,两者之间的接口事先定死:只加,不改名。它们合并得干干净净,因为边界是在两边动手之前就定下的,而不是事后才发现的。
每一条硬规则都来自我亲眼看到的东西
设计里有一份硬规则清单,没有一条是在白板上想出来的。每一条都来自看着它在 Desktop Head Unit9(Google 在电脑上的车机屏幕模拟器)里或者在车里运行,看到它做错了什么。
| 硬规则 | 让它成为规则的那件事 |
|---|---|
| 摄像头只有朝着你这边才提醒 | 对面车道的提醒是噪声,只会教你学会无视提醒 |
| 车机屏幕上不放任何不起作用的东西 | 屏幕上有两个停止按钮,其中一个是摆设 |
| 同一个功能不显示两次 | 还是那对按钮,外加两个回中按钮、两个车速显示 |
| 只有一个取消,用 Google 的 | 角落里带 X 的那张卡片是 Android Auto 自己的,根据应用发布的行程画出来,所以应用自己的停止按钮去掉了 |
| 车机屏幕上不许抖动 | 停着车的时候“更多”页面在抖,因为它每秒重发一次完全相同的界面,而 Android Auto 每次刷新都做动画 |
| 所有按钮都在右侧 | 车机屏幕报告尺寸之前,地图按钮一直待在左上角;现在从一开始就是右边一列,左边没有我们的任何东西 |
| 永远不内置 Maps 密钥 | 谁开车的费用都不能记到别人账上 |
抖动是我最喜欢的一条,因为它太小了,差一点就发布出去了。一行实时 GPS 每秒跳一次。每跳一次就把整个界面原封不动地重发一遍,宿主再给它做一次动画,于是车停着不动,下面每一行都在抖。修复只是一次比较:只有某一行变了才重画。规则比修复更大。一个静止的界面必须看起来是静止的,检查方法是连拍一组截图,每一张都必须完全相同。
这才是 AI 写代码时真正的工作。它不会累,也不介意重写,但它看不见车机屏幕。你看得见。把你看到的东西写成规则,注上日期,才能防止它在三次会话之后又回来。
代码哪里写错了,又是怎么抓到的
错的不少。没有一个是稀奇古怪的,而且每一个都是靠运行抓到的,不是靠读代码:
| 故障 | 它干了什么 | 怎么抓到的 |
|---|---|---|
| 路线匹配到了错误的一段 | Google 从停着的车出发规划的路线先往北,在环岛掉头,再沿同一条路往南回来。匹配器把车钉在 10 米外的北行那段上,于是每个南行摄像头都“偏离道路”一公里多。一个提醒都没有 | 测试台上的脚本化驾驶;提醒日志对每个摄像头都写着 offRoad lateral=1204 |
| 语音看门狗太短 | 它只给 1.5 秒加每个字符 70 毫秒。数字念出来比这慢,所以每一条第二阶段提醒都在句子中间被掐断 | 一次测试台运行的语音记录 |
| 引擎里的限流 | 窗口是三秒,同一个路口的两个摄像头,有一个永远丢了 | 追查第一次真正上路时那些没出声的提醒 |
| 过时的航向 | 模拟器不管你怎么做都报告 0° 方位,所以在南行的路上每个摄像头都过不了方向检查 | 沿 A61 的一次模拟运行 |
| 限速变化被当成摄像头提醒念出来 | 前方限速变化被排进了第一阶段摄像头提醒的队列 | 测试台上的语音日志 |
第二个值得停一下。每一个单独的测试都通过了。按它自己的标准,代码是对的。只是那个超时是由一个从没听过手机把距离念出来的人定的。能抓住它的测试,是在一次真实运行里用真实的语音计时。
第一次真正上路
2026年10月12日,我把一个 release 版本装到手机上,开着小鹏 G6 通过无线 Android Auto 出门。出了两个问题。停车时设好的路线,起步几秒钟后就自己清掉了。还有一些提醒念出来了,一些没有,看不出任何规律。
接着是更糟的问题。什么都没留下可读的。我手机的 ColorOS 会把应用的日志行丢掉,所以这趟驾驶完全没有留下证据。是应用的问题,Google SDK 的问题,还是 Android Auto 本身的问题?我说不上来。
所以第一次上路之后的修复不是改代码,而是留证据。应用现在一直在手机上写两份日志,一份记录路线和地图,一份记录每一个提醒决定,每 15 秒写一批,另外还有一个可选的行车记录器,保存每一个位置,这样一趟驾驶可以在测试台上回放。然后那些靠猜的地方才得到修复,每一处都改成少做一点,并把它做了什么记下来。引导结束的每一种方式,现在都会记下是谁结束的。
此后在测试台上,Android Auto 调用过一次停止,是在一次引导驾驶开始后 2 分 35 秒。当时我正在车机上到处点,所以最可能是它自己卡片上的那个 X。没人碰屏幕的时候,这事没再发生过。下一次上路就能定论,因为这一次驾驶会留下痕迹。
接下来是什么
测试台上的清单还很长。接下来的几次驾驶要检查取消按钮、弯道和逆向的场景、车辆 GPS 和手机 GPS 之间的切换,以及 G6 的驾驶员显示屏到底会不会显示第三方应用的转向卡片。
这个系列后面的几部分会好好讲提醒引擎的数学、限速的变通办法、PocketGPSWorld 的格式,还有测试台本身:没有车、只有一段脚本化的 GPS 和一个以为每条路都朝北的模拟器,你怎么测试一个 Android Auto 应用。
机器负责打字,标准归你
关于 AI 写代码的说法我看了很多,大多出自卖它的人或者怕它的人。我发现的东西比两边说的都平淡,也更有用。
它打字很快,也不会腻。同一个界面让它重写第四遍,它连口气都不叹。它不会做的,是注意到“更多”页面在抖,或者一句话被掐断了,或者一个死按钮挨着一个活按钮。它看不见车。那些是我该看见的,它们之所以修好了,唯一的原因是我把每一条都写成了规则,它在动任何东西之前都必须先读。
正因如此,责任不会转移。代码是我的,因为它要达到的标准是我定的,坐在车里的也是我。让它保持老实的东西,没有一样是 AI 的方法。先写规格再写代码,把学到的东西写下来,留证据而不是靠猜,这本来就是正经工程一直以来的做法。工具改变不了这一点。它只是让你更快发现谁一直在偷工减料。
Apache License, Version 2.0 — AutoNavAlerts 代码发布所用的许可证。 ↩︎
Google — Navigation SDK for Android: Android Auto — Car App Library 提供 “a set of visual templates approved for driver safety”,并且 “Android Auto limits screen surface interaction to a series of SurfaceCallback methods”。 ↩︎ ↩︎
Google — Navigation SDK for Android: real-time disruptions — “real-time disruptions are not available on Android Auto”。 ↩︎
Google — Navigation SDK for Android: speed alerts —
onSpeedingUpdated(float percentageAboveLimit, SpeedAlertSeverity speedAlertSeverity):给的是超出限速的百分比和严重程度,而不是限速本身。 ↩︎googlemaps/flutter-navigation-sdk issue #726 — “Incident reporting on Android Auto & CarPlay”,2026年6月17日提出,至今未关闭。 ↩︎
Google Maps Platform — Get started — “you must create a billing-enabled Cloud project and enable the desired APIs or SDKs”。 ↩︎
Google — Navigation SDK for Android: set up your project — “A Google Cloud console project with the Navigation SDK enabled.” ↩︎
PocketGPSWorld — 应用同步数据所用的英国测速摄像头数据库,每个用户用自己的订阅。 ↩︎
Android Developers — Test using the Desktop Head Unit — Google 的 Android Auto 车机屏幕模拟器。 ↩︎