O mapa da Google, os meus radares, uma app

Eu queria uma coisa no ecrã do carro. O mapa da Google, o trânsito da Google e as indicações curva a curva da Google, com os meus próprios dados de radares de velocidade por cima, a alertar-me só para os radares que estão realmente apontados para o meu lado da estrada.

Não encontrei nada no Android Auto que fizesse isso. O Google Maps tem o mapa e as rotas, mas não há maneira de lhe carregar a tua própria base de dados de radares. Por isso estou a construí-lo.

Chama-se AutoNavAlerts. É uma app de navegação para o Android Auto construída sobre o Navigation SDK da Google, com um sistema de alertas de radares e pontos de interesse escrito por cima. A primeira fonte de radares é a PocketGPSWorld, com a minha própria subscrição paga. O código é público sob a Apache License 2.01 em github.com/damo2929/AutoNavAlerts.

Esta é a parte um de uma série. Cobre o que a app faz, o que a Google deixa e não deixa uma app de terceiros fazer no ecrã de um carro, e como foi construída, porque quase cada linha foi escrita pelo Claude, o modelo de IA da Anthropic, comigo a definir as regras, a testá-la e a responder pelo resultado. Essa última parte é uma história por si só.

É a versão 0.1.0. É instalada à mão, não está na Play Store, e teve uma viagem real. Lê isto como um diário de construção, não como um lançamento de produto.

O que faz hoje

Eis o que está na versão de teste, e para que serve cada parte:

ÁreaO que faz
NavegaçãoMapa da Google com trânsito, pesquisa de locais, pré-visualização da rota com a hora de chegada, indicações curva a curva no ecrã do carro, na barra lateral e no painel do condutor
Ir até um contactoDiz ou escreve um nome e as moradas guardadas do contacto aparecem acima dos resultados do Places. Só a morada que escolhes vai para a Google
Convive com a tua músicaSó templates de navegação, por isso a música mantém o seu cartão no ecrã dividido. A fala dos alertas baixa a música, nunca a pausa
Alertas de radaresTrês fases por radar, só para radares virados para o teu sentido de marcha, na estrada em que estás
Zonas de velocidade médiaUma zona só começa quando há outro radar com o mesmo limite à tua frente, e acaba no último radar
Painel de velocidadeA tua velocidade e o limite da estrada, sempre lado a lado, em baixo à direita
Limites de velocidade offlineUm download dos limites do OpenStreetMap para o Reino Unido: 1 326 619 estradas em 29 MB no telemóvel. Nada é consultado durante a condução
Rotas para carro elétricoA rota mais rápida e a rota energeticamente eficiente da Google lado a lado, e és tu que escolhes
Dados de radaresA tua própria subscrição da PocketGPSWorld, verificada diariamente, nunca trocada enquanto estás a navegar. Ou importa ficheiros iGO, KML, GPX, OV2 ou CSV
Reportar um radarUm toque no carro guarda a posição, o rumo e o limite, com um comentário falado opcional. A revisão e o envio acontecem no telemóvel, nunca durante a condução

Os alertas de radares são a razão de a app existir, por isso ficam com a secção seguinte.

Um radar só conta se estiver virado para ti

Um alerta de radar que dispara para a outra faixa de rodagem é pior do que nenhum alerta. Treina-te para ignorar a coisa. Por isso a primeira regra rígida do design é que um radar só alerta quando está virado para o teu sentido de marcha, e essa regra nunca é afrouxada, nunca é contornada por uma predefinição e nunca é largada quando os dados são complicados.

Como uma posição GPS se torna um alerta de radarEntradaQuatro verificações, cada posiçãoSaídavelocidade e GPS do carroquando o carro os partilhaGPS do telemóvel10 posições por segundoos teus conjuntos de radaresno telemóvel1. perto o suficiente2. à tua frente3. virado para ti4. na tua estradaaviso nomapa do carroalerta falado,música baixadaradar realçadono mapafalha numa verificação: sem alerta; virado ao contrário fica esbatido com a seta
Como uma posição se torna um alerta. Até dez posições por segundo passam por quatro verificações; só um radar que passe as quatro é falado e levantado como alerta.

