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
- Recebo mais consultas que retornam ZERO_RESULTS com o geocodificador. O que está acontecendo?
- Preciso de respostas rápidas, e o geocodificador é muito lento para meu aplicativo. O que posso usar para receber respostas mais rápidas?
- Como posso reduzir a latência nas APIs Directions e Distance Matrix?
- Sou cliente do Plano Premium, e a API Places é muito cara. O que posso fazer para reduzir custos?
- Como informo bugs no geocodificador?
- O geocodificador não está produzindo bons resultados para meu caso de uso. Como posso ajudar?
- Como posso receber os melhores resultados com o geocodificador usando a filtragem de componentes?
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
ecountry
. 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 geocodificação para
- 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 comlocation
eradius
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
- A geocodificação para
- 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: