Weather - Get Daily Forecast

Используйте для получения ежедневного подробного прогноза погоды на ближайшие 1, 5, 10, 15, 25 или 45 дней.
Get Daily Forecast API — это HTTP-запросGET, который возвращает подробный прогноз погоды, такой как температура и ветер на ближайшие 1, 5, 10, 15, 25 или 45 дней для заданного координатного местоположения. Реакция включает в себя такие детали, как температура, ветер, осадки, качество воздуха и УФ-индекс. Дополнительные сведения см. в разделе Запрос данных ежедневного прогноза погоды.

Если вы используете ценовую категорию Gen1 S0, вы можете запросить ежедневный прогноз на следующие 1, 5, 10 и 15 дней. Если вы используете ценовую категорию Gen1 S1 или Gen2, вы также можете запросить ежедневный прогноз на следующие 25 дней и 45 дней.

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}
GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&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 морских миль от береговой линии.

duration
query

integer (int32)

Указывает, сколько дней возвращаются ответы ежедневного прогноза. Доступные значения:

  • 1 - Возврат данных прогноза на следующий день. Возвращается по умолчанию.
  • 5 - Возврат данных прогноза на ближайшие 5 дней.
  • 10 - Вернуть данные прогноза на ближайшие 10 дней.
  • 25 - Возврат данных прогноза на ближайшие 25 дней. Доступно только в SKU S1.
  • 45 - Возврат данных прогноза на ближайшие 45 дней. Доступно только в SKU S1.
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

DailyForecastResult

Запрос выполнен успешно.

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 daily weather forecast for a given coordinate location

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

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

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

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

Определения

Имя Описание
AirAndPollen

Объект AirAndPollen предоставляет комплексные экологические данные. Он выявляет различные типы пыльцы, такие как деревья, трава, амброзия и плесень, а также загрязнители, включая PM2.5, PM10, O3, NO2, SO2 и CO. Кроме того, он показывает УФ-индекс по шкале от 1 до 10, предоставляет качественные описания качества воздуха или уровня пыльцы, а также предоставляет численные измерения концентрации загрязняющих веществ или пыльцы в воздухе. Эта подробная информация помогает пользователям оценить качество воздуха и состояние пыльцы на маршруте передвижения.

DailyForecast

Предоставляет подробную погодную информацию для конкретного дня, такую как температура, ветер, осадки, качество воздуха и индекс ультрафиолета.

DailyForecastDetail

Подробный прогноз погоды на часть дня.

DailyForecastResult

Ежедневный прогноз погоды.

DailyForecastSummary

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

DegreeDaySummary

Краткое описание дней отопления и охлаждения.

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

IconCode

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

JsonFormat

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

LocalSource

Информация о местных поставщиках данных о погоде.

PrecipitationType

Указывает тип осадков. Допустимые значения: Дождь, Снег, Лед или Смесь. Это свойство включается в отклик, когда dBZ больше нуля.

UnitType

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

WeatherDataUnit

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

WeatherValue

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

WeatherValueRange

Возвращаемые значения температуры.

WindDetails

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

WindDirection

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

AirAndPollen

Объект AirAndPollen предоставляет комплексные экологические данные. Он выявляет различные типы пыльцы, такие как деревья, трава, амброзия и плесень, а также загрязнители, включая PM2.5, PM10, O3, NO2, SO2 и CO. Кроме того, он показывает УФ-индекс по шкале от 1 до 10, предоставляет качественные описания качества воздуха или уровня пыльцы, а также предоставляет численные измерения концентрации загрязняющих веществ или пыльцы в воздухе. Эта подробная информация помогает пользователям оценить качество воздуха и состояние пыльцы на маршруте передвижения.

Имя Тип Описание
category

string

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

categoryValue

integer (int32)

Предоставляет числовое представление качества воздуха или уровня пыльцы. Это значение соответствует качественному category свойству, предоставляя точный способ количественной оценки качества воздуха или уровня пыльцы. Эти значения варьируются от 1 до 6, при этом 1 подразумевает хорошие условия, а 6 — опасные условия.

name

string

Для пыльцы: Возвращает название пыльцы, например, дерево, трава, амброзия или плесень.

Для загрязнителей: Когда name объект — AirQuality, название загрязнителя возвращается в объекте type . Допустимые загрязнители включают: PM2.5, PM10, O3, NO2, SO2 и CO.

