API інтерфейс для автоматичного доступу до прогнозів погоди

Для того, щоб використовувати АПІ запити, необхідно активувати токен.

Просто отримай API токен в профілі і роби API запити.

Ласкаво просимо до документації GridForecast API. Використовуючи інструкції та приклади інтерактивного коду нижче, ви зможете почати робити запити API за лічені хвилини.

API GridForecast був розроблений для надання точних даних про погоду для будь-якої програми та випадку використання, починаючи від інформації в режимі реального часу та історії погоди аж до 16-денних прогнозів погоди, підтримуючи всі основні мови програмування. Наш прямий дизайн API спростить використання API — продовжуйте читати нижче, щоб розпочати.

Опис:
Для побудови прогнозів погоди використовуються дані кліматичної моделі Глобальної Системи Прогнозування (GFS). З просторовим дозволом в 0,25 градуса. Тимчасовий дозвіл для найближчих 72-х годин становить 1 годину, а наступних, до 384 годин, - 3 години. GFS модель оновлюється чотири рази на день (00:00, 6:00, 12:00 і 18:00 за UTC). Всі прогнози надаються з тимчасової мітки UTC від поточної тимчасової мітки на період до 16 діб.
Для отримання прогнозу погоди за допомогою цього API, необхідно зробити запит на URL методом GET з обов'язковими параметрами, що містять шукані координати і необхідну тимчасову мітку. В результаті буде отримано відповідь у вигляді рядка в форматі JSON, що містить список висот і даних, які відносяться до цих висот.
 
Параметри:
lat - Широта, роздільник точка 
lon - Довгота, роздільник точка 
datetime - Час у форматі YYYYmmddHHii. де   YYYY - рік,   mm - місяць, dd - день, HH - час, ii - хвилини (Ви можете використовувати now для поточної години)
 
Приклад API запиту:
https://gridforecast.com/api/forecast/ lat; lon / datetime 
https://gridforecast.com/api/forecast/49.8479;35.6541/201912151100
 
Приклад API відповіді:

{"r": 60, "t": 19, "sp": 99779, "tp": 0, "hcy": 0, "lcy": 0, "mcy": 0, "vis": 24135, "lftx": 8, "aptmp": 19, "cpofp": -50, "dswrf": 0, "prmsl": 101691, "tdmax": 20, "tdmin": 13, "speed10": 3.9, "speed20": 5, "speed30": 5.2, "speed40": 5.7, "speed50": 6.3, "speed80": 7.8, "degree10": 269, "degree20": 270, "degree30": 270, "degree40": 270, "degree50": 270, "degree80": 271, "latitude": 49.75, "speed100": 8.5, "degree100": 271, "longitude": 35.75}


 
Параметри відповіді:

r Відносна вологість %
t Температура °C
sp Поверхневий тиск Pa
tp Загальна кількість опадів kg/m^2
crain Категорія дощу 0 - No rain, 1 - Drizzle, 2 - Light rain, 3 - Moderate rain, 4 - Heavy rain, 5 - Violent rain
tstm Можливість грози Більше 0 - Можливі грози, 0 до -4 - Можливі грози, менше -6 - Можливі бурхливі грози, можливі смерчі
hcy Висока хмарність %
lcy Низька хмарність %
mcy Середня хмарність %
vis Видимість m
aptmp Уявна температура °C
cpofp Відсотки заморожених опадів %
dswrf Спадний потік короткохвильового випромінювання W/m^2
prmsl Тиск приведений до MSL Pa
tdmax Максимальна температура за поточний день °C
tdmin Мінімальна температура за поточний день °C
speed* Швидкість вітру на * метрах m/s
degree* Напрямок вітру на * метрах Deg

Опис:

