Difference between revisions of "General weather interface/v2.5"
(→Other links) |
(→API call examples) |
||
| Line 6: | Line 6: | ||
== API call examples == | == API call examples == | ||
| + | |||
| + | === Scenarios of weather apps === | ||
* New York: Weather forecast for New York including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in English and Imperial and US customary measurement systems. | * New York: Weather forecast for New York including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in English and Imperial and US customary measurement systems. | ||
| Line 11: | Line 13: | ||
* Tokyo: Weather forecast for Tokyo including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in Japanese and Metric measurement system. | * Tokyo: Weather forecast for Tokyo including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in Japanese and Metric measurement system. | ||
** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/139.7690,35.6804/weather.json?lang=ja</code> | ** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/139.7690,35.6804/weather.json?lang=ja</code> | ||
| + | |||
| + | === Scenarios of planning software === | ||
| + | |||
| + | * Short term: | ||
| + | ** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-74.0060,40.7128/weather.json?lang=en_US&unit=imperial</code> | ||
| + | * Long term: | ||
| + | ** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/139.7690,35.6804/weather.json?lang=ja</code> | ||
| + | |||
| + | === Scenarios of scientific instrument === | ||
| + | |||
| + | * Assume an instrument on an ocean drilling ship need to get hourly data for next 12 hour | ||
| + | ** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/172.0060,33.7128/weather.json?lang=en_US&unit=SI&granu=hourly&hourlysteps=12</code> | ||
| + | |||
| + | === Scenarios of Real-time cases === | ||
| + | |||
| + | * Assume a drone control system need the current realtime weather data, but the data should be in SI unit system for convenience of control calculation. | ||
| + | ** <code>https://api.caiyunapp.com/v2.5/S45Fnpxcwyq0QT4b/-157.8583,21.3069/weather.json?lang=en_US&unit=SI&granu=realtime</code> | ||
== Parameters == | == Parameters == | ||
Revision as of 07:33, 3 April 2020
Version of this article: v2.5，current stable version: v2.5，historical veriosns: v2.4
Contents
Authentication
After signing up at the dahsboard, you will get your access token. In below sections, we will use a temporary token for demo purpose: S45Fnpxcwyq0QT4b. In production or development, you should use your own.
API call examples
Scenarios of weather apps
- New York: Weather forecast for New York including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in English and Imperial and US customary measurement systems.
- Tokyo: Weather forecast for Tokyo including real time condition, 2h minutely precipitation forecast, 48h hourly general forecast, 5d daily general forecast, in Japanese and Metric measurement system.
Scenarios of planning software
- Short term:
- Long term:
Scenarios of scientific instrument
- Assume an instrument on an ocean drilling ship need to get hourly data for next 12 hour
Scenarios of Real-time cases
- Assume a drone control system need the current realtime weather data, but the data should be in SI unit system for convenience of control calculation.
