Aide-mémoire du SDK Places pour Android

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

Packages officiels du SDK Places pour Android :

  • maven: com.google.android.libraries.places:places

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.Field dans la liste de champs SearchNearbyRequest. 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 avec Places.initializeWithNewPlacesApiEnabled(). Consultez /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problème : Le Place renvoyé par fetchPlace() n'a pas de PhotoMetadata (il n'y a donc rien à résoudre) lorsque la liste de champs omet PHOTO_METADATAS. Correction : incluez Place.Field.PHOTO_METADATAS dans la liste des champs. Comme fetchResolvedPhotoUri() 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, PhotoMetadata et Review. 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() et awaitFindCurrentPlace() (Current Place, ancienne version) : abandonnés depuis le 30/09/2026. Remplacement : PlacesClient.searchNearby() (Nearby Search (New)). Symptôme : les méthodes et les classes FindCurrentPlaceRequest/FindCurrentPlaceResponse ont été supprimées dans la version 6.0.2. Consultez le guide de migration.
  • PlacesClient.fetchPhoto() et awaitFetchPhoto() : 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 classes FetchPhotoRequest/FetchPhotoResponse ont é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) ou PlacesClient.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 (AutocompleteSupportFragment a é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

SDK Places pour Android : Places

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