Для побудови прогнозів погоди використовуються дані кліматичної моделі Глобальної Системи Прогнозування (GFS). З просторовим дозволом в 0,25 градуса. Тимчасовий дозвіл для найближчих 72-х годин становить 1 годину, а наступних, до 384 годин, - 3 години. GFS модель оновлюється чотири рази на день (00:00, 6:00, 12:00 і 18:00 за UTC). Всі прогнози надаються з тимчасової мітки UTC від поточної тимчасової мітки на період до 16 діб.
Для отримання прогнозу погоди за допомогою цього API, необхідно зробити запит на URL методом GET з обов'язковими параметрами, що містять шукані координати і необхідну тимчасову мітку. В результаті буде отримано відповідь у вигляді рядка в форматі JSON, що містить список висот і даних, які відносяться до цих висот.
 

Параметри:

lat - Широта, роздільник точка 
lon - Довгота, роздільник точка 
datetime - Час у форматі YYYYmmddHHii. де   YYYY - рік,   mm - місяць, dd - день, HH - час, ii - хвилини (Ви можете використовувати now для поточної години)
 
Приклад API запиту:
https://gridforecast.com/api/forecast/ lat; lon / datetime 
https://gridforecast.com/api/forecast/49.8479;35.6541/201912151100
 
Приклад API відповіді:
{
"висота метрів над землею": { "параметр": значення, "параметр": значення, "параметр": значення}
}
 
