Open-Meteo Weather API

Vand ID: vand-b94925c2-748a-4811-abce-aedd89190663

Learn how to easily use the Open-Meteo Weather API tool with the OpenAI API.

Open-Meteo offers free weather forecast APIs for open-source developers and non-commercial use. No API key is required.

OpenAI function calls:

{
  "name": "getWeather",
  "description": "current weather and 7 day weather variables in hourly and daily resolution for given WGS84 latitude and longitude coordinates. Available worldwide.  World Meteorological Organization Codes (WMO) should be converted into their meaning (e.g. weathercode 61 is: Rain, not freezing, continuous).",
  "parameters": {
    "type": "object",
    "properties": {
      "hourly": {
        "type": "boolean",
        "description": "A boolean indicating if the hourly forecast data should be fetched."
      },
      "daily": {
        "type": "boolean",
        "description": "A boolean indicating if the daily forecast data should be fetched."
      },
      "latitude": {
        "type": "number",
        "description": "The WGS84 latitude coordinate for the location."
      },
      "longitude": {
        "type": "number",
        "description": "The WGS84 longitude coordinate for the location."
      },
      "current_weather": {
        "type": "boolean",
        "description": "A boolean indicating if current weather data should be fetched; results include World Meteorological Organization Codes (WMO) code for current condition."
      }
    },
    "required": []
  }
}

Auth Type

none

Servers

https://api.open-meteo.com

OpenAPI:

{
  "openapi": "3.0.0",
  "servers": [
    {
      "url": "https://api.open-meteo.com"
    }
  ],
  "info": {
    "title": "Open-Meteo APIs",
    "description": "Open-Meteo offers current weather and weather forcast information using latitude and longitude.",
    "version": "1.0",
    "contact": {
      "name": "Open-Meteo",
      "url": "https://open-meteo.com",
      "email": "info@open-meteo.com"
    },
    "license": {
      "name": "Attribution 4.0 International (CC BY 4.0)",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "termsOfService": "https://open-meteo.com/en/features#terms"
  },
  "paths": {
    "/v1/forecast": {
      "get": {
        "tags": [
          "Weather Forecast APIs"
        ],
        "summary": "current weather and 7 day weather forecast for coordinates",
        "description": "current weather and 7 day weather variables in hourly and daily resolution for given WGS84 latitude and longitude coordinates. Available worldwide.",
        "operationId": "getWeather",
        "parameters": [
          {
            "name": "hourly",
            "in": "query",
            "description": "A boolean indicating if the hourly forecast data should be fetched.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "daily",
            "in": "query",
            "description": "A boolean indicating if the daily forecast data should be fetched.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "latitude",
            "in": "query",
            "required": true,
            "description": "The WGS84 latitude coordinate for the location.",
            "schema": {
              "type": "number",
              "format": "float"
            }
          },
          {
            "name": "longitude",
            "in": "query",
            "required": true,
            "description": "The WGS84 longitude coordinate for the location.",
            "schema": {
              "type": "number",
              "format": "float"
            }
          },
          {
            "name": "current_weather",
            "in": "query",
            "description": "A boolean indicating if current weather data should be fetched; results include World Meteorological Organization Codes (WMO) code for current condition.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "latitude": {
                      "type": "number",
                      "example": 52.52,
                      "description": "WGS84 of the center of the weather grid-cell which was used to generate this forecast. This coordinate might be up to 5 km away."
                    },
                    "longitude": {
                      "type": "number",
                      "example": "13.419.52",
                      "description": "WGS84 of the center of the weather grid-cell which was used to generate this forecast. This coordinate might be up to 5 km away."
                    },
                    "elevation": {
                      "type": "number",
                      "example": 44.812,
                      "description": "The elevation in meters of the selected weather grid-cell. In mountain terrain it might differ from the location you would expect."
                    },
                    "generationtime_ms": {
                      "type": "number",
                      "example": 2.2119,
                      "description": "Generation time of the weather forecast in milli seconds. This is mainly used for performance monitoring and improvements."
                    },
                    "utc_offset_seconds": {
                      "type": "integer",
                      "example": 3600,
                      "description": "Applied timezone offset from the \u0026timezone= parameter."
                    },
                    "hourly": {
                      "type": "HourlyResponse",
                      "description": "For each selected weather variable, data will be returned as a floating point array. Additionally a `time` array will be returned with ISO8601 timestamps."
                    },
                    "hourly_units": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      },
                      "description": "For each selected weather variable, the unit will be listed here."
                    },
                    "daily": {
                      "type": "DailyResponse",
                      "description": "For each selected daily weather variable, data will be returned as a floating point array. Additionally a `time` array will be returned with ISO8601 timestamps."
                    },
                    "daily_units": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      },
                      "description": "For each selected daily weather variable, the unit will be listed here."
                    },
                    "current_weather": {
                      "type": "CurrentWeather",
                      "description": "Current weather conditions with the attributes: time, temperature, wind_speed, wind_direction and weather_code"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "boolean",
                      "description": "Always set true for errors"
                    },
                    "reason": {
                      "type": "string",
                      "description": "Description of the error",
                      "example": "Latitude must be in range of -90 to 90\u00b0. Given: 300"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "HourlyResponse": {
        "type": "object",
        "required": [
          "time"
        ],
        "properties": {
          "time": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "temperature_2m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "relative_humidity_2m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "dew_point_2m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "apparent_temperature": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "pressure_msl": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "cloud_cover": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "cloud_cover_low": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "cloud_cover_mid": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "cloud_cover_high": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_speed_10m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_speed_80m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_speed_120m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_speed_180m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_direction_10m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_direction_80m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_direction_120m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_direction_180m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_gusts_10m": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "shortwave_radiation": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "direct_radiation": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "direct_normal_irradiance": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "diffuse_radiation": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "vapour_pressure_deficit": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "evapotranspiration": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "precipitation": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "weather_code": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "snow_height": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "freezing_level_height": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_temperature_0cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_temperature_6cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_temperature_18cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_temperature_54cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_moisture_0_1cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_moisture_1_3cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_moisture_3_9cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_moisture_9_27cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "soil_moisture_27_81cm": {
            "type": "array",
            "items": {
              "type": "float"
            }
          }
        }
      },
      "DailyResponse": {
        "type": "object",
        "properties": {
          "time": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "temperature_2m_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "temperature_2m_min": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "apparent_temperature_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "apparent_temperature_min": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "precipitation_sum": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "precipitation_hours": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "weather_code": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "sunrise": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "sunset": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_speed_10m_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_gusts_10m_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "wind_direction_10m_dominant": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "shortwave_radiation_sum": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "uv_index_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "uv_index_clear_sky_max": {
            "type": "array",
            "items": {
              "type": "float"
            }
          },
          "et0_fao_evapotranspiration": {
            "type": "array",
            "items": {
              "type": "float"
            }
          }
        },
        "required": [
          "time"
        ]
      },
      "CurrentWeather": {
        "type": "object",
        "properties": {
          "time": {
            "type": "string"
          },
          "temperature": {
            "type": "float"
          },
          "wind_speed": {
            "type": "float"
          },
          "wind_direction": {
            "type": "float"
          },
          "weather_code": {
            "type": "int"
          }
        },
        "required": [
          "time",
          "temperature",
          "wind_speed",
          "wind_direction",
          "weather_code"
        ]
      }
    }
  }
}