Weather - Get Current Conditions

Ссылка

Служба:: Maps

Версия API:: 1.1

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

API Get Current Conditions — это 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,-122.125679".
details	query		string	Возвращает полные сведения о текущих условиях. Доступные значения: `true` — возвращает полные сведения. По умолчанию возвращаются все сведения. `false` — Возвращает усеченную версию текущих данных о состоянии, включающую дату наблюдения, метеописную фразу, код значка, флаг индикатора осадков и температуру.
duration	query		integer	Временной интервал возвращаемых погодных условий. По умолчанию возвращаются самые последние погодные условия. По умолчанию установлено значение 0. Поддерживаются значения: `0` — Возвращает самые текущие погодные условия. `6` - Возврат погодных условий за последние 6 часов. `24` - Возврат погодных условий за последние 24 часа.
language	query		string	Язык, на котором должны возвращаться результаты поиска. Должен быть одним из поддерживаемых языковых тегов IETF без учета регистра. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию. Дополнительные сведения см. в разделе Поддерживаемые языки .
unit	query		WeatherDataUnit	Указывает, как возвращать данные в единицах метрик или в единицах империи. Значение по умолчанию — метрика.

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

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности Microsoft Entra ID. Он представляет уникальный идентификатор для учетной записи Azure Maps и может быть получен из API учетной записи плоскости управления Azure Maps. Инструкции по использованию безопасности Microsoft Entra ID в 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-адреса, созданный с помощью операции List SAS в ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK для Azure или REST API.

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

Для общедоступных приложений мы рекомендуем настроить определенный список разрешенных источников в ресурсе учетной записи map , чтобы ограничить использование маркера 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
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "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	Числовое значение идентификатора, связанное с типом отображаемой единицы измерения. Может использоваться для преобразования единиц. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
WeatherDataUnit	Указывает, что данные возвращаются в единицах метрик или в единицах империи. Значение по умолчанию — metric.
WeatherUnit	Конкретное значение заданной единицы измерения, связанное с погодой.
WindDetails	Сведения о ветре возвращаются, включая скорость и направление.
WindDirection	Направление ветра

CurrentConditions

Имя	Тип	Описание
apparentTemperature	WeatherUnit	Воспринимаемая температура на открытом воздухе, вызванная сочетанием температуры воздуха, относительной влажности и скорости ветра в указанной единице.
ceiling	WeatherUnit	Облачный потолок в указанной единице. Потолок — это измерение высоты основания самых низких облаков.
cloudCover	integer	Процент, представляющий облачное покрытие.
dateTime	string	Дата и время текущего наблюдения, отображаемого в формате ISO 8601, например 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Температура точки росы в указанной единице измерения. Температура точки росы — это температура, до которую необходимо охладить воздух, чтобы достичь насыщения.
hasPrecipitation	boolean	Указывает на наличие или отсутствие осадков. Значение True указывает на наличие осадков, значение false — на отсутствие осадков.
iconCode	IconCode	Числовое значение, представляющее изображение, отображающее `iconPhrase`. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
isDayTime	boolean	Указывает время суток. Значение True указывает на "день", "false" — "ночь.
obstructionsToVisibility	string	Причина ограниченной видимости. Возможные значения: A = сильный гроза/град BD = выдувная пыль BN = вдув песка BS = дует снег D = пыль F = туман GF = наземный туман ГЦ = дымка 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™ Temperature.
realFeelTemperatureShade	WeatherUnit	Возвращается значение RealFeel™ Temperature. Описывает, что температура действительно чувствует себя в тени.
relativeHumidity	integer	Относительная влажность — это количество водяного пара, присутствующего в воздухе, выраженное в процентах от количества, необходимого для насыщения при той же температуре.
temperature	WeatherUnit	Возвращаемая температура.
temperatureSummary	TemperatureSummary	Сводка колебаний температуры за последние 6, 12 и 24 часа.
uvIndex	integer	Мера силы солнечного излучения. Поддерживаются значения: `0-2` - Низкая опасность от УФ-лучей солнца или среднего человека. `3-5` - Умеренный риск вреда от незащищенного воздействия солнца. `6-7` - Высокий риск вреда от незащищенного воздействия солнца. `8-10` - Очень высокий риск вреда от незащищенного воздействия солнца. `11+` - Крайний риск вреда от незащищенного воздействия солнца.
uvIndexPhrase	string	Фраза, связанная `uvIndex`с .
visibility	WeatherUnit	Видимость в указанной единице. Мера расстояния, на котором можно четко различить объект или свет.
wetBulbTemperature	WeatherUnit	Температура, до которой воздух может быть охлажден путем испарения воды в него под постоянным давлением, пока он не достигнет насыщения.
wind	WindDetails	Сведения о ветре возвращаются, включая скорость и направление.
windChillTemperature	WeatherUnit	Воспринимается температура воздуха на обнажаемой коже из-за ветра.
windGust	WindDetails	Порыв ветра. Порыв ветра - это внезапное, кратковременное увеличение скорости ветра.

CurrentConditionsResult

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

ErrorAdditionalInfo

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

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

ErrorDetail

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

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

ErrorResponse

Сообщение об ошибке

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

IconCode

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

Имя	Тип	Описание
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Имя	Тип	Описание
json	string	Формат обмена данными нотации объектов JavaScript

PastHoursTemperature

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

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

PrecipitationSummary

Имя	Тип	Описание
pastEighteenHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние 18 часов.
pastHour	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последний час.
pastNineHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние девять часов.
pastSixHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние шесть часов. Содержит значения метрик и имперских значений.
pastThreeHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние три часа.
pastTwelveHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние 12 часов.
pastTwentyFourHours	WeatherUnit	Количество осадков (жидкий эквивалент), выпавшее за последние 24 часа.

PressureTendency

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

TemperatureSummary

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

UnitType

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

Имя	Тип	Описание
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherDataUnit

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

Имя	Тип	Описание
imperial	string	Возврат данных в имперских единицах. Некоторые примеры единиц имперской системы — это Fahrenheit и миля.
metric	string	Возвращает данные в единицах метрик. Примерами единиц метрики являются цельсия и километр.

WeatherUnit

Конкретное значение заданной единицы измерения, связанное с погодой.

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

WindDetails

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

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

WindDirection

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

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

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