À propos de l'API Places (nouvelle version)

Développeurs de l'Espace économique européen (EEE)

Introduction

L'API Places (New) inclut les API suivantes :

Ce document présente ces nouvelles API.

Place Details (New)

Un ID de lieu identifie de façon unique un lieu dans la base de données Google Places et sur Google Maps. Avec un ID de lieu, vous pouvez demander des informations sur un établissement ou un point d'intérêt spécifique en lançant une requête Place Details (New). Une requête Place Details (New) renvoie des informations complètes sur le lieu indiqué, comme son adresse complète, son numéro de téléphone, la note des utilisateurs et les avis.

Il existe de nombreuses façons d'obtenir un identifiant de lieu. Vous pouvez utiliser :

Photos de lieux (nouveau)

Place Photos (nouveau) vous permet d'ajouter du contenu photographique de haute qualité à votre application en vous donnant accès aux millions de photos stockées dans la base de données Google Places. L'API Place Photos (New) vous permet d'accéder aux photos et de redimensionner l'image pour qu'elle s'adapte parfaitement à votre application.

Toutes les requêtes envoyées à l'API Place Photos (New) doivent inclure un nom de ressource photo, qui identifie de manière unique la photo à renvoyer. Vous pouvez obtenir le nom de ressource de la photo à l'aide de :

Pour inclure le nom de ressource de la photo dans la réponse d'une requête Place Details (New), Text Search (New) ou Nearby Search (New), assurez-vous d'inclure le champ photos dans le masque de champ de la requête.

Text Search (nouvelle version) et Nearby Search (nouvelle version)

L'API Places inclut deux API Search :

  • Recherche textuelle (nouveau)

    Vous permet de spécifier une chaîne de texte sur laquelle rechercher un lieu. Par exemple : "Cuisine végétarienne épicée à Sydney, en Australie" ou "Restaurant de fruits de mer gastronomique près de Palo Alto, en Californie".

    Vous pouvez affiner la recherche en précisant des détails tels que les gammes de prix, l'état d'ouverture actuel, les notes ou des types de lieux spécifiques. Vous pouvez également spécifier de biaiser les résultats vers un lieu spécifique ou de limiter la recherche à un lieu spécifique.

  • Nearby Search (nouveau)

    Vous permet de spécifier une région à rechercher ainsi qu'une liste de types de lieux. Spécifiez la région sous la forme d'un cercle défini par les coordonnées de latitude et de longitude du point central et du rayon en mètres.

    Spécifiez un ou plusieurs types de lieux qui définissent les caractéristiques du lieu. Par exemple, spécifiez "pizza_restaurant" et "shopping_mall" pour rechercher une pizzeria située dans un centre commercial de la région spécifiée.

La principale différence entre les deux recherches est que Text Search (nouvelle version) vous permet de spécifier une chaîne de recherche arbitraire, tandis que Nearby Search (nouvelle version) nécessite une zone spécifique dans laquelle effectuer la recherche.

Saisie semi-automatique (nouveau) et jetons de session

Autocomplete (New) est un service Web qui renvoie des prédictions de lieux et de requêtes en réponse à une requête HTTP. Dans la requête, spécifiez une chaîne de recherche textuelle et des limites géographiques qui contrôlent la zone de recherche.

Les jetons de session sont des chaînes générées par l'utilisateur qui suivent les appels Autocomplete (nouveau) en tant que sessions. La saisie semi-automatique (nouveau) utilise des jetons de session pour regrouper les phases de requête et de sélection d'une recherche de saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation.

Nouveaux champs, attributs et options d'accessibilité

L'API Places (nouveau) inclut de nouveaux champs, attributs et options d'accessibilité pour fournir aux utilisateurs plus d'informations sur un lieu. Ces aspects sont décrits dans les sections suivantes.

Champs

La nouvelle API Places inclut plusieurs nouveaux champs :

Champ Description
regularSecondaryOpeningHours Décrit des heures spécifiques pour certaines opérations. Les horaires d'ouverture secondaires sont différents des horaires principaux d'un établissement. Par exemple, un restaurant peut spécifier les horaires du drive ou de la livraison comme horaires secondaires.
paymentOptions Options de paiement acceptées par le lieu. Un lieu peut accepter plusieurs options de paiement. Si les données de l'option de paiement ne sont pas disponibles, le champ de l'option de paiement ne sera pas défini. Voici quelques exemples d'options :
  • Carte de crédit
  • Carte de débit
  • Argent liquide seulement
  • paiement NFC
