OpenWeatherMap

OpenWeatherMap инструкция на русском

26 апр. 2024 г. • 7 мин чтения

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

Что такое OpenWeatherMap?

OpenWeatherMap (OWM) - это платформа, предоставляющая доступ к погодным данным по всему миру. Запущенная в 2012 году, она быстро стала одним из ведущих источников погодной информации благодаря своей открытой политике и доступности API.

Что делает OpenWeatherMap особенным?

Масштаб и покрытие: OpenWeatherMap собирает информацию о погоде со всех уголков планеты. Благодаря сотням тысяч погодных станций и датчиков, а также сети наблюдений пользователей, покрытие OWM охватывает практически каждый уголок земного шара.
Открытое API: Одним из наиболее привлекательных аспектов OpenWeatherMap является его открытое API. Это позволяет разработчикам создавать разнообразные приложения и сервисы, используя погодные данные OWM в своих проектах. Благодаря API, информация о погоде становится доступной для интеграции в веб-сайты, мобильные приложения, системы управления и многое другое.
Разнообразие данных: OpenWeatherMap предоставляет не только базовые данные о текущей погоде и прогнозах, но и множество других параметров, таких как скорость и направление ветра, уровень осадков, атмосферное давление, индексы UV и многое другое. Это делает OWM полезным инструментом для широкого спектра приложений, от анализа климата до создания персонализированных уведомлений о погоде.
Геопространственные данные: OpenWeatherMap также предоставляет геопространственные данные, такие как информация о населенных пунктах, координаты, границы регионов и другие сведения, что делает его ценным ресурсом для разработчиков, работающих с географической информацией.

Применение OpenWeatherMap

Путешественники: Путешественники могут использовать данные OpenWeatherMap для планирования своих маршрутов и подготовки к погодным условиям в различных регионах мира.
Фермеры и сельскохозяйственные предприятия: Для фермеров и сельскохозяйственных предприятий знание о погодных условиях имеет решающее значение. OpenWeatherMap предоставляет им актуальные данные для принятия решений относительно посевов, орошения и уборки урожая.
Разработчики приложений: Разработчики мобильных приложений и веб-сайтов могут использовать OpenWeatherMap для интеграции погодных функций в свои продукты, такие как отображение текущей погоды, прогнозы, уведомления о погоде и многое другое.
Научные исследования: Ученые и исследователи могут использовать данные OpenWeatherMap для анализа климатических изменений, изучения погодных условий в различных регионах и прогнозирования экстремальных погодных явлений.

Как получить API ключ OpenWeatherMap

Чтобы получить API ключ OpenWeatherMap, следуйте этим простым шагам:

Зарегистрируйтесь на сайте OpenWeatherMap: Перейдите на официальный сайт OpenWeatherMap.
Заполните форму регистрации: Введите свой адрес электронной почты, создайте пароль и подтвердите его. Заполните необходимые поля и нажмите кнопку "Sign Up" (Зарегистрироваться).
Подтвердите свой аккаунт: После завершения регистрации вам придет письмо на указанный адрес электронной почты с инструкциями по подтверждению аккаунта. Перейдите по ссылке в письме для подтверждения.
Войдите в свой аккаунт: После подтверждения аккаунта вернитесь на сайт OpenWeatherMap и войдите в свой аккаунт, используя адрес электронной почты и пароль, которые вы указали при регистрации.
Получите API ключ: После входа в аккаунт перейдите на страницу My API Keys. Здесь вы найдете свой уникальный API ключ, который можно использовать для доступа к погодным данным через API OpenWeatherMap.
Сохраните ключ: Скопируйте свой API ключ. Обязательно храните свой ключ в безопасном месте, так как он будет использоваться в ваших приложениях или скриптах для доступа к погодным данным.

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

Бесплатное использование OpenWeatherMap

OpenWeatherMap предлагает разнообразные тарифные планы, включая бесплатный тариф, позволяющий разработчикам опробовать сервис.

Ограничения бесплатного тарифа:

60 запросов в минуту
1 000 000 запросов в месяц
Базовый доступ к данным (текущая погода, прогноз погоды на 5 дней и т.д.)

Этого вполне достаточно для небольших проектов. Посмотреть пример проекта на бесплатном тарифе OpenWeatherMap можно по ссылке https://pogoda.pogrommist.ru/498817/

