Skip to main content

气象历史API

域名​

http://weather-api.xm-opt.com

GET 查询气象历史-逐小时​

GET /v1/history

查询逐小时的过去气象历史， 时间推荐早于当前日的5天， 5天内的数据可能未生成。 

历史天气 API 基于再分析数据集，结合使用气象站、飞机、浮标、雷达和卫星观测来创建过去天气状况的综合记录。

数据源：全球范围内的精度9km网格级多源融合天气预报

历史范围：最远可追溯到1940年1月1日。

空间分辨率：9km*9km

时间分辨率：逐小时

更新频率：历史某日（D日）的数据在5天后（D+5日）后更新。

请求参数​

--header apikey=您的API密钥（获取方式详见官网密钥管理）

名称位置类型必选说明
longitudequerynumber是经度
latitudequerynumber是纬度
elevationquerynumber否海拔高度
start_datequerystring是开始日期，日期必须指定为ISO8601日期(例如2024-03-01)。
end_datequerystring是结束日期，日期必须指定为ISO8601日期(例如2024-03-01)。
hourlyquerystring是逐小时天气变量列表，取值可以用逗号分隔。
timezonequerystring是时区，支持时区数据库中的任何时区名称，

返回示例

成功

{
  "latitude": 30.263618,
  "longitude": 120.14051,
  "timezone": "Asia/Shanghai",
  "elevation": 6,
  "hourly_units": {
    "time": "iso8601",
    "temperature_2m": "°C"
  },
  "hourly": {
    "time": [
      "2024-04-08T00:00",
      ......
      "2024-04-08T23:00"
    ],
    "temperature_2m": [
      12.4,
      ......
      9.9
    ]
  },
  "model": "v1"
}

返回结果​

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构​

暂无

逐小时天气变量列表​

::: temperature_2m,relative_humidity_2m,dew_point_2m,apparent_temperature,precipitation,rain,snowfall,snow_depth,weather_code,pressure_msl,surface_pressure,cloud_cover,cloud_cover_low,cloud_cover_mid,cloud_cover_high,et0_fao_evapotranspiration,vapour_pressure_deficit,wind_speed_10m,wind_speed_100m,wind_direction_10m,wind_direction_100m,wind_gusts_10m,soil_temperature_0_to_7cm,soil_temperature_7_to_28cm,soil_temperature_28_to_100cm,soil_temperature_100_to_255cm,soil_moisture_0_to_7cm,soil_moisture_7_to_28cm,soil_moisture_28_to_100cm,soil_moisture_100_to_255cm,shortwave_radiation,direct_radiation,diffuse_radiation,direct_normal_irradiance,global_tilted_irradiance,terrestrial_radiation,shortwave_radiation_instant,direct_radiation_instant,diffuse_radiation_instant,direct_normal_irradiance_instant,global_tilted_irradiance_instant,terrestrial_radiation_instant,is_day,sunshine_duration :::

详细说明见[逐小时历史气象属性说明]

GET 查询气象历史-逐日​

GET /v1/historyDaily

请求参数​

--header apikey=您的API密钥（获取方式详见官网密钥管理）

名称位置类型必选说明
longitudequerynumber是经度
latitudequerynumber是纬度
elevationquerynumber否海拔高度
start_datequerystring是开始日期，日期必须指定为ISO8601日期(例如2024-03-01)。
end_datequerystring是结束日期，日期必须指定为ISO8601日期(例如2024-03-01)。
dailyquerystring是逐小时天气变量列表，取值可以用逗号分隔。
timezonequerystring是时区，支持时区数据库中的任何时区名称，

返回示例

成功

{
  "latitude": 30.263618,
  "longitude": 120.14051,
  "timezone": "Asia/Shanghai",
  "elevation": 90,
  "daily_units": {
    "time": "iso8601",
    "temperature_2m_max": "°C"
  },
  "daily": {
    "time": [
      "2024-04-08",
      "2024-04-09"
    ],
    "temperature_2m_max": [
      15.4,
      21.1
    ]
  },
  "model":"v1"
}

返回结果​

状态码状态码含义说明数据模型
200OK成功Inline

返回数据结构​

暂无

逐日天气变量列表​

::: weather_code,temperature_2m_max,temperature_2m_min,temperature_2m_mean,apparent_temperature_max,apparent_temperature_min,apparent_temperature_mean,sunrise,sunset,daylight_duration,sunshine_duration,precipitation_sum,rain_sum,snowfall_sum,precipitation_hours,wind_speed_10m_max,wind_gusts_10m_max,wind_direction_10m_dominant,shortwave_radiation_sum,et0_fao_evapotranspiration :::

详细说明见[逐日历史气象属性说明]