Riferimento rapido di Maps SDK for iOS

Maps SDK for iOS consente di aggiungere mappe basate sui dati di Google Maps alle app per iOS. L'SDK gestisce l'accesso ai server di Google Maps, la visualizzazione della mappa e la risposta alle attivazioni dall'utente, oltre a consentirti di aggiungere alla mappa indicatori, polilinee, overlay del terreno e finestre informative.

Maps SDK for iOS: informazioni chiave

  • Prodotto: Maps SDK for iOS
  • Noto anche come: Google Maps SDK for iOS
  • Category: Maps
  • Piattaforma: iOS
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica di Maps SDK for iOS
  • Disponibilità regionale: ovunque. Consulta la pagina sulla copertura di Google Maps Platform. I link alla pagina Utilizzo e fatturazione separano i listini prezzi globali da quelli per l'India. (dettagli sulla copertura)

Maps SDK for iOS: quando utilizzarlo

Utilizza Maps SDK for iOS quando:

  • Hai bisogno di una mappa Google interattiva con gestione dei gesti all'interno di un'app per iOS nativa.
  • Devi aggiungere indicatori, polilinee, overlay del terreno o finestre informative a una mappa in un'app per iOS.
  • Devi mostrare panoramiche in Street View all'interno di un'app per iOS.
  • Devi eseguire la geocodifica inversa delle coordinate in indirizzi da un'app per iOS che mostra una mappa.

Non utilizzare Maps SDK for iOS quando:

  • Hai bisogno di mappe 3D fotorealistiche in un'app per iOS. Utilizza invece Maps 3D SDK for iOS.
  • Devi solo aprire una località o le indicazioni stradali nell'app Google Maps anziché eseguire il rendering di una mappa nella tua app. Utilizza invece gli URL di Maps.

Maps SDK for iOS: configurazione

Pacchetti Maps SDK for iOS ufficiali:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

Maps SDK for iOS: errori comuni

  • Problema: l'SDK non supporta le librerie unibili; l'attivazione di Build Mergeable Library in Xcode causa errori del linker nelle build di release. Correzione: mantieni l'impostazione Build Mergeable Library (Crea libreria unibile) su No (impostazione predefinita). Consulta /maps/documentation/ios-sdk/config.
  • Problema: senza le voci LSApplicationQueriesSchemes, toccando il logo Google sulla mappa vengono registrati errori -canOpenURL per comgooglemaps:// e googlechromes://. Correzione: aggiungi googlechromes e comgooglemaps a LSApplicationQueriesSchemes in Info.plist. Consulta /maps/documentation/ios-sdk/config.
  • Problema: è improbabile che l'utilizzo dell'SDK all'interno delle estensioni delle app per iOS (ad esempio una tastiera personalizzata) funzioni a causa di rigide limitazioni della memoria. Correzione: utilizza l'SDK nell'app principale, non nelle estensioni dell'app. Consulta /maps/documentation/ios-sdk/overview.
  • Problema: l'SDK non è ottimizzato per più finestre o istanze simultanee di iPadOS 13 e versioni successive e potrebbe mostrare un comportamento non definito. Correzione: testa attentamente gli scenari iPad con più finestre o evita più istanze di mappe simultanee. Consulta /maps/documentation/ios-sdk/overview.

Maps SDK for iOS: funzionalità legacy e deprecate

  • Renderer OpenGL e setMetalRendererEnabled: ritirati dal 19 maggio 2025. Sostituzione: renderer Metal (predefinito dalla versione 8.0.0); rimuovi setMetalRendererEnabled. Sintomo: deprecato nella versione 9.0.0 (28/05/2024) e rimosso nella versione 10.0.0; GMSServices non elenca più setMetalRendererEnabled:.
  • Modulo GoogleMapsM4B: ritirato dal 19 maggio 2025. Sostituzione: rimuovi il pod o il framework GoogleMapsM4B, che si riferisce a un piano di fatturazione obsoleto. Sintomo: deprecato il 20 febbraio 2024; rimosso dal pacchetto Swift nella versione 9.0.0 e dall'SDK nella versione 10.0.0.
  • Distribuzione CocoaPods: ritirata dal 6 agosto 2026. Sostituzione: Swift Package Manager. Sintomo: modalità di manutenzione dal 18 agosto 2025; deprecata a partire dalla versione 11.0.0. Consulta la guida alla migrazione.
  • Installazione di Carthage: ritirata dal 27 giugno 2022. Sostituzione: Swift Package Manager. Sintomo: Carthage non supporta le librerie destinate a iOS 13 e versioni successive; l'ultima versione disponibile tramite Carthage è la 6.2.1. Consulta la guida alla migrazione.

Cosa puoi fare con Maps SDK for iOS

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.

Maps SDK for iOS: stile basato sui dati per i confini

Maps SDK for iOS: stile basato sui dati per i set di dati

Maps SDK for iOS: set di dati

Maps SDK for iOS: Geocoding

Maps SDK for iOS: Maps

Maps SDK for iOS: annotazioni sulle mappe

Maps SDK for iOS: stile di mappa

Maps SDK for iOS: Street View