Как получить текущую погоду на OpenWeatherMap

Данные доступны в формате JSON, XML или HTML.

Для получения данных о текущей погоде необходимо сделать запрос по адресу:

https://api.openweathermap.org/data/2.5/weather?lat={lat}&lon={lon}&appid={API key}

lat – обязательный параметр. Широта

lon – обязательный параметр. Долгота

appid – обязательный параметр. Ваш уникальный API-ключ

mode – необязательный параметр. Формат ответа. Возможные значения: xml и html. Если параметр не указан, то по умолчанию используется json.

units – необязательный параметр. Единицы измерения. Доступные варианты: standard, metricи imperial. По умолчанию используется standard.

Если Вам необходимо автоматическое преобразование названий городов в координаты, то необходимо использовать Geocoder API.

Пример запроса для текущей погоды в Санкт-Петербурге:

https://api.openweathermap.org/data/2.5/weather?lon=30.26&lat=59.89&units=metric&appid=2f3c1bad2f3c1bad2f3c1bad2f3c1bad&lang=ru

Ответ в формате JSON:

{
    "coord": {
        "lon": 30.2642,
        "lat": 59.8944
    },
    "weather": [
        {
            "id": 804,
            "main": "Clouds",
            "description": "пасмурно",
            "icon": "04n"
        }
    ],
    "base": "stations",
    "main": {
        "temp": 7.8,
        "feels_like": 5.3,
        "temp_min": 5.26,
        "temp_max": 8.08,
        "pressure": 1002,
        "humidity": 92
    },
    "visibility": 10000,
    "wind": {
        "speed": 4,
        "deg": 230
    },
    "clouds": {
        "all": 100
    },
    "dt": 1714078768,
    "sys": {
        "type": 2,
        "id": 197864,
        "country": "RU",
        "sunrise": 1714097407,
        "sunset": 1714153379
    },
    "timezone": 10800,
    "id": 498817,
    "name": "Санкт-Петербург",
    "cod": 200
}

Поля ответа API формата JSON

coord
- coord.lonДолгота местоположения
- coord.latШирота места
weather
- weather.idИдентификатор погодных условий
- weather.mainГруппа параметров погоды (дождь, снег, облака и т. д.)
- weather.descriptionПогодные условия внутри группы.
- weather.iconИдентификатор значка погоды
baseВнутренний параметр
main
- main.tempТемпература. Единица измерения по умолчанию: Кельвин, Метрическая система: Цельсий, Британская система: Фаренгейт.
- main.feels_likeТемпература. Этот температурный параметр отвечает за восприятие человеком погоды. Единица измерения по умолчанию: Кельвин, Метрическая система: Цельсий, Британская система: Фаренгейт.
- main.pressureАтмосферное давление на уровне моря, гПа
- main.humidityВлажность, %
- main.temp_minМинимальная температура на данный момент. Это минимальная наблюдаемая в настоящее время температура (в пределах крупных мегаполисов и городских территорий). Единица измерения по умолчанию: Кельвин, Метрическая система: Цельсий, Британская система: Фаренгейт.
- main.temp_maxМаксимальная температура на данный момент. Это максимальная наблюдаемая в настоящее время температура (в пределах крупных мегаполисов и городских территорий). Единица измерения по умолчанию: Кельвин, Метрическая система: Цельсий, Британская система: Фаренгейт.
- main.sea_levelАтмосферное давление на уровне моря, гПа
- main.grnd_levelАтмосферное давление на уровне земли, гПа
visibilityВидимость. Максимальное значение видимости 10 км. Единица измерения: метр.
wind
- wind.speedСкорость ветра. Единица измерения по умолчанию: метр/сек, Метрическая система: метр/сек, Британская система: мили/час.
- wind.degНаправление ветра, градусы (метеорологические)
- wind.gustПорыв ветра. Единица измерения по умолчанию: метр/сек, Метрическая система: метр/сек, Британская система: мили/час.
clouds
- clouds.allОблачность, %
rain
- rain.1h (при наличии) Объем дождя за последний 1 час, мм. Обратите внимание, что для этого параметра доступны только мм в качестве единиц измерения.
- rain.3h (при наличии) Объем дождя за последние 3 часа, мм. Обратите внимание, что для этого параметра доступны только мм в качестве единиц измерения.
snow
- snow.1h(при наличии) Объем снега за последний час, мм. Обратите внимание, что для этого параметра доступны только мм в качестве единиц измерения.
- snow.3h (при наличии) Объем снега за последние 3 часа, мм. Обратите внимание, что для этого параметра доступны только мм в качестве единиц измерения.
dtВремя расчета данных, unix, UTC
sys
- sys.typeВнутренний параметр
- sys.idВнутренний параметр
- sys.messageВнутренний параметр
- sys.countryКод страны (Великобритания, Япония и т. д.)
- sys.sunriseВремя восхода солнца, unix, UTC
- sys.sunsetВремя заката, unix, UTC
timezoneСдвиг в секундах от UTC
id Идентификатор города.
name Название города.
codКод ответа

