L'API Places est compatible avec deux versions : les API existantes sont appelées API Places, tandis que la version de nouvelle génération est appelée API Places (nouvelle).
Avec la sortie de l'API Places (nouvelle), votre première tâche consiste à choisir l'ensemble d'API à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilise déjà les API. Utilisez ce guide pour comprendre les principales différences entre les deux API.
Liste des API
Le tableau suivant liste les deux ensembles d'API. Si vous êtes un client existant, utilisez ce tableau pour déterminer la nouvelle API qui remplace une API que vous utilisez.
| API Places | API Places (New) | Remarque |
|---|---|---|
| Find Place | Recherche textuelle (nouvelle) | Il n'existe pas de nouvelle version de Find Place. Text Search (nouvelle version) l'a remplacé. |
| Nearby Search | Nearby Search (Nouveau) | Toutes les requêtes utilisant l'API existante 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 | Recherche textuelle (nouvelle) | |
| Informations sur le lieu | Informations sur un lieu (nouvelle version) | |
| Placer une photo | Placer une photo (nouveau) | |
| Place Autocomplete | Saisie semi-automatique (nouvelle version) | |
| Saisie semi-automatique des requêtes | Saisie semi-automatique (nouvelle version) | Fonctionnalités ajoutées à la saisie semi-automatique (nouvelle) |
La version du service de l'API Places que vous activez sur votre clé API contrôle les API utilisées par votre application:
API Places: active les API existantes. Si seule l'API Places est activée pour le projet associé à la clé API utilisée pour votre application, votre application n'aura pas accès aux nouvelles API.
API Places (nouvelle): permet d'utiliser toutes les nouvelles API et fonctionnalités décrites dans la section Principales fonctionnalités ajoutées au SDK Places pour iOS (nouveau). Votre application n'aura pas accès aux API existantes.
Les deux: active toutes les fonctionnalités et API pour le SDK Places pour iOS (nouveau) et le SDK Places pour iOS.
Pour en savoir plus sur la sélection du service de l'API Places, consultez Configurer votre projet Google Cloud.
Migrer vers les nouvelles API
Si vous utilisez une API existante et que vous souhaitez passer à la nouvelle API, consultez les guides de migration suivants pour chaque API:
- Migrer vers Nearby Search (Nouveau)
- Migrater vers la recherche dans le texte (nouveau)
- Migrater vers Place Details (Nouveau)
- Migrater vers Place Photo (Nouveau)
- Migrate to Autocomplete (Nouveau)
Principales fonctionnalités ajoutées à l'API Places (nouveau)
Cette section présente les principales fonctionnalités ajoutées à l'API Places (nouvelle).
Implémenté sur la plate-forme standard Google Cloud
L'API Places (nouveau) est implémentée sur l'infrastructure de service sur 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).
Performances améliorées
L'API Places (nouvelle) offre de meilleures performances, ce qui justifie le remplacement des applications qui utilisent l'API Places existante.
Tarification simplifiée
Les tarifs sont simplifiés avec l'API Places (nouvelle) afin que vous ne payiez que 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. Vous ne payez alors que les données demandées. Le masquage de champ est une bonne pratique de conception pour vous assurer de ne pas demander de données inutiles, ce qui permet d'éviter des temps de traitement et des frais de facturation inutiles.
Données de réponse cohérentes pour un lieu
Avec les API existantes, les API Place Details, Nearby Search et Text Search renvoyaient différentes données de réponse 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.
De plus, la nouvelle API ajoute les types d'établissements indiqués dans le tableau ci-dessous. Vous pouvez utiliser ces nouveaux types, ainsi que les types existants, dans une recherche avec Nearby Search (nouveau) et Text Search (nouveau). Les nouveaux types sont tous inclus dans le tableau A.
| Type | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | ferme | korean_restaurant | sporting_goods_store |
| barber_shop | vacances à la ferme | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | marché | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | tailleur |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| consultant | héliport | aire de jeu | vegetarian_restaurant |
| convention_center | hiking_area | centre préscolaire | vietnamese_restaurant |
| cottage | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | auberge de jeunesse | resort_hotel | grossiste |
| dental_clinic | hotel | rest_stop |
En plus de ces nouveaux types, l'API Places (nouvelle) a déplacé les types suivants du tableau 2 de l'API Places vers le tableau A de l'API Places (nouvelle). Vous pouvez donc désormais utiliser ces types dans une recherche:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Données dynamiques sur les lieux
L'API Places (nouvelle) est compatible avec les données de réponse dynamiques, telles que la disponibilité d'une borne de recharge de VE ou les derniers prix des carburants d'une station-service. Utilisez ces champs de réponse pour créer des expériences utilisateur dynamiques.
Quelle API choisissez-vous ?
Avant de pouvoir commencer à développer une application, vous devez choisir votre API:
Si vous êtes un nouveau client qui commence à utiliser l'API Places, commencez par les nouvelles API.
Si vous êtes un nouveau client et qu'il n'existe pas encore de solution de remplacement pour une API existante, telle que la saisie semi-automatique de lieux ou de requêtes, vous pouvez utiliser une combinaison d'API nouvelles et existantes.
Si vous êtes un client existant, vous pouvez continuer à utiliser les API existantes. Toutefois, pour profiter des améliorations de performances et des fonctionnalités de l'API Places (nouvelle), vous pouvez migrer vers les nouvelles API.
Pour en savoir plus sur la migration, consultez la section Présentation de la migration.