Weather - Get Daily Forecast

  • Reference
Service:
Maps
API Version:
1.1

Umožňuje získat denní podrobnou předpověď počasí na příštích 1, 5, 10, 15, 25 nebo 45 dní.

Rozhraní Get Daily Forecast API je požadavek HTTP GET , který vrací podrobnou předpověď počasí, jako je teplota a vítr po dnech pro následující 1, 5, 10, 15, 25 nebo 45 dnů pro danou souřadnici. Odpověď obsahuje podrobnosti, jako je teplota, vítr, srážky, kvalita ovzduší a index UV záření. Další informace najdete v tématu Žádost o data denní předpovědi počasí.

Pokud používáte cenovou úroveň Gen1 S0, můžete požádat o denní předpověď na příštích 1, 5, 10 a 15 dnů. Pokud používáte cenovou úroveň Gen1 S1 nebo Gen2, můžete také požádat o denní předpověď na příštích 25 dnů a 45 dnů.

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}
With optional parameters: 
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
format
 path True

JsonFormat

Požadovaný formát odpovědi Podporuje se pouze json formát.
api-version
 query True

string

Číslo verze rozhraní API Azure Maps.
query
 query True

number[]

Příslušný dotaz zadaný jako řetězec oddělený čárkou složený podle zeměpisné šířky následované délkou, například 47.641268,-122.125679.
duration
 query

integer

Určuje, kolik dní se budou vracet odpovědi na denní prognózu. Dostupné hodnoty jsou:

  • 1 – Vrátí data prognózy pro další den. Ve výchozím nastavení se vrátí.
  • 5 – Vrátí data prognózy pro příštích 5 dnů.
  • 10 – Vrátí data prognózy pro následujících 10 dnů.
  • 25 – Vrátí data prognózy pro následujících 25 dnů. K dispozici pouze pro skladovou položku S1.
  • 45 – Vrátí data prognózy pro následujících 45 dnů. K dispozici pouze pro skladovou položku S1.
language
 query

string

Jazyk, ve kterém se mají vrátit výsledky hledání. Měl by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole k dispozici, použije se výchozí jazyk.

Podrobnosti najdete v části Podporované jazyky .
unit
 query

WeatherDataUnit

Určuje, že se mají vracet data v metrických nebo imperiálních jednotkách. Výchozí hodnota je metrika.

Hlavička požadavku

Name Vyžadováno Typ Description
x-ms-client-id

string

Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Microsoft Entra ID zabezpečení v Azure Maps pokyny najdete v následujících článcích.

Odpovědi

Name Typ Description
200 OK

DailyForecastResult

OK
Other Status Codes

ErrorResponse

Došlo k neočekávané chybě.

Zabezpečení

AADToken

Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.

Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.

Poznámky

  • Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.

Je Authorization URL specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID. * Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API. * Použití sady AZURE MAPS Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Jedná se o sdílený klíč, který se zřídí při Create účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto klíčem může každá aplikace přistupovat ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve kterému je vystavený.

U veřejně vystavených aplikací doporučujeme pro přístup k Azure Maps rozhraní REST API použít přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.

Type: apiKey
In: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v Azure Maps prostředku prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečeným způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.

Type: apiKey
In: header

Příklady

Successfully retrieve detailed daily weather forecast for a given coordinate location

Sample Request

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"
      ]
    }
  ]
}

Definice

Name Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary

Souhrn hlavních podmínek požadovaného časového období Všimněte si, že souhrn může pokrývat jenom část časového období.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Odpověď na chybu
IconCode

Číselná hodnota představující obrázek, který zobrazuje iconPhrase. Podrobnosti najdete v Azure Maps ve službách Počasí.
JsonFormat

Požadovaný formát odpovědi. Podporuje se pouze json formát.
LocalSource

Informace o místním poskytovateli dat o počasí.
PrecipitationType

Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud dbz je nula, precipitationType není v odpovědi přítomen.
UnitType

Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v Azure Maps ve službách Počasí.
WeatherDataUnit

Určuje, že se mají vracet data buď v jednotkách metrik, nebo v jednotkách impéria. Výchozí hodnota je metrika.
WeatherUnit

Konkrétní hodnota dané jednotky související s počasím.
WeatherUnitRange

