Monitore o uso da sua chave antes de atingir um limite
Acompanhar seus cabeçalhos de cota ao longo do caminho mostra quando um limite está se aproximando, bem antes de uma requisição ser realmente rejeitada.
Interprete corretamente uma pontuação de confiança antes de confiar nela
Um valor de confiança entre 0.0 e 1.0 em um resultado de geocodificação parece um simples sinal de aprovado ou reprovado, mas tratá-lo assim ignora o que ele realmente mede.
O que a confiança mede
A confiança reflete o quanto a correspondência tem certeza, com base no texto de entrada, de que esse resultado específico é aquele a que a entrada se referia. Uma pontuação de confiança alta para uma entrada ambígua ou com formatação estranha continua significando que o sistema confia no seu melhor palpite, e não que a entrada estava definitivamente correta ou que o local definitivamente existe como descrito.
GET /v1/forward?q=Main Street, Springfield&limit=1{
"status": "ok",
"query": "Main Street, Springfield",
"results": [
{"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
]
}Uma confiança de 0.62 aqui reflete o fato de que muitas cidades se chamam Springfield, então mesmo uma correspondência correta com uma Springfield específica carrega alguma incerteza inerente sobre se é a Springfield que a entrada queria dizer.
Confiança versus precisão
São dois campos diferentes que medem duas coisas diferentes. A precisão descreve o quão específica é a correspondência: casa, rua ou um nível mais amplo. A confiança descreve o quanto o sistema tem certeza da correspondência que fez. Um resultado com precisão "house" ainda pode ter uma pontuação de confiança moderada se a entrada era ambígua sobre qual casa em qual rua, e um resultado com precisão "street" pode ter uma pontuação de confiança alta se a correspondência, embora ampla, não era ambígua.
Definindo um limite
Escolha um limite de confiança com base no custo que um resultado errado teria para você. Um limite de 0.8 ou mais faz sentido para algo automatizado e com consequências, como preencher automaticamente uma etiqueta de envio sem revisão humana. Um limite mais baixo é razoável para algo em que uma pessoa confere o resultado depois, como uma sugestão mostrada a um cliente para confirmação.
Combinando com o parâmetro countries
Correspondências ambíguas como o exemplo de Springfield acima muitas vezes são resolvidas restringindo a busca com o parâmetro countries quando você já sabe em que país o endereço deve estar, o que aumenta as chances de uma correspondência de alta confiança na primeira tentativa, sem precisar de uma segunda consulta.
O custo continua o mesmo
Ler a confiança corretamente não muda o custo de uma consulta, que continua sendo uma requisição de qualquer forma. O que muda é se você age sobre o resultado com o nível certo de confiança.
A confiança é um sinal específico e restrito, não uma garantia geral de exatidão, e lê-la dessa forma evita agir rápido demais com base em uma correspondência duvidosa. As definições completas dos campos estão na documentação de geocodificação direta.