O motor corre em cada posição GPS, até dez por segundo. Para cada radar próximo faz quatro perguntas, por ordem:

VerificaçãoPassa quandoPorque está lá
Perto o suficientedentro da distância de disparo mais 200 m, com um máximo de 3 kmnenhum trabalho gasto em radares a quilómetros
À tua frenterumo até ao radar a menos de 45° do teu rumoum radar atrás de ti é história
Virado para o teu ladoo rumo do radar a menos de 45° do teu rumo, ou do rumo até ao radar numa curvaa outra faixa fica em silêncio
Na tua estradaa menos de 50 m da rota à frente, ou num corredor de 40 m que alarga com a distância em condução livrea estrada paralela fica em silêncio

Os 45° não são generosos. Os ficheiros TomTom da PocketGPSWorld dão a direção de um radar em oito pontos cardeais, por isso 22,5° vão-se logo nos dados antes de mais nada. Um rumo GPS custa mais uns graus, e a curva da estrada mais uns quantos. É por isso que mais nada pode comer essa margem.

Um radar que falha a verificação de direção continua desenhado no mapa, esbatido, com uma seta a mostrar para onde está virado. Consegues vê-lo. Só não fala contigo.

Três fases de alerta a 70 mphAntecedência predefinida: 15 segundos à tua velocidade, aqui 70 mphtu, 70 mphradarvirado para tioutra faixa, virado ao contrário: esbatido, calado1.º alertaa 469 m, 15 s2.º alertaa 235 m, 7,5 spassagem100 yd (91 m)fora de escala; mínimos de 242 m e 142 m separam os dois primeiros a baixa velocidade
As três fases a 70 mph com a antecedência predefinida de 15 segundos. As duas primeiras são calculadas a partir da tua velocidade; o alerta de passagem é fixo nas 100 jardas e não pode ser desligado enquanto o som estiver ligado.

As fases são temporizadas, não distâncias fixas. O primeiro alerta chega 15 segundos antes à tua velocidade atual e o segundo a metade disso, ambos com um mínimo para nunca se encavalitarem no terceiro. O terceiro é fixo nas 100 jardas, e é obrigatório sempre que o som estiver ligado. A distância de disparo só cresce numa aproximação, por isso travar a fundo não encurta o aviso a que já tinhas direito.

O que a Google deixa uma app fazer no ecrã do carro

É aqui que fica interessante, porque uma app de terceiros no Android Auto não é o Google Maps. Corre dentro das regras definidas pela Car App Library do Android Auto, que dá às apps «a set of visual templates approved for driver safety»2, e dentro do que o Navigation SDK decide expor.

Três lacunas moldaram a app mais do que qualquer coisa que eu tenha escolhido construir:

O quêGoogle Maps no carroUma app sobre o Navigation SDK
Reportar um acidente, polícia ou obrasincorporadonão disponível. A própria documentação da Google: «real-time disruptions are not available on Android Auto»3
O limite de velocidade da estradamostradosó a percentagem acima dele, e só enquanto vais em excesso4
Toque nos controlos de mapa do próprio SDKn/anenhum. O Android Auto «limits screen surface interaction to a series of SurfaceCallback methods»2

Pega no limite de velocidade. A Google sabe-o. A Google diz a uma app quanto acima dele vais, como percentagem e gravidade, e nada de nada enquanto estás abaixo. Posso perguntar porque é que um condutor só pode saber o limite depois de já o estar a infringir? Não vou ter resposta a isso, por isso a app contorna-o. Enquanto estás acima, calcula o limite a partir da tua velocidade e da percentagem. Abaixo dele, usa o radar de que te estás a aproximar, depois o download do OpenStreetMap, e mostra um traço em vez de nada quando não tem limite nenhum.

