Introduction
L'API Places (New) inclut les API suivantes :
Ce document présente ces nouvelles API.
Place Details (New)
Un ID de lieu identifie de façon unique un lieu 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, la note des visiteurs et les avis.
Il existe de nombreuses façons d'obtenir un ID de lieu. Voici ce que vous pouvez utiliser :
- Text Search (New)
- Nearby Search (New)
- API Geocoding
- API Routes
- API Address Validation
- Autocomplete (New)
Place Photos (New)
Place Photos (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 Photos (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 Photos (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 en utilisant :
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 (New) et Nearby Search (New)
L'API Places (nouvelle version) inclut deux API de recherche :
-
Permet de spécifier une chaîne de texte sur laquelle rechercher un lieu. Par exemple : "Cuisine végétarienne épicée à Sydney, Australie" ou "Restaurant de fruits de mer gastronomique près de Palo Alto, Californie".
Vous pouvez affiner la recherche en spécifiant des détails tels 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 privilégier les résultats pour un lieu spécifique ou de limiter la recherche à un lieu spécifique.
-
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 une zone de recherche spécifique.
Autocomplete (New) et jetons de session
Autocomplete (New) 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 permettent de suivre les appels Autocomplete (New) en tant que sessions. Autocomplete (New) 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 (New) 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 (New) inclut plusieurs nouveaux champs :
| Champ | Description |
|---|---|
regularSecondaryOpeningHours |
Décrit des horaires particuliers pour certaines opérations. Les horaires d'ouverture secondaires sont différents des horaires d'ouverture principaux d'un établissement. Par exemple, un restaurant peut spécifier des horaires de drive ou de livraison comme horaires secondaires. |
paymentOptions |
Modes de paiement acceptés par l'établissement. Un établissement peut accepter plusieurs modes de paiement. Si les données sur le mode de paiement ne sont pas disponibles, le champ correspondant n'est pas défini. Vous avez le choix entre plusieurs options :
|
parkingOptions |
Options de stationnement proposées par l'établissement. Vous avez le choix entre plusieurs options :
|
subDestinations |
Lieux uniques associés à un lieu particulier. Par exemple, les terminaux d'un aéroport sont considérés comme des sous-destinations de cet 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. Vous avez le choix entre plusieurs options :
|
evChargeOptions |
Nombre de bornes de recharge pour véhicules électriques (VE) à cette station. Bien que certaines bornes pour VE disposent de plusieurs connecteurs, chaque borne ne peut recharger qu'un seul véhicule à la fois. Par conséquent, ce champ reflète le nombre de bornes pour 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é comme cafe ou airport. Un lieu ne peut avoir qu'un seul type principal. Pour obtenir la liste complète des valeurs possibles, consultez Types compatibles. |
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 Types compatibles. |
entrances |
Entrées de la destination. Une entrée est une paire de coordonnées de latitude/longitude unique qui définit l'emplacement d'un point d'entrée et de sortie pour un lieu. |
navigationPoints |
Points de navigation pour la destination. Un point de navigation est un emplacement situé à côté d'une route où la navigation peut se terminer, y compris les modes de transport et les utilisations acceptés. |
Attributs
L'API Places (New) inclut plusieurs nouveaux attributs :
| Attribut | Description |
|---|---|
outdoorSeating |
L'établissement dispose d'une terrasse. |
liveMusic |
L'établissement 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 |
L'établissement est adapté aux enfants. |
allowsDogs |
L'établissement accepte les chiens. |
restroom |
L'établissement dispose de toilettes. |
goodForGroups |
L'établissement peut accueillir des groupes. |
goodForWatchingSports |
L'établissement convient pour regarder du sport. |
Options d'accessibilité
L'API Places (New) 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 dispose de toilettes accessibles en fauteuil roulant. |
wheelchairAccessibleSeating |
L'établissement propose des places assises accessibles en fauteuil roulant. |
Résumés optimisés par l'IA
Les résumés optimisés par l'IA de l'API Places (New) utilisent les fonctionnalités du modèle Gemini pour renvoyer des résumés sur des lieux et des zones qui peuvent aider les utilisateurs à décider où aller.
Les résumés optimisés par l'IA synthétisent les données provenant de différentes sources pour aider les utilisateurs à prendre des décisions plus éclairées concernant un lieu. Par exemple, si vous envisagez d'essayer un nouveau restaurant, un résumé optimisé par l'IA peut mettre en avant les plats les plus populaires, vous donner une idée de l'ambiance ou regrouper les thèmes des avis des utilisateurs. Si vous visitez une nouvelle ville, un résumé optimisé par l'IA peut vous donner un aperçu des attractions et des services à proximité.
Fonctionnalités optimisées par l'IA ajoutées à l'API Places (nouvelle version)
Les résumés optimisés par l'IA sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New). Les résumés suivants optimisés par l'IA sont disponibles dans les réponses de l'API Places (New) :
- Résumés des lieux, qui sont de courts résumés d'un lieu spécifique.
- Résumés des avis, qui sont des résumés faciles à lire de ce que les utilisateurs ont dit d'un lieu.
- Résumés de zone, qui fournissent un aperçu des lieux populaires et à proximité dans les environs. Cela inclut les résumés de quartiers et les résumés de bornes de recharge pour VE.
Google régénère fréquemment ces résumés pour s'assurer qu'ils sont actualisés en fonction des dernières informations disponibles. Lorsque vous envoyez une requête à l'API Places (New), les données les plus récentes s'affichent dans votre application.
Migrer vers l'API Places (New)
Si vous utilisez déjà l'API Places (ancienne version) et que vous souhaitez migrer votre application pour utiliser l'API Places (nouvelle version), consultez la documentation de migration suivante :
- Migrer vers Place Details (New)
- Migrer vers Nearby Search (New)
- Migrer vers Text Search (New)
- Migrer vers Place Photos (New)
- Migrer vers Autocomplete (New)