Présentation du SDK Places (ancien)

Le SDK Places vous permet de rechercher et de récupérer des informations pour différents types de lieux à l'aide d'une chaîne de texte ou par proximité. Le SDK Places est l'ancienne version du SDK Places (nouveau).

Utilisez ce guide pour comprendre les principales différences entre les versions du SDK Places et migrer vers le nouveau SDK Places.

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é L'API Places est activée sur la clé API. Méthode d'initialisation Version minimale du SDK
Saisie semi-automatique (nouveau) API Places (New) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (nouveau) API Places (New) initializeWithNewPlacesApiEnabled() 3.3.0
Nearby Search (nouveau) API Places (New) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (nouveau) API Places (New) initializeWithNewPlacesApiEnabled() 3.4.0
Recherche textuelle (nouveau) API Places (New) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete API Places initialize()
Current Place API Places initialize()
Place Details API Places initialize()
Place Photos API Places initialize()

Migrer vers les nouvelles API

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

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

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

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

Le SDK Places pour Android (nouveau) est implémenté sur l'infrastructure de service sur Google Cloud. Cette implémentation permet de disposer d'une plate-forme plus sécurisée et plus 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 (nouveau).

Performances améliorées

Le SDK Places pour Android (nouveau) offre de meilleures performances, ce qui justifie de remplacer les applications qui utilisent le SDK existant.

Nouvelles fonctionnalités

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

Nouveau service Text Search

Text Search (nouveau) 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.

Ajout de nouvelles données de réponse à Place Details (New) et Place Photos (New)

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

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

Nouvelle réponse URI ajoutée à Place Photos (nouveau)

Vous pouvez désormais utiliser Place Photo (nouveau) pour renvoyer un URI vers un bitmap d'image. Auparavant, vous ne pouviez renvoyer que le bitmap de l'image lui-même.

Tarification simplifiée

La tarification est simplifiée avec le SDK Places pour Android (nouveau). Vous ne payez que les données que vous utilisez. La tarification simplifiée est implémentée à l'aide de listes de champs, également appelées masques de champ.

Avec Place Details et Text Search, vous utilisez des listes de champs pour contrôler la liste des champs à renvoyer dans la réponse. Vous ne serez alors facturé que pour les données demandé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 des deux SDK, consultez Utilisation et facturation.

Types de lieux étendus

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