O reporte de incidentes tem a mesma forma. As APIs de reporte existem na vista de navegação do telemóvel e não na do carro. Já alguém o pediu à Google5, e o pedido continua aberto. A app procura as APIs em tempo de execução, por isso, se um SDK posterior as acrescentar, o botão de reporte da Google aparece sem qualquer alteração ao meu código. Uma tarefa do GitHub Actions verifica a cada trimestre e abre um issue no dia em que acontecer.

A regra do toque apanhou-me a sério. O mapa do carro do SDK desenha o seu próprio cartão de chegada, cabeçalho, botão de recentrar, velocímetro e barra de viagem. Nenhum deles aceita um toque, porque nenhum toque chega à vista do SDK. Parecem botões e não fazem nada. Por isso estão todos desligados, e a app desenha os seus próprios controlos onde um toque chega de facto.

Traz a tua própria chave, traz os teus próprios dados

Duas decisões mantêm esta app honesta quanto a dinheiro e licenças, e ambas são deliberadas.

Não há chave do Maps incorporada. A Google Maps Platform precisa de «a billing-enabled Cloud project»6, e o Navigation SDK precisa de um projeto com ele ativado7. Se eu distribuísse uma chave, a condução de toda a gente seria faturada a mim, ou a chave fugia e era faturada a mim na mesma. Por isso cada utilizador traz a sua própria chave, na sua própria conta Google Cloud. A app do telemóvel consegue criar uma com a tua própria conta Google, ou colas uma. Fica guardada encriptada no telemóvel. Não há recurso de espécie nenhuma, e a app não faz uma única chamada ao SDK até a tua chave estar lá.

Não há dados de radares na app. A PocketGPSWorld licencia a sua base de dados para uso individual, põe uma marca de água em cada download com o nome do membro, e proíbe colocá-la em qualquer sítio onde alguém além do comprador lhe possa chegar. Por isso a app nunca a distribui, nunca a aloja e nunca a sincroniza entre telemóveis. Inicias sessão com a tua própria subscrição, e o telemóvel descarrega a tua própria cópia com marca de água para um armazenamento privado excluído das cópias de segurança. Na bancada foram 19 826 radares em 33 conjuntos, um conjunto por ficheiro, nunca fundidos.

A sincronização automática é educada nisso. Lê o feed RSS público da PocketGPSWorld uma vez por dia8 e só inicia sessão quando há uma versão nova. Nunca troca os radares enquanto estás a navegar.

Há uma cláusula na licença deles que isto não resolve por completo, a que fala de incorporar os dados numa aplicação. Para uso meu, aceito isso. Antes de a app ir para mais alguém, a PocketGPSWorld recebe um email a perguntar.

Dois dias, 87 commits, e primeiro um documento de design

Agora a parte sobre a qual as pessoas vão discutir. Não fui eu que escrevi este código. Foi o Claude, através do Claude Code, com dois modelos, o Claude Fable e o Claude Opus. Eu escrevi os requisitos, tomei todas as decisões, corri a bancada, conduzi o carro e revi o que voltava. Cada commit com alterações escritas por IA leva um trailer que o diz, e o README também.

Estes são os números, lidos do repositório:

MedidaValor
Commits87, das 22:10 de 11 de outubro às 12:44 de 13 de outubro de 2026
Commits com uma linha de coautor Claude83 (56 Fable, 27 Opus)
Kotlin na app e na sua biblioteca central15 334 linhas
Testes unitários211, em 3464 linhas
DESIGN.md, a especificação1763 linhas, escritas antes de qualquer código

O documento de design veio primeiro, e essa é a coisa mais útil que posso dizer a quem quer que esteja a fazer isto. A sua primeira linha diz que nenhum código é escrito até ser aprovado, e que qualquer alteração posterior é feita lá primeiro. Cada classe tem uma função escrita ao lado. Cada limiar tem uma razão. Cada regra que defini está marcada como minha, com a data.

Isso importa porque um modelo esquece-se. Uma sessão longa é resumida, e o resumo fica com a ideia geral e larga o pormenor, e é no pormenor que estão os bugs. O próprio AGENTS.md do repositório di-lo às claras: não confies num resumo destes ficheiros de memória ou de uma sessão anterior. O agente volta ao documento. Sempre.

