API метеорологических карт

API МЕТЕОРОЛОГИЧЕСКИХ КАРТ предоставляет глобальный прогноз погоды, а также радарные и спутниковые данные в виде фрагментов карт, которые совместимы с такими общераспространенными картографическими службами как Open Street Maps и Google Maps. Все требуемые и опциональные параметры предоставляются в виде параметров пути и запроса, соответственно. Чтобы получить изображение, необходимо сначала запросить маркер доступа через действующие реквизиты. Маркер доступа затем будет использоваться для получения функционального запроса, который содержит информацию о том, как получить изображения.

При вызове API маркер доступа может предоставляться в виде параметра запроса или аутентификационного заголовка.

postAuthorization

Конечная точка аутентификации используется для получения маркеров, открывающих доступ к API. Маркеры являются одноразовыми и могут использоваться только для одного сеанса. Имя пользователя и пароль необходимо сохранять в тайне, и данный запрос необходимо отправлять из доверенного источника. В ответе на аутентификацию указывается время действия маркера в секундах.

Параметры

ТРЕБУЕМЫЕ

Название	Пример	Описание
пользователь		Имя пользователя приложения
пароль		Пароль приложения

Пример

URL

authorize/token

ОТВЕТ

{
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9mbnc2LmZvcmVjYS5jb21cL2F1dGhvcml6ZVwvdG9rZW4iLCJpYXQiOjE1MjYzMDAzODAsImV4cCI6MTUyNjMwMzk4MCwibmJmIjoxNTI2MzAwMzgwLCJqdGkiOiJxSXl3WVlQNjc1NkczejBEIiwic3ViIjoibFFHa1Y4Z2pIeGUyZU1ibndUUUs4NktqVTY3RXJlS2htenY1IiwicHJ2IjoiYWY3YTAzOThkZGNiNWE3YTUzN2Q3YzdkMjU2NWEyZjgxZGM4ZTQxNCJ9.V8xg6L9yrY9__VH-jdrL_CqXisEpgcfdUa0NoxlGz0k",
"expires_in": 86400,
"token_type": "bearer"
}

getCapabilities

Конечная точка функциональных возможностей используется для получения метаданных по слоям. Эти метаданные используются для запросов изображений. Функциональный ответ включает такую информацию о слоях как описание, временная и пространственная протяженности, а также доступные цветовые схемы. Изображения представляют собой слои, воспроизводимые в таких форматах изображений как png или svg.

Текущее свойство данных во временном элементе является указателем на самое последнее доступное время. Конечные изображения могут иметь дополнительные цветовые схемы, которые можно указать в качестве опции.

Параметры

ТРЕБУЕМЫЕ

Название	Пример	Описание
маркер		Маркер доступа, предоставляемый конечной точкой аутентификации.

Пример

URL

api/v1/capabilities

ОТВЕТ

{
"images": [
{
"title": "Cell simulated precipitation",
"description": "Precipitation with more intricate convection visualization",
"formats": [
"image/png"
],
"colorschemes": [
"default",
"csdata-blue"
],
"extent": {
"minLat": -79.1709976196289,
"maxLat": 79.1709976196289,
"minLon": -180,
"maxLon": 180,
"maxZoom": 11,
"minZoom": 3
},
"times": {
"updated": "2017-01-01T00:00:00Z",
"available": [
"2017-09-01T03:00:00Z",
"2017-09-01T06:00:00Z"
],
"current": 1
},
"id": 1
},
{
"title": "Wind symbol",
"description": "Traditional wind symbol",
"formats": [
"image/svg+xml"
],
"colorschemes": [
"default",
"data-pt"
],
"extent": {
"minLat": -79.1709976196289,
"maxLat": 79.1709976196289,
"minLon": -180,
"maxLon": 180,
"maxZoom": 11,
"minZoom": 3
},
"times": {
"updated": "2017-01-01T00:00:00Z",
"available": [
"2017-09-18T06:00:00Z",
"2017-09-18T07:00:00Z"
],
"current": 0
},
"id": 2
}
]
}

getTile

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

Параметры

ТРЕБУЕМЫЕ

