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

Ce guide vous permet de comprendre les principales différences entre les versions du SDK Places et de migrer vers le SDK Places pour Android (nouveau).

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
Saisie semi-automatique (nouvelle version) API Places (nouvelle version) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (nouvelle version) API Places (nouvelle version) initializeWithNewPlacesApiEnabled() 3.3.0
Nearby Search (nouvelle version) API Places (nouvelle version) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (nouvelle version) API Places (nouvelle version) initializeWithNewPlacesApiEnabled() 3.4.0
Text Search (nouvelle version) API Places (nouvelle version) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete API Places (Legacy) initialize() (obsolète)
Current Place API Places (Legacy) initialize() (obsolète)
Place Details API Places (Legacy) initialize() (obsolète)
Place Photos API Places (Legacy) initialize() (obsolète)

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 (nouveau)

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

Implémentation sur la plate-forme standard Google Cloud

Le SDK Places pour Android (nouveau) est implémenté sur l'infrastructure de service de Google Cloud. Cette implémentation offre une plate-forme plus sécurisée et fiable. Cette conception standard assure un niveau de cohérence entre les SDK, ce 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 le remplacement des 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 :

Text Search (nouvelle version)

Text Search (nouvelle version) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York" ou "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 (nouvelle version) et Place Photos (nouvelle version)

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

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

Tarification simplifiée

La tarification est simplifiée avec le SDK Places pour Android (nouveau) : vous ne payez que pour 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 (nouvelle version) et Text Search (nouvelle version), vous utilisez des listes de champs pour contrôler la liste des champs à renvoyer dans la réponse. Vous n'êtes ensuite facturé(e) que pour les données demandées. L'utilisation d'une liste de champs est une bonne pratique de conception 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 les tarifs, consultez Utilisation et facturation.

Types de lieux étendus

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