L'API Places (nouvelle version) inclut les API suivantes:
- Place Details (New)
- Place Photo (nouveauté)
- Nearby Search (nouveau)
- Text Search (nouvelle version)
- Saisie semi-automatique (nouveauté)
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 :
- Text Search (nouvelle version)
- Nearby Search (nouveau)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
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.
-
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:
|
parkingOptions |
Options de stationnement proposées par l'établissement. Les options sont les suivantes:
|
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:
|
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: