Choisir la version de votre API

L'API Places est compatible avec deux versions d'API : les API Places sont les API existantes, tandis que l'API Places (nouvelle version) est la version nouvelle génération des API.

Avec le lancement de l'API Places (nouvelle version), 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. Consultez ce guide pour comprendre les principales 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 remplacera une API que vous utilisez actuellement.

API Places API Places (New) Remarque
Find Place Recherche de texte (nouveau) Il n'existe pas de nouvelle version de Find Place. Text Search (New) l'a remplacé.
Nearby Search Nearby Search (nouveauté) Toutes les requêtes utilisant l'API existante qui incluent une requête textuelle doivent utiliser Text Search (New), car Nearby Search (New) n'est pas compatible avec la saisie de texte.
Recherche textuelle Recherche de texte (nouveau)
Place Details Place Details (Nouveau)
Place Photo Place Photo (nouvelle version)
Place Autocomplete Saisie semi-automatique (nouveau) Dans l'aperçu
Saisie semi-automatique des requêtes Saisie semi-automatique (nouveau) Fonctionnalités ajoutées à la version preview d'Autocomplete (nouveau)

Si vous utilisez une API existante et souhaitez migrer vers la nouvelle, consultez les guides de migration suivants pour chaque API:

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).

Mise en œuvre sur la plate-forme standard Google Cloud

L'API Places (nouvelle version) est mise en œuvre sur l'infrastructure de service sur Google Cloud. Cette implémentation lui apporte une plate-forme plus sécurisée et plus 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éliorent l'efficacité du développement avec l'API Places (nouveauté).

Performances améliorées

L'API Places (nouvelle version) offre de meilleures performances. Il est donc intéressant de remplacer les applications qui utilisent l'API Places existante.

Tarification simplifiée

La tarification est simplifiée avec l'API Places (nouvelle version) afin que vous ne payiez que pour 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 (New) et Text Search (New), 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 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 (New) 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 seule valeur de type spécifiée comme type principal du lieu, comme indiqué dans le 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 (New) et Text Search (New). 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 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 playground 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, le SDK Places pour Android (nouveau) a déplacé les types suivants du tableau B vers le tableau A. Cela signifie que vous pouvez désormais utiliser les types suivants dans une recherche :
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

Données de lieu dynamiques

L'API Places (New) est compatible avec les données de réponses dynamiques, telles que la disponibilité d'une borne de recharge de VE ou les prix les plus récents du carburant pour 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 le développement d'applications, vous devez choisir votre API:

  1. Si vous êtes un nouveau client qui fait vos premiers pas avec l'API Places, commencez avec les nouvelles API.

  2. Si vous êtes un nouveau client et qu'il n'existe pas encore de solution de remplacement pour une API existante, telle que Place Autocomplete ou Query Autocomplete, vous pouvez utiliser une combinaison d'API nouvelles et existantes.

  3. Si vous êtes un client existant, vous pouvez continuer à utiliser les API existantes. Toutefois, pour profiter des améliorations des performances et des fonctionnalités de l'API Places (nouvelle version), vous pouvez migrer vers les nouvelles API.

    Pour en savoir plus sur la migration, consultez la section Présentation de la migration.