Aide-mémoire du SDK Places pour iOS

Le SDK Places pour iOS permet aux applications iOS d'obtenir des informations sur des lieux (établissements, points d'intérêt, emplacements géographiques) via Place Details, Place Photos, Text Search, Nearby Search et Autocomplete. L'API Places (New) est la version actuelle du SDK.

SDK Places pour iOS : informations clés

  • Produit : SDK Places pour iOS
  • Également appelé : SDK Places pour iOS (nouveau)
  • Catégorie : Lieux
  • 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 Places pour iOS

SDK Places pour iOS : quand l'utiliser

Utilisez le SDK Places pour iOS dans les cas suivants :

  • Vous avez besoin de détails sur un lieu, de photos, ou de résultats Text Search ou Nearby Search dans une application iOS native.
  • Vous avez besoin de la saisie semi-automatique des noms ou des adresses de lieux à mesure que les utilisateurs saisissent du texte dans une application iOS.
  • Vous souhaitez utiliser des composants prédéfinis du kit UI pour Places (Place Details, Place Search, Place Autocomplete) dans une application iOS.

N'utilisez pas le SDK Places pour iOS dans les cas suivants :

SDK Places pour iOS : configuration

Packages officiels du SDK Places pour iOS :

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

SDK Places pour iOS : erreurs courantes

  • Problème : Les appels du SDK Places pour iOS (New) échouent si l'API Places (New) n'est pas activée dans le projet Cloud ou ne figure pas dans la liste des API autorisées de la clé API. Solution : Activez l'API Places (nouvelle version) et ajoutez-la aux restrictions de clé API utilisées par l'application. Consultez /maps/documentation/places/ios-sdk/legacy/migrate-overview.
  • Problème : kGMSPlacesRateLimitExceeded (-7) signifie que la clé API a dépassé sa limite de débit d'utilisation. Les applications utilisant des versions désactivées du SDK 2.x (désactivées le 29 juillet 2019) reçoivent également cette erreur. Correction : Vérifiez le quota et l'utilisation de l'API Places (New) dans la console Google Cloud, et mettez à jour les applications sur les versions du SDK antérieures à la version 3.0. Consultez /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode.
  • Problème : Les jetons de session réutilisés dans plusieurs applications d'un même projet ou dans plusieurs sessions interrompent le regroupement de la facturation des sessions de saisie semi-automatique. Correction : générez un jeton de session unique (UUID version 4 recommandé) par session de saisie semi-automatique. Les jetons doivent être uniques par projet. Consultez /maps/documentation/places/ios-sdk/use-session-tokens.
  • Problème : Les applications affichent les données de lieu sans les attributions renvoyées par l'API. Correction : Affichez toutes les attributions pertinentes renvoyées avec les données Places, conformément à la page des règles. Consultez /maps/documentation/places/ios-sdk/overview.

