Megosztás a következőn keresztül:


Weather - Get Minute Forecast

A használatával percenkénti előrejelzést kaphat a következő 120 percre 1, 5 és 15 perces időközönként.

Az Get Minute Forecast API egy HTTP-kérés GET , amely percenkénti előrejelzéseket ad vissza egy adott helyhez a következő 120 percre vonatkozóan. A felhasználók 1, 5 és 15 perces időközönként kérhetnek időjárás-előrejelzést. A válasz olyan részleteket tartalmaz, mint a csapadék típusa (beleértve az esőt, a havat vagy mindkettő keverékét), a kezdési időpontot és a csapadékintenzitás értékét (dBZ). További információ: Percenkénti időjárás-előrejelzési adatok kérése.

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

URI-paraméterek

Name In Kötelező Típus Description
format
path True

JsonFormat

A válasz kívánt formátuma. Csak json a formátum támogatott.

api-version
query True

string

Az Azure Maps API verziószáma.

query
query True

number[]

A megfelelő lekérdezés, amelyet vesszővel tagolt sztringként határoz meg, amelyet szélesség és hosszúság követ, például:"47.641268,-122.125679".

interval
query

integer

Az időintervallumot adja meg percekben a visszaadott időjárás-előrejelzéshez. A támogatott értékek a következők:

  • 1 – 1 perces időközök előrejelzésének lekérése. Alapértelmezés szerint visszaadva.
  • 5 – 5 perces időközökre vonatkozó előrejelzések lekérése.
  • 15 – 15 perces időközökre vonatkozó előrejelzések lekérése.
language
query

string

Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvcímkék egyikének kell lennie, a kis- és nagybetűk nem különböztethetők meg. Ha a megadott nyelvű adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja.

Részletekért tekintse meg a támogatott nyelveket ismertető cikket.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. Az Azure Maps-fiók egyedi azonosítóját jelöli, és lekérhető az Azure Maps felügyeleti síkjának Fiók API-jából. A Microsoft Entra ID-biztonság Azure Mapsben való használatához tekintse meg az alábbi cikkeket .

Válaszok

Name Típus Description
200 OK

MinuteForecastResult

OK

Other Status Codes

ErrorResponse

Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel, vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

  • Ez a biztonsági definíció megköveteli a fejléc használatát x-ms-client-id annak jelzéséhez, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.

Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy a PowerShell, a CLI, az Azure SDK-k vagy a REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével érje el az Azure Maps REST API-kat, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázási műveletéből jön létre az Azure Felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy konfigurálja az engedélyezett források adott listáját a Térképfiók erőforráson a megjelenítési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

Successfully retrieve minute-by-minute forecasts for a given location

Mintakérelem

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Mintaválasz

{
  "summary": {
    "briefPhrase60": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min",
    "briefPhrase": "Rain ending in 25 min",
    "longPhrase": "Rain ending in 25 min",
    "iconCode": 12
  },
  "intervalSummaries": [
    {
      "startMinute": 0,
      "endMinute": 24,
      "totalMinutes": 25,
      "shortPhrase": "Rain ending in %minute_value min",
      "briefPhrase": "Rain ending in %minute_value min",
      "longPhrase": "Rain ending in %minute_value min",
      "iconCode": 12
    },
    {
      "startMinute": 25,
      "endMinute": 119,
      "totalMinutes": 95,
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "iconCode": 7
    }
  ],
  "intervals": [
    {
      "startTime": "2019-11-14T15:18:00-08:00",
      "minute": 0,
      "dbz": 23,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 8,
        "green": 98,
        "blue": 2,
        "hex": "#086202"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:33:00-08:00",
      "minute": 15,
      "dbz": 18,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 32,
        "green": 133,
        "blue": 9,
        "hex": "#208509"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:48:00-08:00",
      "minute": 30,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:03:00-08:00",
      "minute": 45,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:18:00-08:00",
      "minute": 60,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:33:00-08:00",
      "minute": 75,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:48:00-08:00",
      "minute": 90,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T17:03:00-08:00",
      "minute": 105,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    }
  ]
}

Definíciók

Name Description
ColorValue
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ForecastInterval
IconCode

A képet megjelenítő iconPhrasenumerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

IntervalSummary
JsonFormat

A válasz kívánt formátuma. Csak json a formátum támogatott.

MinuteForecastResult
MinuteForecastSummary

