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

Weather - Get Daily Forecast

  • Referencia
Szolgáltatás:
Maps
API-verzió:
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ás-előrejelzést ad vissza, például a hőmérsékletet és a szélt naponta a következő 1, 5, 10, 15, 25 vagy 45 napra vonatkozóan egy adott koordináta-helyhez. A válasz olyan részleteket tartalmaz, mint a hőmérséklet, a szél, a csapadék, a levegőminőség é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}
Opcionális paraméterekkel: 
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

Az Azure Maps API verziószáma.
query
 query True

number[]

A megfelelő lekérdezés vesszővel elválasztott sztringként van megadva, amelyet szélesség és hosszúság követ, például "47.641268,-122.125679".
duration
 query

integer

Megadja, hogy a rendszer hány napig adja vissza a napi előrejelzési válaszokat. A rendelkezésre álló értékek a következők:

  • 1 – Előrejelzési adatokat ad vissza a következő napra vonatkozóan. Alapértelmezés szerint visszaadva.
  • 5 – Előrejelzési adatokat ad vissza a következő 5 napra vonatkozóan.
  • 10 – Előrejelzési adatokat ad vissza a következő 10 napra vonatkozóan.
  • 25 – Előrejelzési adatokat ad vissza a következő 25 napra vonatkozóan. Csak az S1 termékváltozatban érhető el.
  • 45 – Előrejelzési adatokat ad vissza a következő 45 napra vonatkozóan. Csak az S1 termékváltozatban érhető el.
language
 query

string

Nyelv, amelyben a keresési eredményeket vissza kell adni. Az egyik támogatott IETF-nyelvi címke, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven megadott adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja.

A részletekért tekintse meg a Támogatott nyelvek című témakört .
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

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 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 detailed daily weather forecast for a given coordinate location

Mintakérelem

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

Mintaválasz

Állapotkó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"
      ]
    }
  ]
}

Definíciók

Name Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary

A kért időszak fő feltételeinek összefoglalása. 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ő iconPhrasenumerikus é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.
LocalSource

Helyi időjárás-adatszolgáltató adatai.
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.
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

Egy 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

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, nem kifogástalan, 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. Ilyen 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 egységben vannak megadva. 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 ISO 8601 formátumban megjelenített jelenlegi megfigyelés dátuma és időpontja, 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

Órákon át süt a nap.
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[]

Az egyes kért napokra vonatkozó előrejelzési adatok.
summary

DailyForecastSummary

A kért időszak fő feltételeinek összefoglalása. 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 összefoglalása. 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 befejezésének 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 összefoglalá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

A 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 jelölő százalék. Például: "30".
iconCode

IconCode

A képet megjelenítő iconPhrasenumerikus érték. További részletekért tekintse meg az Azure Maps időjárási szolgáltatásaival foglalkozó cikket.
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. Az Azure Maps megpróbálja 100 karakter alatt tartani ezt a kifejezést, de egyes nyelvek/időjárási események hosszabb kifejezéshosszt eredményezhetnek, amely meghaladja a 100 karaktert.
precipitationIntensity

string

Az intenzitás leírása.
precipitationProbability

integer

A csapadék valószínűségét jelölő százalék. Például: "20".
precipitationType

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.
rain

WeatherUnit

Eső
rainProbability

integer

Az eső valószínűségét jelölő százalék. Például: "40".
shortPhrase

string

Az előrejelzés kifejezésleírása a megadott nyelven. Az 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 jelölő százalék. Például: "30".
thunderstormProbability

integer

A zivatar valószínűségét jelölő 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 visszaadott széladatok, beleértve a sebességet és az irányt.
windGust

WindDetails

Széllökés. A széllökés a szél sebességének hirtelen, rövid növekedése.

DegreeDaySummary

Name Típus Description
cooling

WeatherUnit

Az átlaghőmérséklet 65 F/ 18 °C feletti foka.
heating

WeatherUnit

Azon fokok száma, amelyekben a középhőmérséklet 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 adattí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 hiba célja.

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 object Notation Data Interchange formátuma

LocalSource

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

Name Típus Description
id

integer

A helyi adatszolgáltatóra egyedi numerikus azonosító.
name

string

A helyi adatszolgáltató neve. A név a nyelvkód által megadott nyelven jelenik meg az URL-címben, ha van ilyen. Ellenkező esetben a Név angolul vagy azon a nyelven jelenik meg, amelyben a név meg lett adva.
weatherCode

string

A helyi adatszolgáltató által megadott időjárási kód. Ez az időjárás-kód lehetővé teszi, hogy az előrejelzés az Azure Maps ikonjai helyett a helyi adatszolgáltató által megadott ikonokkal legyen egyeztetve.

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ó

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

Egy 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őszak 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.