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-отметка времени (UTC), когда был сгенерирован этот файл API. Полезно для проверки наличия обновлений. | Int(8) | 1609402525 |
host | Хост и протокол для изображений. | String(255) | https://tilecache.rainviewer.com |
radar | Карты погодных радаров. | Объект радара | |
satellite | Карты спутников. | Объект спутника |
ключ | Описание | Значения | Пример |
---|---|---|---|
past | Прошлые кадры погодных радаров. 2 часа, с интервалом в 10 минут. | Массив(Объект Кадра) | |
nowcast | Будущие кадры погодных радаров. 30 минут или 60 минут для Золотых и Платиновых API Патронов. | Массив(Объект Кадра) |
ключ | Описание | Значения | Пример |
---|---|---|---|
infrared | Последние 2 часа данных инфракрасного спутника (канал 13) от доступных спутников. | Массив(Объект Кадра) |
ключ | Описание | Значения | Пример |
---|---|---|---|
time | Данные генерации карты кадра в формате UNIX-времени (UTC). Карта кадра обычно содержит изображения (радар, спутник) с разных времен, поэтому это время не данных, а время генерации кадра. | Int(8) | 1609401600 |
path | Базовый путь для изображений этого кадра. Для получения информации о его использовании обратитесь к следующему Как использовать хост и путь информация раздела этой страницы | String(255) | /v2/satellite/0680143a9470 |
Если вам нравился наш API и вы хотите, чтобы он оставался бесплатным как можно дольше, поддержите нас на Patreon. Дополнительно, вы сможете получить доступ к API базы данных метеорадаров, 60-минутной карте будущего радара и возможность получать плитки в своей собственной цветовой схеме.
Стать патрономхост
и информацию о пути ``Как и в случае с старым API, вы должны использовать хост
и данные пути `` из API в качестве части URL. Все доступные URL-адреса и их параметры описаны ниже.
Каждый URL начинается с {host}
, где:
{host}
является хост
из Root Object этого 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-временных меток из API.{x}, {y}, {z}
- x, y и уровень масштабирования плитки, которую вы хотите загрузить. Узнать больше о плитках{latitude}, {longitude}
- широта и долгота соответствующих координат. Десятичный формат. Должно содержать точку в числе. Пример: -32.7892, 108.67821.{size}
– размер изображения, может быть 256 или 512.{big_size}
– может быть 2000, 4000, 8000, 16000 или 24000 (24000x12000 px или ~2 км на пиксель). Для квадратных изображений используйте соответственно 4096, 8196 и 16384.{color}
- номер цветовой схемы из предоставленного списка.{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 | Композитная плитка охвата для всего мира сразу. Генерируется медленно. |