Riferimento rapido per l'SDK Navigation per iOS

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:

SDK Navigation per iOS: configurazione

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: 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 = true durante la navigazione. Consulta /maps/documentation/navigation/ios-sdk/route.
  • Problema: una futura release principale dell'SDK utilizzerà l'altimetro (CMAltimeter) e le app senza NSMotionUsageDescription in Info.plist si arresteranno in modo anomalo durante l'inizializzazione. L'aggiunta della chiave ora non ha alcun effetto sul comportamento attuale. Correzione: aggiungi NSMotionUsageDescription (Privacy - Motion Usage Description) a Info.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 .travelModeUnsupported quando l'travelMode dell'app non è driving o twoWheeler. Correzione: imposta mapView.travelMode su .driving o .twoWheeler. Controlla resolvedParameters.travelMode per 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.
  • GMSNavigator setDestinations: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 GMSServices appCheckTokenProvider: ritirata dal 24/09/2026. Sostituzione: proprietà della classe GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Sintomo: nella versione 11.1.0, la configurazione di App Check tramite GMSServices.sharedServices() non è riuscita. Consulta la guida alla migrazione.
  • GMSNavigator continueToNextDestination: Deprecato dal 07/04/2026. Sostituzione: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights e showsStopSigns: 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.
  • .terrain Tipo di mappa durante la navigazione attiva: Dismessa dal 06-08-2026. Sostituzione: tipo di mappa .normal (kGMSTypeNormal), .satellite o .hybrid.
  • Protocolli GMSNavigatorDelegate e GMSRoadSnappedLocationProviderDelegate: ritirati dal 13 maggio 2021. Sostituzione: GMSNavigatorListener e GMSRoadSnappedLocationProviderListener (aggiungi con -addListener:; imposta timeUpdateThreshold e distanceUpdateThreshold su GMSNavigator). 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