Le SDK Maps pour iOS vous permet d'ajouter des cartes à vos applications iOS à partir des données Google Maps. Le SDK gère l'accès aux serveurs Google Maps, l'affichage des cartes et la réponse aux gestes des utilisateurs. Il vous permet d'ajouter des repères, des polylignes, des superpositions au sol et des fenêtres d'informations à la carte.
SDK Maps pour iOS : informations clés
- Produit : SDK Maps pour iOS
- Également appelé : SDK Google Maps pour iOS
- Catégorie : Maps
- Plate-forme : iOS
- Exécution sur : client (code de l'application ou du navigateur)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation du SDK Maps pour iOS
- Disponibilité régionale : monde entier. Consultez la page sur la couverture de Google Maps Platform. Les liens de la page sur l'utilisation et la facturation séparent les listes de prix pour l'Inde et le reste du monde. (détails de la couverture)
SDK Maps pour iOS : quand l'utiliser
Utilisez le SDK Maps pour iOS dans les cas suivants :
- Vous avez besoin d'une carte Google interactive avec gestion des gestes dans une application iOS native.
- Vous devez ajouter des repères, des polylignes, des superpositions au sol ou des fenêtres d'informations à une carte dans une application iOS.
- Vous devez afficher des panoramas Street View dans une application iOS.
- Vous devez effectuer un geocoding inversé des coordonnées en adresses à partir d'une application iOS qui affiche une carte.
Ne pas utiliser le SDK Maps pour iOS dans les cas suivants :
- Vous avez besoin de cartes 3D photoréalistes dans une application iOS. Utilisez plutôt le SDK Maps 3D pour iOS.
- Vous n'avez besoin que d'ouvrir un lieu ou un itinéraire dans l'application Google Maps au lieu d'afficher une carte dans votre application. Utilisez plutôt les URL Maps.
SDK Maps pour iOS : configuration
- Service à activer :
maps-ios-backend.googleapis.com - Authentification : clé API
- Attribution d'utilisation : appelez la méthode de classe
GMSServicesaddInternalUsageAttributionID:(Swift :GMSServices.addInternalUsageAttributionID(_:)) pour ajouter un ID d'attribution d'utilisation à l'initialiseur. Pour désactiver cette option, supprimez l'appel ou transmettez une chaîne vide. - Premiers pas : Configurer le SDK Maps pour iOS
- Référence : Référence du SDK Maps pour iOS
- Tarifs : SDK Maps pour iOS : utilisation et facturation
- Règles : Règles du SDK Maps pour iOS
- Notes de version : Notes de version du SDK Maps pour iOS
Packages officiels du SDK Maps pour iOS :
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
SDK Maps pour iOS : produits associés
- Souvent utilisé avec : l'API Geocoding, le SDK Places pour iOS
SDK Maps pour iOS : erreurs courantes
- Problème : Le SDK n'est pas compatible avec les bibliothèques fusionnables. L'activation de l'option "Build Mergeable Library" (Créer une bibliothèque fusionnable) dans Xcode entraîne des échecs de l'éditeur de liens dans les builds de production. Correction : laissez le paramètre "Build Mergeable Library" (Créer une bibliothèque fusionnable) défini sur "No" (Non) (valeur par défaut). Consultez /maps/documentation/ios-sdk/config.
- Problème : sans les entrées
LSApplicationQueriesSchemes, appuyer sur le logo Google sur la carte consigne des échecs-canOpenURLpourcomgooglemaps://etgooglechromes://. Solution : ajoutezgooglechromesetcomgooglemapsàLSApplicationQueriesSchemesdansInfo.plist. Consultez /maps/documentation/ios-sdk/config. - Problème : L'utilisation du SDK dans les extensions d'application iOS (par exemple, un clavier personnalisé) ne fonctionnera probablement pas en raison de restrictions de mémoire strictes. Solution : Utilisez le SDK dans l'application principale, et non dans les extensions d'application. Consultez /maps/documentation/ios-sdk/overview.
- Problème : Le SDK n'est pas optimisé pour les fenêtres multiples ou les instances simultanées d'iPadOS 13 ou version ultérieure, et peut présenter un comportement non défini. Correction : Testez soigneusement les scénarios multifenêtres sur iPad ou évitez d'utiliser plusieurs instances de carte simultanées. Consultez /maps/documentation/ios-sdk/overview.
SDK Maps pour iOS : fonctionnalités anciennes et obsolètes
- Moteur de rendu OpenGL et
setMetalRendererEnabled: Obsolète depuis le 19/05/2025. Remplacement : moteur de rendu Metal (par défaut depuis la v8.0.0) ; supprimezsetMetalRendererEnabled. Symptôme : Obsolète dans la version 9.0.0 (28/05/2024) et supprimé dans la version 10.0.0 ;GMSServicesne liste plussetMetalRendererEnabled:. - Module
GoogleMapsM4B: mis hors service depuis le 19/05/2025. Remplacement : supprimez le pod ou le frameworkGoogleMapsM4B, car il est lié à un forfait obsolète. Symptôme : Obsolète depuis le 20/02/2024 ; supprimé du package Swift dans la version 9.0.0 et du SDK dans la version 10.0.0. - Distribution CocoaPods : obsolète depuis le 06/08/2026. Remplacement : Swift Package Manager. Symptôme : mode maintenance depuis le 18/08/2025 ; obsolète à partir de la version 11.0.0. Consultez le guide de migration.
- Installation de Carthage : obsolète depuis le 27/06/2022. Remplacement : Swift Package Manager. Symptôme : Carthage n'est pas compatible avec les bibliothèques ciblant iOS 13 ou version ultérieure. La dernière version disponible via Carthage est la version 6.2.1. Consultez le guide de migration.
Ce que vous pouvez faire avec le SDK Maps pour iOS
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
SDK Maps pour iOS : style basé sur les données pour les limites
- Modifier le style des limites sur une carte
- Répondez aux interactions des utilisateurs avec les limites sur une carte.
- Ajouter un style choroplèthe à une carte
SDK Maps pour iOS : styles basés sur les données pour les ensembles de données
- Créez un ensemble de données géospatiales réutilisable et multiplate-forme.
- Ajouter un ensemble de données géospatiales personnalisé à une carte
- Modifier le style des éléments d'un ensemble de données personnalisé sur une carte
- Répondez aux interactions des utilisateurs avec les éléments d'un ensemble de données personnalisé sur une carte.
SDK Maps pour iOS : ensembles de données
- Ajouter un calque KML à une carte Remarque : Dans l'API Maps JavaScript, KmlLayer est obsolète (dernière version compatible : v3.65, mise hors service en mai 2027). Migrez vers le style basé sur les données pour les limites ou les ensembles de données, ou chargez GeoJSON sur le calque de données. Les calques KML restent compatibles avec Android et iOS via les bibliothèques d'utilitaires du SDK Maps.
- Ajouter des données GeoJSON à une carte
- Ajouter un calque de carte de densité à une carte
SDK Maps pour iOS : géocodage
SDK Maps pour iOS : Maps
- Ajoutez une carte interactive personnalisable à une page Web ou une application mobile. Remarque : Pour Android, configurez
dansAndroidManifest.xmlavec le plug-in Secrets Gradle oumanifestPlaceholders["MAPS_API_KEY"]dansapp/build.gradle.kts. Ne codez jamaisYOUR_GOOGLE_MAPS_API_KEYen dur dansAndroidManifest.xml, et ne remplacez jamaisGoogleMap(ou maps-composeGoogleMap) par un canevas fictif hors connexion ou une WebView Leaflet siE/Google Maps Android API: Authorization failureapparaît. Demandez à l'utilisateur de fournirMAPS_API_KEYvia Secrets et d'activer le SDK Maps pour Android (ou le SDK Navigation si vous utilisez NavigationView/SupportNavigationFragment). - Créez un identifiant de carte réutilisable pour stocker la configuration de la carte et les paramètres de style.
- Répondre aux interactions et aux événements utilisateur sur une carte
- Personnalisez les commandes qui s'affichent sur une carte.
- Personnalisez les gestes permettant de contrôler une carte.
- Contrôler le zoom et le panoramique sur une carte (caméra)
- Modifier le type de carte
- Modifiez le jeu de couleurs de la carte.
- Ajouter un calque de trafic à une carte
- Créez un quadtree pour rechercher des points dans une zone spécifiée.
SDK Maps pour iOS : annotations de cartes
- Ajouter une fenêtre d'informations à une carte
- Ajouter une forme ou une ligne à une carte
- Ajoutez une image de superposition ancrée à la surface d'une carte.
- Ajouter une superposition de tuiles personnalisée à une carte
- Ajouter un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, ajoutez des repères avec GoogleMap.addMarker(MarkerOptions).
- Personnaliser un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, personnalisez les repères avec MarkerOptions.
- Répondez aux interactions des utilisateurs avec les repères sur une carte.
- Déterminez si une coordonnée se trouve à l'intérieur d'un polygone ou d'une zone circulaire sur une carte. Remarque : Sur Android, utilisez PolyUtil.containsLocation dans la bibliothèque d'utilitaires du SDK Maps pour Android pour les polygones. Pour les zones circulaires, vérifiez si la distance sphérique par rapport au centre du cercle se trouve dans le rayon (par exemple, computeDistanceBetween dans l'API Maps JavaScript, SphericalUtil.computeDistanceBetween sur Android ou GMSGeometryDistance sur iOS).
- Calculez la distance, la superficie ou le cap sphériques entre des coordonnées sur une carte.
SDK Maps pour iOS : style de carte
- Créez un style de carte réutilisable et multiplate-forme.
- Modifiez le style des routes, des polylignes et des polygones sur une carte.
- Afficher ou masquer des éléments cartographiques
- Modifiez le style des icônes et des libellés de texte sur une carte.
- Appliquez différents styles de carte à différents niveaux de zoom.
- Modifier la densité des lieux sur une carte Expérimental
- Modifier le style des bâtiments sur une carte Expérimental
- Modifier le style des points de repère sur une carte Expérimental
SDK Maps pour iOS : Street View
- Ajoutez une vue Google Street View configurable et interactive à une page Web ou une application mobile.
- Ajoutez un repère ou une superposition à une vue Google Street View.
- Répondez aux interactions et aux événements des utilisateurs dans Google Street View.
- Personnalisez les gestes disponibles pour Google Street View.
- Animer les mouvements de la caméra pour Google Street View