SDK Places pour iOS : fonctionnalités anciennes et obsolètes

  • SDK Places pour iOS (ancienne version) : Ancienne version depuis le 01/03/2025. Remplacement : SDK Places pour iOS (nouvelle version) (nécessite l'API Places (nouvelle version)). Symptôme : Les classes et méthodes anciennes (par exemple, fetchPlaceFromPlaceID, GMSAutocompleteFetcher et GMSAutocompleteViewController) n'existent pas dans le SDK 11.0.0 et les versions ultérieures, ce qui interrompt la compilation. Consultez le guide de migration.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner et GMSAutocompleteFetcher initWithBounds:filter : Mis hors service depuis le 13/10/2020. Remplacement : GMSAutocompleteFilter (locationBias ou locationRestriction) sur GMSAutocompleteRequest avec GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, ou les modificateurs GooglePlacesSwift placeAutocomplete ou basicPlaceAutocomplete pour un widget d'interface utilisateur. Symptôme : Les méthodes n'existent pas dans le SDK 4.0.0 et les versions ultérieures (et GMSAutocompleteResultsViewController et GMSAutocompleteFetcher ont été supprimées dans le SDK 11.0.0). Consultez le guide de migration.
  • Limites de saisie semi-automatique basées sur GMSCoordinateBounds (paramètres GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode ; bounds/boundsMode de findAutocompletePredictionsFromQuery et autocompleteQuery) : abandonnées depuis le 13/10/2020. Remplacement : GMSAutocompleteRequest par GMSAutocompleteFilter (locationBias ou locationRestriction) et GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, ou les modificateurs GooglePlacesSwift placeAutocomplete ou basicPlaceAutocomplete pour un widget d'interface utilisateur. Symptôme : Les propriétés et les paramètres n'existent pas dans le SDK 4.0.0 et les versions ultérieures (et GMSAutocompleteViewController et findAutocompletePredictionsFromQuery ont été supprimés dans le SDK 11.0.0). Consultez le guide de migration.
  • GMSPlace.openNowStatus : Obsolète depuis le 13/10/2020. Remplacement : GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) ou PlacesClient.isPlaceOpen(with:) dans GooglePlacesSwift. Symptôme : La propriété n'existe pas dans le SDK 4.0.0 et les versions ultérieures. Consultez le guide de migration.
  • GMSPlaceField en tant que NS_ENUM : Obsolète depuis le 13-10-2020. Remplacement : constantes GMSPlaceProperty par des classes de requête telles que GMSFetchPlaceRequest et GMSPlaceSearchByTextRequest, ou PlaceProperty dans GooglePlacesSwift. Symptôme : remplacé par NS_OPTIONS dans le SDK 4.0.0 (GMSPlaceField, car NS_OPTIONS appartient à l'ancienne API et n'existe pas dans le SDK 11.0.0 et versions ultérieures). Consultez le guide de migration.
  • SDK Places pour iOS version 2.7.0 : mis hors service depuis le 29/07/2019. Remplacement : version actuelle du SDK Places pour iOS. Symptôme : erreurs kGMSPlacesRateLimitExceeded.

Ce que vous pouvez faire avec le SDK Places pour iOS

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.

SDK Places pour iOS : IA générative

SDK Places pour iOS : Places

SDK Places pour iOS : Kit UI pour Places

  • Appliquer un style CSS à un élément d'interface utilisateur de données de lieu Remarque : Les propriétés CSS personnalisées s'appliquent aux éléments du Kit UI pour Places de l'API Maps JavaScript. Le SDK Places pour Android et le SDK Places pour iOS stylisent les vues du Kit UI pour Places de manière programmatique à l'aide d'attributs de thème et de style. EXIGENCE DE CONFORMITÉ POUR L'EEE : Pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq
  • Personnalisez le style et les configurations des éléments d'interface utilisateur pour les données de lieu à l'aide d'un outil de personnalisation des éléments d'interface utilisateur. Remarque : EXIGENCE DE CONFORMITÉ POUR L'EEE : pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq
  • Ajoutez un élément d'interface utilisateur qui affiche des informations sur un lieu spécifique sur une page Web ou dans une application mobile. Remarque : EXIGENCE DE CONFORMITÉ POUR L'EEE : pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq
  • Ajoutez à une page Web un élément d'interface utilisateur qui affiche une liste de lieux en fonction d'une chaîne de requête. Remarque : Compatible avec les pages Web (API Maps JavaScript) et les applications mobiles (SDK Places pour Android et SDK Places pour iOS). EXIGENCE DE CONFORMITÉ POUR L'EEE : Pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq
  • Ajoutez à une page Web un élément d'interface utilisateur qui affiche une liste de lieux à proximité d'un emplacement spécifique. Remarque : Compatible avec les pages Web (API Maps JavaScript) et les applications mobiles (SDK Places pour Android et SDK Places pour iOS). EXIGENCE DE CONFORMITÉ POUR L'EEE : Pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq
  • Ajoutez un élément d'interface utilisateur de base pour la saisie semi-automatique à une page Web ou une application qui renvoie des identifiants de lieux Google en fonction d'une chaîne de requête. Remarque : EXIGENCE DE CONFORMITÉ POUR L'EEE : pour afficher des données de lieu sur une carte dans l'Espace économique européen (EEE), n'appelez pas les services Web de l'API Places depuis un serveur backend. Utilisez les composants du Kit UI pour Places côté client sur la plate-forme cible (API Maps JavaScript sur le Web, SDK Places pour Android sur Android ou SDK Places pour iOS sur iOS). Exigences complètes et questions fréquentes : https://developers.google.com/maps/comms/eea/faq