Riferimento rapido per gli URL di Maps

Gli URL di Maps ti consentono di creare un URL universale e multipiattaforma che avvia Google Maps per eseguire ricerche, ottenere indicazioni stradali e navigazione, visualizzare viste della mappa, creare un elenco di luoghi o mostrare panoramiche in Street View. La sintassi dell'URL è la stessa su ogni piattaforma e non è richiesta alcuna chiave API.

URL di Maps: punti chiave

  • Prodotto: URL di Maps
  • Noto anche come: URL di Google Maps
  • Category: Maps
  • Piattaforma: schema URL
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica degli URL di Maps

URL di Maps: quando utilizzarli

Utilizza gli URL di Maps quando:

  • Ti serve un link dalla tua app per Android, app per iOS o dal tuo sito web che apra Google Maps per cercare un luogo o mostrare i risultati di ricerca.
  • Devi aprire Google Maps con le indicazioni stradali tra i punti, facoltativamente con waypoint, modalità di viaggio o navigazione passo passo.
  • Devi aprire Google Maps in una visualizzazione mappa, un elenco di luoghi o una panoramica in Street View senza utilizzare una chiave API.
  • Hai bisogno di una sintassi degli URL che funzioni allo stesso modo su Android, iOS e browser desktop.

Non utilizzare gli URL di Maps quando:

  • Richiedi già Place Details e vuoi link a Google Maps preformattati per un luogo (campi googleMapsUri o googleMapsLinks). Utilizza l'API Places (novità).
  • Hai bisogno di funzionalità solo per dispositivi mobili quando avvii l'app Google Maps; utilizza gli intent di Google Maps per Android o lo schema URL di Google Maps per iOS.

URL di Maps: configurazione

  • Attribuzione di utilizzo: aggiungi i parametri di query facoltativi utm_source (il nome della tua applicazione) e utm_campaign (l'azione prevista dell'utente, ad esempio place_details_search) agli URL di Maps.
  • Inizia: configura gli URL di Maps

URL di Maps: errori comuni

  • Problema: un URL di ricerca con solo latitudine/longitudine in query mostra un segnaposto, ma nessun dettaglio del luogo nella mappa o nel riquadro laterale. Correzione: utilizza query=PLACE_NAME,ADDRESS o aggiungi query_place_id insieme a query per mostrare i dettagli del luogo specifico. Consulta /maps/documentation/urls/get-started.
  • Problema: i parametri ID luogo (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) non funzionano da soli. Correzione: includi sempre il parametro di base corrispondente (query, origin, destination o waypoints) quando passi un parametro ID luogo. Consulta /maps/documentation/urls/get-started.
  • Problema: il parametro waypoints viene ignorato nei prodotti Google Maps che non supportano i waypoint e ha limiti di conteggio che dipendono dalla piattaforma, mentre dir_action=navigate viene ignorato se la navigazione non è disponibile. Correzione: utilizza non più di tre tappe per i link che si aprono nei browser mobile (altrimenti nove) e non fare affidamento sul funzionamento di waypoints o dir_action=navigate su ogni prodotto o percorso di Google Maps. Consulta /maps/documentation/urls/get-started#directions-action.
  • Problema: Maps e Street View condividono lo stesso endpoint @, quindi un URL della mappa senza l'azione corretta potrebbe non mostrare una mappa. Correzione: imposta map_action=map per le visualizzazioni mappa e map_action=pano per le panoramiche in Street View. Consulta /maps/documentation/urls/get-started.
  • Problema: se api=1 non è presente in un URL di Maps, tutti i parametri vengono ignorati e Google Maps apre la visualizzazione predefinita. Correzione: includi api=1 in ogni URL di Maps (1 è l'unico valore valido). Consulta /maps/documentation/urls/get-started#forming-the-url.