Aide-mémoire sur le SDK Maps pour iOS

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

Packages officiels du SDK Maps pour iOS :

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

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 -canOpenURL pour comgooglemaps:// et googlechromes://. Solution : ajoutez googlechromes et comgooglemaps à LSApplicationQueriesSchemes dans Info.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) ; supprimez setMetalRendererEnabled. Symptôme : Obsolète dans la version 9.0.0 (28/05/2024) et supprimé dans la version 10.0.0 ; GMSServices ne liste plus setMetalRendererEnabled:.
  • Module GoogleMapsM4B : mis hors service depuis le 19/05/2025. Remplacement : supprimez le pod ou le framework GoogleMapsM4B, 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

SDK Maps pour iOS : styles basés sur les données pour les ensembles de données

SDK Maps pour iOS : ensembles de données

SDK Maps pour iOS : géocodage

SDK Maps pour iOS : Maps

SDK Maps pour iOS : annotations de cartes

SDK Maps pour iOS : style de carte

SDK Maps pour iOS : Street View