parkingOptions Options de stationnement proposées par le lieu. Voici quelques exemples d'options :
  • Parkings gratuits
  • Parkings payants
  • Parking gratuit dans la rue
  • Service de voiturier
  • Parking couvert gratuit
  • Parking couvert payant
subDestinations Lieux uniques associés à un lieu spécifique. Par exemple, les terminaux d'aéroport sont considérés comme des sous-destinations d'un aéroport.
fuelOptions Les informations les plus récentes sur les options de carburant disponibles dans une station-service. Ces informations sont mises à jour régulièrement. Voici quelques exemples d'options :
  • Véhicule diesel
  • Sans plomb standard
  • Intermédiaire
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95-E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Méthane
  • Biodiesel
  • Diesel pour camions
evChargeOptions Nombre de bornes de recharge pour véhicules électriques (VE) à cette station. Bien que certains chargeurs de véhicules électriques disposent de plusieurs connecteurs, chacun d'eux ne peut recharger qu'un seul véhicule à la fois. Par conséquent, ce champ reflète le nombre de chargeurs de véhicules électriques disponibles à un moment donné.
shortFormattedAddress Adresse courte et lisible d'un lieu.
primaryType Type principal du résultat donné. Par exemple, un lieu peut être classé comme cafe ou airport. Un lieu ne peut avoir qu'un seul type principal. Pour obtenir la liste complète des valeurs possibles, consultez Types acceptés.
primaryTypeDisplayName Nom à afficher du type principal, localisé dans la langue de la requête, le cas échéant. Pour obtenir la liste complète des valeurs possibles, consultez Types acceptés.

Attributs

L'API Places (New) inclut plusieurs nouveaux attributs :

Attribut Description
outdoorSeating L'établissement dispose d'une terrasse.
liveMusic Le lieu propose des concerts.
menuForChildren L'établissement propose un menu pour enfants.
servesCocktails L'établissement sert des cocktails.
servesDessert L'établissement sert des desserts.
servesCoffee Le lieu sert du café.
goodForChildren Lieu adapté aux enfants.
allowsDogs Les chiens sont acceptés.
restroom L'établissement dispose de toilettes.
goodForGroups L'établissement peut accueillir des groupes.
goodForWatchingSports L'établissement est adapté pour regarder des événements sportifs.

Options d'accessibilité

L'API Places (nouveau) inclut les champs d'options d'accessibilité suivants :

Champ Description
wheelchairAccessibleParking Le parking est accessible en fauteuil roulant.
wheelchairAccessibleEntrance L'établissement dispose d'une entrée accessible en fauteuil roulant.
wheelchairAccessibleRestroom L'établissement dispose de toilettes accessibles en fauteuil roulant.
wheelchairAccessibleSeating L'établissement propose des places assises accessibles en fauteuil roulant.

Résumés optimisés par l'IA

Les résumés optimisés par l'IA de la nouvelle API Places utilisent les fonctionnalités du modèle Gemini pour renvoyer des résumés sur des lieux et des zones qui peuvent aider les utilisateurs à choisir leur destination.

Les résumés optimisés par l'IA synthétisent les données provenant de diverses sources pour aider les utilisateurs à prendre des décisions plus éclairées sur un lieu. Par exemple, si vous envisagez d'essayer un nouveau restaurant, un résumé optimisé par l'IA peut mettre en évidence les plats les plus populaires du menu, vous donner une idée de l'ambiance ou regrouper les thèmes des avis des utilisateurs. Si vous visitez une nouvelle ville, un résumé optimisé par l'IA peut vous donner un aperçu des attractions et des commodités à proximité.

Ajout de fonctionnalités optimisées par l'IA à l'API Places (nouveau)

Les résumés optimisés par l'IA sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New). Les résumés optimisés par l'IA suivants sont disponibles dans les réponses de l'API Places (New) :

  • Résumés des lieux : il s'agit de brefs résumés liés à un lieu spécifique.
  • Les résumés des avis, qui sont des résumés faciles à lire de ce que les utilisateurs ont dit sur un lieu.
  • Les résumés de zones, qui présentent les lieux à proximité et les lieux populaires dans les environs. Il s'agit, par exemple, des résumés de quartier et des résumés des bornes de recharge pour véhicules électriques.

Google régénère fréquemment ces résumés pour s'assurer qu'ils sont à jour en fonction des dernières informations disponibles. Lorsque vous effectuez une requête Places API (New), les données les plus récentes s'affichent dans votre application.

Migrer vers les nouvelles API Places

Si vous êtes déjà client de l'API Places (nouvelle version) et que vous souhaitez migrer votre application pour utiliser les nouvelles API, consultez la documentation de migration suivante :