Weather - Get Quarter Day Forecast

Ссылка

Служба:: Maps

Версия API:: 1.1

Используйте для получения Quarter-Day прогноза на ближайшие 1, 5, 10 или 15 дней.

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

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

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

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}&unit={unit}&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 морских миль от береговой линии.
duration	query		integer	Указывает, на сколько дней будут возвращены ответы прогноза на день запроса. Поддерживаются значения: `1` - Возврат данных прогноза на следующий день. Возвращается по умолчанию. `5` - Возврат данных прогноза на ближайшие 5 дней. `10` - Возврат данных прогноза на ближайшие 10 дней. `15` - Возврат данных прогноза на ближайшие 15 дней.
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	QuarterDayForecastResult	ХОРОШО
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 weather forecast by a given location

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

HTTP

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

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

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

{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Определения

Имя	Описание
DayQuarter	Четверть дня.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
IconCode	Числовое значение, представляющее изображение, отображающее .`iconPhrase` Дополнительные сведения см. в статье Службы погоды в Azure Maps .
JsonFormat	Требуемый формат ответа. Поддерживается только `json` формат.
PrecipitationType	Указывает тип осадков («Дождь», «Снег», «Лед» или «Смесь»). Если dbz равен нулю, precipitationType отсутствует в ответе.
QuarterDayForecast
QuarterDayForecastResult
UnitType	Числовое значение ID, связанное с типом отображаемой единицы измерения. Может использоваться для перевода единиц измерения. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
WeatherDataUnit	Указывает, что данные возвращаются в метрических или британских единицах. Значение по умолчанию — metric.
WeatherUnit	Удельное значение данной единицы, связанное с погодой.
WeatherUnitRange	Возвращаемые значения температуры.
WindDetails	Возвращаются данные о ветре, включая скорость и направление.
WindDirection	Направление ветра

DayQuarter

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

Четверть дня.

Значение	Описание
0	7:00 утра - 13:00 вечера / 7:00 - 13:00
1	13:00 - 19:00/ 13:00 - 19:00
2	19:00 - 1:00/ 19:00 - 01:00
3	1:00 - 7:00 / 01:00 - 07:00

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

PrecipitationType

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

Указывает тип осадков («Дождь», «Снег», «Лед» или «Смесь»). Если dbz равен нулю, precipitationType отсутствует в ответе.

Значение	Описание
Ice	Лёд
Mix	Смешивать
Rain	дождь.
Snow	Снег

QuarterDayForecast

Object

Имя	Тип	Описание
cloudCover	integer (int32)	Процент представляет облачность.
date	string (date-time)	Дата составления прогноза в качестве примера, 2019-10-27T00:00:00
dewPoint	WeatherUnit	Температура точки росы в указанных единицах. Температура точки росы — это температура, до которой воздух должен быть охлажден для достижения насыщения.
effectiveDate	string (date-time)	Дата и время начала прогнозируемого квартала отображаются в формате ISO 8601, например, 2019-10-27T19:39:57-08:00.
hasPrecipitation	boolean	Указывает на наличие или отсутствие осадков. True указывает на наличие осадков, false – на отсутствие осадков.
ice	WeatherUnit	Лёд
iconCode	IconCode (int32)	Числовое значение, представляющее изображение, отображающее .`iconPhrase` Дополнительные сведения см. в статье Службы погоды в Azure Maps .
iconPhrase	string	Фразовое описание иконки. Отображается на указанном языке. Например, 'Sunny'.
phrase	string	Краткое резюме фразы резюме за квартал.
precipitationIntensity	string	Описание интенсивности.
precipitationProbability	integer (int32)	Проценты, представляющие вероятность выпадения осадков. Например, '20'.
precipitationType	PrecipitationType	Указывает тип осадков («Дождь», «Снег», «Лед» или «Смесь»). Если dbz равен нулю, precipitationType отсутствует в ответе.
quarter	DayQuarter (int32)	Четверть дня.
rain	WeatherUnit	дождь.
realFeelTemperature	WeatherUnitRange	Значения температуры RealFeel™ за квартал.
relativeHumidity	integer (int32)	Относительная влажность — это количество водяного пара, присутствующего в воздухе, выраженное в процентах от количества, необходимого для насыщения при той же температуре.
snow	WeatherUnit	Снег
temperature	WeatherUnitRange	Значения температуры за квартал.
thunderstormProbability	integer (int32)	Процент, представляющий вероятность грозы. Например, '10'.
totalLiquid	WeatherUnit	Общий жидкий эквивалент осадков в течение прогнозируемого периода.
visibility	WeatherUnit	Видимость в указанном блоке. Мера расстояния, на котором объект или свет могут быть четко различимы.
wind	WindDetails	Возвращаются данные о ветре, включая скорость и направление.
windGust	WindDetails	Порыв ветра. Порыв ветра – это внезапное, кратковременное увеличение скорости ветра.

QuarterDayForecastResult

Object

Имя	Тип	Описание
forecasts	QuarterDayForecast[]	Прогнозируйте данные за каждый квартал в ответе.

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)	Округленное значение.

WeatherUnitRange

Object

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

Имя	Тип	Описание
maximum	WeatherUnit	Максимальная температура за период времени
minimum	WeatherUnit	Минимальная температура за временной промежуток.

WindDetails

Object

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

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

WindDirection

Object

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

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

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

Weather - Get Quarter Day Forecast

Параметры URI

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

Ответы

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

AADToken

Примечания.

Области

subscription-key

SAS Token

Примеры

Successfully retrieve detailed weather forecast by a given location

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

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

Определения

DayQuarter

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PrecipitationType

QuarterDayForecast

QuarterDayForecastResult

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection