Sdílet prostřednictvím

Weather - Get Daily Forecast

  • Reference
Služba:
Maps
Verze rozhraní API:
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}
S volitelnými parametry: 
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 služby 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 Služby Azure Maps. Informace o použití zabezpečení Microsoft Entra ID v Azure Maps 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 toky Microsoft Entra 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 rozhraním Azure Maps REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika účtům prostředků nebo dílčím prostředkům Azure Maps. 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 několika oprávnění k rozhraním REST API služby Azure Maps.

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í prostředku Azure Maps, 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 webu 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í.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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 vytváření účtu Azure Maps na webu 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 rozhraním Rest API služby Azure Maps použít přístup k důvěrným klientským aplikacím , aby se váš klíč mohl bezpečně uložit.

Typ: apiKey
V: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS prostředku Azure Maps prostřednictvím roviny správy 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.

Typ: apiKey
V: header

Příklady

Successfully retrieve detailed daily weather forecast for a given coordinate location

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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 pro požadované časové 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

Chybová odpověď
IconCode

Číselná hodnota představující obrázek, který zobrazuje iconPhrase. Podrobnosti najdete v tématu Služby Počasí v Azure Maps .
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 tématu Služby Počasí v Azure Maps .
WeatherDataUnit

Určuje, že se mají vracet data v metrických nebo imperiálních jednotkách. 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 s dobrými podmínkami, 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 ovzduší, strom a UV index.
type

string

Existuje pouze pro kvalitu ovzduší. Mezi příklady patří ozon a znečištění částic.
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 dílů na metr krychlový. Kvalita ovzduší i 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

Podrobnosti prognózy dne
degreeDaySummary

DegreeDaySummary

Souhrn informací o průměrné teplotě stupně vytápění nebo dne ochlazování
hoursOfSun

number

Hodiny slunce.
night

DayOrNight

Podrobnosti o noční předpovědi
realFeelTemperature

WeatherUnitRange

Vrácená hodnota RealFeel™ Temperature.
realFeelTemperatureShade

WeatherUnitRange

Vrácená hodnota RealFeel™ Temperature. Popisuje, jaká je skutečně teplota ve stínu.
sources

string[]

Zdroje dat prognózy.
temperature

WeatherUnitRange

Hodnoty teploty pro den.

DailyForecastResult

Name Typ Description
forecasts

DailyForecast[]

Data prognózy pro každý požadovaný den.
summary

DailyForecastSummary

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

DailyForecastSummary

Souhrn hlavních podmínek pro požadované časové 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 pro shrnutí fráze.
endDate

string

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

string

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

integer

severity
startDate

string

Datum a čas, kdy je souhrn v platnosti, zobrazené 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é pokrytí.
hasPrecipitation

boolean

Označuje přítomnost nebo nepřítomnost srážek. True označuje přítomnost srážek, false označuje nepřítomnost 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

Popis fráze ikony. Zobrazuje se v zadaném jazyce. Například Slunečná.
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 pokouší zachovat délku této fráze kratší než 100 znaků, ale některé jazyky nebo události počasí můžou mít za následek delší délku fráze, než je 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 dbz je nula, precipitationType není v odpovědi přítomen.
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 pokouší zachovat délku této fráze kratší než 30 znaků, ale v některých jazycích nebo povětrnostních událostech může být fráze delší a může překročit 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ý tekutý ekvivalent srážek během předpověděného období.
wind

WindDetails

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

WindDetails

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

DegreeDaySummary

Name Typ Description
cooling

WeatherUnit

Počet stupňů, kdy je průměrná teplota vyšší než 65 stupňů F/18 °C.
heating

WeatherUnit

Počet stupňů, kdy je průměrná teplota nižší než 65 stupňů F/18 °C.

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.
type

string

Typ další informace.

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

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

IconCode

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

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 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 ikon Azure Maps.

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 tématu Služby Počasí v Azure Maps .

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 v metrických nebo imperiálních jednotkách. 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 metrických jednotkách. Mezi ukázkové jednotky metrického systému patří stupně Celsia a kilometry.

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 tématu Služby Počasí v Azure Maps .
value

number

Zaokrouhlená hodnota.

WeatherUnitRange

Vrátily se hodnoty teploty.

Name Typ Description
maximum

WeatherUnit

Maximální teplota v časovém období
minimum

WeatherUnit

Minimální teplota pro dané č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