lookup_weather
Retrieves comprehensive weather data including current conditions, hourly, and daily forecasts.
Specific Data Available: Temperature (Current, Feels Like, Max/Min, Heat Index), Wind (Speed, Gusts, Direction), Celestial Events (Sunrise/Sunset, Moon Phase), Precipitation (Type, Probability, Quantity/QPF), Atmospheric Conditions (UV Index, Humidity, Cloud Cover, Thunderstorm Probability), and Geocoded Location Address.
Location & Location Rules (CRITICAL):
The location for which weather data is requested is specified using the location field.
This field is a 'oneof' structure, meaning you MUST provide a value for ONLY ONE
of the three location sub-fields below to ensure an accurate weather data lookup.
Geographic Coordinates (lat_lng)
Use it when you are provided with exact lat/lng coordinates.
Example: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
Place ID (place_id)
An unambiguous string identifier (Google Maps Place ID).
The place_id can be fetched from the search_places tool.
Example: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eiffel Tower
Address String (address)
A free-form string that requires specificity for geocoding.
City & Region: Always include region/country (e.g., "London, UK", not "London").
Street Address: Provide the full address (e.g., "1600 Pennsylvania Ave NW, Washington, DC").
Postal/Zip Codes: MUST be accompanied by a country name (e.g., "90210, USA", NOT "90210").
Example: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Usage Modes:
Current Weather: Provide
locationonly. Do not specifydateandhour.Hourly Forecast: Provide
location,date, andhour(0-23). Use for specific times (e.g., "at 5 PM") or terms like "next few hours" or "later today". If the user specifies minute, round down to the nearest hour. Hourly forecast beyond 120 hours from now is not supported. Historical hourly weather is supported up to 24 hours in the past.Daily Forecast: Provide
locationanddate. Do not specifyhour. Use for general day requests (e.g., "weather for tomorrow", "weather on Friday", "weather on 12/25"). If today's date is not in the context, you should clarify it with the user. Daily forecast beyond 10 days including today is not supported. Historical weather is not supported.
Parameter Constraints:
Timezones: All
dateandhourinputs must be relative to the location's local time zone, not the user's time zone.Date Format: Inputs must be separated into
{year, month, day}integers.Units: Defaults to
METRIC. Setunits_systemtoIMPERIALfor Fahrenheit/Miles if the user implies US standards or explicitly requests it.The grounded output must be attributed to the source using the information from the
attributionfield when available.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional. The date of the required weather information. Note: This date is relative to the local timezone of the location specified in the location field. The date must be between 24 hours in the past and the next 10 days. | |
| hour | No | Optional. The hour of the requested weather information, in 24-hour format (0-23). This value is relative to the local timezone of the location specified in the location field. Hourly forecast beyond 120 hours from now is not supported. Historical hourly weather is supported up to 24 hours in the past. | |
| location | Yes | Required. The location to get the weather conditions for. | |
| unitsSystem | No | Optional. The units system to use for the returned weather conditions. If not provided, the returned weather conditions will be in the metric system (default = METRIC). | |
| capabilities | No | Optional. The environmental capabilities to include in the response. | |
| languageCode | No | Optional. The BCP-47 language code for localized text in the response (e.g. "en", "ja", "fr-CA"). Defaults to "en" if not specified. | |
| weatherOptions | No | Optional. Options specific to weather requests. `weather_options.units_system` is supported in tandem with top-level `units_system` (tag 4) to preserve backwards compatibility for existing callers; returns INVALID_ARGUMENT if both specify conflicting unit systems. Ignored if `WEATHER` is not requested in `capabilities`. | |
| airQualityOptions | No | Optional. Options specific to air quality requests. Ignored if `AIR_QUALITY` is not requested in `capabilities`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wind | No | The wind conditions | |
| pollen | No | Pollen information at the requested location. | |
| uvIndex | No | The maximum ultraviolet (UV) index. define optional because it is not always available | |
| weather | No | Weather conditions at the requested location. | |
| timeZone | No | Resolved IANA timezone string for the location (e.g., "America/New_York", "Asia/Tokyo"). | |
| heatIndex | No | The hourly heat index temperature. | |
| sunEvents | No | The events related to the sun (e.g. sunrise, sunset). | |
| airQuality | No | Air quality information at the requested location. | |
| cloudCover | No | The percentage of the sky covered by clouds (values from 0 to 100). define optional because it is not always available | |
| moonEvents | No | The events related to the moon (e.g. moonrise, moonset). | |
| airPressure | No | The hourly air pressure conditions. | |
| attribution | No | Required attribution to show with the weather. | |
| temperature | No | The hourly temperature | |
| maxHeatIndex | No | The maximum heat index temperature throughout the day. | |
| precipitation | No | The precipitation probability and amount of precipitation accumulated | |
| maxTemperature | No | The maximum (high) temperature throughout the day. | |
| minTemperature | No | The minimum (low) temperature throughout the day. | |
| relativeHumidity | No | The percent of relative humidity (values from 0 to 100). define optional because it is not always available | |
| returnedLocation | No | Required. The location where the weather information is returned. This location is identical to the location in the request, but can be different from it if the requested location is a free text address that looks up to a coarse location (e.g. "Mountain View, CA"). | |
| weatherCondition | No | The weather condition | |
| feelsLikeTemperature | No | The hourly measure of how the temperature feels like. | |
| feelsLikeMaxTemperature | No | The maximum (high) feels-like temperature throughout the day. | |
| feelsLikeMinTemperature | No | The minimum (low) feels-like temperature throughout the day. | |
| thunderstormProbability | No | The thunderstorm probability (values from 0 to 100). define optional because it is not always available |