À propos de l'API Places (nouvelle version)

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 particulier en envoyant une requête Place Details (New) (Informations sur le lieu (nouveau)). Une requête Place Details (New) renvoie des informations détaillées sur le lieu indiqué, telles que son adresse complète, son numéro de téléphone, sa note et ses avis.

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

Photos du lieu (nouvelle version)

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 (nouvelle) 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 (nouvelle) doivent inclure un nom de ressource photo, qui identifie de manière unique la photo à renvoyer. Vous pouvez obtenir le nom de la ressource photo à l'aide de:

Pour inclure le nom de la ressource 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 de recherche:

  • Recherche textuelle (nouvelle)

    Permet de spécifier une chaîne de texte à partir de laquelle rechercher un lieu. Par exemple : "Repas végétarien épicé à Sydney, Australie" ou "Restaurant gastronomique de fruits de mer près de Palo Alto, CA".

    Vous pouvez affiner la recherche en spécifiant des détails tels que les niveaux de prix, l'état d'ouverture actuel, les avis 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)

    Permet de spécifier une région à rechercher ainsi qu'une liste de types de lieux. Spécifiez la région en tant que cercle défini par les coordonnées de latitude et de longitude du point central et le 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 (nouvelle) et jetons de session

Autocomplete (New) est un service Web qui renvoie des prédictions de lieux et des prédictions de requêtes en réponse à une requête HTTP. Dans la requête, spécifiez une chaîne de recherche de texte 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 de saisie semi-automatique (Nouveau) en tant que sessions. La saisie semi-automatique (nouvelle) 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 (nouvelle) 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

L'API Places (nouvelle version) 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 de l'é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 établissement peut accepter plusieurs options de paiement. Si les données sur les options de paiement ne sont pas disponibles, le champ des options de paiement ne sera pas défini. Vous avez le choix entre plusieurs options:
  • Carte de crédit
  • Carte de débit
  • Argent liquide seulement
  • paiement NFC
parkingOptions Options de stationnement proposées par l'établissement. Vous avez le choix entre plusieurs 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 Informations les plus récentes sur les carburants disponibles dans une station-service. Ces informations sont mises à jour régulièrement. Voici quelques options:
  • Véhicule diesel
  • Essence sans plomb ordinaire
  • Intermédiaire
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Méthane
  • Biodiesel
  • Diesel de camion
evChargeOptions Nombre de bornes de recharge pour véhicules électriques (VE) à cette borne. Bien que certains chargeurs de VE disposent de plusieurs connecteurs, chaque chargeur ne peut charger qu'un seul véhicule à la fois. Par conséquent, ce champ reflète le nombre de chargeurs de VE 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 la section 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 la section 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 enfant.
servesCocktails L'établissement sert des cocktails.
servesDessert L'établissement propose des desserts.
servesCoffee L'établissement sert du café.
goodForChildren L'endroit est adapté aux enfants.
allowsDogs Les chiens sont acceptés.
restroom L'établissement dispose de toilettes.
goodForGroups L'établissement accepte les groupes.
goodForWatchingSports L'établissement est adapté pour regarder des événements sportifs.

Options d'accessibilité

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

Champ Description
wheelchairAccessibleParking Le lieu propose un parking 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écapitulatifs optimisés par l'IA de l'API Places (nouveau) utilisent les fonctionnalités du modèle Gemini pour renvoyer des récapitulatifs sur les lieux et les zones qui peuvent aider les utilisateurs à choisir où aller.

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 avant les points forts courants du menu, vous donner une idée de l'ambiance ou rassembler des thèmes à partir des avis des utilisateurs. Si vous visitez une nouvelle ville, un résumé optimisé par l'IA peut vous fournir un aperçu des attractions et des services à proximité.

Fonctionnalités optimisées par l'IA ajoutées à l'API Places (nouveau)

Les récapitulatifs 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 (nouvelle) :

  • Résumés des lieux, qui sont de courts résumés d'informations sur un lieu spécifique.
  • Les résumés des avis, qui sont des résumés faciles à lire de ce que les contributeurs ont dit sur un lieu.
  • Résumés de zone, qui fournissent un aperçu des lieux populaires et à proximité dans la zone environnante. Il s'agit notamment des résumés de quartier et des résumés des bornes de recharge de VE.

Google regénère fréquemment ces récapitulatifs pour s'assurer qu'ils sont à jour en fonction des dernières informations disponibles. Lorsque vous effectuez une requête API Places (nouvelle), vous affichez les données les plus récentes 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 vers les nouvelles API, consultez la documentation de migration suivante: