Perguntas frequentes sobre geocodificação

Esta seção de perguntas frequentes aborda questões específicas da API Geocoding. Consulte as Perguntas frequentes da Plataforma Google Maps para ver perguntas comuns a todos os produtos da Plataforma Google Maps. Consulte também Práticas recomendadas para geocodificar 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, consultas ambíguas, incompletas e mal formatadas, como endereços com erros ortográficos ou inexistentes, tendem a produzir ZERO_RESULTS. Se o endereço não for encontrado, ZERO_RESULTS é preferível a um resultado parcial (por exemplo, retornando apenas o subúrbio em vez de um endereço).

Se o app lida com a entrada de endereços do usuário, o recurso Place Autocomplete na API Places pode produzir resultados de melhor qualidade. O Place Autocomplete permite que os usuários selecionem entre um conjunto de resultados com base no que eles digitaram. Isso permite que os usuários escolham entre resultados com nomes semelhantes e ajustem a consulta se digitarem um endereço incorreto.

Se você tiver um aplicativo que lida com consultas ambíguas ou incompletas ou que possam conter erros, recomendamos usar o recurso Place Autocomplete na API Places em vez do geocodificador direto disponível na API Geocoding. Para mais detalhes, consulte as práticas recomendadas para endereços com geocodificação e a postagem do blog sobre a geocodificação de endereços nas APIs Google Maps.

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

Recomendamos que os aplicativos que respondem à entrada do usuário e, portanto, são 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 geocodificação de endereço. 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, bem formatados e sem ambiguidade, como endereços de entrega inseridos em formulários on-line, e, portanto, tem latência maior que o Place Autocomplete. O geocodificador direto tem maior cobertura e melhor qualidade de resultado, mas com latência um pouco maior.

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 passagem, 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 é consultada com uma string de endereço em vez de um ID de lugar ou latlng, elas usam o mesmo back-end da API Geocoding para converter esse endereço em um ID de lugar antes de calcular as rotas. O Place Autocomplete é mais rápido do que a geocodificação de endereços. Para aplicativos que usam a API Directions ou a API Distance Matrix em situações de alta latência, como responder à entrada do usuário, recomendamos usar o Place Autocomplete para receber os IDs de local correspondentes a esses endereços e transmiti-los à API Directions ou Distance Matrix. Essa abordagem reduz a latência significativamente. Consulte nossa documentação para conferir um exemplo de como usar o Place Autocomplete com direções.

Como faço para informar bugs no geocodificador?

Se você tiver relatórios de bugs ou solicitações de recursos para o serviço de geocodificador de encaminhamento, informe-nos usando nosso Issue Tracker público.

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

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

Como conseguir os melhores resultados com o geocodificador usando a filtragem de componentes?

No geocodificador, a filtragem de componentes impõe apenas 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 exemplo, substitua "YOUR_API_KEY" pela sua chave de API real.

  • Para restringir os CEPs a um país específico, especifique a restrição de país usando um código de país ISO 3166-2. Por exemplo: components=country:CH|postal_code:8000 retorna "8000 Zurique, Suíça". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Para restringir as consultas a um país específico, especifique a restrição de país usando um código de país ISO 3166-2. Não é possível garantir que os nomes de país e outras abreviações vão produzir 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, Alemanha. Isso ocorre porque o código de três letras da França (FRA) não é aceito. Portanto, os resultados em qualquer país são permitidos, e o resultado em Frankfurt é mais adequado do que qualquer coisa na França. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • A API Geocoding não vai necessariamente retornar vários resultados para consultas ambíguas. Essas consultas são melhor respondidas pelo Place Autocomplete.

    Exemplos:

    • A geocodificação de components=country:US|locality:madrid retorna "Madrid, NM 87010, EUA", mas nenhuma das outras cidades nos EUA com o nome "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 viewport usando location e radius para enviesar os resultados de localização gera uma resposta com várias cidades nos EUA com o nome "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