Для УФ-индекса: Когда name свойство — UVIndex, UV-индекс возвращается в свойстве value . Действительные значения УФ-индекса варьируются от 0 до 11+ и отражают интенсивность ультрафиолетового излучения. Значения индекса УФ классифицируются следующим образом:

  • 0-2: Низкий балл
  • 3-5: Умеренный
  • 6-7: Высокий
  • 8-10: Очень высокая
  • 11+: Экстремаль
type

string

Указывает тип измеряемого загрязнителя воздуха. Используется только тогда, когда name свойство соответствует AirQuality. Примеры загрязнителей воздуха включают твердые частицы (PM2.5, PM10), озон (O3), диоксид азота (NO2), диоксид серы (SO2) и угарный газ (CO).

value

integer (int32)

Обеспечивает численное измерение концентрации загрязняющих веществ или пыльцы в воздухе. Это значение обычно выражается в единицах, соответствующих типу измеряемого загрязнителя или пыльцы, таких как микрограммы на кубический метр (мкг/м³) для твердых частиц или части на миллиард (ppb) для газов, таких как озон. И качество воздуха, и ультрафиолет являются индексами, поэтому они не имеют единиц измерения.

DailyForecast

Предоставляет подробную погодную информацию для конкретного дня, такую как температура, ветер, осадки, качество воздуха и индекс ультрафиолета.

Имя Тип Описание
airAndPollen

AirAndPollen[]

Список с загрязнителями, уровнем пыльцы и индексом УФ-излучения для ежедневного прогноза. Каждый пункт списка включает прогнозируемые количества и категории (например, низкий, высокий, хороший, умеренный, вредный, опасный) для оценки потенциальных рисков для здоровья.

date

string (date-time)

Дата и время текущего наблюдения отображаются в формате ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Например, 2025-04-29T07:00:00-07:00.

day

DailyForecastDetail

Предоставляет подробную погодную информацию для дневного прогноза, включая температуру, осадки, ветер и другие ключевые характеристики.

degreeDaySummary

DegreeDaySummary

Содержит сводку дней с температурой отопления и охлаждения. Дни отопления (HDD) измеряют потребность в энергии для отопления здания, рассчитываясь на основе средней температуры за день ниже 65°F/18°C. Дни охлаждения (CDD) измеряют потребность в энергии для охлаждения здания, рассчитывая на основе средней температуры за день выше 65°F/18°C. Это резюме помогает в управлении энергией и планировании.

hoursOfSun

number (float)

Обеспечивает ожидаемое количество солнечных часов в указанный день.

night

DailyForecastDetail

Предоставляет подробную погодную информацию для ночного прогноза, включая температуру, осадки, ветер и другие ключевые характеристики.

realFeelTemperature

WeatherValueRange

Предоставляет значения температуры RealFeel™ за указанный день, измеряемые в градусах Цельсия (C) или Фаренгейте (F), в зависимости от единицы, указанной в запросе. Этот показатель, разработанный AccuWeather, включает более десятка факторов, включая влажность, скорость ветра, облачность и интенсивность солнца, чтобы дать комплексную оценку того, как на самом деле ощущается погода.

realFeelTemperatureShade

WeatherValueRange

Предоставляет значения температуры RealFeel™ для указанного дня в затенённых местах. Этот показатель, разработанный AccuWeather, включает более десятка факторов, включая влажность, скорость ветра, облачность и интенсивность солнца, чтобы дать комплексную оценку того, как на самом деле ощущается погода в тени.

sources

string[]

Список источников, вносящих вклад в прогноз погоды.

temperature

WeatherValueRange

Предоставляет прогнозируемые максимальные и низкие температуры за день в градусах Цельсия (C) или Фаренгейте (F), в зависимости от указанных в запросе unit .

DailyForecastDetail

Подробный прогноз погоды на часть дня.

Имя Тип Описание
cloudCover

integer (int32)

Процент, указывающий на степень облачности.

hasPrecipitation

boolean

Булево значение, указывающее, ожидаются ли осадки (дождь, снег, мокрый снег или град) в указанный период. Возвращает истину, если ожидается осадки, в противном случае — ложно.

hoursOfIce

number (float)

Часы льда.

hoursOfPrecipitation

number (float)

Количество часов осадков

hoursOfRain

number (float)

Часы дождя.

hoursOfSnow

number (float)

Часы снега.

ice

WeatherValue

Ice

iceProbability

integer (int32)

Процент, представляющий вероятность гололеда. Например, '30'.

iconCode

IconCode

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

iconPhrase

string

Фразовое описание иконки. Отображается на указанном языке. Например, 'Sunny'.

