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
googleMapsUriougoogleMapsLinks). 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) eutm_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: produtos relacionados
- Frequentemente usada com: API Places (nova)
URLs do Maps: erros comuns
- Problema: um URL de pesquisa com apenas latitude/longitude em
querymostra um alfinete, mas não os detalhes do lugar no mapa ou no painel lateral. Correção: usequery=PLACE_NAME,ADDRESSou adicionequery_place_idao lado dequerypara 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,destinationouwaypoints) 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âmetrodir_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 dewaypointsoudir_action=navigateem 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: definamap_action=mappara visualizações de mapa emap_action=panopara panoramas do Street View. Consulte /maps/documentation/urls/get-started. - Problema: se
api=1estiver 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: incluaapi=1em todos os URLs do Maps (1é o único valor válido). Consulte /maps/documentation/urls/get-started#forming-the-url.