Perguntas frequentes sobre geocodificação

Estas perguntas frequentes abordam questões específicas sobre a 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 Práticas recomendadas ao geocodificar endereços.

Solução de problemas

Solução de problemas

Recebo 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, são propensas 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 subúrbio em vez de um endereço).

Se o aplicativo lida com a entrada de endereços do usuário, o recurso Place Autocomplete da 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, escolher entre resultados com nomes semelhantes e ajustar a consulta em caso de erro de digitação de um endereço.

Se você tem um aplicativo que lida com consultas ambíguas ou incompletas ou que podem conter erros, recomendamos usar o recurso Place Autocomplete da API Places em vez do geocodificador inverso disponível na API Geocoding. Para mais detalhes, consulte Práticas recomendadas para geocodificar endereços 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 os aplicativos que respondem à entrada do usuário e, portanto, são altamente sensíveis à latência, usem o recurso Place Autocomplete da 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ço da 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. Portanto, a latência é maior do que o Place Autocomplete. O geocodificador inverso tem maior cobertura e melhor qualidade de resultado, mas com latência um pouco maior.

Como posso reduzir a latência nas APIs Directions e Distance Matrix?

Em vez de endereços, use IDs de lugar para especificar waypoints, a origem e o destino. É melhor conseguir os IDs de lugares usando o recurso Place Autocomplete da API Places ou a biblioteca Places da API Maps JavaScript. Veja 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 latitude/longitude, elas usam o mesmo back-end que a API Geocoding para converter o endereço em um ID de local antes de calcular a rota. O Place Autocomplete é mais rápido que a geocodificação de endereços. Em aplicativos que usam a API Directions ou a API Distance Matrix em situações sensíveis à latência, como responder a entradas do usuário, recomendamos o uso do Place Autocomplete para ver os IDs de lugar correspondentes a esses endereços e transmiti-los para a API Directions ou API Distance Matrix. Essa abordagem reduz a latência significativamente. Consulte nossa documentação para ver um exemplo de como usar o Place Autocomplete com rotas.

Como informo bugs no geocodificador?

Se você tiver algum relatório de bugs ou solicitação de recurso para o serviço de geocodificador avançado, 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 nossa equipe usando nosso Issue Tracker público, compartilhando algumas consultas específicas para que possamos investigar se há bugs ou problemas sistêmicos causando problemas com a qualidade dos resultados ou se há alguma mudança que podemos fazer no guia de práticas recomendadas para ajudar os desenvolvedores a ter resultados melhores.

Como posso receber 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 exemplo, substitua "YOUR_API_KEY" pela sua chave de API real.

  • Para restringir 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, especifique a restrição usando um código de país ISO 3166-2. Não há garantia de que nomes de países e outras abreviações produzam 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 do país de três letras da França (FRA, na sigla em inglês) não é aceito. Portanto, resultados em qualquer país são permitidos e o resultado em Frankfurt é melhor do que qualquer outro país 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 retornará necessariamente vários resultados para consultas ambíguas. É melhor responder a essas consultas pelo Place Autocomplete.

    Exemplos:

    • A geocodificação para components=country:US|locality:madrid retorna "Madrid, NM 87010, USA", mas nenhuma das outras cidades dos 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), além de especificar uma janela de visualização com location e radius para direcionar os resultados de localização, gera uma resposta com várias cidades dos 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