Weather API overview
Stay organized with collections
Save and categorize content based on your preferences.
The Weather API lets you request real-time, hyperlocal weather data for
locations around the world. Weather information includes temperature,
precipitation, humidity, and more.
For a location at a given latitude and longitude, the API provides endpoints
that let you query:
- Current conditions: The current weather conditions.
- Hourly forecast: Up to 240 hours of forecasted conditions for all
elements.
- Daily forecast: Up to 10 days of forecasted conditions for all elements.
- Hourly history: Up to 24 hours of cached past conditions for all
elements.
Features of the Weather API
Weather API data includes the following:
- Weather conditions and icons: A description and corresponding icon
indicating the current weather conditions (for example, "Cloudy" or
"Scattered snow showers").
- Temperature: Minimum, maximum, and apparent ("feels like") temperatures.
- Precipitation: Total precipitation and precipitation type (snow, rain,
ice, mix).
- Wind: Average windchill, wind direction, maximum speed, and gust.
- Ice thickness: Thickness of ice.
- Humidity: Dew point, heat index, wet-bulb temperature, and relative
humidity.
- UV index: Ultraviolet (UV) index.
- Thunderstorm probability: The percent chance of a thunderstorm
occurring.
- Visibility: The distance at which an object is clearly visible.
- Air pressure: The average sea level air pressure.
- Sun and moon events: Sunrise, sunset, moonrise, and moonset times.
- Cloud cover: The percentage of the sky covered by clouds.
How to use the Weather API
What's next
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Weather API overview\n\nThe Weather API lets you request real-time, hyperlocal weather data for\nlocations around the world. Weather information includes temperature,\nprecipitation, humidity, and more.\n\nFor a location at a given latitude and longitude, the API provides endpoints\nthat let you query:\n\n- **Current conditions:** The current weather conditions.\n- **Hourly forecast:** Up to 240 hours of forecasted conditions for all elements.\n- **Daily forecast:** Up to 10 days of forecasted conditions for all elements.\n- **Hourly history:** Up to 24 hours of cached past conditions for all elements.\n\nFeatures of the Weather API\n---------------------------\n\nWeather API data includes the following:\n\n- **Weather conditions and icons:** A description and corresponding icon indicating the current weather conditions (for example, \"Cloudy\" or \"Scattered snow showers\").\n- **Temperature:** Minimum, maximum, and apparent (\"feels like\") temperatures.\n- **Precipitation:** Total precipitation and precipitation type (snow, rain, ice, mix).\n- **Wind:** Average windchill, wind direction, maximum speed, and gust.\n- **Ice thickness:** Thickness of ice.\n- **Humidity:** Dew point, heat index, wet-bulb temperature, and relative humidity.\n- **UV index:** Ultraviolet (UV) index.\n- **Thunderstorm probability:** The percent chance of a thunderstorm occurring.\n- **Visibility:** The distance at which an object is clearly visible.\n- **Air pressure:** The average sea level air pressure.\n- **Sun and moon events:** Sunrise, sunset, moonrise, and moonset times.\n- **Cloud cover:** The percentage of the sky covered by clouds.\n\nHow to use the Weather API\n--------------------------\n\n|---|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/weather/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current conditions** | See [Get current conditions](/maps/documentation/weather/current-conditions). |\n| 3 | **Get hourly forecast** | See [Get hourly forecast](/maps/documentation/weather/hourly-forecast). |\n| 4 | **Get daily forecast** | See [Get daily forecast](/maps/documentation/weather/daily-forecast). |\n| 5 | **Get hourly history** | See [Get hourly history](/maps/documentation/weather/hourly-history). |\n\nWhat's next\n-----------\n\n- [Set up your Google Cloud project](/maps/documentation/weather/cloud-setup)\n- [Get current conditions](/maps/documentation/weather/current-conditions)\n- [Get hourly forecast](/maps/documentation/weather/hourly-forecast)\n- [Get daily forecast](/maps/documentation/weather/daily-forecast)\n- [Get hourly history](/maps/documentation/weather/hourly-history)"]]