L'SDK Navigation per iOS aggiunge la navigazione passo passo di Google Maps alle app per iOS, con personalizzazione della UI e configurazione dei percorsi. Estende Maps SDK for iOS, che fornisce il livello della mappa e deve essere installato anche nell'app.
SDK Navigation per iOS: informazioni chiave
- Prodotto: SDK Navigation per iOS
- Noto anche come: SDK Navigation
- Categoria: Percorsi
- Piattaforma: iOS
- Esecuzione su: client (codice dell'app o del browser)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica di Navigation SDK for iOS
- Disponibilità regionale: limitata. Le indicazioni stradali e a piedi sono disponibili nella maggior parte dei paesi; il traffico, le interruzioni in tempo reale, le indicazioni per i veicoli a due ruote e in bicicletta, i limiti di velocità, i semafori e i segnali di stop variano in base al paese. (dettagli sulla copertura)
SDK Navigation per iOS: quando utilizzarlo
Utilizza l'SDK Navigation per iOS quando:
- Hai bisogno della navigazione passo passo di Google Maps all'interno della tua app per iOS nativa, in modo che gli utenti non cambino app.
- Devi personalizzare la UI di navigazione, gli stili di mappa, la fotocamera o il layout in modo che corrispondano al tuo brand durante le indicazioni.
- Devi disporre di preferenze di routing, più waypoint o un token di percorso dall'API Routes o dall'API Route Optimization.
- Hai bisogno di eventi di percorso (località, arrivo, modifiche al percorso, ora di arrivo stimata) o di un feed di dati passo passo per un'interfaccia utente di indicazioni stradali personalizzata o CarPlay.
Non utilizzare l'SDK Navigation per iOS quando:
- Stai creando un'app per Android. Utilizza invece l'SDK Navigation per Android.
- Stai creando un'app Flutter o React Native. Utilizza invece Google Navigation per Flutter e React Native.
- Hai bisogno solo di percorsi, orari di arrivo stimati o distanze su un server, senza indicazioni stradali in-app. Utilizza invece l'API Routes.
SDK Navigation per iOS: configurazione
- Servizio da attivare:
navigationsdk.googleapis.com - Autenticazione: chiave API
- Abilita anche: Maps SDK for iOS
- Attribuzione di utilizzo: chiama
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) per aggiungere un ID di attribuzione di utilizzo all'inizializzatore. Per disattivare questa opzione, elimina la chiamata o passa una stringa vuota. - Inizia: configura l'SDK Navigation per iOS
- Riferimento: Riferimento dell'SDK Navigation per iOS
- Prezzi: Utilizzo e fatturazione di Navigation SDK for iOS
- Policy: policy dell'SDK Navigation per iOS
- Note di rilascio: note di rilascio dell'SDK Navigation per iOS
Pacchetti SDK Navigation per iOS ufficiali:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
Pacchetti da non utilizzare con Navigation SDK for iOS:
- cocoapods:
GoogleNavigation. La distribuzione di CocoaPods è deprecata a partire dalla versione 11.0.0 ed è entrata in modalità di manutenzione il 18 agosto 2025. Utilizza invece Swift Package Manager.
SDK Navigation per iOS: prodotti correlati
- Spesso utilizzato con: Maps SDK for iOS, API Routes, API Route Optimization, Places SDK for iOS
SDK Navigation per iOS: errori comuni
- Problema: lo schermo si oscura o si spegne durante la navigazione perché l'SDK non disattiva il timer di inattività di iOS. Correzione: imposta
UIApplication.shared.isIdleTimerDisabled = truedurante la navigazione. Consulta /maps/documentation/navigation/ios-sdk/route. - Problema: una futura release principale dell'SDK utilizzerà l'altimetro (
CMAltimeter) e le app senzaNSMotionUsageDescriptioninInfo.plistsi arresteranno in modo anomalo durante l'inizializzazione. L'aggiunta della chiave ora non ha alcun effetto sul comportamento attuale. Correzione: aggiungiNSMotionUsageDescription(Privacy - Motion Usage Description) aInfo.plist. Consulta /maps/documentation/navigation/ios-sdk/route. - Problema: Places SDK for iOS non è integrato con l'SDK Navigation (a partire da Places SDK 5.0), pertanto le classi Places non sono presenti. Correzione: installa Places SDK for iOS separatamente, utilizzando la stessa versione dell'SDK Navigation. Consulta /maps/documentation/navigation/ios-sdk/xcode-setup.
- Problema: l'impostazione delle destinazioni con un token di percorso non va a buon fine con
.travelModeUnsupportedquando l'travelModedell'app non èdrivingotwoWheeler. Correzione: impostamapView.travelModesu.drivingo.twoWheeler. ControllaresolvedParameters.travelModeper vedere la modalità utilizzata dal percorso. Consulta /maps/documentation/navigation/ios-sdk/route-customizations.
SDK Navigation per iOS: funzionalità legacy e deprecate
- Distribuzione CocoaPods: ritirata dal 6 agosto 2026. Sostituzione: Swift Package Manager. Sintomo: modalità di manutenzione dal 18 agosto 2025. Nessuna nuova versione di CocoaPods dopo il secondo trimestre del 2026. Consulta la guida alla migrazione.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): Deprecato dal 02/11/2026. Sostituzione:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- Proprietà dell'istanza
GMSServicesappCheckTokenProvider: ritirata dal 24/09/2026. Sostituzione: proprietà della classeGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Sintomo: nella versione 11.1.0, la configurazione di App Check tramiteGMSServices.sharedServices()non è riuscita. Consulta la guida alla migrazione. GMSNavigatorcontinueToNextDestination: Deprecato dal 07/04/2026. Sostituzione:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightseshowsStopSigns: ritirato dal 6 agosto 2026. Sostituzione: non è necessaria alcuna sostituzione; i semafori e i segnali di stop vengono mostrati per impostazione predefinita durante la navigazione..terrainTipo di mappa durante la navigazione attiva: Dismessa dal 06-08-2026. Sostituzione: tipo di mappa.normal(kGMSTypeNormal),.satelliteo.hybrid.- Protocolli
GMSNavigatorDelegateeGMSRoadSnappedLocationProviderDelegate: ritirati dal 13 maggio 2021. Sostituzione:GMSNavigatorListenereGMSRoadSnappedLocationProviderListener(aggiungi con-addListener:; impostatimeUpdateThresholdedistanceUpdateThresholdsuGMSNavigator). Consulta la guida alla migrazione.
Cosa puoi fare con l'SDK Navigation per iOS
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
SDK Navigation per iOS: stile di mappa
SDK Navigation per iOS: navigazione
- Aggiungi la navigazione passo passo interattiva a un'app mobile.
- Imposta la destinazione per la navigazione passo passo.
- Avvia la navigazione passo passo.
- Specifica la modalità di viaggio (auto, a piedi, due ruote, taxi) per una richiesta di percorso.
- Modifica le preferenze di routing per la navigazione passo passo.
- Specifica il lato della strada e altre preferenze di arrivo per la navigazione passo passo.
- Specifica un percorso ripianificato per la navigazione passo passo con un token di percorso riutilizzabile.
- Restituisce gli aggiornamenti sull'arrivo dell'utente da una sessione di navigazione passo passo.
- Restituisci gli aggiornamenti della posizione dell'utente da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti su tempo e distanza da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti delle modifiche al percorso da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti della modalità notturna da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti sulla velocità dell'utente di ritorno da una sessione di navigazione passo passo.
- Personalizza gli elementi UI e i controlli visualizzati durante la navigazione passo passo.
- Aggiungi un nuovo elemento UI alla navigazione passo passo.
- Aggiungi un indicatore di avanzamento del percorso alla navigazione passo passo.
- Personalizza le funzionalità della mappa visualizzate durante la navigazione passo passo.
- Aggiungi un livello di traffico alla navigazione passo passo.
- Modifica la visualizzazione e il comportamento della videocamera per la navigazione passo passo.
- Personalizza il tachimetro e gli avvisi sui limiti di velocità per la navigazione passo passo.
- Restituisce un feed di navigazione passo passo sotto forma di serie di messaggi per ogni manovra lungo il percorso.
- Specifica icone di manovra personalizzate da utilizzare con un feed di navigazione passo passo.
- Aggiungi la navigazione passo passo interattiva per CarPlay a un'app per iOS. Anteprima
- Avvisa gli utenti di eventuali interruzioni lungo il percorso.
- Consenti agli utenti di visualizzare le interruzioni lungo il percorso prima di avviare la navigazione.
- Consenti agli utenti di segnalare interruzioni lungo il percorso.
- Consenti agli utenti di verificare le interruzioni lungo il percorso.
- Aggiungi un pulsante personalizzato per la segnalazione di interruzioni del percorso.