Perguntas frequentes sobre geocodificação

Estas perguntas frequentes abordam questões específicas sobre a API Geocoding. Em caso de dúvidas, consulte as Perguntas frequentes sobre a Plataforma Google Maps comuns a toda a Plataforma Google Maps. 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 inexistentes ou com erros ortográficos são propensos a produzir ZERO_RESULTS. Se não for possível encontrar o endereço, é preferível usar ZERO_RESULTS resultado (por exemplo, retornar apenas o subúrbio em vez de um endereço).

Se seu aplicativo lida com a entrada de endereços do usuário, o Recurso de Place Autocomplete na API Places pode produzir resultados de melhor qualidade. O Place Autocomplete permite que os usuários selecionem de um conjunto de resultados que os usuários digitaram, o que permite que os usuários escolham entre resultados com nomes semelhantes, e ajustar a consulta caso ele digite um endereço incorretamente.

Se você tiver um aplicativo que lida com consultas ou consultas ambíguas ou incompletas que possa conter erros, recomendamos o uso do Recurso de Place Autocomplete na API Places em vez de no geocodificador inverso, disponíveis na API Geocoding. Para mais detalhes, consulte práticas recomendadas ao geocodificar endereços e os a geocodificação de endereços na postagem do blog das APIs Google Maps (em inglês).

Preciso de respostas rápidas, e o geocodificador é muito lento para o meu aplicativo. O que pode que eu uso para ter respostas mais rápidas?

Recomendamos que os aplicativos que respondem à entrada do usuário e, portanto, sensíveis à latência, use a API 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ço na API Geocoding é otimizada para uso com endereços completos, não ambíguos e bem formatados, como endereços de entrega inseridos no formulários on-line e, portanto, tem maior latência do que o Place Autocomplete. O geocodificador inverso tem maior cobertura e melhor qualidade de resultados, mas com latência um pouco maior.

Como posso reduzir a latência na API Directions e 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 Place Autocomplete na API Places ou na Biblioteca Places no API Maps JavaScript. Consulte também as informações sobre placeIdOnly, que pode ser usada para reduzir o custo do Place Autocomplete.

Quando a API Directions ou a API Distance Matrix for consultado com uma string de endereço em vez de um ID de lugar ou latlng, eles usarão a mesma como a API Geocoding para converter esse endereço em um ID de lugar antes de calcular a rota. O Place Autocomplete é mais rápido que o endereço de geocodificação. Para aplicativos que usam a API Directions ou a API Distance Matrix em situações com alta latência, como respondendo à entrada do usuário, recomendamos que você use o Place Autocomplete para conseguir os IDs de lugar correspondentes a esses endereços e passar os IDs de local para o API Directions ou API Distance Matrix. Essa abordagem reduz a latência significativamente. Consulte nossa documentação para exemplo de como usar o Place Autocomplete com rotas

Como informo bugs no geocodificador?

Se você tiver relatórios de bugs ou solicitações de recursos para o serviço de geocodificador inverso, informe-nos usando nossa Issue Tracker.

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

Informe-nos usando nossa conta rastreador de problemas, compartilhando algumas consultas específicas para que possamos investigar verifique se há bugs ou problemas sistêmicos que causam problemas no resultado da qualidade do produto ou se há alguma mudança que possamos fazer na guia de práticas recomendadas para ajudar os desenvolvedores a alcançar 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 postal_code e country restrições. Os exemplos a seguir ilustram a melhor forma de usar filtragem, dependendo dos resultados que você precisa. 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 de país usando um código de país ISO 3166-2; País nomes e outras abreviações não garantem os mesmos resultados que os códigos de países.

    Exemplos:

    • Geocodificação para devoluções de components=country:FRA|locality:gallus a sublocalidade de Gallus em Frankfurt am Main, Alemanha. Isso acontece porque a letra de 3 letras o código de país da França (FRA) não é suportado. Portanto, resultados em qualquer país são permitidos e o resultado em Frankfurt é melhor do que qualquer outra 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 retorna necessariamente vários resultados para consultas ambíguas. Essas as consultas são melhor respondidas pelo Place Autocomplete.

    Exemplos:

    • Geocodificação para devoluções de components=country:US|locality:madrid "Madri, NM 87010, EUA" mas nenhuma das outras cidades dos EUA chamadas "Madri". 
      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 usando location e radius para influenciar os resultados de localização, gerar uma resposta com várias cidades nos EUA chamada "Madri". 
      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