Difference between revisions of "General weather interface/v2.5"

From CaiyunWiki
Jump to: navigation, search
(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

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

Scenarios of planning software

Scenarios of scientific instrument

Scenarios of Real-time cases

Parameters

Return values

Errors

Other links