Dois agentes também trabalharam em paralelo na segunda fase, um na orientação, no mapa e nos ecrãs, o outro na localização, nos alertas, na fala e nos marcadores do mapa. Cada um era dono de uma lista escrita de ficheiros, e as interfaces entre eles foram fixadas de antemão: acrescenta, não mudes o nome. Fundiram-se sem problemas porque a fronteira foi decidida antes de qualquer um começar, não descoberta depois.

Cada regra rígida veio de algo que eu vi

O design tem uma lista de regras rígidas, e nenhuma delas veio de um quadro branco. Cada uma veio de ver a coisa a correr na Desktop Head Unit9, o emulador do ecrã do carro da Google no PC, ou no carro, e de a ver fazer algo errado.

Regra rígidaO que vi que a tornou uma regra
Um radar só alerta quando está virado para o teu ladoalertas para a outra faixa são ruído que te ensina a ignorar alertas
Nada no ecrã do carro que não funcionedois botões de parar no ecrã, um deles morto
Nenhuma função mostrada duas vezesesse mesmo par, mais dois botões de recentrar, dois mostradores de velocidade
Um só cancelar, o da Googleo cartão no canto com o X é o do próprio Android Auto, desenhado a partir da viagem que a app publica, por isso o botão de parar da app saiu
Nada a tremer no ecrã do carroo ecrã More a tremer com o carro estacionado, porque reenviava um ecrã idêntico a cada segundo e o Android Auto anima cada atualização
Todos os botões do lado direitoos botões do mapa ficavam em cima à esquerda até o ecrã do carro reportar o seu tamanho; agora uma coluna pela margem direita desde o início, nada nosso à esquerda
Nenhuma chave do Maps incorporada, nuncaa condução de ninguém é faturada a outra pessoa

O tremor é o meu preferido, porque é tão pequeno e teria passado. Uma linha de GPS ao vivo atualizava uma vez por segundo. Cada atualização reenviava o ecrã inteiro, sem alterações, e o host animava-o, por isso todas as linhas abaixo abanavam com o carro parado. A correção é uma comparação: só redesenhar quando uma linha mudou. A regra é maior do que a correção. Um ecrã que está parado tem de parecer parado, e isso é verificado com uma rajada de capturas de ecrã que têm de ser idênticas.

Esse é o verdadeiro trabalho quando uma IA escreve o código. Não se cansa e não se importa de reescrever, mas não consegue ver o ecrã do carro. Tu consegues. Escrever o que viste como uma regra, com a data, é o que impede que volte três sessões depois.

O que o código fez mal, e como foi apanhado

Muita coisa. Nada disso foi exótico, e cada uma foi apanhada a correr o código, não a lê-lo:

FalhaO que faziaComo foi apanhada
Rota associada ao troço erradoA rota da Google a partir de um carro estacionado ia para norte, fazia inversão de marcha numa rotunda e voltava para sul pela mesma estrada. O associador prendeu o carro ao troço para norte, a 10 m, por isso cada radar para sul ficava «fora da estrada» por mais de um quilómetro. Nada alertouuma condução simulada por script na bancada; o registo de alertas dizia offRoad lateral=1204 para cada radar
Watchdog da fala demasiado curtopermitia 1,5 s mais 70 ms por carácter. Os números demoram mais a dizer do que isso, por isso cada alerta da segunda fase era cortado a meio da fraseos registos de fala de uma execução na bancada
Um limite de frequência no motorcom uma janela de três segundos, de dois radares num cruzamento, um perdia-se de vezseguir os alertas que ficaram em silêncio na primeira viagem real
Um rumo desatualizadoo emulador reporta um rumo de 0° faças o que fizeres, por isso numa estrada para sul cada radar falhava a verificação de direçãouma execução simulada pela A61 abaixo
Mudanças de limite faladas como alertas de radaruma mudança de limite à frente era posta na fila como alerta de radar da primeira faseo registo de fala na bancada

