Dois pontos geocodificados a poucos metros de distância em um mapa podem representar tipos de correspondência fundamentalmente diferentes, e a diferença entre eles, geocodificação rooftop versus no nível da rua, é uma das distinções mais importantes escondidas por trás de um único ponto na tela.
A geocodificação rooftop coloca a coordenada retornada na localização real do edifício específico correspondente ao endereço, geralmente obtida a partir de dados reais de edificações ou de lotes que registram onde essa construção realmente fica. Essa é a categoria de correspondência mais precisa disponível, e é o que o nível de precisão house em uma resposta pretende representar: uma coordenada que corresponde a um edifício físico identificado, não uma estimativa de onde ele provavelmente está.
A geocodificação no nível da rua funciona de outra forma. Em vez de corresponder a um edifício específico conhecido, ela interpola uma posição ao longo de um trecho de via com base em onde o número solicitado estatisticamente deveria cair dentro da faixa conhecida de números daquele trecho, supondo uma distribuição mais ou menos uniforme dos endereços ao longo da rua. Isso gera uma coordenada que fica na via correta ou perto dela e aproximadamente no trecho certo, mas que é fundamentalmente uma estimativa baseada em padrões típicos de numeração, não uma localização confirmada daquele edifício específico.
A diferença entre as duas importa mais do que pode parecer à primeira vista, porque a interpolação no nível da rua supõe que a numeração seja razoavelmente uniforme e sequencial ao longo de um trecho, uma suposição que nem sempre se confirma. Onde uma rua foi ocupada de forma desigual, onde a numeração tem lacunas ou onde um trecho longo cobre uma ampla faixa de endereços distribuídos de forma desigual, um ponto interpolado pode cair a uma distância significativa, às vezes um edifício inteiro ou mais, da construção real, mesmo que o método esteja funcionando exatamente como foi projetado.
É exatamente essa distinção que o campo precision foi criado para mostrar, então ele deve sempre ser verificado, e não deduzido apenas a partir da coordenada, já que uma correspondência rooftop e uma interpolação no nível da rua podem gerar pontos visualmente parecidos em um mapa, com precisões reais bem diferentes. Para qualquer caso de uso em que a diferença realmente importa, como enviar um atendimento a um edifício exato em vez de a um vizinho, verificar especificamente a precisão house, em vez de aceitar qualquer resultado que caiu em algum ponto da rua certa, é a diferença entre confiar em uma correspondência confirmada e confiar em uma estimativa estatística.
Nosso endpoint de geocodificação direta informa a precisão real obtida em cada correspondência, justamente para que a sua aplicação consiga distinguir um resultado rooftop confirmado de uma interpolação no nível da rua antes de decidir o quanto confiar nele para o seu caso de uso específico.