Как запрашивать актуальные и прогнозные погодные данные с помощью Служб погоды Azure Maps
Службы погоды Azure Maps — это набор интерфейсов REST API, позволяющий разработчикам интегрировать в свои решения высокодинамичные исторические, актуальные и прогнозные погодные данные, а также визуализации.
В этой статье показано, как запросить данные о погоде в режиме реального времени и прогнозируемые данные:
- Запрашивать актуальные (текущие) погодные данные с помощью Get Current Conditions API.
- Запрашивать предупреждения о неблагоприятных погодных условиях, используя Get Severe Weather Alerts API.
- Запрашивать ежедневные прогнозы с помощью Get Daily Forecast API.
- Запрашивать почасовые прогнозы с помощью Get Hourly Forecast API.
- Запрашивать поминутные прогнозы с помощью Get Minute Forecast API.
В этом видеоролике приведены примеры вызовов REST для Служб погоды Azure Maps.
Предварительные требования
-
Важно!
Для API получения прогноза минут требуется ценовая категория 1-го поколения (S1) или 2-го поколения.
В этом руководстве используется приложение Postman, но вы можете выбрать другую среду разработки API.
Запрос актуальных данных о погоде
Get Current Conditions API возвращает подробные данные о погодных условиях, например количество осадков, температура и скорость ветра, для заданного с помощью координат расположения. Кроме того, можно получить данные наблюдений за последние 6 часов или 24 часа для определенного расположения. Ответ включает такие сведения, как дата и время наблюдения, описание погодных условий, значок погоды, флаги индикаторов осадков и температура. Также возвращается значение RealFeel™ (ощущаемая температура) и индекс УФ-излучения.
В этом примере вы используете API получения текущих условий для получения текущих погодных условий в координатах, расположенных в Сиэтле, штат Вашингтон.
Откройте приложение Postman. Нажмите кнопку Создать, чтобы создать запрос. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос). Введите Имя запроса для запроса.
Выберите метод HTTP GET на вкладке конструктора и введите следующий URL-адрес. Для этого запроса и других запросов, упомянутых в этой статье, замените
{Your-Azure-Maps-Subscription-key}Azure Maps ключом подписки.https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.0&query=47.60357,-122.32945&subscription-key={Your-Azure-Maps-Subscription-key}Нажмите синюю кнопку Отправить . Текст ответа содержит сведения о текущей погоде.
{ "results": [ { "dateTime": "2020-10-19T20:39:00+00:00", "phrase": "Cloudy", "iconCode": 7, "hasPrecipitation": false, "isDayTime": true, "temperature": { "value": 12.4, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 13.7, "unit": "C", "unitType": 17 }, "realFeelTemperatureShade": { "value": 13.7, "unit": "C", "unitType": 17 }, "relativeHumidity": 87, "dewPoint": { "value": 10.3, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 23.0, "localizedDescription": "NNE" }, "speed": { "value": 4.5, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 9.0, "unit": "km/h", "unitType": 7 } }, "uvIndex": 1, "uvIndexPhrase": "Low", "visibility": { "value": 9.7, "unit": "km", "unitType": 6 }, "obstructionsToVisibility": "", "cloudCover": 100, "ceiling": { "value": 1494.0, "unit": "m", "unitType": 5 }, "pressure": { "value": 1021.2, "unit": "mb", "unitType": 14 }, "pressureTendency": { "localizedDescription": "Steady", "code": "S" }, "past24HourTemperatureDeparture": { "value": -2.1, "unit": "C", "unitType": 17 }, "apparentTemperature": { "value": 15.0, "unit": "C", "unitType": 17 }, "windChillTemperature": { "value": 12.2, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 11.3, "unit": "C", "unitType": 17 }, "precipitationSummary": { "pastHour": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past3Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past6Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past9Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past12Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past18Hours": { "value": 0.0, "unit": "mm", "unitType": 3 }, "past24Hours": { "value": 0.4, "unit": "mm", "unitType": 3 } }, "temperatureSummary": { "past6Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 14.0, "unit": "C", "unitType": 17 } }, "past12Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 14.0, "unit": "C", "unitType": 17 } }, "past24Hours": { "minimum": { "value": 12.2, "unit": "C", "unitType": 17 }, "maximum": { "value": 15.6, "unit": "C", "unitType": 17 } } } } ] }
Как запрашивать предупреждения о неблагоприятных погодных условиях
Azure Maps API получения оповещений о суровых погодных условиях возвращает оповещения о суровых погодных условиях, доступные по всему миру как от официальных правительственных метеорологических агентств, так и от ведущих мировых и региональных поставщиков оповещений о погоде. Служба возвращает такие сведения, как тип оповещения, категория, уровень. Служба также возвращает подробные описания активных серьезных оповещений для запрошенного расположения, таких как ураганы, грозы, молнии, тепловые волны или лесные пожары. Например, менеджеры по логистике могут визуализировать данные о неблагоприятных погодных условиях на карте вместе с объектами коммерческой деятельности и запланированными маршрутами, а также координировать работу с водителями и сотрудниками на местах.
В этом примере вы используете API получения оповещений о тяжелой погоде для получения текущих погодных условий в координатах, расположенных в Шайенне, штат Вашингтон.
Примечание
В этом примере извлекаются предупреждения о неблагоприятных погодных условиях на момент написания этой статьи. Вероятно, для запрошенного расположения больше нет активных предупреждений о неблагоприятных погодных условиях. Чтобы получить фактические данные при выполнении этого примера, необходимо получить данные в расположении с другими координатами.
В приложении Postman нажмите Создать, чтобы создать запрос. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос). Введите Имя запроса для запроса.
Выберите метод HTTP GET на вкладке конструктора и введите следующий URL-адрес. Для этого запроса и других запросов, упомянутых в этой статье, замените
{Your-Azure-Maps-Subscription-key}Azure Maps ключом подписки.https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.0&query=41.161079,-104.805450&subscription-key={Your-Azure-Maps-Subscription-key}Нажмите синюю кнопку Отправить . Если оповещений о суровых погодных условиях нет, текст ответа содержит пустой
results[]массив. При наличии предупреждений текст ответа будет содержать ответ JSON, подобный следующему:{ "results": [ { "countryCode": "US", "alertId": 2194734, "description": { "localized": "Red Flag Warning", "english": "Red Flag Warning" }, "category": "FIRE", "priority": 54, "source": "U.S. National Weather Service", "sourceId": 2, "alertAreas": [ { "name": "Platte/Goshen/Central and Eastern Laramie", "summary": "Red Flag Warning in effect until 7:00 PM MDT. Source: U.S. National Weather Service", "startTime": "2020-10-05T15:00:00+00:00", "endTime": "2020-10-06T01:00:00+00:00", "latestStatus": { "localized": "Continue", "english": "Continue" }, "alertDetails": "...RED FLAG WARNING REMAINS IN EFFECT FROM 9 AM THIS MORNING TO\n7 PM MDT THIS EVENING FOR STRONG GUSTY WINDS AND LOW HUMIDITY...\n\n* WHERE...Fire weather zones 303, 304, 305, 306, 307, 308, 309,\n and 310 in southeast Wyoming. Fire weather zone 313 in Nebraska.\n\n* WIND...West to northwest 15 to 30 MPH with gusts around 40 MPH.\n\n* HUMIDITY...10 to 15 percent.\n\n* IMPACTS...Any fires that develop will likely spread rapidly.\n Outdoor burning is not recommended.\n\nPRECAUTIONARY/PREPAREDNESS ACTIONS...\n\nA Red Flag Warning means that critical fire weather conditions\nare either occurring now...or will shortly. A combination of\nstrong winds...low relative humidity...and warm temperatures can\ncontribute to extreme fire behavior.\n\n&&", "alertDetailsLanguageCode": "en" } ] },... ] }
Как запрашивать данные прогноза погоды по дням
Get Daily Forecast API возвращает подробный прогноз погоды по дням, включая температуру и скорость ветра. В запросе можно указать, за сколько дней требуются данные (1, 5, 10, 15, 25 или 45) для заданного с помощью координат расположения. Ответ включает такие сведения, как температура, скорость ветра, количество осадков, качество воздуха и индекс УФ-излучения. В этом примере мы запрашиваем данные за пять дней, установив duration=5.
Важно!
В ценовой категории S0 можно запросить прогноз по дням на следующие 1, 5, 10 и 15 дней. В ценовой категории 1-го поколения (S1) или 2-го поколения можно запросить ежедневный прогноз на следующие 25 дней и 45 дней.
Прекращение поддержки ценовой категории Azure Maps 1-го поколения
Ценовая категория 1-го поколения теперь является устаревшей и будет прекращена 15.09.26. Ценовая категория 2-го поколения заменяет ценовую категорию 1-го поколения (S0 и S1). Если для вашей учетной записи Azure Maps выбрана ценовая категория 1-го поколения, вы можете перейти на ценовую категорию 2-го поколения, прежде чем она будет прекращена. В противном случае она будет автоматически обновлена. Дополнительные сведения см. в статье Управление ценовой категорией учетной записи Azure Maps.
В этом примере вы используете API получения ежедневного прогноза для получения прогноза погоды на пять дней для координат, расположенных в Сиэтле, штат Вашингтон.
В приложении Postman нажмите New (Создать), чтобы создать запрос. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос). Введите Имя запроса для запроса.
Выберите метод HTTP GET на вкладке конструктора и введите следующий URL-адрес. Для этого запроса и других запросов, упомянутых в этой статье, замените
{Your-Azure-Maps-Subscription-key}Azure Maps ключом подписки.https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.0&query=47.60357,-122.32945&duration=5&subscription-key={Your-Azure-Maps-Subscription-key}Нажмите синюю кнопку Отправить . Текст ответа содержит данные прогноза погоды на пять дней. Для краткости в следующем ответе JSON показан прогноз на первый день.
{ "summary": { "startDate": "2020-10-18T17:00:00+00:00", "endDate": "2020-10-19T23:00:00+00:00", "severity": 2, "phrase": "Snow, mixed with rain at times continuing through Monday evening and a storm total of 3-6 cm", "category": "snow/rain" }, "forecasts": [ { "date": "2020-10-19T04:00:00+00:00", "temperature": { "minimum": { "value": -1.1, "unit": "C", "unitType": 17 }, "maximum": { "value": 1.3, "unit": "C", "unitType": 17 } }, "realFeelTemperature": { "minimum": { "value": -6.0, "unit": "C", "unitType": 17 }, "maximum": { "value": 0.5, "unit": "C", "unitType": 17 } }, "realFeelTemperatureShade": { "minimum": { "value": -6.0, "unit": "C", "unitType": 17 }, "maximum": { "value": 0.7, "unit": "C", "unitType": 17 } }, "hoursOfSun": 1.8, "degreeDaySummary": { "heating": { "value": 18.0, "unit": "C", "unitType": 17 }, "cooling": { "value": 0.0, "unit": "C", "unitType": 17 } }, "airAndPollen": [ { "name": "AirQuality", "value": 23, "category": "Good", "categoryValue": 1, "type": "Ozone" }, { "name": "Grass", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "Mold", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "Ragweed", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "Tree", "value": 0, "category": "Low", "categoryValue": 1 }, { "name": "UVIndex", "value": 0, "category": "Low", "categoryValue": 1 } ], "day": { "iconCode": 22, "iconPhrase": "Snow", "hasPrecipitation": true, "precipitationType": "Mixed", "precipitationIntensity": "Light", "shortPhrase": "Chilly with snow, 2-4 cm", "longPhrase": "Chilly with snow, accumulating an additional 2-4 cm", "precipitationProbability": 90, "thunderstormProbability": 0, "rainProbability": 54, "snowProbability": 85, "iceProbability": 8, "wind": { "direction": { "degrees": 36.0, "localizedDescription": "NE" }, "speed": { "value": 9.3, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 70.0, "localizedDescription": "ENE" }, "speed": { "value": 25.9, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 4.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 0.5, "unit": "mm", "unitType": 3 }, "snow": { "value": 2.72, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 9.0, "hoursOfRain": 1.0, "hoursOfSnow": 9.0, "hoursOfIce": 0.0, "cloudCover": 96 }, "night": { "iconCode": 29, "iconPhrase": "Rain and snow", "hasPrecipitation": true, "precipitationType": "Mixed", "precipitationIntensity": "Light", "shortPhrase": "Showers of rain and snow", "longPhrase": "A couple of showers of rain or snow this evening; otherwise, cloudy; storm total snowfall 1-3 cm", "precipitationProbability": 65, "thunderstormProbability": 0, "rainProbability": 60, "snowProbability": 54, "iceProbability": 4, "wind": { "direction": { "degrees": 16.0, "localizedDescription": "NNE" }, "speed": { "value": 16.7, "unit": "km/h", "unitType": 7 } }, "windGust": { "direction": { "degrees": 1.0, "localizedDescription": "N" }, "speed": { "value": 35.2, "unit": "km/h", "unitType": 7 } }, "totalLiquid": { "value": 4.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 3.0, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.79, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 }, "hoursOfPrecipitation": 4.0, "hoursOfRain": 1.0, "hoursOfSnow": 3.0, "hoursOfIce": 0.0, "cloudCover": 94 }, "sources": [ "AccuWeather" ] },... ] }
Как запрашивать данные прогноза погоды по часам
Get Hourly Forecast API возвращает подробный почасовой прогноз погоды на следующий 1 час, 12 часов, 24 часа (1 день), 72 часа (3 дня), 120 часов (5 дней) или 240 часов (10 дней) для заданного с помощью координат расположения. API возвращает такие сведения, как температура, влажность, скорость ветра, количество осадков и индекс УФ-излучения.
Важно!
В ценовой категории 1-го поколения (S0) можно запросить почасовой прогноз на следующие 1, 12, 24 часа (1 день) и 72 часа (3 дня). В ценовой категории 1-го поколения (S1) или 2-го поколения можно запросить почасовой прогноз на следующие 120 (5 дней) и 240 часов (10 дней).
В этом примере вы используете API получения почасового прогноза для получения почасового прогноза погоды на следующие 12 часов в координатах, расположенных в Сиэтле, штат Вашингтон.
В приложении Postman нажмите New (Создать), чтобы создать запрос. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос). Введите Имя запроса для запроса.
Выберите метод HTTP GET на вкладке конструктора и введите следующий URL-адрес. Для этого запроса и других запросов, упомянутых в этой статье, замените
{Your-Azure-Maps-Subscription-key}Azure Maps ключом подписки.https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.0&query=47.60357,-122.32945&duration=12&subscription-key={Your-Azure-Maps-Subscription-key}Нажмите синюю кнопку Отправить . Текст ответа содержит данные прогноза погоды на следующие 12 часов. Для краткости в следующем ответе JSON показан прогноз на первый час.
{ "forecasts": [ { "date": "2020-10-19T21:00:00+00:00", "iconCode": 12, "iconPhrase": "Showers", "hasPrecipitation": true, "precipitationType": "Rain", "precipitationIntensity": "Light", "isDaylight": true, "temperature": { "value": 14.7, "unit": "C", "unitType": 17 }, "realFeelTemperature": { "value": 13.3, "unit": "C", "unitType": 17 }, "wetBulbTemperature": { "value": 12.0, "unit": "C", "unitType": 17 }, "dewPoint": { "value": 9.5, "unit": "C", "unitType": 17 }, "wind": { "direction": { "degrees": 242.0, "localizedDescription": "WSW" }, "speed": { "value": 9.3, "unit": "km/h", "unitType": 7 } }, "windGust": { "speed": { "value": 14.8, "unit": "km/h", "unitType": 7 } }, "relativeHumidity": 71, "visibility": { "value": 9.7, "unit": "km", "unitType": 6 }, "cloudCover": 100, "ceiling": { "value": 1128.0, "unit": "m", "unitType": 5 }, "uvIndex": 1, "uvIndexPhrase": "Low", "precipitationProbability": 51, "rainProbability": 51, "snowProbability": 0, "iceProbability": 0, "totalLiquid": { "value": 0.3, "unit": "mm", "unitType": 3 }, "rain": { "value": 0.3, "unit": "mm", "unitType": 3 }, "snow": { "value": 0.0, "unit": "cm", "unitType": 4 }, "ice": { "value": 0.0, "unit": "mm", "unitType": 3 } }... ] }
Как запрашивать данные прогноза погоды по минутам
Get Minute Forecast API возвращает данные поминутного прогноза на следующие 120 минут для определенного расположения. Пользователи могут запрашивать прогноз погоды с интервалом 1, 5 и 15 минут. Ответ содержит такие сведения, как тип осадков (включая дождь, снег или их сочетание), время начала и значение интенсивности осадков (dBZ).
В этом примере вы используете API получения поминутного прогноза для получения поминутного прогноза погоды в координатах, расположенных в Сиэтле, штат Вашингтон. Прогноз погоды предоставляется на следующие 120 минут. Наш запрос запрашивает, чтобы прогноз давался с интервалом в 15 минут, но вы можете настроить параметр на 1 или 5 минут.
В приложении Postman нажмите New (Создать), чтобы создать запрос. В окне Create New (Создание) выберите HTTP Request (HTTP-запрос). Введите Имя запроса для запроса.
Выберите метод HTTP GET на вкладке конструктора и введите следующий URL-адрес. Для этого запроса и других запросов, упомянутых в этой статье, замените
{Your-Azure-Maps-Subscription-key}Azure Maps ключом подписки.https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.0&query=47.60357,-122.32945&interval=15&subscription-key={Your-Azure-Maps-Subscription-key}Нажмите синюю кнопку Отправить . Текст ответа содержит данные прогноза погоды на следующие 120 минут с интервалом в 15 минут.
{ "summary": { "briefPhrase60": "No precipitation for at least 60 min", "shortPhrase": "No precip for 120 min", "briefPhrase": "No precipitation for at least 120 min", "longPhrase": "No precipitation for at least 120 min", "iconCode": 7 }, "intervalSummaries": [ { "startMinute": 0, "endMinute": 119, "totalMinutes": 120, "shortPhrase": "No precip for %MINUTE_VALUE min", "briefPhrase": "No precipitation for at least %MINUTE_VALUE min", "longPhrase": "No precipitation for at least %MINUTE_VALUE min", "iconCode": 7 } ], "intervals": [ { "startTime": "2020-10-19T20:51:00+00:00", "minute": 0, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:06:00+00:00", "minute": 15, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:21:00+00:00", "minute": 30, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:36:00+00:00", "minute": 45, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T21:51:00+00:00", "minute": 60, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:06:00+00:00", "minute": 75, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:21:00+00:00", "minute": 90, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 }, { "startTime": "2020-10-19T22:36:00+00:00", "minute": 105, "dbz": 0.0, "shortPhrase": "No Precipitation", "iconCode": 7, "cloudCover": 100 } ] }