Карта 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
Повідомити про камеруОдин дотик в авто зберігає позицію, курс і обмеження, з необов’язковим голосовим коментарем. Перегляд і надсилання відбуваються на телефоні, ніколи під час руху

Сповіщення про камери і є причиною, з якої існує застосунок, тож їм наступний розділ.

Камера рахується, лише якщо вона повернута до тебе

Сповіщення про камеру, яке спрацьовує для зустрічної смуги, гірше, ніж жодного сповіщення. Воно привчає тебе ігнорувати цю штуку. Тому перше жорстке правило в проєкті: камера сповіщає лише тоді, коли вона повернута в напрямку твого руху, і це правило ніколи не послаблюється, ніколи не обходиться налаштуваннями за замовчуванням і ніколи не відкидається, коли дані незручні.

Як позиція стає сповіщенням про камеруВхідЧотири перевірки, кожна позиціяВихідшвидкість і GPS автоколи авто їх надаєGPS телефона10 позицій на секундутвої набори камерна телефоні1. досить близько2. попереду тебе3. повернута до тебе4. на твоїй дорозібанер накарті автоголосове сповіщення,музика тихішекамера підсвіченана картіне пройшла перевірку: сповіщення нема; повернуту геть малюють тьмяно зі стрілкою
Як позиція стає сповіщенням. До десяти позицій на секунду проходять чотири перевірки; лише камеру, що пройшла всі чотири, озвучують і показують як сповіщення.

Рушій працює на кожній позиції, до десяти на секунду. Для кожної камери поблизу він ставить чотири питання по черзі:

ПеревіркаПроходить, колиНавіщо вона
Досить близькоу межах відстані спрацювання плюс 200 m, не більше 3 kmжодної роботи над камерами за кілометри
Попереду тебенапрямок на камеру в межах 45° від твого курсукамера позаду вже в минулому
Повернута до тебенапрямок камери в межах 45° від твого курсу або від напрямку на камеру на поворотізустрічна смуга мовчить
На твоїй дорозіу межах 50 m від маршруту попереду або коридор 40 m, що розширюється з відстанню у вільному русіпаралельна дорога мовчить

45° це не щедро. Файли TomTom від PocketGPSWorld задають напрямок камери у восьми румбах, тож 22,5° з’їдають дані ще до всього іншого. Курс GPS коштує ще кілька градусів, вигин дороги ще кілька. Ось чому більше ніщо не має права від цього відкушувати.

Камеру, що не пройшла перевірку напрямку, все одно малюють на карті, приглушено, зі стрілкою, яка показує, куди вона повернута. Ти її бачиш. Вона просто з тобою не говорить.

Три етапи сповіщення на 70 mphТипове випередження: 15 секунд на твоїй швидкості, тут 70 mphти, 70 mphкамерадо тебезустрічна смуга, повернута геть: тьмяна, мовчить1-ше сповіщенняза 469 m, 15 s2-ге сповіщенняза 235 m, 7,5 sпроїзд100 ярд. (91 m)не в масштабі; мінімуми 242 m і 142 m розводять перші два на малій швидкості
Три етапи на 70 mph з типовим випередженням 15 секунд. Перші два розраховуються від твоєї швидкості; сповіщення при проїзді зафіксоване на 100 ярдах і не вимикається, поки звук увімкнено.

Етапи розраховуються за часом, а не за фіксованими відстанями. Перше сповіщення приходить за 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
Коміти з рядком співавтора Claude83 (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 та емулятором, який думає, що кожна дорога веде на північ.

Машина набирає, стандарт твій

Я чув багато розмов про те, як ШІ пише код, здебільшого від тих, хто його продає, або від тих, хто його боїться. Те, що я виявив, нудніше за обидва варіанти й корисніше.

Він набирає швидко й не нудьгує. Він перепише екран учетверте без жодного зітхання. Але він не помітить, що екран «Ще» тремтить, що речення обірвалося чи що мертва кнопка стоїть поруч із живою. Він не бачить авто. Бачити це мав я, і єдина причина, чому це виправлено: я записав кожне як правило, яке він мусить прочитати, перш ніж щось чіпати.

Як таке, відповідальність нікуди не переходить. Код мій, бо я встановив стандарт, за яким його міряють, і саме я сиджу в авто. Ніщо з того, що тримало його чесним, не є методом ШІ. Писати специфікацію до коду, записувати те, чого навчився, і збирати докази замість здогадок: так завжди робилася справжня інженерія. Інструмент цього не змінює. Він лише швидше показує, хто це пропускав.


  1. Apache License, Version 2.0 — ліцензія, за якою опубліковано код AutoNavAlerts. ↩︎

  2. 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». ↩︎ ↩︎

  3. Google — Navigation SDK for Android: real-time disruptions — «real-time disruptions are not available on Android Auto». ↩︎

  4. Google — Navigation SDK for Android: speed alerts — onSpeedingUpdated(float percentageAboveLimit, SpeedAlertSeverity speedAlertSeverity): відсоток понад обмеження й ступінь серйозності, а не саме обмеження. ↩︎

  5. googlemaps/flutter-navigation-sdk issue #726 — «Incident reporting on Android Auto & CarPlay», відкрито 17 червня 2026, досі відкрите. ↩︎

  6. Google Maps Platform — Get started — «you must create a billing-enabled Cloud project and enable the desired APIs or SDKs». ↩︎

  7. Google — Navigation SDK for Android: set up your project — «A Google Cloud console project with the Navigation SDK enabled.» ↩︎

  8. PocketGPSWorld — британська база камер швидкості, з якої синхронізується застосунок, через власну підписку кожного користувача. ↩︎

  9. Android Developers — Test using the Desktop Head Unit — емулятор автомобільного екрана Android Auto від Google. ↩︎