Карти погоди, 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).

Виберіть країну та мову

Будь ласка, оберіть мову та регіон для найкращої роботи Rain Viewer сайту для вашої країни.

Будь ласка, оберіть мову та регіон для найкращої роботи Rain Viewer сайту для вашої країни.

Логотип RainViewer Rain Viewer