À 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 identifie 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). Une requête Place Details (New) renvoie des informations complètes sur le lieu indiqué, telles que son adresse complète, son numéro de téléphone, les notes des visiteurs et ses avis.

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

Place Photo (Nouveau)

L'API Place Photo (nouvelle version) 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'aide de l'API Place Photo (nouvelle version), vous pouvez accéder aux photos et redimensionner l'image à la taille optimale pour votre application.

Toutes les requêtes adressé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 la commande suivante:

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), veillez à 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:

  • Text Search (nouvelle version)

    Permet de spécifier une chaîne de texte sur laquelle rechercher un lieu. Par exemple : "Plat végétarien épicé à Sydney, en Australie" ou "Restaurants de poissons et fruits de mer raffinés à proximité de Palo Alto, en 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 limiter les résultats à un lieu spécifique ou de limiter la recherche à un lieu en particulier.

  • Nearby Search (nouveau)

    Vous permet de spécifier une région à rechercher et 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 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.

Autocomplete (nouveau) et jetons de session

Autocomplete (nouveau) 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 (New) 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 avec 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 version) 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) 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 standards d'un établissement. Par exemple, un restaurant peut indiquer des horaires de drive ou de livraison comme horaires secondaires.
paymentOptions Modes de paiement acceptés par le lieu. Un même établissement peut accepter plusieurs options de paiement. Si aucune donnée n'est disponible, le champ de l'option de paiement n'est 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. Les options sont les suivantes:
  • Parkings sans frais
  • Parkings payants
  • Parking gratuit dans la rue
  • Service de voiturier
  • Parking couvert sans frais
  • Parking couvert payant
subDestinations Lieux uniques associés à un lieu spécifique. Par exemple, les terminaux d'un aéroport sont considérés comme des sous-destinations d'un aéroport.
fuelOptions Informations les plus récentes sur les options de carburant disponibles dans une station-service. Ces informations sont mises à jour régulièrement. Les options sont les suivantes:
  • 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 soient équipés 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 bornes de recharge 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é en tant que 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 (nouvelle version) comprend plusieurs nouveaux attributs:

Attribut Description
outdoorSeating L'établissement possède une terrasse aménagée.
liveMusic Cet établissement accueille des concerts.
menuForChildren L'établissement propose un menu enfant.
servesCocktails L'établissement sert des cocktails.
servesDessert L'établissement propose des desserts.
servesCoffee Cet établissement sert du café.
goodForChildren L'établissement est bon pour les enfants.
allowsDogs Les chiens sont acceptés dans l'établissement.
restroom L'établissement est équipé 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 dispose d'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 pour utiliser les nouvelles API, consultez la documentation sur la migration suivante: