Weather - Get Quarter Day Forecast

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

A használatával Quarter-Day előrejelzést kaphat a következő 1, 5, 10 vagy 15 napra vonatkozóan.

Az Get Quarter-Day Forecast API egy HTTP-kérés GET , amely egy adott hely következő 1, 5, 10 vagy 15 napjára vonatkozó részletes időjárás-előrejelzést ad vissza negyedévente. A válaszadatokat a nap negyedévei – reggel, délután, este és éjszaka – jelenítik meg. A rendszer olyan részleteket ad vissza, mint a hőmérséklet, a páratartalom, a szél, a csapadék és az UV-index.

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

Opcionális paraméterekkel:

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&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".
duration	query		integer	Azt adja meg, hogy a rendszer hány napig adja vissza a quester-day előrejelzési válaszokat. A támogatott értékek a következők: `1` – Előrejelzési adatok visszaadása a következő napra. Alapértelmezés szerint visszaadva. `5` – A következő 5 napra vonatkozó előrejelzési adatok visszaadása. `10` – Előrejelzési adatokat ad vissza a következő 10 napra vonatkozóan. `15` – Az előrejelzési adatok visszaadása a következő 15 napra vonatkozóan.
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.
unit	query		WeatherDataUnit	Megadja, hogy az adatokat metrikaegységekben vagy angolszász egységekben adja vissza. Az alapértelmezett érték a metrika.

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	QuarterDayForecastResult	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-beli 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 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.

További információ a Microsoft identitásplatformról: A Microsoft identitásplatformjának áttekintése.

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 PowerShell, CLI, Azure SDK-k vagy 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ét használja az Azure Maps REST API-k eléréséhez, 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ása 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 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 jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

Successfully retrieve detailed weather forecast by a given location

Mintakérelem

HTTP

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

Mintaválasz

Állapotkód:: 200

{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definíciók

Name	Description
DayQuarter	A nap negyede.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
IconCode	A képet megjelenítő `iconPhrase`numerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
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.
QuarterDayForecast
QuarterDayForecastResult
UnitType	A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .
WeatherDataUnit	Megadja, hogy az adatokat metrikaegységekben vagy angolszász egységekben adja vissza. Az alapértelmezett érték a metrika.
WeatherUnit	Adott egység adott, időjárással kapcsolatos értéke.
WeatherUnitRange	Visszaadott hőmérsékleti értékek.
WindDetails	A szél részletei, beleértve a sebességet és az irányt.
WindDirection	Szélirány

DayQuarter

A nap negyede.

Name	Típus	Description
0	Integer
1	Integer
2	Integer
3	Integer

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.

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

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

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ó

QuarterDayForecast

Name	Típus	Description
cloudCover	integer	Felhőfedés százalékos aránya.
date	string	Az előrejelzés dátuma példaként, 2019-10-27T00:00:00
dewPoint	WeatherUnit	A harmatpont hőmérséklete a megadott egységben. A harmatpont hőmérséklete az a hőmérséklet, amellyel a levegőt le kell hűteni a telítettség eléréséhez.
effectiveDate	string	Az előrejelzési negyedév elejének dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00.
hasPrecipitation	boolean	A csapadék jelenlétét vagy hiányát jelzi. Az igaz érték a csapadék jelenlétét jelzi, a hamis pedig a csapadék hiányát jelzi.
ice	WeatherUnit	Ice
iconCode	IconCode	A képet megjelenítő `iconPhrase`numerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .
iconPhrase	string	Az ikon kifejezésleírása. Megadott nyelven jelenik meg. Például: "Sunny".
phrase	string	Rövid összefoglaló kifejezés összefoglalása a negyedévhez.
precipitationIntensity	string	Az intenzitás leírása.
precipitationProbability	integer	A csapadék valószínűségét jelző százalék. Például: "20".
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.
quarter	DayQuarter	A nap negyede.
rain	WeatherUnit	Eső
realFeelTemperature	WeatherUnitRange	RealFeel™ Temperature értékek a negyedévben.
relativeHumidity	integer	A relatív páratartalom a levegőben található vízgőz mennyisége, amely az azonos hőmérsékleten történő telítettséghez szükséges mennyiség százalékában kifejezve van kifejezve.
snow	WeatherUnit	Hó
temperature	WeatherUnitRange	A negyedév hőmérsékleti értékei.
thunderstormProbability	integer	A zivatar valószínűségét jelző százalék. Például: "10".
totalLiquid	WeatherUnit	A csapadék teljes folyadékegyenértéke az előrejelzési időszakban.
visibility	WeatherUnit	Láthatóság a megadott egységben. Annak a távolságnak a mértéke, amelyen egy objektum vagy fény egyértelműen észlelhető.
wind	WindDetails	A szél részletei, beleértve a sebességet és az irányt.
windGust	WindDetails	Széllökés. A széllökés a szél hirtelen, rövid sebességnövekedése.

QuarterDayForecastResult

Name	Típus	Description
forecasts	QuarterDayForecast[]	Előrejelzési adatok a válasz minden negyedévére vonatkozóan.

UnitType

A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .

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

Megadja, hogy az adatokat metrikaegységekben vagy angolszász egységekben adja vissza. Az alapértelmezett érték a metrika.

Name	Típus	Description
imperial	string	Adatokat ad vissza angolszász egységekben. A birodalmi rendszer néhány példaegysége a Fahrenheit és a mérföld.
metric	string	Adatokat ad vissza metrikaegységekben. A metrikarendszer néhány példaegysége a Celsius és a kilométer.

WeatherUnit

Adott egység adott, időjárással kapcsolatos értéke.

Name	Típus	Description
unit	string	A visszaadott érték egységtípusa.
unitType	UnitType	A megjelenített egység típusához társított numerikus azonosító érték. Az egységfordításhoz használható. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .
value	number	Kerekített érték.

WeatherUnitRange

Visszaadott hőmérsékleti értékek.

Name	Típus	Description
maximum	WeatherUnit	Az időszak maximális hőmérséklete
minimum	WeatherUnit	Az időtartam minimális hőmérséklete.

WindDetails

A szél részletei, beleértve a sebességet és az irányt.

Name	Típus	Description
direction	WindDirection	Szélirány
speed	WeatherUnit	A szél sebessége a megadott egységben.

WindDirection

Szélirány

Name	Típus	Description
degrees	integer	Szélirány az Azimuth fokban, az igaz északi iránytól kezdve és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugaton 270 fok. Lehetséges értékek: 0-359.
localizedDescription	string	Irány rövidítése a megadott nyelven.

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