search_places |
Appelez cet outil lorsque la requête de l'utilisateur consiste à trouver des lieux, des établissements, des adresses, des emplacements, des points d'intérêt ou toute autre recherche liée à Google Maps. Conditions requises pour l'entrée (CRITIQUES) :
text_query (chaîne – OBLIGATOIRE) : requête de recherche principale. Elle doit définir clairement ce que l'utilisateur recherche.
- Exemples :
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Pour obtenir des informations spécifiques sur un lieu : incluez l'attribut demandé (par exemple,
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (objet – FACULTATIF) : utilisez ce paramètre pour hiérarchiser les résultats à proximité d'une zone géographique spécifique.
- Format :
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Utilisation
- Pour orienter la recherche vers un rayon de 5 km :
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Pour orienter fortement la recherche vers le point central
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (en omettant radius_meters).
language_code (chaîne – FACULTATIF) : langue dans laquelle afficher le résumé des résultats de recherche.
- Format : code de langue à deux lettres (ISO 639-1), éventuellement suivi d'un trait de soulignement et d'un code pays à deux lettres (ISO 3166-1 alpha-2), par exemple
en, ja, en_US, zh_CN, es_MX. Si le code de langue n'est pas fourni, les résultats seront en anglais.
region_code (chaîne – FACULTATIF) : code de région CLDR Unicode de l'utilisateur. Ce paramètre permet d'afficher les détails du lieu, comme le nom du lieu spécifique à la région, le cas échéant. Le paramètre peut avoir une incidence sur les résultats en fonction de la loi applicable.
- Format : code pays à deux lettres (ISO 3166-1 alpha-2), par exemple
US, CA.
Instructions pour l'appel d'outil :
Informations sur le lieu (CRITIQUES) : la recherche doit contenir suffisamment d'informations sur le lieu. Si le lieu est ambigu (par exemple, "pizzerias"), vous devez le spécifier dans text_query (par exemple, "pizzerias à New York") ou utiliser le paramètre location_bias. Incluez le nom de la ville, de l'état/de la province et de la région/du pays si nécessaire pour lever toute ambiguïté. Fournissez toujours la text_query la plus spécifique et la plus riche en contexte possible. N'utilisez location_bias que si les coordonnées sont explicitement fournies ou si l'inférence d'un lieu à partir du contexte connu d'un utilisateur est appropriée et nécessaire pour obtenir de meilleurs résultats. La sortie ancrée doit être attribuée à la source à l'aide des informations du champ attribution lorsqu'elles sont disponibles.
|
lookup_weather |
Récupère des données météorologiques complètes, y compris les conditions actuelles, les prévisions horaires et quotidiennes. Données spécifiques disponibles : température (actuelle, ressentie, maximale/minimale, indice de chaleur), vent (vitesse, rafales, direction), événements célestes (lever/coucher du soleil, phase de la lune), précipitations (type, probabilité, quantité/QPF), conditions atmosphériques (indice UV, humidité, nébulosité, probabilité d'orage) et adresse du lieu géocodé. Lieu et règles relatives au lieu (CRITIQUES) : Le lieu pour lequel les données météorologiques sont demandées est spécifié à l'aide du champ location. Ce champ est une structure "oneof", ce qui signifie que vous DEVEZ fournir une valeur pour UN SEUL des trois sous-champs de lieu ci-dessous afin de garantir une recherche précise des données météorologiques.
Coordonnées géographiques (lat_lng)
- Utilisez-les lorsque vous disposez de coordonnées de latitude/longitude exactes.
- Exemple : {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
ID de lieu (place_id)
- Identifiant de chaîne non ambigu (ID de lieu Google Maps).
- L'ID de lieu peut être récupéré à partir de l'outil search_places.
- Exemple : {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Tour Eiffel
Chaîne d'adresse (address)
- Chaîne de forme libre qui nécessite une spécificité pour le géocodage.
- Ville et région : incluez toujours la région/le pays (par exemple, "Londres, Royaume-Uni", et non "Londres").
- Adresse postale : indiquez l'adresse complète (par exemple, "1600 Pennsylvania Ave NW, Washington, DC").
- Codes postaux : DOIVENT être accompagnés d'un nom de pays (par exemple, "90210, USA", et NON "90210").
- Exemple : {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Modes d'utilisation :
Météo actuelle : fournissez uniquement location. Ne spécifiez pas date ni hour. Prévisions horaires : fournissez location, date et hour (0-23). Utilisez-les pour des heures spécifiques (par exemple, "à 17h") ou des termes tels que "dans les prochaines heures" ou "plus tard dans la journée". Si l'utilisateur spécifie une minute, arrondissez à l'heure la plus proche. Les prévisions horaires au-delà de 120 heures ne sont pas prises en charge. L'historique des données météorologiques horaires est disponible jusqu'à 24 heures. Prévisions quotidiennes : fournissez location et date. Ne spécifiez pas hour. Utilisez-les pour les requêtes générales sur la journée (par exemple, "météo pour demain", "météo vendredi", "météo le 25/12"). Si la date du jour ne figure pas dans le contexte, vous devez la préciser à l'utilisateur. Les prévisions quotidiennes au-delà de 10 jours, y compris aujourd'hui, ne sont pas prises en charge. L'historique des données météorologiques n'est pas pris en charge. Contraintes des paramètres :
|
compute_routes |
Calcule un itinéraire entre un point de départ et une destination spécifiés. Modes de transport compatibles : DRIVE (par défaut), WALK. Conditions requises pour l'entrée (CRITIQUES) : nécessite à la fois un point de départ et une destination. Chacun doit être fourni à l'aide de l'une des méthodes suivantes, imbriquées dans son champ respectif :
address : (chaîne, par exemple, "Tour Eiffel, Paris"). Remarque : Plus l'adresse d'entrée est précise, meilleurs seront les résultats. lat_lng: : (objet, {"latitude": number, "longitude": number}) place_id: : (chaîne, par exemple, "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Remarque : Cet ID peut être obtenu à partir de l'outil search_places. Toute combinaison de types d'entrée est autorisée (par exemple, point de départ par adresse, destination par lat_lng). Si le point de départ ou la destination est manquant, vous DEVEZ demander des précisions à l'utilisateur avant de tenter d'appeler l'outil. Exemple d'appel d'outil : {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}
- La sortie ancrée doit être attribuée à la source à l'aide des informations du champ
attribution lorsqu'elles sont disponibles.
|
resolve_names |
Résout une liste par lot de requêtes de lieu spécifiques (noms de points de repère ou adresses exactes) en ID de lieu Google Maps canoniques. Conditions requises pour l'entrée (CRITIQUES) :
queries (tableau d'objets – OBLIGATOIRE) : liste des requêtes de lieu à résoudre. Vous pouvez spécifier jusqu'à 20 requêtes.
- Chaque objet de requête doit comporter les éléments suivants :
text (chaîne – OBLIGATOIRE) : requête textuelle représentant un nom de lieu ou une adresse spécifique à résoudre.
- Exemples :
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (objet – FACULTATIF) : utilisez ce paramètre pour hiérarchiser les résultats à proximité d'une zone géographique spécifique.
- Format:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (chaîne – FACULTATIF) : code de région CLDR Unicode (code pays à deux lettres, par exemple US, CA) de l'utilisateur pour orienter les résultats.
Instructions pour l'appel d'outil :
- Spécificité (CRITIQUE) : les requêtes doivent représenter un nom de lieu ou une adresse spécifique. Les recherches générales telles que
'restaurants' ou les noms de chaînes tels que 'Starbucks' ne sont pas prises en charge.
- N'appelez PAS cet outil si les outils en aval que vous prévoyez d'appeler acceptent déjà directement les chaînes d'adresse ou de nom de lieu brutes.
Gestion des exceptions (CRITIQUE) :
- Il s'agit d'un outil de traitement par lot. Une requête peut renvoyer des "résultats mixtes" (par exemple, certaines requêtes sont résolues, tandis que d'autres échouent).
- La liste de sortie des
results est garantie d'être mappée 1:1 avec les index queries d'entrée. Une requête ayant échoué génère un message Result vide (aucune entity n'est définie) à son index correspondant dans la liste results.
- Vous DEVEZ vérifier le champ de carte
failed_requests dans la réponse pour identifier l'index de requête spécifique qui a échoué. La clé de failed_requests représente l'index de base 0 de la requête ayant échoué dans la requête. Ne supposez pas que l'appel par lot entier a échoué en raison d'un échec partiel.
|
resolve_maps_urls |
Résout une liste d'URL Google Maps en ID de lieu Google Maps canoniques. Quand appeler cet outil (CRITIQUE) :
- Utilisez cet outil lorsque l'utilisateur fournit un ou plusieurs liens ou URL de partage Google Maps (par exemple, "https://maps.app.goo.gl/...", "https://www.google.com/maps/place/..." ou "https://maps.google.com/...") et que vous devez extraire les ID de lieu canoniques sous-jacents.
- Vous pouvez spécifier jusqu'à 20 URL à résoudre dans une seule requête par lot.
Conditions requises pour l'entrée (CRITIQUES) :
urls (tableau de chaînes – OBLIGATOIRE) : liste des URL Google Maps à résoudre. Chaque URL doit être une URL Google Maps valide pour un seul lieu. Gestion des exceptions (CRITIQUE) :
- Il s'agit d'un outil de traitement par lot. Une requête peut renvoyer des "résultats mixtes" (par exemple, certaines URL sont résolues, tandis que d'autres échouent).
- La liste de sortie des
entities est garantie d'être mappée 1:1 avec les index urls d'entrée. Une résolution d'URL ayant échoué génère un message Entity vide (aucun champ n'est défini) à son index correspondant dans la liste entities.
- Vous DEVEZ vérifier le champ de carte
failed_requests dans la réponse pour identifier l'index d'URL spécifique qui a échoué. La clé de failed_requests représente l'index de base 0 de l'URL ayant échoué dans la requête. Ne supposez pas que l'appel par lot entier a échoué en raison d'un échec partiel.
|