{
"0": { "vis": 24100, "gust": 1.32, "hindex": 2, "sp": 99447, "orog": 175.9, "t": 5.2, "sdwe": 0, "sde" : 0, "pevpr": 20.98, "cpofp": - 50, "cprat": 0, "prate": 0, "tp": 0, "acpcp": 0, "watr": 0.2, "csnow": 0, "cicep": 0, "cfrzr": 0, "crain": 0, "lhtfl": 6.70, "shtfl": 12.2, "gflux": - 49.92, "uflx": 0.012, "vflx": 0.01 , "u-gwd": - 0.00004, "v-gwd": 0.0003, "wilt": 0.066, "fldcp": 0.29, "SUNSD": 21600, "lftx": 11.68, "cape": 1, "cin ": -0.05," dswrf ": 160," dlwrf ": 258.83," uswrf ": 21," ulwrf ": 331.003," 4lftx ": 9.94," hpbl ": 351.42," lsm ": 1," ci " : 0, "al": 12.84, "landn": 1, "latitude": 49.75, "longitude": 35.75, "distance": "12.88 Km"},
"2": { "q": 0.004, "2d": 2, "2r": 83.7, "aptmp": 3.9, "tmax": 4.5, "tmin": 1, "t": 4.5},
"10": { "speed": 1.1, "degree": 194},
"80": { "t": 3.6, "q": 0.004, "pres": 98475, "speed": 1.3, "degree": 196},
"100": { "t": 3.4, "speed": 1.3, "degree": 197},
"125": { "gh": 336.528, "t": 2.7, "r": 91.1, "w": 0.022, "absv": 0.00008, "clwmr": 0, "speed": 1.3, "degree" : 199, "isobaricInhPa": 975},
"375": { "gh": 546.08, "t": 1, "r": 99.3, "w": 0.03, "absv": 0.00008, "clwmr": 0.00005, "ICSEV": 0, "speed" : 1.2, "degree": 209, "isobaricInhPa": 950},
"575": { "gh": 760.44, "t": 0.6, "r": 92.6, "w": 0.042, "absv": 0.000051, "clwmr": 0, "speed": 1, "degree" : 262, "isobaricInhPa": 925},
"825": { "gh": 980.093, "t": - 0.4, "r": 90.3, "w": 0.051, "absv": 0.00005, "clwmr": 0, "ICSEV": 1, "speed ": 0.8," degree ": 302," isobaricInhPa ": 900},
"1275": { "gh": 1435.717937, "t": - 2.1, "r": 69.9, "w": 0.10649121, "absv": 0.00007, "clwmr": 0, "ICSEV": 0, "speed ": 0.6," degree ": 316," isobaricInhPa ": 850},
"1 654": { "t": - 3.2, "speed": 1.2, "degree": 336},
"1 775": { "gh": 1916.19, "t": - 3.5, "r": 54.5, "w": 0.129, "absv": 0.00008, "clwmr": 0, "ICSEV": 0, "speed ": 1.3," degree ": 343," isobaricInhPa ": 800},
"2275": { "gh": 2424, "t": - 5.3, "r": 43.6, "w": 0.14, "absv": 0.000094, "clwmr": 0, "ICSEV": 0, "speed ": 1.5," degree ": 0," isobaricInhPa ": 750},
"2568": { "t": - 6.9, "speed": 1.3, "degree": 5},
"2825": { "gh": 2963.01, "t": - 8, "r": 36.3, "w": 0.195, "absv": 0.00009, "clwmr": 0, "ICSEV": 0, "speed ": 1," degree ": 13," isobaricInhPa ": 700},
"3000": { "hlcy": - 13.25},
"3425": { "gh": 3534, "t": - 11.4, "r": 35.7, "w": 0.23, "absv": 0, "clwmr": 0, "ICSEV": 0, "speed ": 1.2," degree ": 29," isobaricInhPa ": 650},
"3483": { "t": - 12.3, "speed": 1.3, "degree": 30},
"4025": { "gh": 4143.47, "t": - 15.7, "r": 34.1, "w": 0.2432, "absv": 0.0001, "clwmr": 0, "ICSEV": 0, "speed ": 1.4," degree ": 34," isobaricInhPa ": 600},
"4675": { "gh": 4792.7495, "t": - 20.5, "r": 27.4, "w": 0.2418, "absv": 0.00021, "clwmr": 0, "ICSEV": 0, "speed ": 3.2," degree ": 180," isobaricInhPa ": 550},
"5375": { "gh": 5491.95, "t": - 24.4, "r": 13.7, "w": 0.285, "absv": 0.00027, "clwmr": 0, "ICSEV": 0, "5wavh ": 5482.57," speed ": 13.5," degree ": 192," isobaricInhPa ": 500},
"6000": { "ustm": - 7.82, "vstm": 0.46},
"6175": { "gh": 6252.763, "t": - 28.9, "r": 14.8, "w": 0.418, "absv": 0.00017, "clwmr": 0, "ICSEV": 0, "speed ": 21.9," degree ": 195," isobaricInhPa ": 450},
"7025": { "gh": 7084.78, "t": - 34.9, "r": 27.1, "w": 0.412, "absv": 0.00006805, "clwmr": 0, "ICSEV": 0, "o3mr ": 0.00000009," speed ": 26.9," degree ": 193," isobaricInhPa ": 400},
"7975": { "gh": 8003.092, "t": - 41.5, "r": 45.7, "w": 0.292, "absv": 0.000037, "clwmr": 0, "ICSEV": 0, "o3mr ": 0.00000009," speed ": 32.1," degree ": 189," isobaricInhPa ": 350},
"8975": { "gh": 9031.4218, "t": - 48.9, "r": 68.6, "w": 0.211, "absv": 0.00002138, "clwmr": 0, "ICSEV": 0, "o3mr ": 0.00000009," speed ": 37.3," degree ": 185," isobaricInhPa ": 300},
"10225": { "gh": 10208.418, "t": - 55.2, "r": 53.3, "w": 0.115, "absv": 0.0001, "clwmr": 0, "ICSEV": 0, "o3mr ": 0.00000022," speed ": 30.7," degree ": 181," isobaricInhPa ": 250}
}
 
Параметри відповіді:

