快速开始

使用 Mirror Earth API 获取第一份天气数据，并根据需求选择合适的数据产品。

Mirror Earth 将不同来源的天气数据统一为按经纬度和时间查询的 API，适合科研分析、业务系统和 WebGIS 应用。

5 分钟完成第一次请求

1. 获取 API Key

登录镜像地球开放平台，在个人中心创建或复制 API Key。

API Key 的保存方式和不同接口的鉴权要求，请先阅读API Key 与鉴权。

2. 发起实时预报请求

下面的请求获取南京（纬度 32，经度 118）未来 3 天的逐小时气温：

https://api.mirror-earth.com/v1/forecast?latitude=32&longitude=118&hourly=temperature_2m&forecast_days=3&timezone=Asia/Shanghai&models=ecmwf&apikey=您的API Key

请求参数说明

参数名	类型	描述
apikey必填	string	API Key，登陆后自动填充，或在个人中心获取
latitude必填	number	纬度，多个纬度用逗号分隔，必须和longitude数量一致，例如 32,33
longitude必填	number	经度，多个经度用逗号分隔，必须和latitude数量一致，例如 118,119
hourly选填	string	小时要素，多个要素用逗号分隔：temperature_2m,precipitation
daily选填	string	逐日要素，多个要素用逗号分隔：temperature_2m_max,temperature_2m_min,precipitation_sum
forecast_days选填	number	预报天数，可以和past_days同时使用，但是不能和start_date/end_date/start_hour/end_hour同时使用
past_days选填	number	过去天数，可以和forecast_days同时使用，但是不能和start_date/end_date/start_hour/end_hour同时使用
start_date选填	string	开始日期，只能搭配end_date使用，例如 2025-01-01
end_date选填	string	结束日期，只能搭配start_date使用，例如 2025-01-02
start_hour选填	number	开始时间，只能搭配end_hour使用，例如 2025-01-01T00:00
end_hour选填	number	结束时间，只能搭配start_hour使用，例如 2025-01-01T23:00
temporal_resolution选填	string	时间分辨率，默认都是1小时(hourly_1)，可选10分钟(minutely_10)，15分钟(minutely_15)，30分钟(minutely_30)
models选填	string	数据源，多个数据源用逗号分隔：ecmwf,cma
timezone选填	string	时区，默认为世界时，auto表示根据经度自动计算全部时区：时区列表
cell_selection选填	string	坐标选取偏好，当坐标点位于陆地和海洋分界处时控制返回海洋上的点还是陆地上的点，默认是land表示陆地，sea（海洋），nearest （就近原则）
elevation选填	string	高程，默认情况下会使用高程对温度数据进行校正，数值模式算出来的数据表示的是这个网格点上的平均，我们用高程可以根据地形进行校准，nan表示不校准。

不要把真实 API Key 写入公开代码、Git 提交、截图或 URL 分享内容。生产环境请使用环境变量或服务端密钥管理。

3. 理解返回结果

响应中的 hourly.time 与 hourly.temperature_2m 按相同下标对应，单位在 hourly_units 中声明：

{
  "hourly_units": {
    "time": "iso8601",
    "temperature_2m": "°C"
  },
  "hourly": {
    "time": ["2026-01-01T00:00", "2026-01-01T01:00"],
    "temperature_2m": [1.85, 4.25]
  }
}

选择数据产品

你的需求	使用产品	入口
查询未来天气	实时预报 API	实时预报 API
查询已经发生的天气	历史数据 API	历史数据 API
复盘某一次历史预报	历史预报 API	历史预报数据 API
获取历史到未来的连续时间序列	无缝数据 API	无缝数据 API
下载大量点位、网格或区域数据	批量下载 API	批量下载文档
在地图中展示气象栅格	图层产品	图层快速开始

接下来做什么

选择变量：查看逐小时变量目录和逐日变量目录。
选择数据源：实时预报、历史预报和历史数据支持不同模型，进入对应接口文档后再查看模型详情。
Python 用户：阅读Python SDK 接入。
无需 API Key 的地点转换：阅读地名解析 API。

数据概念

如果你需要了解站点观测、再分析、实时预报和历史预报的区别，请阅读气象数据概念。

数据产品选择