Formatos de URL do Google Maps explicados: cada tipo de link decodificado
Resposta curta
A parte depois de google.com/maps/ indica o tipo: /place/ traz um nome e coordenadas, /search/ termos de busca, /@ só coordenadas, /dir/ uma rota. Um link curto maps.app.goo.gl esconde um desses. Todos eles podem ser convertidos para o Apple Maps abaixo — exceto links cid sem nome, links place_id e listas inteiras.
Os 8 tipos de link
Encontre o padrão do seu link. A etiqueta mostra o que a Conversão rápida faz com ele.
-
Link de lugar ✓ Converte
google.com/maps/place/
Eiffel+Tower/@48.8584,2.2945,17z- nome do lugar
- coordenadas
- zoom
O link da barra de endereço de um lugar aberto. O nome e as coordenadas são transferidos.
-
Link curto ✓ Expandido antes
maps.app.goo.gl/Ab3xYz
- código curto — esconde o link completo
É o que o botão Compartilhar do Google Maps fornece; links goo.gl/maps também. A Conversão rápida segue o redirecionamento antes.
-
Link de busca ✓ Busca o nome
google.com/maps/search/
Louvre+Museum/@48.8606,2.3376,15z- termos de busca
- coordenadas
Uma busca, não um único lugar: os termos viram a consulta no Apple Maps. Links com
q=ouapi=1&query=funcionam do mesmo jeito. -
Só coordenadas ✓ Converte
google.com/maps/
@52.520008,13.404954,15z- coordenadas
- zoom
Sem nome, só uma posição no mapa. O Apple Maps abre no mesmo ponto.
-
Link de rotas ✓ Parada final
google.com/maps/dir/
Louvre/Notre-Dame/Eiffel+Tower- partida e paradas
- parada final
Uma rota. Só a parada final é transferida, não a rota em si.
-
Link cid Precisa do nome
google.com/maps?cid=
10281119596374313554- ID numérico do lugar — sem nome
O número não contém o nome, então um link cid sozinho falha. Ele funciona quando o link também traz o nome do lugar.
-
Link de ID de lugar ✗ Não diretamente
google.com/maps/place/?q=place_id:
ChIJN1t_tDeuEmsRUsoyG83frY4- ID de lugar do Google
Não há nome nem coordenadas dentro dele. Compartilhe o lugar pelo Google Maps e converta esse link.
-
Link de lista ou do My Maps Conversor de arquivos
google.com/maps/placelists/list/
Qm9vZ2xlTGlzdA- ID da lista
Uma lista inteira, não um único lugar. Exporte-a e use o conversor de arquivos ou o app.
Detalhes para desenvolvedores
O link do Apple Maps que a Conversão rápida cria
maps.apple.com/?q=Eiffel%20Tower&ll=48.8584,2.2945
- nome
- coordenadas
O formato clássico maps.apple.com da Apple. Se o link do Google não tem nome, ele leva só ll=lat,lng&z=17; se não tem coordenadas, só q=Name. Ele abre o Apple Maps no iPhone, iPad e Mac, e um mapa web nos demais dispositivos. Todos os parâmetros estão no guia do esquema de URL do Apple Maps.
Regex para coordenadas, nomes e paradas
Decodifique a URL primeiro (decodeURIComponent) e depois:
// @lat,lng (place, search, coords)
/@(-?\d+\.?\d*),(-?\d+\.?\d*)/
// in data=: !3d = lat, !4d = lng
/!3d(-?\d+\.?\d*)/
/!4d(-?\d+\.?\d*)/
// name or search words (+ = space)
/\/maps\/(?:place|search)\/([^/@]+)/
// q=, query= and daddr= parameters
new URL(link).searchParams.get('q')
Rotas: divida o caminho depois de /maps/dir/ em /, descarte os segmentos que começam com @ ou contêm = e fique com o último — esse é o destino.
Links curtos e links encapsulados
Um link maps.app.goo.gl ou goo.gl/maps é um redirecionamento. Faça a requisição, siga o redirecionamento até a URL completa google.com/maps e analise essa URL.
Links copiados do Facebook, do Instagram ou do Google muitas vezes encapsulam o link real em um parâmetro de redirecionamento (u=, q= ou url=). Decodifique-o antes de analisar. A Conversão rápida faz as duas coisas por você.
Perguntas frequentes
Qual formato de URL é o mais confiável para a conversão?
Links de lugar (/maps/place/Name/@lat,lng), porque trazem tanto o nome do lugar quanto as coordenadas. Links só com coordenadas indicam o ponto, mas não o nome. Links curtos funcionam depois de expandidos, links cid precisam do nome do lugar junto, e links place_id não são convertidos diretamente.
O que é o parâmetro cid nas URLs do Google Maps?
Um ID numérico de um único lugar do Google Maps, como em google.com/maps?cid=10281119596374313554. Ele não contém nome nem coordenadas, então a Conversão rápida só converte um link cid quando o link também traz o nome do lugar (por exemplo, ?q=Name&cid=…).
Como extraio as coordenadas de uma URL do Google Maps?
Procure o @ seguido de dois números separados por vírgula: são a latitude e a longitude. Em google.com/maps/@48.8584,2.2945,17z, as coordenadas são 48.8584, 2.2945, e 17z é o zoom. Links curtos as escondem até serem expandidos, e o conversor faz isso por você.