Perguntas frequentes sobre geocodificação

Nesta página, você encontra perguntas específicas sobre a API Geocoding. Consulte as perguntas frequentes da Plataforma Google Maps para ver perguntas comuns sobre toda a Plataforma Google Maps. Veja também Práticas recomendadas para geocodificação de endereços.

Solução de problemas

Solução de problemas

Estou recebendo mais consultas que retornam ZERO_RESULTS com o geocodificador. O que está acontecendo?

No geocodificador, as consultas ambíguas, incompletas e mal formatadas, como endereços errados ou inexistentes, são propensas a produzir ZERO_RESULTS. Se o endereço não for encontrado, ZERO_RESULTS é preferível a um resultado parcial (por exemplo, retornar somente o subúrbio em vez de um endereço).

Se o aplicativo lidar com a entrada de endereços do usuário, o recurso Place Autocomplete na API Places pode produzir resultados de melhor qualidade. Com o Place Autocomplete, os usuários podem selecionar um conjunto de resultados com base no que digitaram. Assim, eles podem escolher entre resultados com nomes semelhantes e ajustar a consulta caso tenham digitados um endereço incorretamente.

Se você tem um aplicativo que lida com consultas ambíguas ou incompletas ou com consultas que podem conter erros, recomendamos usar o recurso Place Autocomplete na API Places, não o geocodificador disponível na API Geocoding. Para mais detalhes, consulte o artigo Práticas recomendadas para geocodificação de endereços e Postagem do blog sobre geocodificação na Pesquisa Google.

Preciso de respostas rápidas, e o geocodificador é muito lento para meu aplicativo. O que posso usar para respostas mais rápidas?

Recomendamos que aplicativos que respondam à entrada do usuário e, portanto, sejam altamente sensíveis à latência, usem o recurso Place Autocomplete na API Places, também disponível em JavaScript, Android ou iOS, em vez de usar a geocodificação de endereços. O Place Autocomplete foi otimizado para uso interativo e, portanto, tem muito pouca latência.

A geocodificação de endereços na API Geocoding é otimizada para uso com endereços completos, não ambíguos e bem formatados, como endereços de entrega inseridos em formulários on-line e, portanto, com maior latência do que o Place Autocomplete. O geocodificador inverso tem mais cobertura e melhor qualidade de resultado, mas com latência um pouco mais alta.

Como posso reduzir a latência na API Directions e na API Distance Matrix?

Em vez de endereços, use IDs de lugar para especificar pontos de referência, origem e destino. Os IDs de lugar são melhor obtidos com o recurso Place Autocomplete na API Places ou a biblioteca Places na API Maps JavaScript. Consulte também as informações sobre a opção placeIdOnly, que pode ser usada para reduzir o custo do Place Autocomplete.

Quando a API Directions ou a API Distance Matrix são consultadas com uma string de endereço em vez de um ID de lugar ou latlng, elas usam o mesmo back-end que a API Geocoding para converter esse endereço em um ID de lugar antes de calcular as rotas. O Place Autocomplete é mais rápido que a geocodificação de endereço. Para aplicativos que usam a API Directions ou a API Distance Matrix em situações altamente sensíveis à latência, como responder à entrada do usuário, recomendamos que você use o Place Autocomplete para ver os IDs de lugar correspondentes a esses endereços e transmiti-los à API Directions ou à API Distance Matrix. Essa abordagem reduz significativamente a latência. Consulte nossa documentação para ver um exemplo de como usar o Place Autocomplete com rotas.

Como faço para informar bugs no geocodificador?

Se você tiver algum relatório de bugs ou solicitações de recursos para o serviço de geocodificador inverso, entre em contato usando nosso rastreador público de problemas.

O geocodificador não está gerando bons resultados para meu caso de uso. Como consigo ajuda?

Informe nossa equipe usando nosso rastreador de problemas público para compartilhar algumas consultas específicas. Assim, podemos investigar se há bugs ou problemas sistêmicos que causam problemas na qualidade dos resultados ou se há alguma mudança que podemos fazer no guia de práticas recomendadas para ajudar os desenvolvedores a conseguir resultados melhores.

Como faço para ter os melhores resultados com o geocodificador usando a filtragem de componentes?

No geocodificador, a filtragem de componentes aplica apenas as restrições postal_code e country. Os exemplos a seguir ilustram a melhor forma de usar a filtragem de componentes, dependendo dos resultados necessários. Nos URLs de solicitação de amostra, não deixe de substituir "YOUR_API_KEY" pela sua chave de API.

  • Para restringir códigos postais a um país específico, use uma código ISO 3166-2 de país. Por exemplo: components=country:CH|postal_code:8000 retorna "quot;8000 Zurique, Suíça". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Para restringir consultas a um país específico, use uma código ISO 3166-2 de país. Os nomes de países e outras abreviações não garantem os mesmos resultados que os códigos de país.

    Exemplos:

    • A geocodificação para components=country:FRA|locality:gallus retorna a sublocalidade de Gallus em Frankfurt am Main, na Alemanha. Isso ocorre porque o código de três letras do país para a França (FRA) não é compatível, e os resultados são permitidos em qualquer país. Assim, o resultado em Frankfurt é mais adequado do que em qualquer país da França. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • A API Geocoding não retorna necessariamente vários resultados para consultas ambíguas. Essas consultas são melhor respondidas pelo Place Autocomplete.

    Exemplos:

    • A geocodificação para components=country:US|locality:madrid retorna "Madrid, NM 87010, EUA" mas nenhuma das outras cidades dos EUA chamada "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • O uso do Place Autocomplete para input=madrid&components=country:us&types=(regions) e a especificação de uma janela de visualização com location e radius para polarizar os resultados de local gera uma resposta com várias cidades nos EUA chamadas "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY