Le SDK Places pour Android permet aux applications Android d'accéder à la base de données Google d'informations sur les lieux et les établissements via Place Autocomplete, Place Details, Nearby Search, Text Search et Place Photos. Le SDK Places pour Android (New) est la version actuelle et dépend de l'API Places (New).
SDK Places pour Android : informations clés
- Produit : SDK Places pour Android
- Également appelé : SDK Places pour Android (nouvelle version)
- Catégorie : Lieux
- Plate-forme : Android
- 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 Android
SDK Places pour Android : quand l'utiliser
Utilisez le SDK Places pour Android dans les cas suivants :
- Vous avez besoin de détails sur un lieu, de photos, ou de résultats de Nearby Search ou Text Search dans une application Android native.
- Vous avez besoin d'un widget de saisie semi-automatique prêt à l'emploi ou de composants du kit UI pour Places qui renvoient des prédictions de lieux à mesure que les utilisateurs saisissent du texte dans une application Android.
- Vous devez créer des fonctionnalités Android géolocalisées basées sur les établissements et les points d'intérêt situés à proximité de l'appareil de l'utilisateur.
N'utilisez pas le SDK Places pour Android dans les cas suivants :
- Vous devez appeler Places depuis un serveur ou un backend via HTTP, et non depuis une application Android. Utilisez plutôt l'API Places (New).
- Vous créez une application iOS native. Utilisez plutôt le SDK Places pour iOS.
- Vous créez une page Web dans le navigateur. Utilisez plutôt l'API Maps JavaScript.
SDK Places pour Android : configuration
- Service à activer :
places.googleapis.com - Authentification : clé API
- Attribution de l'utilisation : appelez
Places.addInternalUsageAttributionId(String)lors de l'initialisation du SDK pour envoyer un ID d'attribution de l'utilisation. Supprimez l'appel ou transmettez une chaîne vide pour désactiver cette option. - Premiers pas : Configurer le SDK Places pour Android
- Référence : Référence du SDK Places pour Android
- Tarifs : SDK Places pour Android : utilisation et facturation
- Règles : Règles du SDK Places pour Android
- Notes de version : Notes de version du SDK Places pour Android
Packages officiels du SDK Places pour Android :
- maven:
com.google.android.libraries.places:places
SDK Places pour Android : produits associés
- Souvent utilisé avec : SDK Maps pour Android
SDK Places pour Android : erreurs courantes
- Problème : Les requêtes Nearby Search sans liste de champs (masque de champ) ou avec une liste vide renvoient une erreur. Correction : transmettez au moins un
Place.Fielddans la liste de champsSearchNearbyRequest. Voir /maps/documentation/places/android-sdk/nearby-search. - Problème : Place Details (New), Nearby Search (New) et Autocomplete (New) échouent lorsque la clé API ne dispose pas de l'API Places (New), ou sur le SDK 5.x et les versions antérieures lorsque l'application appelle
Places.initialize(). La version 6.0.2 a suppriméPlaces.initialize(). Par conséquent, le code qui l'appelle ne se compile pas après la mise à niveau. Correction : Activez l'API Places (New), ajoutez-la aux API autorisées de la clé API et initialisez-la avecPlaces.initializeWithNewPlacesApiEnabled(). Consultez /maps/documentation/places/android-sdk/legacy/migrate-overview. - Problème : Le
Placerenvoyé parfetchPlace()n'a pas dePhotoMetadata(il n'y a donc rien à résoudre) lorsque la liste de champs ometPHOTO_METADATAS. Correction : incluezPlace.Field.PHOTO_METADATASdans la liste des champs. CommefetchResolvedPhotoUri()est obsolète, utilisez le composant Place Details du Kit UI pour Places pour afficher des photos. Consultez /maps/documentation/places/android-sdk/place-photos. - Problème : Les applications qui affichent des détails, des photos ou des avis sur un lieu sans les attributions de tiers et d'auteur renvoyées ne respectent pas les règles. Correction : Affichez les attributions renvoyées avec les objets
Place,PhotoMetadataetReview. Consultez /maps/documentation/places/android-sdk/policies.
SDK Places pour Android : fonctionnalités anciennes et obsolètes
- Fonctionnalités de l'ancienne version du SDK Places pour Android et de l'ancienne version de l'API Places (Autocomplete, Current Place, Place Details, Place Photos) : Ancienne version depuis le 01/03/2025. Remplacement : fonctionnalités du SDK Places pour Android (New) basées sur l'API Places (New), initialisées avec
Places.initializeWithNewPlacesApiEnabled(). Symptôme : à partir d'octobre 2026, les nouveaux projets Cloud ne pourront plus activer l'API Places (ancienne version) (les projets existants resteront compatibles). Le SDK 6.0.2 a supprimé les anciennes méthodes, qui n'existent que dans la version 5.x et les versions antérieures. Consultez le guide de migration. Places.initialize(): Mis hors service depuis le 30/09/2026. Remplacement :Places.initializeWithNewPlacesApiEnabled(). Symptôme : méthode supprimée du SDK dans la version 6.0.2 ; le code qui l'appelle ne se compile plus. Consultez le guide de migration.PlacesClient.findCurrentPlace()etawaitFindCurrentPlace()(Current Place, ancienne version) : abandonnés depuis le 30/09/2026. Remplacement :PlacesClient.searchNearby()(Nearby Search (New)). Symptôme : les méthodes et les classesFindCurrentPlaceRequest/FindCurrentPlaceResponseont été supprimées dans la version 6.0.2. Consultez le guide de migration.PlacesClient.fetchPhoto()etawaitFetchPhoto(): Abandonné depuis le 30/09/2026. Remplacement : composant Place Details du Kit UI pour Places (PlacesClient.fetchResolvedPhotoUri()est obsolète). Symptôme : les méthodes et les classesFetchPhotoRequest/FetchPhotoResponseont été supprimées dans la version 6.0.2. Consultez le guide de migration.- Widget de saisie semi-automatique de l'API Places (ancienne version) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode) : abandonné depuis le 30/09/2026. Remplacement : widget Place Autocomplete (New) (PlaceAutocomplete) ouPlacesClient.findAutocompletePredictions(). Symptôme : classes supprimées du SDK dans la version 6.0.2. Consultez le guide de migration. - Bibliothèque de compatibilité Places (
com.google.android.libraries.places:places-compat) : obsolète depuis le 31/03/2022. Remplacement : SDK Places pour Android (com.google.android.libraries.places:places). Symptôme : figé à la version 2.6.0 ; aucune nouvelle fonctionnalité ni correction de bug. - Classe
AutocompleteFragment: mise hors service depuis le 25/09/2025. Remplacement : widget Place Autocomplete (New) (PlaceAutocomplete). Symptôme : classe supprimée du SDK dans la version 5.0.0 (AutocompleteSupportFragmenta également été supprimé dans la version 6.0.2).
Ce que vous pouvez faire avec le SDK Places pour Android
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
SDK Places pour Android : 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 Android : 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.
- Renvoyez l'URI pour ouvrir la page d'informations d'un lieu dans Google Maps.
- 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.
- Renvoie la distance, le temps de trajet et l'URI de l'itinéraire entre le point de départ d'un itinéraire prédéfini et chacun des lieux renvoyés en fonction d'une chaîne de requête, qui se trouvent également le long de l'itinéraire.
- Renvoyer la distance, le temps de trajet et l'URI de l'itinéraire entre chacun des lieux renvoyés en fonction d'une chaîne de requête, qui se trouvent également sur un itinéraire prédéfini, et la destination de l'itinéraire.
SDK Places pour Android : 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