彩云天气 API

如果您需要

快速了解覆盖区域、涵盖变量、更新频次等信息，请参看彩云天气业务速查表

快速了解彩云天气的 API 格式信息，请参看彩云天气数据格式速查表

有问题，请参看彩云天气常见问题

别犹豫，立刻上手

TAkhjf8d1nlSlspN是我们这里的演示 Token，请在您的开发环境和线上环境中使用您自己的 Token，仅需在开放平台轻松注册，立马可得。

• 通用预报接口
  • 纽约：https://api.caiyunapp.com/v2.5/TAkhjf8d1nlSlspN/-74.0060,40.7128/weather.json?lang=en_US&unit=imperial

联系我们

Email: api@caiyunapp.com

如果您在使用本文档或使用 API 过程中遇到问题，请联系我们。

业务场景

天气应用

Weather apps

分钟级降雨预报:

• Union Square, San Francisco in next 2 hr: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-122.4075,37.7879/weather.json?lang=en_US&granu=minutely

全球覆盖:

• 加德满都: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/85.3240,27.7172/weather.json?lang=en_US&unit=imperial
• 法兰克福: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/8.6821,50.1109/weather.json?lang=en_US&unit=imperial
• 纽约: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-74.0059,40.7128/weather.json?lang=en_US&unit=imperial
• 夏威夷: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-157.8583,21.3069/weather.json?lang=en_US&unit=imperial
• 悉尼: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/151.2093,-33.8688/weather.json?lang=en_US&unit=imperial
• 开普敦: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/18.4241,-33.9249/weather.json?lang=en_US&unit=imperial

Drone controlling

多语言支持:

• 东京: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/139.7690,35.6804/weather.json?lang=ja
• 北京: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/116.4074,39.9042/weather.json?lang=zh_CN

多单位制式的支持:

• 巴黎: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/2.3522,48.8566/weather.json?lang=en_US&unit=metric
• 悉尼: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/151.2093,-33.8688/weather.json?lang=en_US&unit=imperial

全球日出日落:

• 伦敦: https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/0.1278,51.5074/weather.json?lang=en_US&granu=daily&fields=astro

系统控制与 IoT 场景

在系统控制的场景里，您可能需要科学单位制的支持，同时数据也往往只需要实时数据，您可以这样调用

• https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-157.8583,21.3069/weather.json?lang=en_US&unit=SI&granu=realtime

规划与计划

• 短期: 24 小时的小时级预报
  • https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-74.0060,40.7128/weather.json?lang=en_US&unit=imperial&granu=hourly&hourlysteps=24
• 长期: 10 天的天级别预报
  • https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/139.7690,35.6804/weather.json?lang=ja&granu=daily&dailysteps=10

Web 应用

这种场合下，我们需要 jsonp 的支持

• 如果 jsonp callback 是 check_weather
  • https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-157.8583,21.3069/weather.jsonp?lang=en_US&callback=check_weather

给我们提建议

• 你要新功能，比如你要火星天气预报，点击这里
• 出现故障，比如 api 无法访问或者某处温度变成 -300，点击这里
• 彩云天气常见问题
• 联系我们