Vrátily se hodnoty teploty.
WindDetails

Vrací se podrobnosti o větru, včetně rychlosti a směru.
WindDirection

Směr větru

AirAndPollen

Name Typ Description
category

string

Kategorie kvality ovzduší nebo typu znečištění. Například nízká, vysoká, dobrá, střední, nezdravá, nebezpečná.
categoryValue

integer

Hodnota spojená s kvalitou ovzduší nebo kategorií znečištění. Tyto hodnoty jsou v rozsahu od 1 do 6. 1, které znamenají dobré podmínky, 6 znamenající nebezpečné podmínky.
name

string

Název pylu nebo znečišťujících látek. Například tráva, plíseň, tráva, kvalita vzduchu, strom a UV index.
type

string

Existuje pouze pro kvalitu ovzduší. Mezi příklady patří znečištění ozónem a částicemi.
value

integer

Hodnota daného typu výše. Hodnoty spojené s plísněmi, trávou, trávou, trávou a stromem jsou v jednotkách částí na metr krychlový. Jak kvalita ovzduší, tak UV záření jsou indexy, takže jsou bez jednotek.

DailyForecast

Name Typ Description
airAndPollen

AirAndPollen[]

Kvalita ovzduší
date

string

Datum a čas aktuálního pozorování zobrazeného ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00.
day

DayOrNight

Detail denní předpovědi
degreeDaySummary

DegreeDaySummary

Souhrn informací o průměrné teplotě topného stupně dne nebo dne chlazení
hoursOfSun

number

Hodiny slunce.
night

DayOrNight

Detail noční předpovědi
realFeelTemperature

WeatherUnitRange

Vrátí se hodnota RealFeel™ Temperature.
realFeelTemperatureShade

WeatherUnitRange

Vrátí se hodnota RealFeel™ Temperature. Popisuje, jaká je teplota ve stínu.
sources

string[]

Zdroje dat prognózy.
temperature

WeatherUnitRange

Hodnoty teploty pro den.

DailyForecastResult

Name Typ Description
forecasts

DailyForecast[]

Prognóza dat pro každý požadovaný den.
summary

DailyForecastSummary

Souhrn hlavních podmínek požadovaného časového období Všimněte si, že souhrn může pokrývat jenom část časového období.

DailyForecastSummary

Souhrn hlavních podmínek požadovaného časového období Všimněte si, že souhrn může pokrývat jenom část časového období.

Name Typ Description
category

string

jedno nebo 2 slova, která shrnují frázi.
endDate

string

Datum a čas konce souhrnného období, zobrazené ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00.
phrase

string

Souhrnná fráze denní prognózy. Zobrazí se v zadaném jazyce.
severity

integer

severity
startDate

string

Datum a čas, kdy je souhrn platný, se zobrazí ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00.

DayOrNight

Name Typ Description
cloudCover

integer

Procento představující cloudový kryt.
hasPrecipitation

boolean

Označuje přítomnost nebo nepřítomnost srážek. True označuje přítomnost srážek, false označuje absenci srážek.
hoursOfIce

number

Hodiny ledu.
hoursOfPrecipitation

number

Hodiny srážek
hoursOfRain

number

Hodiny deště.
hoursOfSnow

number

Hodiny sněhu.
ice

WeatherUnit

Ice
iceProbability

integer

Procento představující pravděpodobnost ledu. Například 30.
iconCode

IconCode

Číselná hodnota představující obrázek, který zobrazuje iconPhrase. Podrobnosti najdete v tématu Služby počasí v Azure Maps.
iconPhrase

string

Frázi popis ikony. Zobrazí se v zadaném jazyce. Například Sunny.
localSource

LocalSource

Informace o místním poskytovateli dat o počasí.
longPhrase

string

Frázový popis prognózy v zadaném jazyce. Azure Maps se pokusí ponechat tuto frázi kratší než 100 znaků, ale některé jazyky nebo události počasí mohou vést k delší délce fráze, která přesahuje 100 znaků.
precipitationIntensity

string

Popis intenzity.
precipitationProbability

integer

Procento představující pravděpodobnost srážek. Například 20.
precipitationType

PrecipitationType

Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud je dbz nula, není v odpovědi přítomen typ precipitationType.
rain