A segunda merece uma pausa. Cada teste individual passou. O código estava correto pela sua própria medida. Só tinha um timeout escolhido por alguém que nunca tinha ouvido um telemóvel ler uma distância em voz alta. O teste que apanha isso é uma voz real, cronometrada, numa execução real.

A primeira viagem real

A 12 de outubro pus uma versão de produção no meu telemóvel e levei-a no XPENG G6 com Android Auto sem fios. Duas coisas correram mal. Uma rota definida com o carro parado apagou-se a si própria segundos depois de arrancar. E alguns alertas eram falados e outros não, sem nenhum padrão que eu conseguisse ver.

Depois o problema pior. Não ficou nada para ler. O ColorOS do meu telemóvel deita fora as linhas de registo da app, por isso a viagem não deixou prova nenhuma. Foi a app, o SDK da Google ou o próprio Android Auto? Não sabia dizer.

Por isso a correção para a primeira viagem não foi uma alteração de código. Foi prova. A app agora escreve dois registos no telemóvel o tempo todo, um para as rotas e o mapa e outro para cada decisão de alerta, em lotes de 15 segundos, mais um gravador de viagem opcional que guarda cada posição para que uma viagem possa ser repetida na bancada. Depois os palpites foram corrigidos, cada um reescrito para fazer menos e registar que o fez. Cada forma de a orientação terminar regista agora quem a terminou.

Na bancada, desde então, o Android Auto chamou parar uma vez, 2 minutos e 35 segundos depois do início de uma condução guiada. Eu estava a clicar pela head unit na altura, por isso o mais provável foi o X no seu próprio cartão. Não voltou a acontecer sem ninguém a tocar no ecrã. A próxima viagem vai resolver a questão, porque desta vez a viagem deixa rasto.

O que vem a seguir

A lista da bancada ainda é longa. As próximas viagens verificam o botão de cancelar, os cenários de curva e de sentido contrário, a passagem entre o GPS do carro e o do telemóvel, e se o painel do condutor no G6 mostra de todo cartões de manobra de uma app de terceiros.

As partes seguintes desta série entram a sério na matemática do motor de alertas, nos truques para o limite de velocidade, nos formatos da PocketGPSWorld e na própria bancada: como testas uma app de Android Auto sem carro, com um GPS por script e um emulador que acha que todas as estradas vão para norte.

A máquina escreve, o padrão é teu

Já vi muita conversa sobre IA a escrever código, a maior parte de gente que a vende ou de gente que tem medo dela. O que encontrei é mais aborrecido do que as duas coisas, e mais útil.

Escreve depressa e não se aborrece. Reescreve um ecrã pela quarta vez sem um suspiro. O que não faz é reparar que o ecrã More treme, ou que uma frase foi cortada, ou que um botão morto está ao lado de um vivo. Não consegue ver o carro. Isso cabia-me a mim ver, e a única razão pela qual está corrigido é que escrevi cada coisa como uma regra que tem de ler antes de tocar em seja o que for.

Por isso, a responsabilidade não sai do sítio. O código é meu porque fui eu que defini o padrão a que é sujeito e sou eu que vou no carro. Nada do que o manteve honesto é um método de IA. Escrever a especificação antes do código, escrever o que aprendes e guardar provas em vez de adivinhar é como a engenharia a sério sempre foi feita. A ferramenta não muda isso. Só torna mais rápido descobrir quem andava a saltar esse passo.


  1. Apache License, Version 2.0 — a licença sob a qual o código do AutoNavAlerts é publicado. ↩︎

  2. Google — Navigation SDK for Android: Android Auto — a Car App Library fornece «a set of visual templates approved for driver safety», e «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): a percentagem acima do limite e uma gravidade, não o limite em si. ↩︎

  5. googlemaps/flutter-navigation-sdk issue #726 — «Incident reporting on Android Auto & CarPlay», aberto a 17 de junho de 2026, ainda aberto. ↩︎

  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 — a base de dados britânica de radares de velocidade a partir da qual a app sincroniza, com a subscrição de cada utilizador. ↩︎

  9. Android Developers — Test using the Desktop Head Unit — o emulador da Google para o ecrã do carro do Android Auto. ↩︎