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 :
- Vous créez une application Android native. Utilisez plutôt le SDK Places pour Android.
- Vous créez une page Web dans le navigateur. Utilisez plutôt l'API Maps JavaScript.
- Vous avez besoin de données de lieu provenant d'un serveur ou d'un backend via HTTP plutôt que d'un client iOS. Utilisez plutôt l'API Places (nouvelle version).
SDK Places pour iOS : configuration
- Service à activer :
places.googleapis.com - Authentification : clé API
- Attribution de l'utilisation : appelez la méthode de classe
addInternalUsageAttributionIDsurGMSPlacesClient(Objective-C/Swift) ouPlacesClient(GooglePlacesSwift) pour ajouter un ID d'attribution de l'utilisation. Supprimez l'appel pour désactiver cette option. - Premiers pas : Configurer le SDK Places pour iOS
- Documentation de référence : Documentation de référence du SDK Places pour iOS
- Tarifs : SDK Places pour iOS : utilisation et facturation
- Règles : Règles du SDK Places pour iOS
- Notes de version : Notes de version du SDK Places pour iOS
Packages officiels du SDK Places pour iOS :
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
SDK Places pour iOS : produits associés
- Souvent utilisé avec : SDK Maps pour iOS
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,GMSAutocompleteFetcheretGMSAutocompleteViewController) n'existent pas dans le SDK 11.0.0 et les versions ultérieures, ce qui interrompt la compilation. Consultez le guide de migration. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCorneretGMSAutocompleteFetcherinitWithBounds:filter: Mis hors service depuis le 13/10/2020. Remplacement :GMSAutocompleteFilter(locationBiasoulocationRestriction) surGMSAutocompleteRequestavecGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, ou les modificateursGooglePlacesSwiftplaceAutocompleteoubasicPlaceAutocompletepour un widget d'interface utilisateur. Symptôme : Les méthodes n'existent pas dans le SDK 4.0.0 et les versions ultérieures (etGMSAutocompleteResultsViewControlleretGMSAutocompleteFetcheront été supprimées dans le SDK 11.0.0). Consultez le guide de migration.- Limites de saisie semi-automatique basées sur
GMSCoordinateBounds(paramètresGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModedefindAutocompletePredictionsFromQueryetautocompleteQuery) : abandonnées depuis le 13/10/2020. Remplacement :GMSAutocompleteRequestparGMSAutocompleteFilter(locationBiasoulocationRestriction) etGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, ou les modificateursGooglePlacesSwiftplaceAutocompleteoubasicPlaceAutocompletepour 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 (etGMSAutocompleteViewControlleretfindAutocompletePredictionsFromQueryont été supprimés dans le SDK 11.0.0). Consultez le guide de migration. GMSPlace.openNowStatus: Obsolète depuis le 13/10/2020. Remplacement :GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) ouPlacesClient.isPlaceOpen(with:)dansGooglePlacesSwift. Symptôme : La propriété n'existe pas dans le SDK 4.0.0 et les versions ultérieures. Consultez le guide de migration.GMSPlaceFielden tant queNS_ENUM: Obsolète depuis le 13-10-2020. Remplacement : constantesGMSPlacePropertypar des classes de requête telles queGMSFetchPlaceRequestetGMSPlaceSearchByTextRequest, ouPlacePropertydansGooglePlacesSwift. Symptôme : remplacé parNS_OPTIONSdans le SDK 4.0.0 (GMSPlaceField, carNS_OPTIONSappartient à 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
- Renvoie un résumé optimisé par l'IA des avis des utilisateurs pour un identifiant de lieu Google spécifié.
- Renvoie un résumé optimisé par l'IA de la zone et des services autour d'un identifiant de lieu Google spécifié pour une borne de recharge de véhicules électriques.
SDK Places pour iOS : Places
- Affichez une liste de lieux et de détails sur les lieux en fonction d'une chaîne de requête.
- Renvoyez une liste de lieux et de détails sur les lieux à proximité d'un emplacement spécifique.
- Renvoie des résultats de saisie semi-automatique sur des lieux en fonction d'une chaîne de requête.
- Renvoie des informations détaillées sur un lieu spécifique.
- Renvoyer des photos d'un lieu spécifique Remarque : Affichez les attributions de l'auteur de chaque photo (le nom de l'auteur, associé à l'URI de son profil) avec la photo. Les règles Places de chaque plate-forme l'exigent, par exemple /maps/documentation/javascript/policies#photo-attributions et /maps/documentation/places/web-service/policies#photos-and-review.
- Redimensionner les photos de lieux
- Renvoyer les notes et les avis d'un lieu spécifique. Remarque : Dans le service Web de l'API Places (New), Place Details est une requête HTTP GET envoyée à https://places.googleapis.com/v1/places/{placeId} avec X-Goog-FieldMask (par exemple, rating,userRatingCount,reviews). Text Search, Nearby Search et Autocomplete utilisent POST. Sur Android, transmettez Place.Field.RATING, USER_RATING_COUNT et REVIEWS à PlacesClient.fetchPlace(). Sur iOS, transmettez GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal et GMSPlacePropertyReviews dans GMSFetchPlaceRequest.
- Ajoutez un widget de saisie semi-automatique à une page Web ou à une application qui renvoie des résultats sur des lieux en fonction d'une chaîne de requête.
- Spécifiez les champs de données inclus dans les réponses aux informations sur les lieux.
- Spécifiez les types de lieux à inclure dans les réponses d'informations sur les lieux.
- Renvoyer des informations sur le lieu où se trouve actuellement l'appareil de l'utilisateur Remarque : Les anciennes méthodes Current Place ont été supprimées du SDK Places pour Android v6.0+ et du SDK Places pour iOS v11.0+. Récupérez les coordonnées de l'appareil à partir des services de localisation de la plate-forme et appelez Nearby Search.
- Renvoyer un résumé généré par l'IA pour un lieu spécifique
- Renvoyez un résumé de la zone optimisé par l'IA décrivant les lieux situés autour d'un lieu spécifique.
- Renvoie des informations sur les lieux situés le long d'un itinéraire prédéfini en fonction d'une chaîne de requête.
- Affichez la distance, le temps de trajet et l'URI de l'itinéraire vers les lieux de Text Search à partir d'un ensemble de coordonnées de latitude/longitude.
- Renvoyer la distance, le temps de trajet et l'URI de l'itinéraire vers des lieux à proximité à partir d'un ensemble de coordonnées de latitude/longitude.
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