Weather - Get Minute Forecast

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

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}

Opcionális paraméterekkel:

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.

A Microsoft identitásplatformról további információt a Microsoft identitásplatform áttekintése című témakörben talál.

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

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

Sample request

HTTP

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

Sample response

Status code:: 200

{
  "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ő `iconPhrase`numerikus é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ő `iconPhrase`numerikus é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ő `iconPhrase`numerikus é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ő `iconPhrase`numerikus é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	Hó

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