Tomorrow

简介

Tomorrow.io 的 Weather API 通过基于密钥的 REST API 提供当前天气、预报、实时气象预警和历史数据——主打细粒度、分钟级数据和对开发者友好的工具链。免费层可用于评估和轻量应用。

快速开始

当前天气（替换 YOUR_KEY）：

curl "https://api.tomorrow.io/v4/timelines?location=paris&apikey=YOUR_KEY" \
  -H "Accept: application/json"

带特定字段的时间线：

curl "https://api.tomorrow.io/v4/timelines?location=48.85,2.35&fields=temperature,precipitationProbability&timesteps=1h&units=metric&apikey=YOUR_KEY"

天气预警：

curl "https://api.tomorrow.io/v4/timelines?location=paris&fields=weatherCode&timesteps=current&apikey=YOUR_KEY&alerts=true"

认证方式

• 在 tomorrow.io 注册（免费）→ 在控制台创建 API 密钥。
• 通过 apikey 查询参数携带（无效密钥返回 401——已实测）。

速率限制与注意事项

• 免费层：500 次请求/天（历史深度有限）；付费档可扩展。
• v4 API 使用 timelines，带 fields、timesteps（current/1h/1d）和 units。
• location 接受地名或 lat,lon；apikey 是查询参数（不是请求头）。
• 免费层当前时间步包含预警和分钟级预报。

常见问题

Tomorrow.io 免费吗？ 是的——免费层 500 次/天；付费档可扩展。

如何获取密钥？ 在 tomorrow.io 注册，然后在控制台创建 API 密钥。

从其他天气 API 迁移容易吗？ 时间线模型与多数 v4 天气 API 类似——基于字段的选择方式很直接。