Introduction
L'API 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é. L'API Places (ancienne version) 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 version).
| API Places (ancienne version) | API Places (nouvelle version) | Remarques |
|---|---|---|
| Find Place (ancienne version) | Text Search (nouvelle version) | Il n'existe pas de nouvelle version de Find Place (ancienne version). Elle a été remplacée par Text Search (nouvelle version). |
| Nearby Search (ancienne version) | Nearby Search (nouvelle version) | Toutes les requêtes utilisant l'ancienne API qui incluent une requête textuelle doivent utiliser Text Search (nouvelle version) car Nearby Search (nouvelle version) n'accepte pas les entrées de texte. |
| Text Search (ancienne version) | Text Search (nouvelle version) | |
| Place Details (ancienne version) | Place Details (nouvelle version) | |
| Place Photos (ancienne version) | Place Photos (nouvelle version) | |
| Place Autocomplete (ancienne version) | Autocomplete (nouvelle version) | |
| Query Autocomplete (ancienne version) | Autocomplete (nouvelle version) | Fonctionnalités ajoutées à Autocomplete (nouvelle version) |
Migrer vers les nouvelles API
Pour migrer vers les nouvelles API, consultez les guides de migration suivants :
- Migrer vers Nearby Search (nouvelle version)
- Migrer vers Text Search (nouvelle version)
- Migrer vers Place Details (nouvelle version)
- Migrer vers Place Photos (nouvelle version)
- Migrer vers Autocomplete (nouvelle version)
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ée sur la plate-forme standard Google Cloud
L'API Places (nouvelle version) 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é amélioré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 vaut la peine de remplacer les applications qui utilisent l'API Places existante.
Tarification simplifiée
La tarification est simplifiée avec l'API Places (nouvelle version), de sorte que vous ne payez 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 (nouvelle version), Nearby Search (nouvelle version) et Text Search (nouvelle version), vous utilisez le masque de champ pour contrôler la liste des champs à renvoyer dans la réponse. Vous n'êtes ensuite facturé que pour les données demandé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 anciennes API, les API Place Details (ancienne version), Nearby Search (ancienne version) et Text Search (ancienne version) renvoyaient des données de réponse différentes pour un lieu. L'API Places (nouvelle version) 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 Nearby Search (nouvelle version) et Text Search (nouvelle version). Les nouveaux types sont tous inclus dans Table A.
Données de lieu dynamiques
L'API Places (nouvelle version) est compatible avec les données de réponse dynamiques, telles que la disponibilité d'une borne de recharge pour véhicules électriques ou les derniers prix du carburant pour une station-service. Utilisez ces champs de réponse pour créer des expériences utilisateur dynamiques.