localSource

LocalSource

Информация о местных поставщиках данных о погоде.

longPhrase

string

Фразовое описание прогноза на указанном языке. Azure Maps старается ограничить длину этой фразы менее 100 символов, но некоторые языки или погодные явления могут привести к увеличению длины фразы — более 100 символов.

precipitationIntensity

string

Описание интенсивности.

precipitationProbability

integer (int32)

Проценты, представляющие вероятность выпадения осадков. Например, '20'.

precipitationType

PrecipitationType

Указывает тип осадков. Допустимые значения: Дождь, Снег, Лед или Смесь. Это свойство включается в отклик, когда dBZ больше нуля.

rain

WeatherValue

Rain

rainProbability

integer (int32)

Процент, представляющий вероятность дождя. Например, '40'.

shortPhrase

string

Фразовое описание прогноза на указанном языке. Azure Maps старается ограничить длину этой фразы менее 30 символов, но некоторые языки или погодные явления могут привести к увеличению длины фразы — более 30 символов.

snow

WeatherValue

Snow

snowProbability

integer (int32)

Процент, представляющий вероятность выпадения снега. Например, '30'.

thunderstormProbability

integer (int32)

Процент, представляющий вероятность грозы. Например, '80'.

totalLiquid

WeatherValue

Общий жидкий эквивалент осадков в течение прогнозируемого периода.

wind

WindDetails

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

windGust

WindDetails

Порыв ветра. Порыв ветра – это внезапное, кратковременное увеличение скорости ветра.

DailyForecastResult

Ежедневный прогноз погоды.

Имя Тип Описание
forecasts

DailyForecast[]

Прогнозные данные на каждый запрашиваемый день.

summary

DailyForecastSummary

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

DailyForecastSummary

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

Имя Тип Описание
category

string

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

endDate

string (date-time)

Дата и время завершения сводки прогноза в формате ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Например, 2025-04-29T07:00:00-07:00.

phrase

string

Предоставляет краткое текстовое резюме ежедневных погодных условий, отображаемое на указанном языке.

severity

integer (int32)

Показывает суровость прогнозируемой погоды как целое число. Меньшие числа обозначают более высокую степень тяжести: 0 = Неизвестно, 1 = Значимое, 2 = Большое, 3 = Умеренное, 4 = Незначительное, 5 = Минимальное, 6 = Незначительное, 7 = Информационное.

startDate

string (date-time)

Дата и время начала сводки прогноза в формате ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Например, 2025-04-29T07:00:00-07:00.

DegreeDaySummary

Краткое описание дней отопления и охлаждения.

Имя Тип Описание
cooling

WeatherValue

Количество градусов, на которое средняя температура превышает 65 градусов по Фаренгейту / 18 градусов по Цельсию.

heating

WeatherValue

Количество градусов, на которое средняя температура опускается ниже 65 градусов по Фаренгейту / 18 градусов по Цельсию.

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

LocalSource

Информация о местных поставщиках данных о погоде.

Имя Тип Описание
id

integer (int32)

Числовой идентификатор, уникальный для локального поставщика данных.

name

string

Название локального поставщика данных. Название отображается на языке, указанном в коде языка в URL, если таковой имеется. В противном случае поле «Имя» отображается на английском языке или на языке, на котором оно было указано.

weatherCode

string

Код погоды, предоставленный местным поставщиком данных. Этот погодный код позволяет сопоставлять прогноз с иконками, предоставленными локальным поставщиком данных, вместо иконок Azure Maps.

PrecipitationType

Указывает тип осадков. Допустимые значения: Дождь, Снег, Лед или Смесь. Это свойство включается в отклик, когда dBZ больше нуля.

Значение Описание
Ice

Ice

Mix

Mix

Rain

Rain

Snow

Snow

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)

Округленное значение.

WeatherValueRange

Возвращаемые значения температуры.

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

WeatherValue

Максимальная температура за период времени

minimum

WeatherValue

Минимальная температура за временной промежуток.

WindDetails

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

Имя Тип Описание
direction

WindDirection

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

speed

WeatherValue

Скорость ветра в указанной единице.

WindDirection

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

Имя Тип Описание
degrees

integer (int32)

Направление ветра в градусах по азимуту, начиная с истинного севера и продолжая по часовой стрелке. Север составляет 0 градусов, восток составляет 90 градусов, юг составляет 180 градусов, запад — 270 градусов. Возможные значения 0-359.

localizedDescription

string

Аббревиатура направления на указанном языке.