Weather - Get Daily Forecast

Ссылка

Служба:: Maps

Версия API:: 1.1

Используйте для получения ежедневного подробного прогноза погоды на следующие 1, 5, 10, 15, 25 или 45 дней.

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

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

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

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

GET https://atlas.microsoft.com/weather/forecast/daily/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,-122.125679".
duration	query		integer	Указывает, сколько дней возвращаются ежедневные ответы прогноза. Доступные значения: `1` — Возвращает данные прогноза на следующий день. Возвращается по умолчанию. `5` — возвращает данные прогноза на следующие 5 дней. `10` — Возвращает данные прогноза на следующие 10 дней. `25` — Возвращает данные прогноза на следующие 25 дней. Доступно только в SKU S1. `45` — Возвращает данные прогноза на следующие 45 дней. Доступно только в SKU S1.
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	DailyForecastResult	ОК
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
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя	Описание
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 daily weather forecast for a given coordinate location

Sample request

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Sample response

Status code:: 200

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

Определения

Имя	Описание
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary	Сводка по основным условиям запрашиваемого периода времени. Обратите внимание, что сводка может охватывать только часть периода времени.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
IconCode	Числовое значение, представляющее изображение, отображающее `iconPhrase`. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
JsonFormat	Требуемый формат ответа. Поддерживается только формат `json`.
LocalSource	Сведения о локальном поставщике данных о погоде.
PrecipitationType	Указывает тип осадков ("Дождь", "Снег", "Лед" или "Смесь"). Если dbz равно нулю, в ответе отсутствует тип осадков.
UnitType	Числовое значение идентификатора, связанное с типом отображаемой единицы измерения. Может использоваться для преобразования единиц. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
WeatherDataUnit	Указывает, как возвращать данные в единицах метрик или в единицах империи. Значение по умолчанию — метрика.
WeatherUnit	Конкретное значение заданной единицы измерения, связанное с погодой.
WeatherUnitRange	Возвращенные значения температуры.
WindDetails	Возвращаемые сведения о ветре, включая скорость и направление.
WindDirection	Направление ветра

AirAndPollen

Имя	Тип	Описание
category	string	Категория качества воздуха или типа загрязнения. Например, низкий, высокий, хороший, умеренный, нездоровый, опасный.
categoryValue	integer	Значение, связанное с категорией качества или загрязнения воздуха. Эти значения варьируются от 1 до 6. 1 означает хорошие условия, 6 подразумевают опасные условия.
name	string	Название пыльцы или загрязняющего вещества. Например, трава, плесень, росняки, качество воздуха, дерево и УФ-индекс.
type	string	Существует только для качества воздуха. Примеры включают загрязнение озоном и частицами.
value	integer	Значение указанного типа выше. Значения, связанные с плесенью, травой, растут и деревом, в единицах частей на кубический метр. Как качество воздуха, так и УФ являются индексами, поэтому они являются унитарными.

DailyForecast

Имя	Тип	Описание
airAndPollen	AirAndPollen[]	Качество воздуха
date	string	Дата и время текущего наблюдения, отображаемого в формате ISO 8601, например 2019-10-27T19:39:57-08:00.
day	DayOrNight	Сведения о прогнозе на день
degreeDaySummary	DegreeDaySummary	Сводка по средней температуре дня нагревания или дня градуса охлаждения
hoursOfSun	number	Солнечные часы.
night	DayOrNight	Сведения о ночном прогнозе
realFeelTemperature	WeatherUnitRange	Возвращается значение RealFeel™ Temperature.
realFeelTemperatureShade	WeatherUnitRange	Возвращается значение RealFeel™ Temperature. Описывает, что температура на самом деле чувствует, как в тени.
sources	string[]	Источники данных прогноза.
temperature	WeatherUnitRange	Значения температуры за день.

DailyForecastResult

Имя	Тип	Описание
forecasts	DailyForecast[]	Данные прогноза за каждый запрошенный день.
summary	DailyForecastSummary	Сводка по основным условиям запрашиваемого периода времени. Обратите внимание, что сводка может охватывать только часть периода времени.

DailyForecastSummary

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

Имя	Тип	Описание
category	string	одно или 2 слова для подведения итогов фразы.
endDate	string	Дата и время окончания сводного периода, отображаемые в формате ISO 8601, например 2019-10-27T19:39:57-08:00.
phrase	string	Сводная фраза ежедневного прогноза. Отображается на указанном языке.
severity	integer	severity
startDate	string	Дата и время действия сводки, отображаемые в формате ISO 8601, например 2019-10-27T19:39:57-08:00.

DayOrNight

Имя	Тип	Описание
cloudCover	integer	Процент, представляющий облачное покрытие.
hasPrecipitation	boolean	Указывает наличие или отсутствие осадков. Значение True указывает на наличие осадков, значение false — на отсутствие осадков.
hoursOfIce	number	Часы льда.
hoursOfPrecipitation	number	Часы осадков
hoursOfRain	number	Часы дождя.
hoursOfSnow	number	Часы снега.
ice	WeatherUnit	Айс (Ice)
iceProbability	integer	Процент, представляющий вероятность льда. Например, "30".
iconCode	IconCode	Числовое значение, представляющее изображение, отображающее `iconPhrase`. Дополнительные сведения см. в статье Службы погоды в Azure Maps .
iconPhrase	string	Описание фразы значка. Отображается на указанном языке. Например, "Солнечный".
localSource	LocalSource	Сведения о локальном поставщике данных о погоде.
longPhrase	string	Описание фразы для прогноза на указанном языке. Azure Maps пытается сохранить эту фразу длиной не более 100 символов, но некоторые языки и погодные события могут привести к большей длине фразы, превышающей 100 символов.
precipitationIntensity	string	Описание интенсивности.
precipitationProbability	integer	Процент, представляющий вероятность осадков. Например, "20".
precipitationType	PrecipitationType	Указывает тип осадков ("Дождь", "Снег", "Лед" или "Смесь"). Если dbz равно нулю, в ответе отсутствует тип осадков.
rain	WeatherUnit	Дождь
rainProbability	integer	Процент, представляющий вероятность дождя. Например, "40".
shortPhrase	string	Описание фразы для прогноза на указанном языке. Azure Maps пытается сохранить эту фразу длиной не более 30 символов, но некоторые языки и погодные события могут привести к большей длине фразы, превышающей 30 символов.
snow	WeatherUnit	Снег
snowProbability	integer	Процент, представляющий вероятность снега. Например, "30".
thunderstormProbability	integer	Процент, представляющий вероятность грозы. Например, "80".
totalLiquid	WeatherUnit	Общий жидкий эквивалент осадков за прогнозируемый период.
wind	WindDetails	Возвращаемые сведения о ветре, включая скорость и направление.
windGust	WindDetails	Порыв ветра. Порыв ветра — это внезапное, кратковременное увеличение скорости ветра.

DegreeDaySummary

Имя	Тип	Описание
cooling	WeatherUnit	Число градусов, в которых средняя температура выше 65 градусов по F/ 18 градусов по C.
heating	WeatherUnit	Число градусов, что средняя температура ниже 65 градусов по F/ 18 градусов по C.

ErrorAdditionalInfo

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

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

ErrorDetail

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

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

ErrorResponse

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

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

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

LocalSource

Сведения о локальном поставщике данных о погоде.

Имя	Тип	Описание
id	integer	Числовой идентификатор, уникальный для локального поставщика данных.
name	string	Имя локального поставщика данных. Имя отображается на языке, указанном кодом языка в URL-адресе, если оно доступно. В противном случае имя отображается на английском языке или языке, на котором было указано имя.
weatherCode	string	Код погоды, предоставленный локальным поставщиком данных. Этот код погоды позволяет сопоставлять прогноз со значками, предоставляемыми локальным поставщиком данных, а не значками Azure Maps.

PrecipitationType

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

Имя	Тип	Описание
Ice	string	Айс (Ice)
Mix	string	Набор
Rain	string	Дождь
Snow	string	Снег

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

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

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

WeatherUnit

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

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

WeatherUnitRange

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

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

WindDetails

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

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

WindDirection

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

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

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