气候数据API接口-openmeteo

非商业用途免费

Open-Meteo API 对于非商业用途是免费的。我们不限制访问，但要求合理使用和归属。

请确保您的每日请求量保持在 10,000 以下。请注意，我们保留阻止滥用我们服务的应用程序和 IP 地址的权利。如需更多信息，请参阅条款和条件。

API响应

示例代码自动应用上面选择的所有参数。它包括缓存和到 Pandas DataFrame 的转换。 DataFrame 的使用完全是可选的。您可以在Python API 客户端文档中找到更多详细信息和示例。

Python

安装

pip install openmeteo-requests
pip install requests-cache retry-requests numpy pandas

用法

import openmeteo_requests

import requests_cache
import pandas as pd
from retry_requests import retry

# Setup the Open-Meteo API client with cache and retry on error
cache_session = requests_cache.CachedSession('.cache', expire_after = 3600)
retry_session = retry(cache_session, retries = 5, backoff_factor = 0.2)
openmeteo = openmeteo_requests.Client(session = retry_session)

# Make sure all required weather variables are listed here
# The order of variables in hourly or daily is important to assign them correctly below
url = "https://climate-api.open-meteo.com/v1/climate"
params = {
	"latitude": 52.52,
	"longitude": 13.41,
	"start_date": "1950-01-01",
	"end_date": "2050-12-31",
	"models": ["CMCC_CM2_VHR4", "FGOALS_f3_H", "HiRAM_SIT_HR", "MRI_AGCM3_2_S", "EC_Earth3P_HR", "MPI_ESM1_2_XR", "NICAM16_8S"]
}
responses = openmeteo.weather_api(url, params=params)

# Process first location. Add a for-loop for multiple locations or weather models
response = responses[0]
print(f"Coordinates {response.Latitude()}°N {response.Longitude()}°E")
print(f"Elevation {response.Elevation()} m asl")
print(f"Timezone {response.Timezone()} {response.TimezoneAbbreviation()}")
print(f"Timezone difference to GMT+0 {response.UtcOffsetSeconds()} s")

JSON 返回对象

成功后将返回 JSON 对象。请注意：生成的 JSON 大小可能有多个兆字节。

{
  "latitude": 52.52,
  "longitude": 13.419,
  "generationtime_ms": 2.2119,
  "timezone": "Europe/Berlin",
  "timezone_abbreviation": "CEST",
  "daily": {
    "time": ["2022-07-01", "2022-07-01", "2022-07-01", ...],
    "temperature_2m_max": [13, 12.7, 12.7, 12.5, 12.5, 12.8, ...]
  },
  "daily_units": {
    "temperature_2m": "°C"
  },
}

错误

如果发生错误，例如未正确指定 URL 参数，则会返回带有 HTTP 400 状态代码的 JSON 错误对象。

{

  "error": true,
  "reason": "Cannot initialize WeatherVariable from invalid String value tempeture_2m for key hourly"
}

详细指南https://open-meteo.com/en/docs/climate-api#daily=