À propos de l'API Places (nouvelle version)

L'API Places (nouvelle version) inclut les API suivantes:

Ce document présente ces nouvelles API.

Place Details (New)

Un identifiant de lieu permet d'identifier un lieu de manière unique 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 complètes sur le lieu indiqué, comme son adresse complète, son numéro de téléphone, les notes des visiteurs et avis.

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

Place Photo (nouvelle version)

L'API Place Photo (nouvelle version) vous permet d'ajouter des photos de haute qualité à votre application en vous donnant accès aux millions de photos stockées dans l'application base de données Google Places. À l'aide de l'API Place Photo (nouvelle version), vous pouvez accéder aux des photos et redimensionner l'image à la taille adaptée à votre application.

Toutes les requêtes envoyées à l'API Place Photo (nouvelle version) 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)

    Vous permet de spécifier une chaîne de texte à partir de laquelle rechercher un lieu. Par exemple: "Nourriture végétarienne épicée à Sydney, Australie" ou "Restaurants de fruits de mer raffinés à proximité de Palo Alto, Californie".

    Vous pouvez affiner la recherche en spécifiant des informations telles que les niveaux 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)

    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 la latitude et la longitude. coordonnées 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 (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 du texte chaîne de recherche et 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écrites dans les sections suivantes.

Champs

L'API Places (nouvelle version) comprend plusieurs nouveaux champs :

Champ Description
regularSecondaryOpeningHours Décrit les heures particulières 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 Modes de paiement acceptés par le lieu. Un lieu peut accepter plus de une seule option 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. Les options sont les suivantes:
  • 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. Les options sont les suivantes : les éléments suivants:
  • Véhicule diesel
  • Standard sans plomb
  • Intermédiaire
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GPL
  • E80
  • E85
  • Le méthane
  • Biodiesel
  • Camion diesel
evChargeOptions Nombre de bornes de recharge de 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 intelligible 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 les valeurs possibles, consultez la section Types acceptés.
primaryTypeDisplayName Nom à afficher du type principal, localisé en fonction de la requête langue, le cas échéant. Pour obtenir la liste complète des valeurs possibles, consultez la section Types acceptés.

Attributs

L'API Places (nouvelle version) comprend plusieurs nouveaux attributs:

Attribut Description
outdoorSeating L'établissement possède une terrasse aménagée.
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 Cet établissement est bon pour les enfants.
allowsDogs Les chiens sont acceptés.
restroom L'établissement dispose de toilettes.
goodForGroups L'établissement peut accueillir des groupes.
goodForWatchingSports Lieu adapté au visionnage d'événements sportifs.

Options d'accessibilité

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

Champ Description
wheelchairAccessibleParking L'établissement propose un parking accessible en fauteuil roulant.
wheelchairAccessibleEntrance L'établissement dispose d'une entrée accessible en fauteuil roulant.
wheelchairAccessibleRestroom L'établissement comprend des toilettes accessibles en fauteuil roulant.
wheelchairAccessibleSeating L'établissement dispose de sièges accessibles en fauteuil roulant.

Migrer vers les nouvelles API Places

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