Kifejezésösszegzők a teljes előrejelzési időszakra vonatkozóan.

PrecipitationType

Meghatározza a csapadék típusát ("Rain" "Snow" "Ice" vagy "Mix"). Ha a dbz értéke nulla, a csapadéktípus nem jelenik meg a válaszban.

ColorValue

Name Típus Description
blue

integer

Az RGB-érték kék összetevője

green

integer

Az RGB érték zöld összetevője.

hex

string

Hexadecimális színérték.

red

integer

Az RGB érték piros összetevője.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ForecastInterval

Name Típus Description
cloudCover

integer

Felhőfedés százalékos aránya.

color

ColorValue

A teljes spektrumú szín, amely leképezi a dBZ-t (decibel a Z-hez képest). Ha a dbz értéke nulla, a szín nem jelenik meg a válaszban.

dbz

number

Az előrejelzett csapadékintenzitást képviselő egység.

iconCode

IconCode

A képet megjelenítő iconPhrasenumerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

minute

integer

Az intervallum első perce.

precipitationType

PrecipitationType

Meghatározza a csapadék típusát ("Rain" "Snow" "Ice" vagy "Mix"). Ha a dbz értéke nulla, a csapadéktípus nem jelenik meg a válaszban.

shortPhrase

string

Egy rövid kifejezés, amely az intervallum csapadékfeltételét ismerteti.

simplifiedColor

ColorValue

A sáv színe, amely megfelel a csapadék típusának és küszöbértékének. Ha a dbz értéke nulla, akkor nincs jelen a válaszban.

startTime

string

Az intervallum kezdetének dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00.

threshold

string

A küszöbértéket meghatározó kulcs. A csapadéktípus mellett az egyszerűsítettColor meghatározására is használható. Ha a dbz értéke nulla, akkor nincs jelen a válaszban.

IconCode

A képet megjelenítő iconPhrasenumerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

Name Típus 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

IntervalSummary

Name Típus Description
briefPhrase

string

Rövid összefoglaló kifejezés. A kifejezés hossza körülbelül 60 karakter.

endMinute

integer

Az utolsó perc, amelyre az összegzés vonatkozik.

iconCode

IconCode

A képet megjelenítő iconPhrasenumerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

longPhrase

string

Hosszú összefoglaló kifejezés. A kifejezés hossza 60 karakternél hosszabb.

shortPhrase

string

Rövid összefoglaló kifejezés. A kifejezés hossza körülbelül 25 karakter.

startMinute

integer

Az első perc, amelyre az összegzés vonatkozik.

totalMinutes

integer

Azon percek száma, amelyekre az összegzés vonatkozik.

JsonFormat

A válasz kívánt formátuma. Csak json a formátum támogatott.

Name Típus Description
json

string

A JavaScript-objektum jelölési adatcseréjének formátuma

MinuteForecastResult

Name Típus Description
intervalSummaries

IntervalSummary[]

Az előrejelzés egyes időközeinek összefoglaló információi. Az összegzések lebontják az egyes lehetséges intervallumokat, amikor a csapadék elindul és leáll.

intervals

ForecastInterval[]

Előrejelzési adatok az előrejelzés minden egyes intervallumára vonatkozóan.

summary

MinuteForecastSummary

Kifejezésösszegzők a teljes előrejelzési időszakra vonatkozóan.

MinuteForecastSummary

Kifejezésösszegzők a teljes előrejelzési időszakra vonatkozóan.

Name Típus Description
briefPhrase

string

Összefoglaló kifejezés a következő 120 percre. A kifejezés hossza körülbelül 60 karakter.

briefPhrase60

string

Összefoglaló kifejezés a következő 60 percre. A kifejezés hossza körülbelül 60 karakter.

iconCode

IconCode

A képet megjelenítő iconPhrasenumerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

longPhrase

string

Hosszú összefoglaló kifejezés a következő 120 percre. A kifejezés hossza 60 karakternél hosszabb.

shortPhrase

string

Rövid összefoglaló kifejezés a következő 120 percre. A kifejezés hossza körülbelül 25 karakter.

PrecipitationType

Meghatározza a csapadék típusát ("Rain" "Snow" "Ice" vagy "Mix"). Ha a dbz értéke nulla, a csapadéktípus nem jelenik meg a válaszban.

Name Típus Description
Ice

string

Ice

Mix

string

Vegyes

Rain

string

Eső

Snow

string