Weather - Get Daily Forecast

Referencia

Service:: Maps

API Version:: 1.1

A használatával napi részletes időjárás-előrejelzést kaphat a következő 1, 5, 10, 15, 25 vagy 45 napra vonatkozóan.

Az Get Daily Forecast API egy HTTP-kérés GET , amely részletes időjárási előrejelzéseket ad vissza, például a hőmérsékletet és a szélt naponta egy adott koordináta-hely következő 1, 5, 10, 15, 25 vagy 45 napjára vonatkozóan. A válasz olyan részleteket tartalmaz, mint a hőmérséklet, a szél, a csapadék, a levegő minősége és az UV-index. További információ: Napi időjárás-előrejelzési adatok kérése.

Ha a Gen1 S0 tarifacsomagot használja, napi előrejelzést kérhet a következő 1, 5, 10 és 15 napra vonatkozóan. Ha Gen1 S1 vagy Gen2 tarifacsomagot használ, napi előrejelzést is kérhet a következő 25 napra és 45 napra vonatkozóan.

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}

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	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 napi előrejelzési válaszok hány napig lesznek visszaadva. A rendelkezésre álló é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` – Az előrejelzési adatok visszaadása a következő 10 napra vonatkozóan. `25` – Az előrejelzési adatok visszaadása a következő 25 napra vonatkozóan. Csak az S1 termékváltozatban érhető el. `45` – Az előrejelzési adatok visszaadása a következő 45 napra vonatkozóan. Csak az S1 termékváltozatban érhető el.
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 a Microsoft Entra ID biztonsági modellel együtt használva. Ez a Azure Maps fiók egyedi azonosítóját jelöli, és lekérhető a Azure Maps felügyeletisík Fiók API-jából. A Microsoft Entra ID biztonság Azure Maps az alábbi cikkekben talál útmutatást.

Válaszok

Name	Típus	Description
200 OK	DailyForecastResult	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 Azure Maps REST API-khoz való hozzáférés vezérlésére használható. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. 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 rest API-Azure Maps 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ás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

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

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. 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ése az Azure felügyeleti síkjáról van konfigurálva Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával. * A Azure Maps Web SDK használata lehetővé teszi az alkalmazások konfigurációalapú beállítását több használati esetben.

A Microsoft Identitásplatform kapcsolatos további információkért lásd: Microsoft Identitásplatform áttekintése.

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

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Létrehozás egy Azure Maps fiókot a Azure Portal vagy PowerShell, CLI, Azure SDK 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én javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Type: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre az Azure Maps erőforráson keresztül az Azure felügyeleti síkján keresztül Azure Portal, PowerShell, CLI, Azure SDK-k vagy REST API-k használatával.

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.

Type: apiKey
In: header

Példák

Successfully retrieve detailed daily weather forecast for a given coordinate location

Sample Request

HTTP

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

Definíciók

Name	Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary	A kért időszak fő feltételeinek összegzése. Figyelje meg, hogy az összefoglalás csak az időszak egy részére terjedhet ki.
DayOrNight
DegreeDaySummary
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 az időjárási szolgáltatásokat Azure Maps.
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
LocalSource	Helyi időjárás-adatszolgáltató adatai.
PrecipitationType	Megadja a csapadék típusát ("Rain" "Snow" "Ice" vagy "Mix"). Ha a dbz értéke nulla, a csapadéktípus nem szerepel a válaszban.
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 az időjárási szolgáltatásokat Azure Maps.
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 visszaadott széladatok, beleértve a sebességet és az irányt.
WindDirection	Szélirány

AirAndPollen

Name	Típus	Description
category	string	A levegőminőség vagy a szennyezési típus kategóriája. Például alacsony, magas, jó, mérsékelt, egészségtelen, veszélyes.
categoryValue	integer	A levegőminőséggel vagy a szennyezési kategóriával kapcsolatos érték. Ezek az értékek 1 és 6 között mozognak. 1 jó körülményeket jelent, 6 veszélyes körülményeket jelent.
name	string	A pollen vagy a szennyező anyag neve. Például fű, penész, gyom, levegőminőség, fa- és UV-index.
type	string	Csak a levegőminőségre vonatkozik. Ilyenek például az ózon- és részecskeszennyezés.
value	integer	A fenti típus értéke. A penészhez, a fűhez, a gyomhoz és a fához kapcsolódó értékek köbméterenkénti részekben vannak. Mind a levegőminőség, mind az UV indexek, így egység nélküliek.

DailyForecast

Name	Típus	Description
airAndPollen	AirAndPollen[]	Levegőminőség
date	string	Az aktuális megfigyelés dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00.
day	DayOrNight	Napi előrejelzés részletei
degreeDaySummary	DegreeDaySummary	A fűtési fok napjának vagy a hűtési fok napjának középhőmérsékletére vonatkozó információk összegzése
hoursOfSun	number	Több órányi napsütés.
night	DayOrNight	Éjszakai előrejelzés részletei
realFeelTemperature	WeatherUnitRange	A RealFeel™ Hőmérséklet vissza lesz adva.
realFeelTemperatureShade	WeatherUnitRange	A RealFeel™ Hőmérséklet vissza lesz adva. Leírja, hogy milyen a hőmérséklet valójában az árnyékban.
sources	string[]	Az előrejelzési adatok forrása(i).
temperature	WeatherUnitRange	A nap hőmérsékleti értékei.

DailyForecastResult

Name	Típus	Description
forecasts	DailyForecast[]	Előrejelzett adatok az egyes kért napokra vonatkozóan.
summary	DailyForecastSummary	A kért időszak fő feltételeinek összegzése. Figyelje meg, hogy az összefoglalás csak az időszak egy részére terjedhet ki.

DailyForecastSummary

A kért időszak fő feltételeinek összegzése. Figyelje meg, hogy az összefoglalás csak az időszak egy részére terjedhet ki.

Name	Típus	Description
category	string	egy vagy két szó a kifejezés összegzéséhez.
endDate	string	Az összefoglaló időszak lejáratának dátuma és időpontja, iso 8601 formátumban megjelenítve, például 2019-10-27T19:39:57-08:00.
phrase	string	A napi előrejelzés összefoglaló kifejezése. Megadott nyelven jelenik meg.
severity	integer	súlyosság
startDate	string	Az összegzés hatályba lépésének dátuma és időpontja ISO 8601 formátumban jelenik meg, például 2019-10-27T19:39:57-08:00.

DayOrNight

Name	Típus	Description
cloudCover	integer	Felhőfedés százalékos aránya.
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.
hoursOfIce	number	Több órányi jég.
hoursOfPrecipitation	number	Csapadékórák
hoursOfRain	number	Több órányi eső.
hoursOfSnow	number	Több órányi hó.
ice	WeatherUnit	Ice
iceProbability	integer	A jég valószínűségét jelző százalék. Például: "30".
iconCode	IconCode	A képet megjelenítő `iconPhrase`numerikus érték. A részletekért tekintse meg a weather services (Időjárás-szolgáltatások) Azure Maps című témakört.
iconPhrase	string	Az ikon kifejezésleírása. Megadott nyelven jelenik meg. Például: "Sunny".
localSource	LocalSource	Helyi időjárás-adatszolgáltató adatai.
longPhrase	string	Az előrejelzés kifejezésleírása a megadott nyelven. Azure Maps megpróbálja 100 karakter alatt tartani ezt a kifejezést, de egyes nyelvek/időjárási események hosszabb, 100 karakternél hosszabb kifejezéshosszt eredményezhetnek.
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.
rain	WeatherUnit	Eső
rainProbability	integer	Az eső valószínűségét jelző százalék. Például: "40".
shortPhrase	string	Az előrejelzés kifejezésleírása a megadott nyelven. Azure Maps megpróbálja 30 karakter alatt tartani ezt a kifejezést, de egyes nyelvek/időjárási események hosszabb, 30 karakternél hosszabb kifejezéshosszt eredményezhetnek.
snow	WeatherUnit	Hó
snowProbability	integer	A hó valószínűségét jelző százalék. Például: "30".
thunderstormProbability	integer	A zivatar valószínűségét jelző százalék. Például: "80".
totalLiquid	WeatherUnit	A csapadék teljes folyadékegyenértéke az előrejelzési időszakban.
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.

DegreeDaySummary

Name	Típus	Description
cooling	WeatherUnit	Azon fokok száma, amelyek átlaghőmérséklete 65 F/ 18 C fok felett van.
heating	WeatherUnit	Azon fokok száma, amelyek átlaghőmérséklete 65 F/ 18 °C alatt van.

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 az időjárási szolgáltatásokat Azure Maps.

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

LocalSource

Helyi időjárás-adatszolgáltató adatai.

Name	Típus	Description
id	integer	A helyi adatszolgáltató egyedi numerikus azonosítója.
name	string	A helyi adatszolgáltató neve. A név a nyelvkód által megadott nyelven jelenik meg az URL-címben, ha elérhető. Ellenkező esetben a Név angolul vagy a név megadva nyelvként jelenik meg.
weatherCode	string	A helyi adatszolgáltató által megadott időjárási kód. Ez az időjárási kód lehetővé teszi, hogy az előrejelzés a helyi adatszolgáltató által biztosított ikonokkal legyen egyeztetve Azure Maps ikonok helyett.

PrecipitationType

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

Name	Típus	Description
Ice	string	Ice
Mix	string	Vegyes
Rain	string	Eső
Snow	string	Hó

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 az időjárási szolgáltatásokat Azure Maps.

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 az időjárási szolgáltatásokat Azure Maps.
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 visszaadott széladatok, 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, a valódi északtól kezdve és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugat 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: