L'API Places est compatible avec deux versions d'API: L'API Places permet API existantes et API Places (Nouveau) sont les suivants de génération des API.
Avec le lancement de l'API Places (nouvelle version), votre première tâche consiste à choisir ensemble d'API à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilisent déjà les API. Ce guide vous aidera à comprendre les clés les différences entre les deux API.
Liste des API
Le tableau suivant répertorie les deux ensembles d'API. Si vous êtes déjà client, utilisez ce tableau pour déterminer la nouvelle API qui remplace une API que vous que vous utilisez actuellement.
| API Places | API Places (New) | Remarque |
|---|---|---|
| Find Place | Text Search (nouvelle version) | 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 qui incluent une requête textuelle doivent utiliser Text Search (nouvelle version) car Nearby Search (nouvelle version) ne prend pas en charge la saisie de texte. |
| Text Search | Text Search (nouvelle version) | |
| Place Details | Place Details (New) | |
| Place Photo | Place Photo (nouveauté) | |
| Place Autocomplete | Saisie semi-automatique (nouveauté) | |
| Query Autocomplete | Saisie semi-automatique (nouveauté) | Fonctionnalités ajoutées à la saisie semi-automatique (nouveau) |
La version du service de l'API Places que vous activez contrôle les API utilisées par votre application:
API Places: active les API existantes. Si seulement L'API Places est activée pour le projet associé à la clé API utilisée pour votre application, celle-ci n'aura pas accès aux nouvelles API.
API Places (nouvelle version): active toutes les nouvelles API et décrites dans la section Principales fonctionnalités ajoutées SDK Places pour iOS (nouveau) Votre application ne n'ont pas accès aux API existantes.
Les deux: active toutes les fonctionnalités et API pour les deux SDK Places pour iOS (nouveau) et 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 souhaitez passer à la nouvelle API, consultez la les guides de migration suivants pour chaque API:
- Migrer vers Nearby Search (nouveau)
- Migrer vers Text Search (nouvelle version)
- Migrer vers Place Details (nouveau)
- Migrer vers Place Photo (nouveau)
- 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ée sur la plate-forme standard Google Cloud
L'API Places (nouvelle version) est implémentée sur le d'infrastructure de service sur Google Cloud. Grâce à cette implémentation, vous bénéficiez d'un environnement avec des options de sécurité renforcée, OAuth. Cette API standard apporte un niveau de cohérence entre les API, ce qui améliore l'efficacité de développement avec l'API Places (nouvelle version).
Performances améliorées
L'API Places (nouvelle version) offre de meilleures performances, ce qui oblige à remplacer les applications qui utilisent l'API Places existante.
Tarification simplifiée
La tarification est simplifiée grâce à l'API Places (nouvelle version) : pour payer les données que vous utilisez. La tarification simplifiée est mise en œuvre à l'aide d'un masque de champ.
Avec Place Details (New), Nearby Search (nouveau) Text Search (nouvelle version) : utilisez le masque de champ pour contrôler liste des champs à renvoyer dans la réponse. Vous ne payez alors que les données demandée. Le masquage de champ est une bonne pratique de conception pour vous assurer que Ne demandez pas de données inutiles, ce qui permet d'éviter des temps de traitement inutiles et les frais de facturation.
Données de réponse cohérentes pour un lieu
Avec les API existantes, Place Details, Nearby Search et Text Search Les API renvoyaient des données de réponse différentes pour un lieu. 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 développés
La réponse de l'API peut désormais contenir le type principal d'un lieu. Chaque lieu peut avoir une valeur de type unique spécifiée comme type principal du lieu, comme indiqué dans Tableau A :
En outre, la nouvelle API ajoute les types de lieux indiqués dans le tableau ci-dessous. Vous pouvez utiliser ces nouveaux types et les types existants dans une recherche avec Nearby Search (nouveau) et Text Search (nouvelle version). Les nouveaux types sont tous inclus dans 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 | 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 jeux | 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 |
Parallèlement à ces nouveaux types, l'API Places (nouvelle version) a déplacé les types suivants du tableau 2 pour l'API Places au tableau A pour l'API Places (nouvelle version). Vous pouvez donc désormais utiliser ces types dans un recherche:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Données de lieu dynamiques
L'API Places (nouvelle version) accepte les données de réponse dynamique, comme la disponibilité d'une borne de recharge de VE ou les prix de carburant actualisés 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 des applications, vous devez choisir votre API:
Si vous êtes un nouveau client qui commence tout juste à utiliser l'API Places, Commençons par les nouvelles API.
Si vous êtes un nouveau client et qu'il n'existe pas encore de produit de remplacement pour un API existante, comme Place Autocomplete ou Query de saisie semi-automatique, vous pouvez utiliser une combinaison d'API nouvelles et existantes.
Si vous êtes un client existant, vous pouvez continuer à utiliser le API. Toutefois, pour profiter des améliorations de performances améliorations apportées aux fonctionnalités de l'API Places (nouvelle version), vous pouvez migrer vers de nouvelles API.
Pour en savoir plus sur la migration, consultez la section Migration présentation.