O problema das chaves de API que nunca expiram
Uma chave emitida anos atrás, nunca trocada e ainda válida hoje não é uma conveniência. É um risco que ninguém examina de verdade há anos.
Latitude e longitude retornadas com quinze casas decimais parecem impressionantemente exatas. A décima quinta casa decimal de uma coordenada corresponde a uma distância menor que um átomo, o que deveria ser um sinal imediato de que a precisão exibida não tem nada a ver com a exatidão da correspondência subjacente. Um resultado de geocodificação derivado do centroide de uma área postal, de uma correspondência no nível do telhado ou de uma estimativa aproximada de área não fica mais exato porque a resposta traz mais dígitos depois da vírgula. Ele só traz mais dígitos.
Essa distinção, precisão versus exatidão, é borrada o tempo todo na forma como os dados de localização são apresentados. Precisão é quantos dígitos um número tem. Exatidão é o quão perto esse número realmente está da localização real. Uma coordenada pode ser extremamente precisa e consideravelmente errada, e um formato de resposta que destaca uma longa sequência decimal convida o leitor a supor que as duas coisas são iguais, quando elas não têm nenhuma relação além do fato de que uma pode disfarçar a ausência da outra.
Achamos que o mais honesto que uma resposta pode fazer é descrever que tipo de correspondência realmente produziu a coordenada, em vez de depender do número de casas decimais para sugerir um nível de confiança que o método subjacente pode não sustentar. Uma correspondência no nível do telhado e um recurso ao centroide da cidade são diferentes em natureza, não só em precisão decimal, e reduzir essa diferença a "mais casas decimais é melhor" esconde justamente a informação de que um desenvolvedor precisa para decidir se um resultado é bom o suficiente para o seu caso de uso, seja para colocar um marcador em um mapa ou para definir a rota de um veículo de entrega.
Isso se liga diretamente ao motivo pelo qual somos cuidadosos com a forma como descrevemos nossos próprios endpoints de geocodificação direta, geocodificação reversa e preenchimento automático. Seria fácil retornar coordenadas com uma longa cauda decimal e deixar isso substituir uma afirmação de confiança que não estamos preparados para fazer com clareza. Preferimos ser específicos sobre o que o endpoint retorna e deixar que as informações reais da correspondência falem por si, em vez de nos apoiar na formatação decimal para sugerir mais do que os dados subjacentes justificam.
Há uma lição prática aqui para qualquer pessoa que consome uma API de geocodificação, não só sobre como escolhemos construir a nossa: casas decimais em uma coordenada não são prova de qualidade. O que importa é se a resposta diz, em termos simples, o que realmente foi encontrado, em que nível de especificidade, para que você possa decidir por conta própria se essa resposta específica é boa o suficiente para a decisão que vai tomar com ela. Uma longa sequência de dígitos depois da vírgula responde a uma pergunta sobre formatação. Ela não responde à pergunta que realmente importa, que é se o ponto no mundo descrito por esses dígitos é o certo.