search_places |
Llama a esta herramienta cuando la solicitud del usuario sea encontrar lugares, empresas, direcciones, ubicaciones, puntos de interés o cualquier otra búsqueda relacionada con Google Maps. Requisitos de entrada (CRÍTICOS):
text_query (cadena - OBLIGATORIO): Es la búsqueda principal. Debe definir claramente lo que el usuario busca.
- Ejemplos:
'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' y 'accessible public libraries in Los Angeles'
- Para detalles de lugares específicos: Incluye el atributo solicitado (p.ej.,
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').
location_bias (objeto, OPCIONAL): Usa este parámetro para priorizar los resultados cerca de un área geográfica específica.
- Formato:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Uso:
- Para sesgar los resultados hacia un radio de 5 km, haz lo siguiente:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Para sesgar fuertemente hacia el punto central:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (se omite radius_meters).
language_code (cadena - OPCIONAL): Es el idioma en el que se mostrará el resumen de los resultados de la búsqueda.
- Formato: Un código de idioma de dos letras (ISO 639-1), seguido opcionalmente de un guion bajo y un código de país de dos letras (ISO 3166-1 alpha-2), p.ej.,
en, ja, en_US, zh_CN, es_MX. Si no se proporciona el código de idioma, los resultados estarán en inglés.
region_code (cadena - OPCIONAL): Es el código regional CLDR de Unicode del usuario. Este parámetro se usa para mostrar los detalles del lugar, como el nombre específico de la región, si está disponible. El parámetro puede afectar los resultados según la legislación aplicable.
- Formato: Código de país de dos letras (ISO 3166-1 alpha-2), p.ej.,
US o CA.
Instrucciones para la llamada a la herramienta:
Información de ubicación (CRÍTICA): La búsqueda debe contener suficiente información de ubicación. Si la ubicación es ambigua (p.ej., solo "pizzerías"), debes especificarla en text_query (p.ej., "pizzerías en Nueva York") o usar el parámetro location_bias. Incluye el nombre de la ciudad, el estado o la provincia, y la región o el país si es necesario para evitar ambigüedades. Siempre proporciona el text_query más específico y enriquecido contextualmente posible. Solo usa location_bias si se proporcionan coordenadas de forma explícita o si es adecuado y necesario inferir una ubicación a partir del contexto conocido de un usuario para obtener mejores resultados. El resultado fundamentado debe atribuirse a la fuente con la información del campo attribution cuando esté disponible.
|
lookup_weather |
Recupera datos meteorológicos integrales, incluidas las condiciones actuales y los pronósticos por hora y por día. Datos específicos disponibles: Temperatura (actual, sensación térmica, máxima/mínima, índice de calor), viento (velocidad, ráfagas, dirección), eventos celestes (amanecer/atardecer, fase lunar), precipitación (tipo, probabilidad, cantidad/QPF), condiciones atmosféricas (índice UV, humedad, cobertura de nubes, probabilidad de tormentas eléctricas) y dirección de ubicación geocodificada. Ubicación y reglas de ubicación (CRÍTICO): La ubicación para la que se solicitan datos meteorológicos se especifica con el campo location. Este campo es una estructura "oneof", lo que significa que DEBES proporcionar un valor para SOLO UNO de los tres subcampos de ubicación que se indican a continuación para garantizar una búsqueda precisa de datos meteorológicos.
Coordenadas geográficas (lat_lng)
- Úsala cuando se te proporcionen coordenadas exactas de latitud y longitud.
- Ejemplo: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Ángeles
ID de lugar (place_id)
- Es un identificador de cadena inequívoco (ID de lugar de Google Maps).
- El place_id se puede recuperar de la herramienta search_places.
- Ejemplo: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Torre Eiffel
Cadena de dirección (address)
- Es una cadena de formato libre que requiere especificidad para la geocodificación.
- Ciudad y región: Siempre incluye la región o el país (p.ej., "Londres, Reino Unido", no "Londres").
- Dirección: Proporciona la dirección completa (p.ej., "1600 Pennsylvania Ave NW, Washington, DC").
- Códigos postales: DEBEN estar acompañados del nombre del país (p. ej., "90210, EE.UU.", NO "90210").
- Ejemplo: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Modos de uso:
Clima actual: Proporciona solo location. No especifiques date ni hour. Pronóstico por hora: Proporciona location, date y hour (0-23). Úsalo para horarios específicos (p. ej., "a las 5 p.m.") o términos como "en las próximas horas" o "más tarde hoy". Si el usuario especifica minutos, redondea hacia abajo a la hora más cercana. No se admite la previsión por hora más allá de las 120 horas a partir de ahora. El clima histórico por hora se admite hasta 24 horas en el pasado. Pronóstico diario: Proporciona location y date. No especifiques hour. Se usa para solicitudes generales del día (p.ej., "clima para mañana", "clima el viernes", "clima el 25/12"). Si la fecha de hoy no está en el contexto, debes aclararla con el usuario. No se admite la previsión diaria más allá de los 10 días, incluido el día de hoy. No se admite el clima histórico. Restricciones de parámetros:
|
compute_routes |
Calcula una ruta de viaje entre un origen y un destino especificados. Modos de viaje admitidos: DRIVE (predeterminado), WALK. Requisitos de entrada (CRÍTICOS): Requiere origen y destino. Cada uno debe proporcionarse con uno de los siguientes métodos, anidado dentro de su campo respectivo:
address: (cadena, p.ej., "Torre Eiffel, París"). Nota: Cuanto más detallada o específica sea la dirección de entrada, mejores serán los resultados. lat_lng: (objeto, {"latitude": número, "longitude": número}) place_id: (cadena, p.ej., "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Nota: Este ID se puede obtener de la herramienta search_places. Se permite cualquier combinación de tipos de entrada (p.ej., origen por dirección, destino por lat_lng). Si falta el origen o el destino, DEBES pedirle al usuario que te aclare la información antes de intentar llamar a la herramienta. Ejemplo de llamada a herramienta: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}
- El resultado fundamentado debe atribuirse a la fuente con la información del campo
attribution cuando esté disponible.
|
resolve_names |
Resuelve una lista de lotes de búsquedas de ubicaciones específicas (nombres de lugares de interés o direcciones exactas) en IDs de lugar canónicos de Google Maps. Requisitos de entrada (CRÍTICOS):
queries (array de objetos - OBLIGATORIO): Es una lista de búsquedas de ubicación que se resolverán. Puedes especificar hasta 20 búsquedas.
- Cada objeto de consulta debe tener lo siguiente:
text (cadena; OBLIGATORIO): Es la búsqueda de texto que representa un nombre de lugar o una dirección específicos que se deben resolver.
- Ejemplos:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA' y 'Eiffel Tower, Paris'
location_bias (objeto, OPCIONAL): Usa este parámetro para priorizar los resultados cerca de un área geográfica específica.
- Formato:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (cadena, OPCIONAL): Es el código regional CLDR de Unicode (código de país de dos letras, p.ej., US, CA) del usuario para sesgar los resultados.
Instrucciones para la llamada a la herramienta:
- Especificidad (CRÍTICA): Las búsquedas deben representar un nombre o una dirección de lugar específicos. No se admiten búsquedas generales, como
'restaurants', ni nombres de cadenas, como 'Starbucks'.
- NO llames a esta herramienta si las herramientas posteriores que planeas invocar ya aceptan directamente cadenas sin procesar de direcciones o nombres de lugares.
Cómo guardar en Google Maps:
- La respuesta incluye un campo
save_to_maps_url: un solo vínculo de Maps que contiene todos los lugares resueltos correctamente.
- Cuando el usuario quiera guardar, compartir o abrir los lugares resueltos como una lista en Google Maps, muéstrale este vínculo. NO construyas este vínculo por tu cuenta.
Manejo de errores (CRÍTICO):
- Esta es una herramienta de procesamiento por lotes. Una solicitud puede devolver "resultados mixtos" (p.ej., algunas búsquedas se resuelven correctamente, mientras que otras fallan).
- Se garantiza que la lista de salida de
results se asigna 1:1 con los índices de queries de entrada. Una consulta fallida generará un mensaje Result vacío (no se establece ningún entity) en su índice correspondiente en la lista results.
- DEBES verificar el campo del mapa
failed_requests en la respuesta para identificar qué índice de búsqueda específico falló. La clave de failed_requests representa el índice basado en 0 de la búsqueda fallida en la solicitud. No supongas que falló toda la llamada por lotes debido a una falla parcial.
|
resolve_maps_urls |
Resuelve una lista de URLs de Google Maps en IDs de lugar canónicos de Google Maps. Cuándo llamar a esta herramienta (CRÍTICO):
- Usa esta herramienta cuando el usuario proporcione uno o más vínculos o URLs para compartir de Google Maps (p.ej., "https://maps.app.goo.gl/...", "https://www.google.com/maps/place/…" o "https://maps.google.com/…") y necesitas extraer los IDs de lugar canónicos subyacentes.
- Puedes especificar hasta 20 URLs para resolver en una sola solicitud por lotes.
Requisitos de entrada (CRÍTICOS):
urls (array de cadenas; OBLIGATORIO): Es la lista de URLs de Google Maps que se deben resolver. Cada URL debe ser una URL de Google Maps válida para un solo lugar. Cómo guardar en Google Maps:
- La respuesta incluye un campo
save_to_maps_url: un solo vínculo de Maps que contiene todos los lugares resueltos correctamente.
- Cuando el usuario quiera guardar, compartir o abrir los lugares resueltos como una lista en Google Maps (p.ej., recopilar lugares compartidos en una conversación), muéstrale este vínculo. NO construyas este vínculo por tu cuenta.
Manejo de errores (CRÍTICO):
- Esta es una herramienta de procesamiento por lotes. Una solicitud puede devolver "resultados mixtos" (p.ej., algunas URLs se resuelven correctamente, mientras que otras fallan).
- Se garantiza que la lista de salida de
entities se asigna 1:1 con los índices de urls de entrada. Si falla la resolución de la URL, se generará un mensaje Entity vacío (no se establece ningún campo) en su índice correspondiente de la lista entities.
- DEBES verificar el campo del mapa
failed_requests en la respuesta para identificar qué índice de URL específico falló. La clave de failed_requests representa el índice basado en 0 de la URL fallida en la solicitud. No supongas que falló toda la llamada por lotes debido a una falla parcial.
|
