Referência rápida de URLs do Maps

Com os URLs do Maps, você pode criar um URL universal multiplataforma que abre o Google Maps para fazer pesquisas, ver rotas e iniciar trajeto, exibir visualizações de mapa, criar uma lista de lugares ou mostrar panoramas do Street View. A sintaxe do URL é a mesma em todas as plataformas, e não é necessário usar uma chave de API.

URLs do Maps: informações importantes

  • Produto: URLs do Maps
  • Também conhecido como: URLs do Google Maps
  • Categoria: Maps
  • Plataforma: esquema de URL
  • Estágio de lançamento: GA
  • Ciclo de vida: Ativo
  • Visão geral: Visão geral dos URLs do Maps

URLs do Maps: quando usar

Use URLs do Maps quando:

  • Você precisa de um link do seu app Android, app iOS ou site que abra o Google Maps para pesquisar um lugar ou mostrar resultados da pesquisa.
  • Você precisa abrir o Google Maps com rotas entre pontos, opcionalmente com waypoints, modo de viagem ou navegação guiada.
  • Você precisa abrir o Google Maps em uma visualização de mapa, uma lista de lugares ou um panorama do Street View sem usar uma chave de API.
  • Você precisa de uma sintaxe de URL que funcione da mesma forma no Android, no iOS e em navegadores para computador.

Não use URLs do Maps quando:

  • Você já solicita o Place Details e quer links pré-formatados do Google Maps para um lugar (campos googleMapsUri ou googleMapsLinks). Use a API Places (nova).
  • Você precisa de recursos exclusivos para dispositivos móveis ao iniciar o app Google Maps. Use as intents do Google Maps para Android ou o esquema de URL do Google Maps para iOS.

URLs do Maps: configuração

  • Atribuição de uso: adicione os parâmetros de consulta opcionais utm_source (nome do aplicativo) e utm_campaign (ação pretendida do usuário, por exemplo, place_details_search) aos URLs do Maps.
  • Comece a usar: configure os URLs do Maps

URLs do Maps: erros comuns

  • Problema: um URL de pesquisa com apenas latitude/longitude em query mostra um alfinete, mas não os detalhes do lugar no mapa ou no painel lateral. Correção: use query=PLACE_NAME,ADDRESS ou adicione query_place_id ao lado de query para mostrar os detalhes do lugar específico. Consulte /maps/documentation/urls/get-started.
  • Problema: os parâmetros de ID de lugar (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) não funcionam sozinhos. Correção: sempre inclua o parâmetro de base correspondente (query, origin, destination ou waypoints) ao transmitir um parâmetro de ID de lugar. Consulte /maps/documentation/urls/get-started.
  • Problema: o parâmetro waypoints é ignorado nos produtos do Google Maps que não são compatíveis com pontos de referência e tem limites de contagem que dependem da plataforma. Além disso, o parâmetro dir_action=navigate é ignorado quando a navegação não está disponível. Correção: use no máximo três waypoints para links que abrem em navegadores para dispositivos móveis (nove em outros casos) e não dependa de waypoints ou dir_action=navigate em todos os produtos ou rotas do Google Maps. Consulte /maps/documentation/urls/get-started#directions-action.
  • Problema: o Maps e o Street View compartilham o mesmo endpoint @. Por isso, um URL de mapa sem a ação correta pode não mostrar um mapa. Correção: defina map_action=map para visualizações de mapa e map_action=pano para panoramas do Street View. Consulte /maps/documentation/urls/get-started.
  • Problema: se api=1 estiver ausente de um URL do Maps, todos os parâmetros serão ignorados, e o Google Maps abrirá a visualização padrão. Correção: inclua api=1 em todos os URLs do Maps (1 é o único valor válido). Consulte /maps/documentation/urls/get-started#forming-the-url.