Если вы не видите некоторых параметров в ответе API, это означает, что эти погодные явления просто не произошли в выбранном городе или месте на момент запроса. В ответе API отображаются только реально измеренные или рассчитанные данные.

Запрос текущей погоды по названию города

https://api.openweathermap.org/data/2.5/weather?q=Санкт-Петербург&units=metric&appid=2f3c1bad2f3c1bad2f3c1bad2f3c1bad&lang=ru

или с названием города и кодом страны:

https://api.openweathermap.org/data/2.5/weather?q=Париж,RU&units=metric&appid=2f3c1bad2f3c1bad2f3c1bad2f3c1bad&lang=ru

Параметры запроса:

q – обязательный параметр. Название города, код штата и код страны, разделенные запятой. Коды штатов и стран см. в стандарте ISO 3166.

Вы можете указать параметр не только на английском языке. В этом случае ответ API должен быть возвращен на том же языке, что и язык запрошенного названия местоположения, если местоположение находится в предопределенном списке, состоящем из более чем 200 000 местоположений.

appid – обязательный параметр. Ваш уникальный API-ключ.

lang – необязательный параметр. Язык ответа.

Запрос текущей погоды по коду города

https://api.openweathermap.org/data/2.5/weather?id=498817&units=metric&appid=2f3c1bad2f3c1bad2f3c1bad2f3c1bad&lang=ru

Параметры запроса:

id – обязательный параметр. Идентификатор города. Список городов с идентификатором «city.list.json.gz» можно скачать здесь .

appid – обязательный параметр. Ваш уникальный API-ключ.

lang – необязательный параметр. Язык ответа.

Поддерживаемые языки ответа

afАфриканский
alАлбанский
arАрабский
azАзербайджанский
bgБолгарский
caКаталанский
czЧешский
daДатский
deНемецкий
elГреческий
enАнглийский
euБаскский
faПерсидский (фарси)
fiФинский
frФранцузский
glГалисийский
heИврит
hiХинди
hrХорватский
huВенгерский
idИндонезийский
itИтальянский
jaЯпонский
krКорейский
laЛатышский
ltЛитовский
mkМакедонский
noНорвежский
nlГолландский
plПольский
ptПортугальский
pt_brПортугалия, Бразилия
roРумынский
ruРусский
sv, seШведский
skСловацкий
slСловенский
sp, esИспанский
srСербский
thТайский
trТурецкий
ua, ukУкраинский
viВьетнамский
zh_cnКитайский упрощенный
zh_twКитайский традиционный
zuЗулу

Коды ошибок в ответах на запросы

401 – эта ошибка связанна с API-ключом. Возможные причины:

API-ключ не указан.
API-ключ не активирован. В данном случае необходимо повторить запрос через несколько часов.
Неправильно указан API-ключ.
Используется API-ключ бесплатного тарифа для получения данных из платного тарифа.

404 – эта ошибка связана с неправильным запросом. Возможные причины:

Указано неправильное название города, почтовый индекс или идентификатор города.
Неправильный запрос к API. Проверьте запрос на ошибки. Используйте примеры запросов из документации.

429 – эта ошибка связана с API-ключом. Ошибка возникает при превышении лимитов тарифа.

500, 502, 503 или 504 – при возникновении данных ошибок необходимо связываться с технической поддержкой OpenWeatherMap.

Пример как можно использовать бесплатный API от OpenWeatherMap – https://pogoda.pogrommist.ru

👋