Perguntas frequentes sobre geocodificação

Estas perguntas frequentes abordam questões específicas da API Geocoding. Consulte as Perguntas frequentes sobre a Plataforma Google Maps para tirar suas dúvidas sobre a plataforma de forma geral. Consulte também as 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, consultas ambíguas, incompletas e mal formatadas, como endereços com erros de ortografia ou inexistentes, tendem a produzir ZERO_RESULTS. Se o endereço não for encontrado, ZERO_RESULTS será preferível a um resultado parcial (por exemplo, retornar apenas o bairro em vez de um endereço).

Se o aplicativo lida 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 digitam. Assim, é possível escolher entre resultados com nomes semelhantes e ajustar a consulta se um endereço for digitado incorretamente.

Se você tiver um aplicativo que lida com consultas ambíguas ou incompletas ou que podem 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 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 receber respostas mais rápidas?

Recomendamos que 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 da 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, inequívocos e bem formatados, como endereços de entrega inseridos em formulários on-line, e, portanto, tem uma latência maior do que o Place Autocomplete. O geocodificador direto tem maior cobertura e melhor qualidade de resultados, mas com uma latência um pouco maior.

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

Em vez de endereços, use IDs de lugar para especificar pontos de referência, origem e destino. A melhor maneira de obter IDs de lugar é usando 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 (legada) ou a API Distance Matrix (legada) é 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 que a geocodificação de endereços. Para aplicativos que usam as APIs Directions (legada) ou API Distance Matrix (legada) em situações altamente sensíveis à latência, como responder à entrada do usuário, recomendamos usar o Place Autocomplete para receber os IDs de lugar correspondentes a esses endereços e transmitir os IDs para as APIs Directions (legada) ou API Distance Matrix (legada). 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 relatórios de bugs ou solicitações de recursos para o serviço de geocodificação direta, use nosso Issue Tracker público.

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

Informe-nos usando nosso Issue Tracker público e compartilhe algumas consultas específicas para que possamos investigar se há bugs ou problemas sistêmicos que causam problemas na qualidade dos resultados ou se há mudanças que podemos fazer no guia de práticas recomendadas para ajudar os desenvolvedores a conseguir resultados melhores.

Como consigo 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 maneira 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 códigos postais 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, use a restrição de país ISO 3166-2. Nomes de países e outras abreviações podem não produzir os mesmos resultados que os códigos de país.

    Exemplos:

    • O geocódigo para components=country:FRA|locality:gallus retorna a sublocalidade de Gallus em Frankfurt am Main, Alemanha. Isso acontece porque o código de país de três letras da França (FRA) não é compatível. Assim, 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 necessariamente retorna 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, USA", mas nenhuma das outras cidades nos EUA chamadas "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Usar o Place Autocomplete para input=madrid&components=country:us&types=(regions) e também especificar uma janela de visualização usando location e radius para influenciar os resultados de localização 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