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 |
Ключ | Опис | Значення | Приклад |
---|---|---|---|
past | Кадри метеорадарів з минулого. 2 години, з 10-хвилинним кроком. | Масив (Об’єкт Frame) | |
nowcast | Кадри прогнозу метеорадарів. 30 хвилин або 60 хвилин для Gold+ і Platinum API патронів. | Масив (Об’єкт Frame) |
Ключ | Опис | Значення | Приклад |
---|---|---|---|
infrared | Дані інфрачервоного діапазону вимірювань з метеосупутників за останні 2 години (канал 13). | Масив (Об’єкт Frame) |
Ключ | Опис | Значення | Приклад |
---|---|---|---|
time | Час кадру карти у форматі Unix Timestamp (UTC). Кадр карти зазвичай містить зображення метеорадарів чи супутників за різну дату, бо не всі вони одночасно оновлюються. Тому це не час даних, а час створення кадру. | Int(8) | 1609401600 |
path | Кореневий шлях для зображень цього кадру. Щоб отримати інформацію про його використання, зверніться до наступного розділу Як використовувати хост і шлях інформація цієї сторінки | String(255) | /v2/satellite/0680143a9470 |
Якщо вам подобається наш API і ви хочете, щоб він був безкоштовним якомога довше, підтримайте нас на Patreon. Додатково ви отримаєте доступ до API бази даних метеорологічних радарів, 60-хвилинної карти-прогнозу метеорологічних радарів та можливість отримувати плитки у власній колірній схемі.
Стати патроном</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, 8192 і 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).