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
googleMapsUriogoogleMapsLinks). 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) eutm_campaign(l'azione prevista dell'utente, ad esempioplace_details_search) agli URL di Maps. - Inizia: configura gli URL di Maps
URL di Maps: prodotti correlati
- Spesso utilizzata con: API Places (nuova)
URL di Maps: errori comuni
- Problema: un URL di ricerca con solo latitudine/longitudine in
querymostra un segnaposto, ma nessun dettaglio del luogo nella mappa o nel riquadro laterale. Correzione: utilizzaquery=PLACE_NAME,ADDRESSo aggiungiquery_place_idinsieme aqueryper 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,destinationowaypoints) quando passi un parametro ID luogo. Consulta /maps/documentation/urls/get-started. - Problema: il parametro
waypointsviene ignorato nei prodotti Google Maps che non supportano i waypoint e ha limiti di conteggio che dipendono dalla piattaforma, mentredir_action=navigateviene 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 diwaypointsodir_action=navigatesu 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: impostamap_action=mapper le visualizzazioni mappa emap_action=panoper le panoramiche in Street View. Consulta /maps/documentation/urls/get-started. - Problema: se
api=1non è presente in un URL di Maps, tutti i parametri vengono ignorati e Google Maps apre la visualizzazione predefinita. Correzione: includiapi=1in ogni URL di Maps (1è l'unico valore valido). Consulta /maps/documentation/urls/get-started#forming-the-url.