WeatherUnit

Déšť
rainProbability

integer

Procento představující pravděpodobnost deště. Například 40.
shortPhrase

string

Frázový popis prognózy v zadaném jazyce. Azure Maps se pokusí zachovat tuto frázi kratší než 30 znaků, ale některé jazyky nebo události počasí můžou mít za následek delší frázi, která přesahuje 30 znaků.
snow

WeatherUnit

Sníh
snowProbability

integer

Procento představující pravděpodobnost sněhu. Například 30.
thunderstormProbability

integer

Procento představující pravděpodobnost bouřky. Například 80.
totalLiquid

WeatherUnit

Celkový liquidní ekvivalent srážek během předpovídajícího období.
wind

WindDetails

Vrací se podrobnosti o větru, včetně rychlosti a směru.
windGust

WindDetails

Poryv větru. Poryv větru je náhlé, krátké zvýšení rychlosti větru.

DegreeDaySummary

Name Typ Description
cooling

WeatherUnit

Počet stupňů, o které je střední teplota vyšší než 65 stupňů F/ 18 stupňů C.
heating

WeatherUnit

Počet stupňů, o které je střední teplota nižší než 65 stupňů F/ 18 stupňů C.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě
code

string

Kód chyby
details

ErrorDetail[]

Podrobnosti o chybě
message

string

Chybová zpráva
target

string

Cíl chyby.

ErrorResponse

Odpověď na chybu

Name Typ Description
error

ErrorDetail

Objekt chyby.

IconCode

Číselná hodnota představující obrázek, který zobrazuje iconPhrase. Podrobnosti najdete v Azure Maps ve službách Počasí.

Name Typ Description
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

Požadovaný formát odpovědi. Podporuje se pouze json formát.

Name Typ Description
json

string

Formát výměny dat v zápisu objektů JavaScriptu

LocalSource

Informace o místním poskytovateli dat o počasí.

Name Typ Description
id

integer

Číselný identifikátor jedinečný pro místního zprostředkovatele dat.
name

string

Název místního zprostředkovatele dat. Název se zobrazí v jazyce určeném kódem jazyka v adrese URL, pokud je k dispozici. V opačném případě se název zobrazí v angličtině nebo v jazyce, ve kterém byl název zadaný.
weatherCode

string

Kód počasí poskytnutý místním poskytovatelem dat. Tento kód počasí umožňuje, aby předpověď odpovídala ikonám poskytovaným místním poskytovatelem dat místo Azure Maps ikon.

PrecipitationType

Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud dbz je nula, precipitationType není v odpovědi přítomen.

Name Typ Description
Ice

string

Ice
Mix

string

Kombinace
Rain

string

Déšť
Snow

string

Sníh

UnitType

Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v Azure Maps ve službách Počasí.

Name Typ Description
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

Určuje, že se mají vracet data buď v jednotkách metrik, nebo v jednotkách impéria. Výchozí hodnota je metrika.

Name Typ Description
imperial

string

Vrátí data v imperiálních jednotkách. Mezi příklady jednotek císařského systému patří Fahrenheita a míle.
metric

string

Vrátí data v jednotkách metrik. Mezi příklady jednotek metrické soustavy patří Celsia a kilometr.

WeatherUnit

Konkrétní hodnota dané jednotky související s počasím.

Name Typ Description
unit

string

Typ jednotky pro vrácenou hodnotu.
unitType

UnitType

Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v Azure Maps ve službách Počasí.
value

number

Zaokrouhlená hodnota.

WeatherUnitRange

Vrátily se hodnoty teploty.

Name Typ Description
maximum

WeatherUnit

Maximální teplota pro časové období
minimum

WeatherUnit

Minimální teplota pro časové období.

WindDetails

Vrací se podrobnosti o větru, včetně rychlosti a směru.

Name Typ Description
direction

WindDirection

Směr větru
speed

WeatherUnit

Rychlost větru v zadané jednotce.

WindDirection

Směr větru

Name Typ Description
degrees

integer

Směr větru ve stupních Azimuth, začíná na severu a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ 90 stupňů, jih 180 stupňů, západ 270 stupňů. Možné hodnoty 0–359.
localizedDescription

string

Zkratka směru v zadaném jazyce