Weather - Get Current Conditions

Служба:: Maps

Версия API:: 1.1

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

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}

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

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

Параметры URI

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

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

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

Ответы

Имя	Тип	Описание
200 OK	CurrentConditionsResult	Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

AadToken

Это Microsoft Entra OAuth 2.0 потоки. В сочетании с управлением Azure ролевым доступом он может использоваться для управления доступом к Azure Maps REST API. Ролевые контроли доступа Azure используются для обозначения доступа к одной или нескольким учетной записи ресурсов или подресурсам Azure Maps. Любой пользователь, группа или принципал сервиса может получить доступ через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений Azure Maps REST API.\n\nДля реализации сценариев рекомендуем ознакомиться с концепциями аутентификационные концепции. В заключение, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, способных контролировать доступ к определённым API и областям видимости.\n\n#### Примечания\n* Это определение безопасности требует использование заголовка x-ms-client-id для указания, к какому Azure Maps ресурсу приложение запрашивает доступ. Её можно получить через API управления Maps.\n* \nAuthorization URL специфичен для экземпляра публичного облака Azure. Облака Sovereign имеют уникальные URL-адреса авторизации и конфигурации Microsoft Entra ID. \n* \nУправление доступом на основе ролей Azure настраивается с плоскости управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n* \nИспользование Azure Maps Web SDK позволяет настраивать приложение на основе конфигурации для нескольких сценариев использования.\n* Для получения дополнительной информации о платформа удостоверений Майкрософт см. платформа удостоверений Майкрософт обзор.

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

Области

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

subscription-key

Это общий ключ, который создаётся при Создайте Azure Maps аккаунт в Azure-портале или с помощью PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого ключа любое приложение может получить доступ ко всем REST API. Другими словами, этот ключ может использоваться как мастер-ключ на счете, на котором они выпущены.\n\n Для публично открытых приложений мы рекомендуем использовать подход confidential client applications для доступа к Azure Maps REST API, чтобы ваш ключ можно было безопасно хранить.

Тип: apiKey
В: header

SAS Token

Это токен общего доступа, созданный из операции List SAS на ресурсе Azure Maps/c0> через плоскость управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого токена любое приложение имеет право на доступ с помощью Azure ролевые контроли доступа и тонкий контроль истечения срока действия, скорости и региона использования конкретного токена. Другими словами, SAS Token может использоваться для того, чтобы приложения могли управлять доступом более защищённо, чем общий ключ.\n\n Для публично открытых приложений мы рекомендуем настроить конкретный список разрешённых источников на ресурсе аккаунта Map , чтобы ограничить злоупотребления рендерингом и регулярно продлевать токен SAS.

Тип: apiKey
В: header

Примеры

Successfully retrieve detailed current weather conditions for a given coordinate location

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

HTTP

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

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

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

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

Определения

Имя	Описание
CurrentConditions	Данные о текущих погодных условиях.
CurrentConditionsResult	Текущие погодные условия тоже подтверждаются.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Обычный ответ на ошибку для всех API Azure Resource Manager для возврата деталей ошибок при неудачных операциях. (Это также следует формату ответа об ошибках OData.).
IconCode	Числовое значение, представляющее изображение, которое соответствует текущим погодным условиям, описываемым свойством `Phrase` . Для получения дополнительной информации см. Метеослужбы в Azure Maps. Может иметь значение NULL.
JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
PastHoursTemperature	Сводка колебаний температуры за прошедшие часы.
PrecipitationSummary	Сводка по количеству осадков.
PressureTendency	Тенденция атмосферного давления.
TemperatureSummary	Краткое описание колебаний температуры.
UnitType	Целое число, представляющее тип единицы измерения. Например, 17 для Цельсия, 18 для Фаренгейта. Может использоваться для перевода единиц измерения. Полный список см. Метеорологические службы в Azure Maps.
WeatherDataUnit	Единица измерения погодных данных.
WeatherValue	Удельное значение данной единицы, связанное с погодой.
WindDetails	Возвращаются данные о ветре, включая скорость и направление.
WindDirection	Направление ветра

CurrentConditions

Объект

Данные о текущих погодных условиях.

