Le SDK Places vous permet de rechercher et de récupérer des informations sur 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 SDK Places (nouveau).
Fonctionnalités du SDK disponibles dans chaque version
Le tableau suivant indique les versions de SDK et d'API requises pour chaque fonctionnalité de SDK:
| Fonctionnalité | API Places activée sur la clé API | Méthode d'initialisation | Version minimale du SDK |
|---|---|---|---|
| Saisie semi-automatique (nouvelle) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Informations sur le lieu (nouvelle version) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (Nouveau) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Placer des photos (nouveau) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Recherche textuelle (nouvelle) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places | initialize() |
|
| Current Place | API Places | initialize() |
|
| Place Details | API Places | initialize() |
|
| Placer des photos | API Places | initialize() |
Migrer vers les nouvelles API
Pour migrer vers les nouvelles API, consultez les guides de migration suivants:
- Migrater vers Place Details (Nouveau)
- Migrer vers Place Photo (nouvelle version)
- Migrer vers la saisie semi-automatique (nouveau)
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é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 offre 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 (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:
- Saisie semi-automatique (nouvelle)
- Informations sur le lieu (nouvelle version)
- Nearby Search (Nouveau)
- Placer des photos (nouveau)
- Recherche textuelle (nouvelle)
Nouveau service de recherche textuelle
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.
Nouvelles données de réponse ajoutées à Place Details (New) et Place Photos (New)
Informations sur le lieu (nouveau) inclut désormais la nouvelle classe Avis dans l'objet
Placede la réponse. La classe Place contient la nouvelle méthodegetReviews()pour prendre en charge ce champ. AppelezgetReviews()pour renvoyer jusqu'à cinq avis pour un lieu.Placer une photo (nouveau) ajoute
AuthorAttributionsà la classePhotoMetadata.AuthorAttributionscontient unListd'objetsAuthorAttribution.
Nouvelle réponse URI ajoutée à "Photos de lieux" (nouveau)
Vous pouvez désormais utiliser Placer une photo (nouveau) pour renvoyer un URI vers un bitmap d'image. Auparavant, vous ne pouviez renvoyer que le bitmap de l'image elle-même.
Tarification simplifiée
La tarification est simplifiée avec le SDK Places pour Android (nouveau) afin que vous ne payiez 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. Seules les données demandées vous sont alors facturé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 la tarification des deux SDK, consultez la section Consommation 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 textuelle. Les nouveaux types sont inclus dans le tableau A.