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
- Servizio da attivare:
maps-ios-backend.googleapis.com - Autenticazione: chiave API
- Attribuzione di utilizzo: chiama il metodo della classe
GMSServicesaddInternalUsageAttributionID:(Swift: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 Maps SDK for iOS
- Riferimento: Riferimento di Maps SDK for iOS
- Prezzi: utilizzo e fatturazione di Maps SDK for iOS
- Policy: policy di Maps SDK for iOS
- Note di rilascio: note di rilascio di Maps SDK for iOS
Pacchetti Maps SDK for iOS ufficiali:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK for iOS: prodotti correlati
- Spesso utilizzata con: API Geocoding, Places SDK for iOS
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-canOpenURLpercomgooglemaps://egooglechromes://. Correzione: aggiungigooglechromesecomgooglemapsaLSApplicationQueriesSchemesinInfo.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); rimuovisetMetalRendererEnabled. Sintomo: deprecato nella versione 9.0.0 (28/05/2024) e rimosso nella versione 10.0.0;GMSServicesnon elenca piùsetMetalRendererEnabled:. - Modulo
GoogleMapsM4B: ritirato dal 19 maggio 2025. Sostituzione: rimuovi il pod o il frameworkGoogleMapsM4B, 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
- Modifica lo stile dei confini su una mappa.
- Rispondi alle interazioni degli utenti con i confini su una mappa.
- Aggiungi lo stile coropletico a una mappa.
Maps SDK for iOS: stile basato sui dati per i set di dati
- Crea un set di dati geospaziali multipiattaforma riutilizzabile.
- Aggiungi un set di dati geospaziali personalizzato a una mappa.
- Modifica lo stile delle caratteristiche dei set di dati personalizzati su una mappa.
- Rispondi alle interazioni degli utenti con le caratteristiche dei set di dati personalizzati su una mappa.
Maps SDK for iOS: set di dati
- Aggiungi un livello KML a una mappa. Nota: nell'API Maps JavaScript, KmlLayer è stato ritirato (ultima versione supportata v3.65, dismissione a maggio 2027). Esegui la migrazione allo stile basato sui dati per i confini o i set di dati oppure carica GeoJSON sul livello dati. I livelli KML continuano a essere supportati su Android e iOS tramite le librerie di utilità di Maps SDK.
- Aggiungi dati GeoJSON a una mappa.
- Aggiungi un livello della mappa termica a una mappa.
Maps SDK for iOS: Geocoding
Maps SDK for iOS: Maps
- Aggiungi una mappa interattiva e personalizzabile a una pagina web o a un'app mobile. Nota: per Android, configura
inAndroidManifest.xmlsupportato dal plug-in Secrets Gradle omanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts. Non impostare mai come hardcodedYOUR_GOOGLE_MAPS_API_KEYinAndroidManifest.xmle non sostituire maiGoogleMap(o maps-composeGoogleMap) con un canvas fittizio offline o Leaflet WebView se viene visualizzatoE/Google Maps Android API: Authorization failure. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Crea un identificatore di mappa riutilizzabile per archiviare le impostazioni di configurazione e stile della mappa.
- Rispondi alle interazioni e agli eventi degli utenti su una mappa.
- Personalizza i controlli visualizzati su una mappa.
- Personalizza i gesti per controllare una mappa.
- Controllare lo zoom e la panoramica su una mappa (videocamera).
- Modifica il tipo di mappa.
- Cambia la combinazione di colori della mappa.
- Aggiungi un livello di traffico a una mappa.
- Crea un quadtree per cercare punti all'interno di un'area specificata.
Maps SDK for iOS: annotazioni sulle mappe
- Aggiungi una finestra informativa a una mappa.
- Aggiungi una forma o una linea a una mappa.
- Aggiungi un'immagine in overlay ancorata alla superficie di una mappa.
- Aggiungi un overlay di riquadri personalizzato a una mappa.
- Aggiungi un indicatore a una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions; quando utilizzi l'SDK Navigation per Android, aggiungi gli indicatori con GoogleMap.addMarker(MarkerOptions).
- Personalizza un indicatore su una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions. Quando utilizzi l'SDK Navigation per Android, personalizza gli indicatori con MarkerOptions.
- Rispondi alle interazioni degli utenti con gli indicatori su una mappa.
- Determinare se una coordinata si trova all'interno di un poligono o di un'area circolare su una mappa. Nota: su Android, utilizza PolyUtil.containsLocation nella libreria di utilità di Maps SDK for Android per i poligoni. Per le aree circolari, verifica se la distanza sferica dal centro del cerchio rientra nel raggio (ad esempio, computeDistanceBetween nell'API Maps JavaScript, SphericalUtil.computeDistanceBetween su Android o GMSGeometryDistance su iOS).
- Calcola la distanza sferica, l'area o la direzione tra le coordinate su una mappa.
Maps SDK for iOS: stile di mappa
- Crea uno stile di mappa multipiattaforma riutilizzabile.
- Modifica lo stile di strade, polilinee e poligoni su una mappa.
- Visualizza o nascondi gli elementi della mappa.
- Modifica lo stile delle icone e delle etichette di testo su una mappa.
- Applica stili di mappa diversi a livelli di zoom diversi.
- Modifica la densità dei luoghi su una mappa. Sperimentale
- Modifica lo stile degli edifici su una mappa. Sperimentale
- Modifica lo stile dei punti di riferimento su una mappa. Sperimentale
Maps SDK for iOS: Street View
- Aggiungi una visualizzazione Google Street View configurabile e interattiva a una pagina web o a un'app mobile.
- Aggiungi un indicatore o un overlay a Google Street View.
- Rispondi alle interazioni e agli eventi degli utenti in Google Street View.
- Personalizza i gesti disponibili per Google Street View.
- Anima i movimenti della videocamera per Google Street View.