Название	Пример	Описание
id		Идентификатор слоя
x	74	X индекс запрашиваемого фрагмента.
y	34	Y индекс запрашиваемого фрагмента.
z	7	Коэффициент масштабирования запрашиваемого фрагмента.
время		Отметка времени UTC (Всемирное координированное время) для извлечения данных в формате ISO 8601. Должна отображаться в действующем списке значений времени.
маркер		Маркер доступа, предоставляемый конечной точкой аутентификации.

ОПЦИОНАЛЬНЫЕ

Название	Пример	Описание
цветовая схема	по умолчанию	Цветовая схема слоев. Должна отображаться в списке цветных схем, который возвращается конечной точкой функциональных возможностей.

Пример

URL

api/v1/image/tile/{z}/{x}/{y}/{time}/{id}

ОТВЕТ

getLegend

Конечная точка условных обозначений используется для получения изображения условных обозначений для цветовой схемы.

Параметры

ТРЕБУЕМЫЕ

Название	Пример	Описание
цветовая схема		Идентификатор цветовой схемы. Должен отображаться в списке цветных схем, который возвращается конечной точкой функциональных возможностей.
id		Идентификатор слоя
маркер		Маркер доступа, предоставляемый конечной точкой аутентификации.

Пример

URL

api/v1/legend/{colorscheme}/{id}

ОТВЕТ

getUsage

Конечная точка использования применяется для получения статистики запросов. Конечная точка может применяться для контроля использования API.

Ответ содержит элементы, представляющие все события для каждого продукта, объединенные в статистику ежедневного суммирования.

Параметры

ТРЕБУЕМЫЕ

Название	Пример	Описание
маркер		Маркер доступа, предоставляемый конечной точкой аутентификации.

ОПЦИОНАЛЬНЫЕ

Название	Пример	Описание
начальная дата		Начальная дата сбора статистики в формате ISO.
конечная дата		Конечная дата сбора статистики в формате ISO.

Пример

URL

api/v1/usage

ОТВЕТ

[
{
"product": "Info request",
"date": "2019-01-08",
"hits": 3
},
{
"product": "Layer 2",
"date": "2019-01-08",
"hits": 37
},
{
"product": "Layer 4",
"date": "2019-01-08",
"hits": 85
},
{
"product": "Legend 'default' for layer 2",
"date": "2019-01-08",
"hits": 1
},
{
"product": "Legend 'default' for layer 4",
"date": "2019-01-08",
"hits": 1
},
{
"product": "Statistics request",
"date": "2019-01-08",
"hits": 2
}
]

API метеорологических карт

API метеорологических карт предоставляет прогнозы погоды и результаты наблюдений по всему миру. Они отображаются в виде макетов карт. Обычно в виде макетов карт представляются радиолокационные снимки атмосферных осадков, атмосферные прогнозы погоды и спутниковые изображения. Компания Vaisala предоставляет изображения макетных карт через API метеорологических карт. Макеты в основном предоставляются в форме фрагментов, совместимых с большинством картографических служб, например HERE, Google Maps и OpenStreetMap. Также доступны фоновые карты.

API МЕТЕОРОЛОГИЧЕСКИХ КАРТ

API погоды и метеорологических карт

Эффективное моделирование и измерение погоды для создания исключительно точных метеорологических данных в режиме реального времени для разнообразных коммерческих и потребительских целей.

Оптимизация операций

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

Высокоточные прогнозы

Предоставляемые компанией Vaisala прогнозы создаются в момент запроса API и рассчитываются для точного местоположения. В результате создается гиперлокальная обновленная информация о конкретных местоположениях по всему миру.

При создании прогнозов компания Vaisala опирается не только на усовершенствованные технологии моделирования, она также объединяет многочисленные высококачественные источники со всего мира. Комплексная система объединения данных сравнивает и комбинирует информацию, в результате чего выявляются наилучшие источники данных для каждой ситуации.

Простая интеграция API

Компания Vaisala предоставляет макеты карт по всем применимым погодным условиям. Данные отправляются в виде широко используемых фрагментов карт, которые можно легко объединить с помощью LeafLet API. API могут использоваться в любом языке кодирования и представляться в выходных форматах XML, JSON (Javascript), либо в виде строк обычного текста.

Высокоэффективная поддержка

Договор о сервисном обслуживании Vaisala (SLA) гарантирует извлечение потребителями максимальной прибыли из своих инвестиций и постоянную поддержку в решении технических проблем и обеспечении гарантированного доступа к данным.