À propos des nouvelles API Places

La nouvelle API Places inclut les API suivantes:

Ce document contient une présentation de ces nouvelles API.

API Place Details

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, sa note et ses avis.

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

API Place Photo

L'API Place Photo (New) 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 Photo (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 adressées à l'API Place Photo (New) doivent inclure un nom de ressource de 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 et Nearby Search

L'API Places comprend deux API de recherche:

  • Recherche de texte (nouveau)

    Permet de spécifier une chaîne de texte sur laquelle rechercher un lieu. Par exemple : "Nourriture végétarienne épicée à Sydney, Australie" ou "Restaurant de poissons et fruits de mer raffinés près de Palao Alto, Californie".

    Vous pouvez affiner la recherche en indiquant des détails tels que les niveaux de prix, le statut d'ouverture actuel, des avis ou des types de lieux spécifiques. Vous pouvez également spécifier de pondérer les résultats en fonction d'un lieu spécifique ou limiter la recherche à un lieu spécifique.

  • Nearby Search (nouveauté)

    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 (New) vous permet de spécifier une chaîne de recherche arbitraire, tandis que Nearby Search (New) nécessite un domaine spécifique dans lequel effectuer la recherche.

API Autocomplete et jetons de session

L'API Autocomplete (nouvelle) est un service Web qui renvoie des prédictions de lieu et des prédictions de requête 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 Autocomplete (New) en tant que sessions. Autocomplete (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 des 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 spécifier des horaires de drive ou de livraison comme horaires secondaires.
paymentOptions Options de paiement acceptées par le lieu. Un même établissement peut accepter plusieurs options de paiement. Si aucune donnée n'est disponible, le champ des options 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 fournies par le lieu. 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 liés à un lieu particulier. 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:
  • 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 pour véhicules électriques (VE). Bien que certains chargeurs de VE disposent de plusieurs connecteurs, chacun ne peut charger qu'un seul véhicule à la fois. Par conséquent, ce champ indique le nombre de bornes de recharge 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é 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 Des concerts sont organisés.
menuForChildren Cet établissement propose un menu pour enfants.
servesCocktails L'établissement sert des cocktails.
servesDessert Établissement servant des desserts.
servesCoffee L'établissement sert du café.
goodForChildren L'emplacement est idéal pour les enfants.
allowsDogs Les chiens sont acceptés.
restroom L'établissement dispose de toilettes.
goodForGroups L'établissement peut accueillir des groupes.
goodForWatchingSports Ce lieu permet de regarder des é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 Le lieu dispose d'une entrée accessible en fauteuil roulant.
wheelchairAccessibleRestroom L'établissement dispose de toilettes accessibles en fauteuil roulant.
wheelchairAccessibleSeating L'établissement dispose de places assises 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 de migration suivante: