L'API Places vous permet de rechercher et de récupérer des informations sur divers types de lieux à l'aide d'une chaîne de texte ou par proximité. L'API Places est l'ancienne version de l'API Places (nouvelle version).
Le tableau suivant répertorie les versions correspondantes des deux API. Consultez ce guide pour comprendre les principales différences entre les deux et migrer vers l'API Places (nouvelle).
| API Places (ancienne) | API Places (New) | Remarques |
|---|---|---|
| Find Place (Ancien) | Recherche textuelle (nouvelle) | Il n'existe pas de nouvelle version de Find Place. Text Search (nouvelle version) l'a remplacé. |
| Recherche à proximité (ancienne) | Nearby Search (Nouveau) | Toutes les requêtes utilisant l'ancienne API et incluant une requête textuelle doivent utiliser Text Search (New), car Nearby Search (New) n'est pas compatible avec la saisie de texte. |
| Recherche dans le texte (ancienne) | Recherche textuelle (nouvelle) | |
| Informations sur le lieu (ancienne version) | Informations sur le lieu (nouvelle version) | |
| Placer une photo (ancienne interface) | Placer une photo (nouveau) | |
| Place Autocomplete (ancienne version) | Saisie semi-automatique (nouvelle) | |
| Saisie semi-automatique des requêtes (ancienne) | Saisie semi-automatique (nouvelle) | Fonctionnalités ajoutées à la saisie semi-automatique (nouvelle). |
Migrer vers les nouvelles API
Pour migrer vers les nouvelles API, consultez les guides de migration suivants:
- Migrer vers Nearby Search (Nouveau)
- Migrer vers Text Search (nouveau)
- Migrater vers Place Details (Nouveau)
- Migrer vers Place Photo (nouvelle version)
- Migrer vers la saisie semi-automatique (nouveau)
Principales fonctionnalités ajoutées à l'API Places (nouvelle version)
Cette section présente les principales fonctionnalités ajoutées à l'API Places (nouvelle version).
Implémenté sur la plate-forme standard Google Cloud
L'API Places (nouvelle) est implémentée sur l'infrastructure de service de Google Cloud. Cette implémentation offre une plate-forme plus sécurisée et fiable, avec des options de sécurité renforcées telles que OAuth. Cette conception d'API standard apporte un niveau de cohérence entre les API qui améliore l'efficacité du développement avec l'API Places (nouvelle version).
Performances améliorées
L'API Places (nouvelle version) offre de meilleures performances, ce qui justifie le remplacement des applications qui utilisent l'API Places existante.
Tarification simplifiée
La tarification est simplifiée avec l'API Places (nouvelle) afin que vous ne payiez que pour les données que vous utilisez. La tarification simplifiée est implémentée à l'aide d'un masque de champ.
Avec Place Details (New), Nearby Search (New) et Text Search (New), vous utilisez le masque de champ pour contrôler la liste des champs à renvoyer dans la réponse. Seules les données demandées vous sont alors facturées. Le masquage de champ 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.
Données de réponse cohérentes pour un lieu
Avec les API existantes, les API Place Details, Nearby Search et Text Search renvoyaient des données de réponse différentes pour un lieu. L'API Places (nouvelle) standardise la réponse afin que ces API renvoient toutes les mêmes données pour un lieu.
Types de lieux étendus
La réponse de l'API peut désormais contenir le type principal d'un lieu. Chaque lieu peut avoir une seule valeur de type spécifiée comme type principal du lieu, comme indiqué dans le tableau A.
La nouvelle API inclut également plusieurs nouveaux types. Vous pouvez utiliser ces nouveaux types, ainsi que les types existants, dans une recherche avec la recherche à proximité (nouvelle) et la recherche textuelle (nouvelle). Les nouveaux types sont tous inclus dans le tableau A.
Données de lieu dynamiques
L'API Places (nouvelle) prend en charge les données de réponse dynamiques, telles que la disponibilité d'une borne de recharge de VE ou les derniers prix des carburants pour une station-service. Utilisez ces champs de réponse pour créer des expériences utilisateur dynamiques.