Карта Google, мої камери, один застосунок
Я хотів на екрані автомобіля одного. Карту Google, затори від Google і покрокові підказки від Google, а зверху мої власні дані про камери швидкості, які сповіщають мене лише про камери, що справді дивляться на мій бік дороги.
Я не знайшов нічого для Android Auto, що б це робило. Google Maps має карту й маршрути, але завантажити туди власну базу камер неможливо. Тож я будую це сам.
Він називається AutoNavAlerts. Це навігаційний застосунок для Android Auto, побудований на Navigation SDK від Google, зі системою сповіщень про камери та точки інтересу, написаною зверху. Перше джерело камер: PocketGPSWorld, через мою власну платну підписку. Код відкритий за ліцензією Apache License 2.01 на github.com/damo2929/AutoNavAlerts.
Це перша частина серії. Вона розповідає, що робить застосунок, що Google дозволить і чого не дозволить сторонньому застосунку на екрані автомобіля, і як його побудовано, бо майже кожен рядок у ньому написав Claude, модель штучного інтелекту від Anthropic, а я встановлював правила, тестував і відповідаю за результат. Ця остання частина сама по собі історія.
Це версія 0.1.0. Її встановлено вручну, не з Play Store, і вона пройшла одну справжню поїздку. Читай це як журнал збирання, а не як запуск продукту.
Що він робить сьогодні
Ось що є в тестовій збірці і для чого кожна частина:
| Розділ | Що робить |
|---|---|
| Навігація | Карта Google із заторами, пошук місць, попередній перегляд маршруту з часом прибуття, покрокові підказки на екрані авто, на бічній панелі та на дисплеї водія |
| Їхати до контакту | Скажи або введи ім’я, і збережені адреси контакту з’являться над результатами Places. До Google іде лише та адреса, яку ти вибрав |
| Уживається з музикою | Лише навігаційні шаблони, тож музика зберігає свою картку на розділеному екрані. Голосове сповіщення приглушує музику, але ніколи не ставить її на паузу |
| Сповіщення про камери | Три етапи для кожної камери, лише для камер, повернутих у напрямку твого руху, на дорозі, якою ти їдеш |
| Зони середньої швидкості | Зона починається лише тоді, коли попереду є ще одна камера з тим самим обмеженням, і закінчується на останній камері |
| Панель швидкості | Твоя швидкість і обмеження на дорозі завжди поруч, унизу праворуч |
| Обмеження швидкості офлайн | Одне завантаження обмежень OpenStreetMap для Великої Британії: 1 326 619 доріг у 29 MB на телефоні. Під час руху нічого не шукається |
| Маршрути для електромобіля | Найшвидший маршрут і енергоефективний маршрут Google поруч, а вибираєш ти |
| Дані про камери | Твоя власна підписка PocketGPSWorld, перевіряється щодня, ніколи не підмінюється, поки ти ведеш маршрут. Або імпорт файлів iGO, KML, GPX, OV2 чи CSV |
| Повідомити про камеру | Один дотик в авто зберігає позицію, курс і обмеження, з необов’язковим голосовим коментарем. Перегляд і надсилання відбуваються на телефоні, ніколи під час руху |
Сповіщення про камери і є причиною, з якої існує застосунок, тож їм наступний розділ.
Камера рахується, лише якщо вона повернута до тебе
Сповіщення про камеру, яке спрацьовує для зустрічної смуги, гірше, ніж жодного сповіщення. Воно привчає тебе ігнорувати цю штуку. Тому перше жорстке правило в проєкті: камера сповіщає лише тоді, коли вона повернута в напрямку твого руху, і це правило ніколи не послаблюється, ніколи не обходиться налаштуваннями за замовчуванням і ніколи не відкидається, коли дані незручні.
Рушій працює на кожній позиції, до десяти на секунду. Для кожної камери поблизу він ставить чотири питання по черзі:
| Перевірка | Проходить, коли | Навіщо вона |
|---|---|---|
| Досить близько | у межах відстані спрацювання плюс 200 m, не більше 3 km | жодної роботи над камерами за кілометри |
| Попереду тебе | напрямок на камеру в межах 45° від твого курсу | камера позаду вже в минулому |
| Повернута до тебе | напрямок камери в межах 45° від твого курсу або від напрямку на камеру на повороті | зустрічна смуга мовчить |
| На твоїй дорозі | у межах 50 m від маршруту попереду або коридор 40 m, що розширюється з відстанню у вільному русі | паралельна дорога мовчить |
45° це не щедро. Файли TomTom від PocketGPSWorld задають напрямок камери у восьми румбах, тож 22,5° з’їдають дані ще до всього іншого. Курс GPS коштує ще кілька градусів, вигин дороги ще кілька. Ось чому більше ніщо не має права від цього відкушувати.
Камеру, що не пройшла перевірку напрямку, все одно малюють на карті, приглушено, зі стрілкою, яка показує, куди вона повернута. Ти її бачиш. Вона просто з тобою не говорить.
Етапи розраховуються за часом, а не за фіксованими відстанями. Перше сповіщення приходить за 15 секунд до камери на твоїй поточній швидкості, друге за половину цього часу, обидва з нижньою межею, щоб ніколи не тиснути на третє. Третє зафіксоване на 100 ярдах і обов’язкове, щойно звук увімкнено. Відстань спрацювання під час наближення лише зростає, тож різке гальмування не скорочує попередження, яке тобі вже належало.
Що Google дозволяє застосунку на екрані авто
Тут стає цікаво, бо сторонній застосунок в Android Auto не є Google Maps. Він працює в межах правил, встановлених Car App Library від Android Auto, яка дає застосункам «a set of visual templates approved for driver safety»2, і в межах того, що Navigation SDK вирішить відкрити.
Три прогалини сформували застосунок більше, ніж усе, що я вирішив побудувати:
| Що | Google Maps в авто | Застосунок на 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 для повідомлень існують у навігаційному поданні телефона, а в автомобільному нема. Хтось уже попросив про це Google5, і запит досі відкритий. Застосунок перевіряє ці 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 ліцензує свою базу для індивідуального використання, ставить водяний знак учасника на кожне завантаження й забороняє класти її туди, куди може дістатися хтось, окрім покупця. Тож застосунок ніколи її не постачає, ніколи не розміщує й ніколи не синхронізує між телефонами. Ти входиш зі своєю підпискою, і телефон завантажує твою власну копію з водяним знаком у приватне сховище, виключене з резервних копій. На стенді це було 19 826 камер у 33 наборах, по одному набору на файл, ніколи не злитих.
Автоматична синхронізація поводиться чемно. Вона читає публічну RSS-стрічку PocketGPSWorld раз на день8 і входить лише тоді, коли вийшов новий випуск. Вона ніколи не підмінює камери, поки ти ведеш маршрут.
Один пункт їхньої ліцензії цим повністю не врегульовано, той, що про включення даних у застосунок. Для власного використання я з цим погоджуюся. Перш ніж застосунок потрапить до когось іще, PocketGPSWorld отримає листа з питанням.
Два дні, 87 комітів і спершу проєктний документ
Тепер частина, про яку люди сперечатимуться. Я цей код не набирав. Його набрав Claude через Claude Code, двома моделями, Claude Fable і Claude Opus. Я написав вимоги, ухвалив кожне рішення, ганяв стенд, кермував автомобілем і переглядав те, що поверталося. Кожен коміт зі змінами, написаними ШІ, має трейлер, який про це каже, і README теж.
Ось цифри, зчитані з репозиторію:
| Показник | Значення |
|---|---|
| Коміти | 87, з 22:10 11 жовтня до 12:44 13 жовтня 2026 |
| Коміти з рядком співавтора Claude | 83 (56 Fable, 27 Opus) |
| Kotlin у застосунку та його базовій бібліотеці | 15 334 рядки |
| Модульні тести | 211, у 3464 рядках |
DESIGN.md, специфікація | 1763 рядки, написані до будь-якого коду |
Проєктний документ був першим, і це найкорисніше, що я можу сказати кожному, хто таке робить. Його перший рядок каже, що жоден код не пишеться, доки документ не схвалено, а будь-яка пізніша зміна спершу вноситься туди. Кожен клас має записане навпроти нього завдання. Кожен поріг має причину. Кожне правило, яке я встановив, позначене як моє, з датою.
Це важить, бо модель забуває. Довгий сеанс стискається в підсумок, і підсумок зберігає суть та губить подробиці, а помилки сидять саме в подробицях. Власний AGENTS.md репозиторію каже це прямо: не покладайся на підсумок цих файлів з пам’яті чи з попереднього сеансу. Агент повертається до документа. Щоразу.
На другому етапі два агенти також працювали паралельно, один над підказками, картою й екранами, другий над позиціонуванням, сповіщеннями, мовленням і маркерами на карті. Кожен володів записаним списком файлів, а інтерфейси між ними зафіксували заздалегідь: додавай, не перейменовуй. Вони злилися чисто, бо межу вирішили до того, як будь-який із них почав, а не виявили потім.
Кожне жорстке правило виникло з того, що я побачив
У проєкті є список жорстких правил, і жодне з них не прийшло з дошки для нотаток. Кожне виникло, коли я дивився, як ця штука працює на Desktop Head Unit9, емуляторі автомобільного екрана від Google на ПК, або в авто, і бачив, як вона робить щось не так.
| Жорстке правило | Що я побачив, через що воно стало правилом |
|---|---|
| Камера сповіщає лише тоді, коли повернута до тебе | сповіщення для зустрічної смуги є шумом, що вчить ігнорувати сповіщення |
| На екрані авто немає нічого, що не працює | дві кнопки зупинки на екрані, одна з них мертва |
| Жодна функція не показується двічі | та сама пара, плюс дві кнопки повернення до центру, два показники швидкості |
| Одне скасування, від Google | картка в кутку з X належить самому Android Auto, малюється з поїздки, яку публікує застосунок, тож власна кнопка зупинки застосунку пішла |
| Жодного тремтіння на екрані авто | екран «Ще» смикався, поки авто стояло, бо щосекунди надсилав ідентичний екран, а Android Auto анімує кожне оновлення |
| Кожна кнопка з правого боку | кнопки карти сиділи вгорі ліворуч, доки екран авто не повідомляв свій розмір; тепер з самого початку одна колонка вздовж правого краю, ліворуч нічого нашого |
| Жодного вбудованого ключа Maps, ніколи | їзду жодної людини не виставляють у рахунок комусь іншому |
Тремтіння мені подобається найбільше, бо воно таке дрібне, і воно б пішло в реліз. Рядок живого GPS оновлювався раз на секунду. Кожне оновлення заново надсилало весь екран, незмінний, а хост його анімував, тож кожен рядок нижче дриґався, поки авто стояло. Виправлення вміщається в одне порівняння: перемальовувати лише тоді, коли рядок змінився. Правило більше за виправлення. Екран, що стоїть нерухомо, мусить виглядати нерухомим, і це перевіряють серією знімків екрана, які мають бути ідентичними.
Ось справжня робота, коли код пише ШІ. Він не втомлюється й не проти переписувати, але не бачить екрана авто. Ти бачиш. Записати побачене як правило, з датою: ось що не дає йому повернутися через три сеанси.
Що код зробив не так і як це впіймали
Чимало. Нічого з цього не було екзотичним, і кожну помилку впіймали запуском, а не читанням:
| Помилка | Що вона робила | Як її впіймали |
|---|---|---|
| Маршрут прив’язано не до тієї ділянки | Маршрут Google від припаркованого авто йшов на північ, розвертався на кільці й повертався на південь тією самою дорогою. Зіставлення прив’язало авто до північної ділянки за 10 m, тож кожна камера на південь була «поза дорогою» більш ніж на кілометр. Нічого не сповіщало | сценарна поїздка на стенді; журнал сповіщень показував offRoad lateral=1204 для кожної камери |
| Сторожовий таймер мовлення закороткий | він дозволяв 1,5 s плюс 70 ms на символ. Числа вимовляються довше, тож кожне сповіщення другого етапу обривалося посеред речення | записи мовлення з прогону на стенді |
| Обмеження частоти в рушії | з вікном у три секунди з двох камер на одному перехресті одна губилася назавжди | відстеження сповіщень, що замовкли під час першої справжньої поїздки |
| Застарілий курс | емулятор повідомляє напрямок 0° хоч би що ти робив, тож на дорозі на південь кожна камера не проходила перевірку напрямку | змодельований проїзд по A61 |
| Зміни обмеження озвучувалися як сповіщення про камеру | зміну обмеження попереду ставили в чергу як сповіщення першого етапу про камеру | журнал мовлення на стенді |
На другій варто зупинитися. Кожен окремий тест проходив. Код був правильним за власною міркою. Просто тайм-аут вибрав хтось, хто ніколи не чув, як телефон уголос читає відстань. Тест, який таке ловить, це справжній голос, з хронометражем, на справжньому прогоні.
Перша справжня поїздка
12 жовтня я поставив релізну збірку на телефон і виїхав на XPENG G6 через бездротовий Android Auto. Дві речі пішли не так. Маршрут, заданий на стоянці, сам скинувся за кілька секунд після початку руху. А деякі сповіщення озвучувалися, а деякі ні, без жодної закономірності, яку я міг би помітити.
Потім проблема гірша. Читати не було чого. ColorOS мого телефона викидає рядки журналу застосунку, тож поїздка не залишила жодних доказів. Це був застосунок, SDK від Google чи сам Android Auto? Я не міг сказати.
Тож виправленням першої поїздки була не зміна коду. Це були докази. Застосунок тепер постійно пише на телефоні два журнали, один для маршрутів і карти, другий для кожного рішення про сповіщення, пакетами по 15 секунд, плюс необов’язковий реєстратор поїздки, що зберігає кожну позицію, щоб поїздку можна було відтворити на стенді. Потім виправили здогадки, кожну переписано так, щоб робила менше й записувала, що зробила. Кожен спосіб, яким може завершитися ведення маршрутом, тепер записує, хто його завершив.
Відтоді на стенді Android Auto один раз викликав зупинку, через 2 хвилини 35 секунд ведення маршрутом. Я тоді клацав по головному пристрою, тож найімовірніше це був X на його власній картці. Коли екрана ніхто не торкався, такого не траплялося. Наступна поїздка це з’ясує, бо цього разу поїздка залишить слід.
Що далі
Список для стенда досі довгий. Наступні поїздки перевіряють кнопку скасування, сценарії з поворотом і рухом не в той бік, передачу між GPS авто й телефона та чи показує дисплей водія в G6 картки поворотів від стороннього застосунку взагалі.
Пізніші частини серії докладно розберуть математику рушія сповіщень, обхідні шляхи з обмеженням швидкості, формати PocketGPSWorld і сам стенд: як тестувати застосунок для Android Auto без автомобіля, зі сценарним GPS та емулятором, який думає, що кожна дорога веде на північ.
Машина набирає, стандарт твій
Я чув багато розмов про те, як ШІ пише код, здебільшого від тих, хто його продає, або від тих, хто його боїться. Те, що я виявив, нудніше за обидва варіанти й корисніше.
Він набирає швидко й не нудьгує. Він перепише екран учетверте без жодного зітхання. Але він не помітить, що екран «Ще» тремтить, що речення обірвалося чи що мертва кнопка стоїть поруч із живою. Він не бачить авто. Бачити це мав я, і єдина причина, чому це виправлено: я записав кожне як правило, яке він мусить прочитати, перш ніж щось чіпати.
Як таке, відповідальність нікуди не переходить. Код мій, бо я встановив стандарт, за яким його міряють, і саме я сиджу в авто. Ніщо з того, що тримало його чесним, не є методом ШІ. Писати специфікацію до коду, записувати те, чого навчився, і збирати докази замість здогадок: так завжди робилася справжня інженерія. Інструмент цього не змінює. Він лише швидше показує, хто це пропускав.
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», відкрито 17 червня 2026, досі відкрите. ↩︎
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 — емулятор автомобільного екрана Android Auto від Google. ↩︎