Uma plataforma completa de rastreamento de frota era mais do que uma pequena empresa de logística realmente precisava para a única coisa específica que a sua equipe de despacho vivia pedindo: uma notificação simples no momento em que um caminhão de entregas chegava a um local de cliente específico e importante ou saía dele, útil para clientes que queriam aviso antecipado de uma entrega a caminho e para o registro da própria empresa de quando uma entrega realmente chegou ao destino, em vez de depender do relatório de fim de dia do próprio motorista.
Os componentes para isso eram mais simples do que uma plataforma completa de rastreamento, e a empresa já recebia coordenadas de GPS em fluxo contínuo dos seus veículos de entrega pelos dispositivos móveis que os motoristas levavam. O que faltava era uma forma de definir o local de um cliente como um limite e verificar as coordenadas recebidas em relação a ele, além de uma forma de interpretar uma coordenada bruta quando algo precisava de uma descrição legível por uma pessoa em vez de um par de números.
Para cada local de cliente importante, a empresa geocodificou o endereço pelo /v1/forward para obter uma coordenada de referência fixa e depois definiu um pequeno raio em torno desse ponto representando o limite de chegada ao local, uma verificação de raio simples em vez de um limite complexo com formato personalizado, já que um raio era preciso o suficiente para os locais reais da empresa, em sua maioria armazéns e docas de carga sem limites incomuns ou irregulares com que se preocupar. À medida que as coordenadas de GPS de um caminhão chegavam, o próprio backend da empresa calculava a distância de cada caminhão rastreado até o ponto de referência de cada local relevante, disparando um alerta de chegada quando um caminhão entrava no raio e um alerta de saída quando voltava a sair dele.
O /v1/reverse teve um papel de apoio no lado humano desse sistema: quando um despachante precisava revisar um alerta ou investigar um padrão inesperado, como um caminhão que parecia sair de um local e voltar imediatamente, ter a coordenada bruta resolvida em um endereço legível e em uma descrição do local tornava a revisão do despachante bem mais rápida do que trabalhar com um par de números em um mapa que exigia investigação manual para ser interpretado.
A empresa manteve isso deliberadamente simples, em vez de caminhar para uma plataforma completa de otimização de rotas ou de gestão de frota, já que o problema específico que estava resolvendo, alertas de chegada e saída para uma lista definida de locais importantes, não precisava da maior parte do que uma plataforma maior ofereceria, e construir apenas o necessário manteve o projeto pequeno o bastante para ser lançado rapidamente e mantido sem uma equipe de engenharia dedicada.
Os clientes que recebiam alertas de chegada relataram um valor real no aviso antecipado, principalmente aqueles com poucos funcionários no local, que precisavam de alguns minutos de antecedência para ter alguém pronto para receber uma entrega em vez de serem pegos de surpresa, uma pequena melhoria operacional para o cliente que custou relativamente pouco para a empresa de logística construir.
A geocodificação dos locais foi um custo de configuração pontual, pequeno considerando quão poucos locais de alta prioridade precisavam desse tratamento específico, e o uso da geocodificação reversa acompanhava a frequência com que um despachante precisava investigar um alerta específico, uma carga de trabalho leve e ocasional, e não constante. Os dois ficaram confortavelmente dentro da cota diária gratuita para uma empresa desse porte.
A documentação dos dois endpoints está em /docs/forward-geocoding/ e /docs/reverse-geocoding/.