À 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 lieu établissement ou point d'intérêt via la fonctionnalité Place Details (Nouveau) requête. 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 ID de lieu. Vous pouvez utiliser :

Place Photo (Nouveau)

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 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 optimale pour 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 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), procédez comme suit : requête 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: "Nourriture végétarienne épicée à Sydney, Australie" ou "restaurants de poissons et 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 pour limiter les résultats à un emplacement spécifique ou restreindre la recherche vers un emplacement spécifique.

  • 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 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 à un emplacement. Par exemple, indiquez "pizza_restaurant". et "shopping_mall" à cherche une pizzeria située dans un centre commercial au dans la même région.

La principale différence entre les deux recherches est que Text Search (nouvelle version) vous permet spécifier une chaîne de recherche arbitraire, tandis que Nearby Search (nouveau) nécessite un identifiant la zone 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 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 Autocomplete (New) comme sessions. La saisie semi-automatique (nouveau) utilise des jetons de session pour regrouper la requête et d'une recherche avec saisie semi-automatique en une session discrète pour à 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é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. Secondaire les horaires d'ouverture sont différents des horaires standards d'un établissement. Pour Par exemple, un restaurant peut spécifier des horaires de drive ou un service de 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 aucune information sur les options de paiement n'est disponible, le 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. Les options sont les suivantes:
  • Parkings gratuits
  • 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. Pour exemple, les terminaux d'aéroport sont considérés comme des sous-destinations à l'aéroport.
fuelOptions Les informations les plus récentes sur les options de carburant disponibles à un 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 Alors que Certains chargeurs de VE ont plusieurs connecteurs, chaque chargeur ne peut recharger un 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. A 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 page Types compatibles.

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 utilisez déjà l'API Places et souhaitez migrer votre application vers utilisez les nouvelles API, consultez la documentation sur la migration suivante: