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

Для того, чтобы использовать АПИ запросы, необходимо активировать токен.

Просто получи API токен в профиле и совершай API запросы.

Добро пожаловать в документацию по API GridForecast. Используя приведенные ниже инструкции и интерактивные примеры кода, вы сможете начать делать запросы API за считанные минуты.

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

Описание:

Для построения прогнозов погоды используются данные климатической модели Глобальной Системы Прогнозирования (GFS). С пространственным разрешением в 0,25 градуса. Временное разрешение для ближайших 72-х часов состовляет 1 час, а последующих, до 384 часов - 3 часа. GFS модель обновляется четыре раза в день (00:00, 06: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, 06: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},
  "1654":{"t":-3.2,"speed":1.2,"degree":336},
  "1775":{"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 

Компонента движения шторма

m/s   
uswrf  Восходящий поток коротковолнового излучения W/m^2   
vflx  Поток импульса  v компонент N/m^2   
v-gwd  Меридиональный поток гравитационного волнового напряжения N/m^2   
vis  Видимость  
VRATE  Скорость вентиляции m^2/s   
vstm  Компонента движения шторма m/s   
vwsh  Вертикальный сдвиг скорости 1/s   
Вертикальная скорость Pa/s   
watr  Водный сток kg/m^2   
wilt  Точка увядания  Fraction