2r  Відносна вологість на висоті 2 метри    
4lftx  Піднятий індекс (LI)   Кращі 4 шари  
5wavh  Висота 5 - хвильового геопотенциала gpm   
absv  Абсолютна завихреність 1/s   
acpcp  Конвективні опади (вода) kg/m^2   
al  Альбедо (характеристика дифузійної відбивної здатності поверхні)  
aptmp  Уявна температура    
cape  Конвективная потенційна енергія J/kg   
cfrzr  Замерзаючий дощ(да = 1; немає = 0)   
ci  Частка морського льоду   (0 -1)    
cicep  Категорії гранул льоду   
cin  Конвективне гальмування J/kg   
clwmr  Співвідношення компонентів суміші хмар kg/kg   
cpofp  Відсоток заморожених опадів  
cprat  Швидкість конвективних опадів kg/m^2/s   
crain  Категорія дощу   
csnow  Категорія снігу   
cwat  Вміст води kg/m^2   
cwork  Функція хмарної роботи J/kg  Функція хмарної роботи, яка є інтегральною мірою сили плавучості в хмарах
degree  Напрямок вітру Deg  
dlwrf  Спадний потік довгохвильового випромінювання W/m^2   
dswrf  Спадний потік короткохвильового випромінювання W/m^2   
fldcp  Потужність поля  Fraction   
gflux  Наземний тепловий потік W/m^2   
gh  геопотенціальна висота  gpm   
gust  Швидкість вітру (пориви) m/s   
hcy  Висока хмарність Pa   
hindex  Індекс Хейнса  Numeric   
hlcy  Відносна спіральність шторму  m^2/s^2   
hpbl  Висота планетарного пограничного шару   
icaht  Контрольна висота стандартної атмосфери ІКАО    
ICSEV  Вага зледеніння  non-dim   
isobaricInhPa  ізобаричний тиск Pa   
landn  Покриття суша - море (найближчий сусід) [земля = 1 land=1,sea=0    
lcy  Низька хмарність Pa   
lftx  Поверхневий піднятий індекс  
lhtfl  Приховані теплові потоки W/m^2   
lsm  Земля - море    
mcy  Середня хмарність Pa   
mslet  MSLP (скорочення моделі Eta)  Pa   
o3mr  Співвідношення змішування озону  kg/kg   
orog  Орографія   
pevpr  Потенційна швидкість випаровування  W/m^2   
plpl  Тиск рівня  з якого була знята точка  Pa   
prate  Швидкість опадів  kg/m^2/s   
pres  Тиск  Pa   
prmsl  Тиск  наведений до MSL  Pa   
pt  Потенційна температура   
pwat  Осаджена вода kg/m^2   
Питома вологість  kg/kg   
Відносна вологість  
sde  Глибина снігу   
sdwe  Водний еквівалент накопиченої глибини снігу  kg/m^2   
shtfl  Відчутний тепловий потік ???  W/m^2   
soilw  Об'ємний вміст вологи у грунту Fraction   
sp  Поверхневий тиск  Pa   
speed  Швидкість вітру m/s   
st  Температура ґрунту   
sunsd  Тривалість сонячного світла  
Температура  
tcc  Загальне покриття хмарами  
tmax  Максимальна температура  
tmin  Мінімальна температура  
tozne  Загальний озон  DU   
tp  Загальна кількість опадів  kg/m^2   
uflx  Потік імпульсу  u компонента N/m^2   
u-gwd   Зональний потік сили тяжіння  N/m^2   
ulwrf  Висхідний потік довгохвильового випромінювання  W/m^2   
ustm  U компонента руху шторму  m/s   
uswrf  Висхідний потік короткохвильового випромінювання  W/m^2   
vflx  Потік імпульсу  v компонента  N/m^2   
v-gwd  Меридіональний потік гравітаційної хвильової напруги  N/m^2   
vis  Видимість   
VRATE  Швидкість вентиляції  m^2/s   
vstm  V компонента руху шторму  m/s   
vwsh  Зміщення швидкості  1/s   
Вертикальна швидкість  Pa/s   
watr  Водний стік  kg/m^2   
wilt  Точка в'янення Fraction