Имя	Тип	Описание
apparentTemperature	WeatherValue	Воспринимаемая температура наружного воздуха, вызванная сочетанием температуры воздуха, относительной влажности и скорости ветра в указанной единице.
ceiling	WeatherValue	Облачная высота в указанной единице измерения. Потолок – это мера высоты основания самых низких облаков.
cloudCover	integer (int32)	Процент, указывающий на степень облачности.
dateTime	string (date-time)	Дата и время текущего наблюдения отображаются в формате ISO 8601 , например, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherValue	Температура точки росы в указанных единицах. Температура точки росы — это температура, до которой воздух должен быть охлажден для достижения насыщения.
hasPrecipitation	boolean	Булево значение, указывающее, ожидаются ли осадки (дождь, снег, мокрый снег или град) в указанный период. Возвращает истину, если ожидается осадки, в противном случае — ложно.
iconCode	IconCode	Числовое значение, представляющее изображение, которое соответствует текущим погодным условиям, описываемым свойством `Phrase` . Для получения дополнительной информации см. Метеослужбы в Azure Maps. Может иметь значение NULL.
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	WeatherValue	Отклонение от температуры, наблюдавшейся 24 часа назад в указанной единице.
phrase	string	Фразовое описание текущих погодных условий. Отображается на указанном языке.
precipitationSummary	PrecipitationSummary	Сводка по количеству осадков за последние 24 часа.
pressure	WeatherValue	Атмосферное давление в указанных единицах.
pressureTendency	PressureTendency	Изменение атмосферного давления.
realFeelTemperature	WeatherValue	Температура RealFeel™ возвращается.
realFeelTemperatureShade	WeatherValue	Температура RealFeel™ возвращается. Описывает, как на самом деле ощущается температура в тени.
relativeHumidity	integer (int32)	Относительная влажность — это количество водяного пара, присутствующего в воздухе, выраженное в процентах от количества, необходимого для насыщения при той же температуре.
temperature	WeatherValue	Возвращается температура.
temperatureSummary	TemperatureSummary	Сводка колебаний температуры за последние 6, 12 и 24 часа.
uvIndex	integer (int32)	Мера силы ультрафиолетового излучения солнца. Поддерживаются значения: `0-2` - Низкая опасность со стороны ультрафиолетовых лучей солнца или обычного человека. `3-5` - Умеренный риск причинения вреда при незащищенном воздействии солнца. `6-7` - Высокий риск причинения вреда при незащищенном воздействии солнца. `8-10` - Очень высокий риск причинения вреда при незащищенном воздействии солнца. `11+` - Чрезвычайный риск причинения вреда при незащищенном воздействии солнца.
uvIndexPhrase	string	Фраза, связанная с .`uvIndex`
visibility	WeatherValue	Видимость в указанной единице. Мера расстояния, на котором объект или свет могут быть четко различимы.
wetBulbTemperature	WeatherValue	Температура, до которой воздух может быть охлажден путем испарения в нем воды при постоянном давлении до тех пор, пока он не достигнет насыщения.
wind	WindDetails	Возвращаются данные о ветре, включая скорость и направление.
windChillTemperature	WeatherValue	Воспринимаемая температура воздуха на открытых участках кожи из-за ветра.
windGust	WindDetails	Порыв ветра. Порыв ветра – это внезапное, кратковременное увеличение скорости ветра.

CurrentConditionsResult

Объект

Текущие погодные условия тоже подтверждаются.

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

ErrorAdditionalInfo

Объект

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

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

ErrorDetail

Объект

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

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

ErrorResponse

Объект

Обычный ответ на ошибку для всех API Azure Resource Manager для возврата деталей ошибок при неудачных операциях. (Это также следует формату ответа об ошибках OData.).

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

IconCode

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

Числовое значение, представляющее изображение, которое соответствует текущим погодным условиям, описываемым свойством Phrase . Для получения дополнительной информации см. Метеослужбы в Azure Maps. Может иметь значение NULL.

Значение	Описание
1	Sunny
2	Малооблачно
3	Небольшая облачность
4	Переменная облачность
5	Солнечно с дымкой
6	Преимущественно облачно
7	Cloudy
8	Пасмурно (сплошная облачность)
11	Fog
12	Showers
13	Значительная облачность, ливни
14	Небольшая облачность, ливни
15	Thunderstorms
16	Значительная облачность, грозы
17	Небольшая облачность, грозы
18	Rain
19	Flurries
20	Значительная облачность, небольшой снег
21	Переменная облачность с небольшими снегопадами
22	Snow
23	Значительная облачность, снег
24	Ice
25	Sleet
26	Замерзающий дождь
29	Дождь со снегом
30	Hot
31	Cold
32	Windy
33	Очистить
34	Малооблачно
35	Частичная облачность
36	Кратковременная облачность (ночь)
37	Туманное Лунное Свечение
38	Преимущественно облачно (ночь)
39	Частичная облачность, ливни
40	Преимущественно облачно с ливнями (ночь)
41	Частичная облачность, грозы
42	Преимущественно облачно с грозами (ночь)
43	Преимущественно облачно со шквалами (ночь)
44	Преимущественно облачно со снегом (ночь)

JsonFormat

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

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

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

PastHoursTemperature

Объект

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

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

PrecipitationSummary

Объект

Сводка по количеству осадков.

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

PressureTendency

Объект

Тенденция атмосферного давления.

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

TemperatureSummary

Объект

Краткое описание колебаний температуры.

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

UnitType

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

Целое число, представляющее тип единицы измерения. Например, 17 для Цельсия, 18 для Фаренгейта. Может использоваться для перевода единиц измерения. Полный список см. Метеорологические службы в Azure Maps.

Значение	Описание
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	По Цельсию
18	Фаренгейт
19	kelvin
20	percent
21	плавать
22	целое число
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

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

Единица измерения погодных данных.

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

WeatherValue

Объект

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

Имя	Тип	Описание
unit	string	Тип единицы измерения для возвращаемого значения.
unitType	UnitType	Целое число, представляющее тип единицы измерения. Например, 17 для Цельсия, 18 для Фаренгейта. Может использоваться для перевода единиц измерения. Полный список см. Метеорологические службы в Azure Maps.
value	number (float)	Округленное значение.

WindDetails

Объект

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

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

WindDirection

Объект

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

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