Карти погоди, API

https://api.rainviewer.com/public/weather-maps.json

Призначення та опис

Містить попередні (2 години) та прогнозовані (30 хвилин) дані метеорадарів та супутникові дані (інфрачервоний діапазон, попередні 2 години). Підходить для відображення в програмах, на веб-сайтах або в будь-якому іншому програмному забезпеченні для карт. Можна також використовувати як джерело для погодних API.

Приклад файлу бази даних

Ось приклад файлу API карт погоди з двома кадрами для кожного розділу даних. Дані всередині прикладу застарілі і не можуть бути використані для отримання інформації. Щоб отримати фактичні дані, відкрийте файл API безпосередньо.

{
  "version": "2.0",
  "generated": 1609402525,
  "host": "https://tilecache.rainviewer.com",
  "radar": {
    "past": [
      {
        "time": 1609401600,
        "path": "/v2/radar/1609401600"
      },
      {
        "time": 1609402200,
        "path": "/v2/radar/1609402200"
      }
    ],
    "nowcast": [
      {
        "time": 1609402800,
        "path": "/v2/radar/nowcast_6b3c5a659cf4"
      },
      {
        "time": 1609403400,
        "path": "/v2/radar/nowcast_dd3474d83b20"
      }
    ]
  },
  "satellite": {
    "infrared": [
      {
        "time": 1609401600,
        "path": "/v2/satellite/0680143a9470"
      },
      {
        "time": 1609402200,
        "path": "/v2/satellite/ba88bf38ac55"
      }
    ]
  }
}

Кореневий об’єкт

КлючОписЗначенняПриклад
versionВерсія API.String(8)“2.0.1”
generatedДата у форматі Unix Timestamp (UTC), коли було створено цей файл API. Корисно для перевірки наявності оновлень.Int(8)1609402525
hostХост і протокол для зображень.String(255)https://tilecache.rainviewer.com
radarКарти метеорадарів.Об’єкт Radar 
satelliteСупутникові карти.Об’єкт Satellite 

Об’єкт Radar

КлючОписЗначенняПриклад
pastКадри метеорадарів з минулого. 2 години, з 10-хвилинним кроком.Масив (Об’єкт Frame) 
nowcastКадри прогнозу метеорадарів. 30 хвилин або 60 хвилин для Gold+ і Platinum API патронів.Масив (Об’єкт Frame) 

Об’єкт Satellite

КлючОписЗначенняПриклад
infraredДані інфрачервоного діапазону вимірювань з метеосупутників за останні 2 години (канал 13).Масив (Об’єкт Frame) 

Об’єкт Frame

КлючОписЗначенняПриклад
timeЧас кадру карти у форматі Unix Timestamp (UTC). Кадр карти зазвичай містить зображення метеорадарів чи супутників за різну дату, бо не всі вони одночасно оновлюються. Тому це не час даних, а час створення кадру.Int(8)1609401600
pathКореневий шлях для зображень цього кадру. Щоб отримати інформацію про його використання, зверніться до наступного розділу Як використовувати хост і шлях інформація цієї сторінкиString(255)/v2/satellite/0680143a9470

Стань нашим патроном!

Якщо вам подобається наш API і ви хочете, щоб він був безкоштовним якомога довше, підтримайте нас на Patreon. Додатково ви отримаєте доступ до API бази даних метеорологічних радарів, 60-хвилинної карти-прогнозу метеорологічних радарів та можливість отримувати плитки у власній колірній схемі.

Стати патроном

Як використовувати інформацію про</code> </code> і шлях `</h2>

Як і у старому API, ви повинні використовувати дані хосту` і `шляху` з API як частину URL-адреси. Усі доступні URL-адреси та їх параметри описані нижче.</p> Кожна URL-адреса починається з `{host}`, де: * `{host}` – це `хост` із [кореневого об’єкта](#rootObject) цього API. | _URL_ | _Опис_ | | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `{path}/{size}/{z}/{x}/{y}/{color}/{options}.png` | Дані радару: відображається одна плитка із композитного зображення всіх метеорадарів із заданим розміром, схемою кольорів та додатковими опціями. | | `{path}/{size}/{z}/{lat}/{lon}/{color}/{options}.png` | Дані радара: такі ж, як і посилання вище, але з центром у визначених координатах (EPSG:4326) із бажаним розміром масштабування. Відмінно підходить для віджетів | | `{path}/{big_size}/{color}/{options}.png` | Композитне зображення з відбиваністю метеорадарів для всього світу. Генерується повільно, до 10 секунд на одне завантаження зображення. Не може бути згладжене. ВАЖЛИВО: колірна гамма та снігова маска для супутникових даних завжди мають бути «0». | * `{ts}` – одна з доступних міток часу Unix Timestamp з API. * `{x}, {y}, {z}` – x, y та рівень масштабування плитки, яку потрібно завантажити. [Докладніше про плитки](http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/) * `{latitude}, {longitude}` - широта і довгота конкретних координат відповідно. Десятковий формат. Число має містити крапку. Приклад: -32.7892, 108.67821. * `{size}` – розмір зображення, може бути 256 або 512. * `{big_size}` – може бути 2000, 4000, 8000, 16000 або 24000 (24000x12000 пікселів або \~2 км на піксель). Для квадратних зображень використовуйте 4096, 8196 і 16384 відповідно. * `{color}` - номер колірної схеми з [наданого списку](color-schemes.html). * `{options}` - список параметрів, розділених символом `_`. Наприклад: '1_0' означає згладжування зображення (1) та без відображення снігу (0). Зараз доступні два варіанти: `{smooth}_{snow}` * `{smooth}` - розмиття (1) чи ні (0) даних радара. Великі складені зображення завжди не згладжуються через проблеми з швидкодією. * `{snow}` - відображати (1) чи ні (0) сніг окремими кольорами на плитках. ## Покриття метеорологічних радарів Крім того, доступний ще один продукт: маска для покриття метеорологічного радара. Ця маска показує, де доступне покриття метеорологічного радара (прозорі області), а де - ні (чорні зони). Ми не часто оновлюємо цю маску. Посилання такі ж, як і для радіолокаційної та супутникової продукції, але без опцій і колірної гами. | _URL_ | _Опис_ | | ------------------------------------------------- | ----------------------------------------------------------------------------------------- | | `/v2/coverage/0/{size}/{z}/{x}/{y}/0/0_0.png` | Плитка покриття: де доступні радіолокаційні дані (прозорі області), а де ні (чорні зони). | | `/v2/coverage/0/{size}/{z}/{lat}/{lon}/0/0_0.png` | Дані покриття для визначених координат центру (широта, довгота). | | `/v2/coverage/0/{big_size}/0/0_0.png` | Композитне зображення з покриттям для всього світу. Генерується повільно. | ## Приклади Будь ласка, зверніться до окремої [сторінки прикладів](examples.html).

RainViewer RainViewer