FlowData

O Maps não encontra nada ou mostra o lugar errado: o que fazer?

Publicado em 10. novembro 2026

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 q está faltando ou tem mais de 256 caracteres.
  • country não tem exatamente duas letras. O correto é BR, não BRA ou Brasil.
  • limit não está entre 1 e 10.
  • Na geocodificação, address está faltando, ou apenas lat foi enviado sem lng.
  • Na rota, origin ou destination está faltando, profile não é um valor conhecido ou alternatives está como true em vez de 1.

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 e country.
  • 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 em avoid é 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:

  1. 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 em types também pode causar um erro de servidor.
  2. 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:

Este artigo foi útil?

Voltar para Maps