Présentation du SDK Places pour Android (ancienne version)

Ce produit est en état obsolète. À partir d'octobre 2026, l'API Places (ancienne version) ne pourra plus être activée pour les nouveaux projets Google Cloud. Les projets existants restent entièrement compatibles. Pour bénéficier de nouvelles fonctionnalités et de performances améliorées, migrez vers l'API Places (nouvelle version).

Ce guide vous aidera à comprendre les principales différences entre les versions du SDK Places et à migrer vers le SDK Places pour Android (nouvelle version).

Fonctionnalités du SDK disponibles dans chaque version

Le tableau suivant indique les versions du SDK et de l'API requises pour chaque fonctionnalité du SDK :

Fonctionnalité	Version de l'API Places	Méthode d'initialisation	Version minimale du SDK
Autocomplete (New)	API Places (New)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Details (New)	API Places (New)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (New)	API Places (New)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (New)	API Places (New)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (New)	API Places (New)	initializeWithNewPlacesApiEnabled()	3.3.0
Place Autocomplete	API Places (ancienne version)	initialize() (obsolète)
Current Place	API Places (ancienne version)	initialize() (obsolète)
Place Details	API Places (ancienne version)	initialize() (obsolète)
Place Photos	API Places (ancienne version)	initialize() (obsolète)

Obsolète : la méthode Places.initialize est obsolète. Utilisez plutôt Places.initializeWithNewPlacesApiEnabled(). Notez que pour utiliser Places.initializeWithNewPlacesApiEnabled(), vous devez activer l'API Places (New) sur votre clé API dans la console Google Cloud.

Migrer vers les nouvelles API

Pour migrer vers les nouvelles API, consultez les guides de migration suivants :

• Migrer vers Place Details (New)
• Migrer vers Place Photos (New)
• Migrer vers Autocomplete (New)

Améliorations apportées au SDK Places pour Android (nouveau)

Cette section présente les principales fonctionnalités ajoutées au SDK Places pour Android (nouvelle version).

Implémenté sur la plate-forme Google Cloud standard

Le SDK Places pour Android (New) est implémenté sur l'infrastructure de service sur Google Cloud. Cette implémentation permet de proposer une plate-forme plus sécurisée et fiable. Cette conception standard apporte un niveau de cohérence entre les SDK qui améliore l'efficacité du développement avec le SDK Places pour Android (nouvelle version).

Performances améliorées

Le SDK Places pour Android (nouvelle version) offre des performances améliorées, ce qui justifie le remplacement des applications qui utilisent le SDK existant.

Nouvelles fonctionnalités

Le SDK Places pour Android (nouvelle version) inclut les dernières versions de toutes les fonctionnalités du SDK :

• Autocomplete (New)
• Place Details (New)
• Nearby Search (New)
• Place Photos (nouveau)
• Text Search (New)

Text Search (nouvelle version)

Text Search (New) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York", "magasin de chaussures près d'Ottawa" ou "123 Main Street". Ce service renvoie une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.

Nouvelles données de réponse ajoutées à Place Details (New) et Place Photos (New)

• Place Details (New) inclut désormais la nouvelle classe Review dans l'objet de réponse Place. La classe Place contient la nouvelle méthode getReviews() pour prendre en charge ce champ. Appelez getReviews() pour renvoyer jusqu'à cinq avis sur un lieu.

• Place Photos (New) ajoute AuthorAttributions à la classe PhotoMetadata. AuthorAttributions contient un List d'objets AuthorAttribution.

Nouvelle réponse d'URI ajoutée à Place Photos (New)

Vous pouvez désormais utiliser Place Photos (New) pour renvoyer un URI vers un bitmap d'image. Auparavant, vous ne pouviez renvoyer que l'image bitmap elle-même.

Tarification simplifiée

La tarification est simplifiée avec le SDK Places pour Android (nouvelle version) afin que vous ne payiez que pour les données que vous utilisez. La tarification simplifiée est mise en œuvre à l'aide de listes de champs, également appelées masques de champs.

Avec Place Details (New) et Text Search (New), vous utilisez des listes de champs pour contrôler la liste des champs à renvoyer dans la réponse. Seules les données demandées vous sont alors facturées. L'utilisation d'une liste de champs est une bonne pratique à appliquer pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés.

Pour en savoir plus sur la tarification, consultez Utilisation et facturation.

Types de lieux détaillés

Le nouveau SDK inclut de nouveaux types de lieux, qui sont renvoyés dans la réponse Place Details (New) et Text Search (New). Vous pouvez également utiliser ces nouveaux types, ainsi que les types existants, dans une recherche avec Text Search (New). Les nouveaux types sont inclus dans le tableau A.