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:
| Área | O que faz |
|---|---|
| Navegação | Mapa 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 contacto | Diz 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úsica | Só 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 radares | Três fases por radar, só para radares virados para o teu sentido de marcha, na estrada em que estás |
| Zonas de velocidade média | Uma zona só começa quando há outro radar com o mesmo limite à tua frente, e acaba no último radar |
| Painel de velocidade | A tua velocidade e o limite da estrada, sempre lado a lado, em baixo à direita |
| Limites de velocidade offline | Um 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étrico | A rota mais rápida e a rota energeticamente eficiente da Google lado a lado, e és tu que escolhes |
| Dados de radares | A 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 radar | Um 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.
O motor corre em cada posição GPS, até dez por segundo. Para cada radar próximo faz quatro perguntas, por ordem:
| Verificação | Passa quando | Porque está lá |
|---|---|---|
| Perto o suficiente | dentro da distância de disparo mais 200 m, com um máximo de 3 km | nenhum trabalho gasto em radares a quilómetros |
| À tua frente | rumo até ao radar a menos de 45° do teu rumo | um radar atrás de ti é história |
| Virado para o teu lado | o rumo do radar a menos de 45° do teu rumo, ou do rumo até ao radar numa curva | a outra faixa fica em silêncio |
| Na tua estrada | a menos de 50 m da rota à frente, ou num corredor de 40 m que alarga com a distância em condução livre | a 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.
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 carro | Uma app sobre o Navigation SDK |
|---|---|---|
| Reportar um acidente, polícia ou obras | incorporado | nã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 estrada | mostrado | só a percentagem acima dele, e só enquanto vais em excesso4 |
| Toque nos controlos de mapa do próprio SDK | n/a | nenhum. 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:
| Medida | Valor |
|---|---|
| Commits | 87, das 22:10 de 11 de outubro às 12:44 de 13 de outubro de 2026 |
| Commits com uma linha de coautor Claude | 83 (56 Fable, 27 Opus) |
| Kotlin na app e na sua biblioteca central | 15 334 linhas |
| Testes unitários | 211, em 3464 linhas |
DESIGN.md, a especificação | 1763 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ígida | O que vi que a tornou uma regra |
|---|---|
| Um radar só alerta quando está virado para o teu lado | alertas para a outra faixa são ruído que te ensina a ignorar alertas |
| Nada no ecrã do carro que não funcione | dois botões de parar no ecrã, um deles morto |
| Nenhuma função mostrada duas vezes | esse mesmo par, mais dois botões de recentrar, dois mostradores de velocidade |
| Um só cancelar, o da Google | o 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 carro | o 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 direito | os 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, nunca | a 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:
| Falha | O que fazia | Como foi apanhada |
|---|---|---|
| Rota associada ao troço errado | A 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 alertou | uma condução simulada por script na bancada; o registo de alertas dizia offRoad lateral=1204 para cada radar |
| Watchdog da fala demasiado curto | permitia 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 frase | os registos de fala de uma execução na bancada |
| Um limite de frequência no motor | com uma janela de três segundos, de dois radares num cruzamento, um perdia-se de vez | seguir os alertas que ficaram em silêncio na primeira viagem real |
| Um rumo desatualizado | o 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ção | uma execução simulada pela A61 abaixo |
| Mudanças de limite faladas como alertas de radar | uma mudança de limite à frente era posta na fila como alerta de radar da primeira fase | o 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.
Apache License, Version 2.0 — a licença sob a qual o código do AutoNavAlerts é publicado. ↩︎
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». ↩︎ ↩︎
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): a percentagem acima do limite e uma gravidade, não o limite em si. ↩︎googlemaps/flutter-navigation-sdk issue #726 — «Incident reporting on Android Auto & CarPlay», aberto a 17 de junho de 2026, ainda aberto. ↩︎
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 — a base de dados britânica de radares de velocidade a partir da qual a app sincroniza, com a subscrição de cada utilizador. ↩︎
Android Developers — Test using the Desktop Head Unit — o emulador da Google para o ecrã do carro do Android Auto. ↩︎