O Maps não retorna nenhum resultado, uma rota termina no meio do mar ou o número da casa está faltando? Quase sempre a causa é uma de poucas situações típicas. Aqui estão elas, com a solução de cada uma.
A rota vai parar no mar, na África ou no lugar errado
Isso quase sempre acontece porque longitude e latitude estão invertidas. No Maps, origin, destination, waypoints e proximity sempre usam a ordem longitude,latitude. Para Berlim, isso significa 13.4050,52.5200, não 52.5200,13.4050.
O problema é que, em muitos lugares, os valores invertidos também são coordenadas válidas. Em vez de um erro, você recebe um resultado em outro ponto do mundo ou um 404 porque ali não há via.
Para se orientar sobre qual nome vale em cada lugar:
| Onde | Formato |
|---|---|
Rotas do Maps e proximity |
um valor longitude,latitude |
| Geocodificação do Maps | dois parâmetros lat e lng |
| Respostas do Maps | campos lat e lng |
| IP Geolocation | campos lat e lon |
Se você aproveitar coordenadas do IP Geolocation, a longitude ali se chama lon. No Maps, passe esse valor como lng ou na primeira posição.
HTTP 422: Invalid parameters
Um parâmetro está faltando ou tem um valor inválido. Em details sempre aparece o campo afetado com uma mensagem, por exemplo:
{"success":false,"error":"Invalid parameters","details":{"country":["..."]}}
O texto da mensagem está em alemão no momento. Causas comuns:
- O termo de busca
qestá faltando ou tem mais de 256 caracteres. countrynão tem exatamente duas letras. O correto éBR, nãoBRAouBrasil.limitnão está entre 1 e 10.- Na geocodificação,
addressestá faltando, ou apenaslatfoi enviado semlng. - Na rota,
originoudestinationestá faltando,profilenão é um valor conhecido oualternativesestá comotrueem vez de1.
HTTP 404: nada encontrado
O Maps não conseguiu determinar um endereço ou rota. O texto em error indica qual endpoint foi afetado:
No address data found for this address: a geocodificação não encontrou nada para o endereço. Verifique a grafia, o código postal ecountry.No address found for the specified coordinates: não há endereço conhecido nesse ponto, muitas vezes porque as coordenadas estão invertidas.No route found for the specified coordinates: não há rota entre os pontos para o meio de transporte escolhido, ou um valor emavoidé inválido.
A busca de lugares, por outro lado, nunca responde com 404. Se não encontrar nada, a lista addresses simplesmente vem vazia. Como todos os erros, essas respostas não são cobradas.
No Registro da área você vê cada requisição com falha, com seus Parâmetros e a Resposta de erro. Coloque o filtro em Com falha e clique no ícone de olho da entrada.
Faltam números de casa nos resultados
A busca de lugares também retorna ruas, códigos postais e cidades. Resultados sem número sempre vêm depois dos endereços completos. Se o número faltar em todos, o Maps não o conhece para essa rua ou o seu termo de busca não inclui um. Informe o número ou restrinja a busca a endereços com types=address.
Resultados no país errado
Sem country, o Maps busca no mundo todo. Uma "Rua Principal 5" existe em muitos países. Defina country=BR ou o país certo e, para resultados perto de um lugar específico, adicione proximity.
HTTP 500: erro de servidor
Um erro de servidor pode ter dois motivos:
- As coordenadas de uma rota estão mal formatadas, por exemplo com espaço em vez de vírgula, com três valores ou com valores fora do intervalo válido. A resposta é então
{"message":"Server Error"}. Verifique primeiro o formato. Um valor desconhecido emtypestambém pode causar um erro de servidor. - O serviço de mapas estava indisponível naquele momento. Aguarde um pouco e tente de novo.
Posso armazenar os resultados?
Não para uso futuro. O aviso no campo attribution de toda resposta bem-sucedida diz que a resposta e seus dados não podem ser armazenados de forma permanente. Use os resultados diretamente, por exemplo para exibição ou para escolher um endereço, e consulte de novo quando precisar.
Bom saber
O básico sobre os três endpoints está aqui: