Weather - Get Current Conditions

Ссылка

Служба:: Maps

Версия API:: 1.1

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

Get Current Conditions API представляет собой HTTP-запросGET, который возвращает подробные сведения о текущих погодных условиях, таких как осадки, температура и ветер для заданного координатного местоположения. Кроме того, можно получить данные наблюдений за последние 6 или 24 часа для определенного местоположения. Основная информация, возвращаемая вместе с ответом, включает в себя такие сведения, как дата и время наблюдения, краткое описание погодных условий, значок погоды, флаги индикатора осадков и температура. Также возвращаются дополнительные данные, такие как температура RealFeel™ и УФ-индекс. Дополнительные сведения см. в разделе Запрос данных о погоде в режиме реального времени

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

С использованием необязательных параметров:

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

Параметры URI

Имя	В	Обязательно	Тип	Описание
format	path	True	JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
api-version	query	True	string	Номер версии API Azure Maps.
query	query	True	number[]	Применимый запрос, указанный как разделенная запятыми строка, состоящая из широты, за которой следует долгота, например "47.641268,-125679". Информация о погоде обычно доступна для мест на суше, водоемов, окруженных сушей, и районов океана, которые находятся в пределах примерно 50 морских миль от береговой линии.
details	query		string	Верните полную информацию о текущих условиях. Доступные значения: `true` - Возвращает полную информацию. По умолчанию возвращаются все данные. `false` - Возвращает усеченную версию данных о текущем состоянии, которая включает дату наблюдения, время, фразу погоды, код значка, флаг индикатора осадков и температуру.
duration	query		integer	Временные рамки возвращаемых погодных условий. По умолчанию будут возвращены самые актуальные погодные условия. Значение по умолчанию равно 0. Поддерживаются значения: `0` - Возврат самых актуальных погодных условий. `6` - Вернитесь к погодным условиям за последние 6 часов. `24` - Укажите погодные условия за последние 24 часа.
language	query		string	Язык, в котором должны быть возвращены результаты поиска. Должен быть одним из поддерживаемых тегов языка IETF, не учитывает регистр. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию. Дополнительные сведения см. в поддерживаемых языках.
unit	query		WeatherDataUnit	Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric.

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности идентификатора Microsoft Entra. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Сведения о том, как использовать безопасность идентификатора Microsoft Entra в Azure Maps, см. в следующих статьях .

Ответы

Имя	Тип	Описание
200 OK	CurrentConditionsResult	ХОРОШО
Other Status Codes	ErrorResponse	Произошла непредвиденная ошибка.

Безопасность

AADToken

Это потоки Microsoft Entra OAuth 2.0. При паре с доступом на основе ролей Azure его можно использовать для управления доступом к REST API Azure Maps. Управление доступом на основе ролей Azure используется для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Доступ к любому пользователю, группе или субъекту-службе можно предоставить через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.

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

Примечания.

Для этого определения безопасности требуется использовать заголовок x-ms-client-id, чтобы указать, к какой ресурсу Azure Maps приложение запрашивает доступ. Это можно получить из API управления карт.

Authorization URL зависит от экземпляра общедоступного облака Azure. В национальных облаках есть уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra. * Управление доступом на основе ролей Azure настраивается с плоскости управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API. * Использование веб-пакета SDK Azure Maps позволяет настроить приложение на основе конфигурации для нескольких вариантов использования.

Дополнительные сведения о платформе удостоверений Майкрософт см. в обзоре платформы удостоверений Майкрософт.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, подготовленный при создания учетной записи Azure Maps на портале Azure или с помощью PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого ключа любой приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве главного ключа в учетной записи, в которую они выданы.

Для общедоступных приложений мы рекомендуем использовать конфиденциальные клиентские приложения, подход для доступа к REST API Azure Maps, чтобы ваш ключ можно было безопасно хранить.

Тип: apiKey
В: query

SAS Token

Это маркер подписанного URL-адреса создается из операции SAS списка на ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого маркера любой приложению разрешен доступ с помощью управления доступом на основе ролей Azure и точного управления сроком действия, скоростью и регионами, используемыми для конкретного маркера. Другими словами, маркер SAS можно использовать для разрешения приложений управлять доступом более защищенным способом, чем общий ключ.

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

Тип: apiKey
В: header

Примеры

Successfully retrieve detailed current weather conditions for a given coordinate location

Образец запроса

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Пример ответа

Код состояния:: 200

{
  "results": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "past3Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past6Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past9Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past12Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past18Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past24Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "past6Hours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past12Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past24Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Определения

Имя	Описание
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
IconCode	Числовое значение, представляющее изображение, отображающее .`iconPhrase` Дополнительные сведения см. в статье Службы погоды в Azure Maps .
JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
PastHoursTemperature	Сводка колебаний температуры за прошедшие часы.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
WeatherDataUnit	Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric.
WeatherUnit	Удельное значение данной единицы, связанное с погодой.
WindDetails	Возвращаются данные о ветре, включая скорость и направление.
WindDirection	Направление ветра

CurrentConditions

Object

Имя	Тип	Описание
apparentTemperature	WeatherUnit	Воспринимаемая температура наружного воздуха, вызванная сочетанием температуры воздуха, относительной влажности и скорости ветра в указанной единице.
ceiling	WeatherUnit	Облачный потолок в указанной единице. Потолок – это мера высоты основания самых низких облаков.
cloudCover	integer (int32)	Процент представляет облачность.
dateTime	string (date-time)	Дата и время текущего наблюдения отображаются в формате ISO 8601, например, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Температура точки росы в указанных единицах. Температура точки росы — это температура, до которой воздух должен быть охлажден для достижения насыщения.
hasPrecipitation	boolean	Указывает на наличие или отсутствие осадков. True указывает на наличие осадков, false – на отсутствие осадков.
iconCode	IconCode (int32)	Числовое значение, представляющее изображение, отображающее .`iconPhrase` Дополнительные сведения см. в статье Службы погоды в Azure Maps .
isDayTime	boolean	Указывает время суток. True обозначает 'день',' false указывает на 'ночь.
obstructionsToVisibility	string	Причина ограниченной видимости. Возможные значения: A = сильная гроза/град BD = выдуваемая пыль BN = выдувной песок BS = снегопад D = пыль F = туман GF = туман на земле HZ = дымка I = лед IC = кристаллы льда IF = ледяной туман IP = ледяные гранулы IPW = душ с ледяными гранулами K = дым L = моросящий дождь R = дождь RS = дождь/снег RW = тропический душ S = снег SG = снежные гранулы SP = снежные гранулы SW = снежный ливень T = гроза UP = неопределенное количество осадков ZL = ледяной дождь ZR = ледяной дождь + = тяжелый - = свет
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Отклонение от температуры, наблюдавшейся 24 часа назад в указанной единице.
phrase	string	Фразовое описание текущих погодных условий. Отображается на указанном языке.
precipitationSummary	PrecipitationSummary	Сводка по количеству осадков за последние 24 часа.
pressure	WeatherUnit	Атмосферное давление в указанных единицах.
pressureTendency	PressureTendency	Изменение атмосферного давления.
realFeelTemperature	WeatherUnit	Возвращается температура RealFeel™.
realFeelTemperatureShade	WeatherUnit	Возвращается температура RealFeel™. Описывает, как на самом деле ощущается температура в тени.
relativeHumidity	integer (int32)	Относительная влажность — это количество водяного пара, присутствующего в воздухе, выраженное в процентах от количества, необходимого для насыщения при той же температуре.
temperature	WeatherUnit	Возвращается температура.
temperatureSummary	TemperatureSummary	Сводка колебаний температуры за последние 6, 12 и 24 часа.
uvIndex	integer (int32)	Мера силы ультрафиолетового излучения солнца. Поддерживаются значения: `0-2` - Низкая опасность со стороны ультрафиолетовых лучей солнца или обычного человека. `3-5` - Умеренный риск причинения вреда при незащищенном воздействии солнца. `6-7` - Высокий риск причинения вреда при незащищенном воздействии солнца. `8-10` - Очень высокий риск причинения вреда при незащищенном воздействии солнца. `11+` - Чрезвычайный риск причинения вреда при незащищенном воздействии солнца.
uvIndexPhrase	string	Фраза, связанная с .`uvIndex`
visibility	WeatherUnit	Видимость в указанном блоке. Мера расстояния, на котором объект или свет могут быть четко различимы.
wetBulbTemperature	WeatherUnit	Температура, до которой воздух может быть охлажден путем испарения в нем воды при постоянном давлении до тех пор, пока он не достигнет насыщения.
wind	WindDetails	Возвращаются данные о ветре, включая скорость и направление.
windChillTemperature	WeatherUnit	Воспринимаемая температура воздуха на открытых участках кожи из-за ветра.
windGust	WindDetails	Порыв ветра. Порыв ветра – это внезапное, кратковременное увеличение скорости ветра.

CurrentConditionsResult

Object

Имя	Тип	Описание
results	CurrentConditions[]	Подробные сведения о текущих погодных условиях.

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IconCode

Перечисление

Числовое значение, представляющее изображение, отображающее .iconPhrase Дополнительные сведения см. в статье Службы погоды в Azure Maps .

Значение	Описание
1	Солнечно
10
11	Туман
12	Ливень
13	Значительная облачность, ливни
14	Небольшая облачность, ливни
15	Гроза
16	Значительная облачность, грозы
17	Небольшая облачность, грозы
18	дождь.
19	Снегопад
2	Малооблачно
20	Значительная облачность, небольшой снег
21	Переменная облачность с небольшими снегопадами
22	Снег
23	Значительная облачность, снег
24	Лёд
25	Дождь со снегом
26	Замерзающий дождь
27
28
29	Дождь со снегом
3	Небольшая облачность
30	жарко
31	холод
32	Ветрено
33	Очистить
34	Малооблачно
35	Частичная облачность
36	Кратковременная облачность (ночь)
37	Туманное Лунное Свечение
38	Преимущественно облачно (ночь)
39	Частичная облачность, ливни
4	Переменная облачность
40	Преимущественно облачно с ливнями (ночь)
41	Частичная облачность, грозы
42	Преимущественно облачно с грозами (ночь)
43	Преимущественно облачно со шквалами (ночь)
44	Преимущественно облачно со снегом (ночь)
5	Солнечно с дымкой
6	Преимущественно облачно
7	Облачно
8	Пасмурно (сплошная облачность)
9

JsonFormat

Перечисление

Требуемый формат ответа. Поддерживается только json формат.

Значение	Описание
json	формат обмена данными для объектов JavaScript

PastHoursTemperature

Object

Сводка колебаний температуры за прошедшие часы.

Имя	Тип	Описание
maximum	WeatherUnit	максимум
minimum	WeatherUnit	минимум

PrecipitationSummary

Object

Имя	Тип	Описание
past12Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние 12 часов.
past18Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние 18 часов.
past24Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние 24 часа.
past3Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние три часа.
past6Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние шесть часов. Содержит метрические и британские значения.
past9Hours	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последние девять часов.
pastHour	WeatherUnit	Количество осадков (в жидком эквиваленте), выпавших за последний час.

PressureTendency

Object

Имя	Тип	Описание
code	string	Код склонности к давлению независимо от языка. Один из F = Падающий, S = Устойчивый, R = Восходящий.
localizedDescription	string	Описание тенденции давления на указанном языке

TemperatureSummary

Object

Имя	Тип	Описание
past12Hours	PastHoursTemperature	Сводка по колебаниям температуры за последние 12 часов.
past24Hours	PastHoursTemperature	Сводка колебаний температуры за последние 24 часа.
past6Hours	PastHoursTemperature	Сводка по колебаниям температуры за последние 6 часов.

UnitType

Перечисление

Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .

Значение	Описание
0	футы
1	дюймы
10	метры в секунду (м/с)
11	гектопаскали
12	дюймы ртутного столба
13	килопаскали
14	миллибары
15	миллиметры ртутного столба (мм рт. столба)
16	poundsPerSquareInch (фунт/кв. дюйм)
17	Цельсия
18	Фаренгейт
19	Кельвин
2	мили
20	процент
21	плавать
22	целое число
3	миллиметр
31	МикрограммКубический метр воздуха
4	сантиметр
5	метр
6	километр
7	километры в час (км/час)
8	узлы
9	миль в час

WeatherDataUnit

Перечисление

Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric.

Значение	Описание
imperial	Возвращайте данные в британских единицах. Некоторыми примерами единиц имперской системы являются Фаренгейт и миля.
metric	Возвращайте данные в метрических единицах. Некоторыми примерами единиц метрической системы являются Цельсий и километр.

WeatherUnit

Object

Удельное значение данной единицы, связанное с погодой.

Имя	Тип	Описание
unit	string	Тип единицы измерения для возвращаемого значения.
unitType	UnitType (int32)	Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
value	number (float)	Округленное значение.

WindDetails

Object

Возвращаются данные о ветре, включая скорость и направление.

Имя	Тип	Описание
direction	WindDirection	Направление ветра
speed	WeatherUnit	Скорость ветра в указанной единице.

WindDirection

Object

Направление ветра

Имя	Тип	Описание
degrees	integer (int32)	Направление ветра в градусах по азимуту, начиная с истинного севера и продолжая по часовой стрелке. Север составляет 0 градусов, восток составляет 90 градусов, юг составляет 180 градусов, запад — 270 градусов. Возможные значения 0-359.
localizedDescription	string	Аббревиатура направления на указанном языке.

Поделиться через

Weather - Get Current Conditions

Параметры URI

Заголовок запроса

Ответы

Безопасность

AADToken

Примечания.

Области

subscription-key

SAS Token

Примеры

Successfully retrieve detailed current weather conditions for a given coordinate location

Образец запроса

Пример ответа

Определения

CurrentConditions

CurrentConditionsResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PastHoursTemperature

PrecipitationSummary

PressureTendency

TemperatureSummary

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection