Schema URL di Google Maps per iOS

Sui dispositivi con iOS 9 e versioni successive, puoi utilizzare i link universali per avviare Google Maps quando hai un URL di Google Maps.

Puoi utilizzare lo schema URL di Google Maps per avviare l'app Google Maps per iOS ed eseguire ricerche, ottenere indicazioni stradali e visualizzare le mappe. Quando avvii Google Maps, l'identificatore pacchetto viene inviato automaticamente come parte della richiesta.

Non è necessaria una chiave API di Google per utilizzare lo schema URL di Google Maps.

Google Maps per iOS supporta i link universali sui dispositivi con iOS 9 o versioni successive.

Se l'URL corrisponde alla seguente espressione regolare e sul dispositivo è installato iOS 9 o versioni successive, ti consigliamo di utilizzare direttamente il metodo openURL:.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Ad esempio,

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

Panoramica

Uno schema URL ti consente di avviare un'applicazione per iOS da un'altra app per iOS o da un'applicazione web. Puoi impostare nell'URL le opzioni che vengono passate all'applicazione avviata. L'app Google Maps per iOS supporta i seguenti schemi URL:

  • comgooglemaps://: questo schema ti consente di avviare l'app Google Maps per iOS ed eseguire una delle seguenti azioni:

    • Visualizza una mappa in una posizione e con un livello di zoom specificati.
    • Cercare località o luoghi e visualizzarli su una mappa.
    • Richiedere indicazioni stradali da un luogo a un altro. Le indicazioni stradali possono essere restituite per quattro modalità di trasporto: in auto, a piedi, in bicicletta e con il trasporto pubblico.
    • Aggiungi la navigazione alla tua app.

  • comgooglemapsurl://: questo schema ti consente di avviare l'app Google Maps per iOS utilizzando un URL derivato dal sito web di Google Maps per computer. Ciò significa che puoi offrire ai tuoi utenti un'esperienza mobile anziché caricare il sito web di Google Maps.

    • L'URL originale può essere per maps.google.com o per google.com/maps oppure può utilizzare qualsiasi dominio di primo livello nazionale valido al posto di com. Puoi anche trasmettere gli URL di reindirizzamento goo.gl/maps.

Avvia l'app Google Maps per iOS ed esegui una funzione specifica

Per avviare l'app Google Maps per iOS ed eventualmente eseguire una delle funzioni supportate, utilizza uno schema URL nel seguente formato:

comgooglemaps://?parameters

I parametri sono descritti in dettaglio più avanti in questo documento.

Verifica la disponibilità dell'app Google Maps sul dispositivo

Prima di presentare uno di questi URL a un utente nella tua app, devi verificare che l'applicazione sia installata. La tua app può verificare che lo schema URL sia disponibile con il seguente codice:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

Ad esempio, per visualizzare una mappa di Central Park a New York, puoi utilizzare il seguente codice:

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

Visualizza una mappa

Utilizza lo schema URL per visualizzare la mappa con un livello di zoom e una posizione specifici. Puoi anche sovrapporre altre visualizzazioni alla mappa o mostrare immagini di Street View.

Parametri

Tutti i parametri descritti di seguito sono facoltativi. Se non vengono impostati parametri, lo schema URL avvierà l'app Google Maps per iOS.

  • center: questo è il punto centrale dell'area visibile della mappa. Formattato come stringa di latitude,longitude separata da virgole.
  • mapmode: imposta il tipo di mappa mostrata. Può essere impostato su: standard o streetview. Se non specificate, verranno utilizzate le impostazioni dell'applicazione corrente.
  • views: attiva/disattiva visualizzazioni specifiche. Può essere impostato su: satellite, traffic o transit. È possibile impostare più valori utilizzando un separatore separato da virgole. Se il parametro viene specificato senza valore, verranno cancellate tutte le visualizzazioni.
  • zoom: specifica il livello di zoom della mappa.

Questo URL di esempio mostra la mappa centrata su New York con zoom 14 e la visualizzazione del traffico attiva:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

Mappa del traffico di New York

Ecco alcuni esempi:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Utilizza questo schema per visualizzare le query di ricerca in una posizione dell'area visibile specificata.

Parametri

Oltre ai parametri utilizzati per visualizzare una mappa, la Ricerca supporta il parametro q.

  • q: la stringa di query per la ricerca.

Questo URL di esempio cerca "Pizza" nella località specificata:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

Pizza nelle vicinanze

Ecco alcuni esempi:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

Visualizza le indicazioni stradali

Utilizza questo schema per richiedere e visualizzare le indicazioni stradali tra due località. Puoi anche specificare la modalità di trasporto.

Parametri

  • saddr: imposta il punto di partenza per le ricerche di indicazioni stradali. Può essere una latitudine,una longitudine o un indirizzo formattato per la query. Se si tratta di una stringa di query che restituisce più di un risultato, verrà selezionato il primo risultato. Se il valore viene lasciato vuoto, verrà utilizzata la posizione corrente dell'utente.
  • daddr: imposta il punto di arrivo per le ricerche di indicazioni stradali. Ha lo stesso formato e lo stesso comportamento di saddr.
  • directionsmode: metodo di trasporto. Può essere impostato su: driving, transit, bicycling o walking.

L'URL di esempio mostra le indicazioni per il trasporto pubblico tra Google NYC e l'aeroporto JFK:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

Indicazioni stradali con mezzi pubblici

Ecco alcuni esempi:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

Aggiungi la navigazione alla tua app

L'avvio dell'app Google Maps per iOS con una richiesta di indicazioni stradali consente agli utenti di accedere alla navigazione passo passo dalla tua app. Puoi utilizzare lo schema URL comgooglemaps://.

Avvia l'app Google Maps per iOS da un URL di Google Maps per computer

Se la tua app ha accesso a un URL di Google Maps preesistente, ad esempio su una pagina web o in un database, puoi utilizzare questo schema per aprire l'URL nell'app Google Maps per iOS, offrendo così ai tuoi utenti la migliore esperienza mobile.

  • Sostituisci lo schema http:// o https:// con comgooglemapsurl://.

Formati URL di Google Maps supportati

Lo schema comgooglemapsurl:// supporta gli URL che corrispondono a questa espressione regolare, dove {TLD} si riferisce a qualsiasi dominio di primo livello del paese valido. Le interruzioni di riga vengono aggiunte per maggiore chiarezza:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Controlla la disponibilità dell'app Google Maps

Innanzitutto, verifica che l'app Google Maps per iOS sia disponibile sul dispositivo e supporti lo schema URL:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemapsurl://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

Esempi

Esempio di URL generico di Google Maps:

URL di Google Maps originale:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

Utilizzando lo schema URL:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Esempio di URL generico di Google Maps:

URL di Google Maps originale:

https://maps.google.com/?q=@37.3161,-122.1836

Utilizzando lo schema URL:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836