Weather - Get Current Conditions

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

A használatával lekérheti az aktuális időjárási körülményeket.

Az Get Current Conditions API egy HTTP-kérés GET , amely részletes aktuális időjárási körülményeket ad vissza, például a csapadékot, a hőmérsékletet és a szélt egy adott koordináta-helyhez. Emellett az elmúlt 6 vagy 24 óra megfigyelései is lekérhetők egy adott helyre vonatkozóan. A válaszban visszaadott alapvető információk olyan részleteket tartalmaznak, mint a megfigyelés dátuma és időpontja, az időjárási körülmények rövid leírása, az időjárás ikon, a csapadékjelző jelzők és a hőmérséklet. A rendszer további részleteket is visszaad, például a RealFeel™ Temperature és az UV-indexet. További információ: Valós idejű időjárási adatok kérése

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

Opcionális paraméterekkel:

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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".
details	query		string	Adja vissza az aktuális feltételek teljes részleteit. A rendelkezésre álló értékek a következők: `true` – A teljes részleteket adja vissza. Alapértelmezés szerint a rendszer minden adatot visszaad. `false` – Az aktuális állapotadatok csonkolt verzióját adja vissza, amely tartalmazza a megfigyelési dátum időpontját, az időjárási kifejezést, az ikonkódot, a csapadékjelző jelzőt és a hőmérsékletet.
duration	query		integer	A visszaadott időjárási körülmények időkerete. Alapértelmezés szerint a rendszer a legfrissebb időjárási körülményeket adja vissza. Az alapértelmezett érték 0. A támogatott értékek a következők: `0` - Adja vissza a legfrissebb időjárási körülményeket. `6` - Adja vissza az időjárási körülményeket az elmúlt 6 órából. `24` - Adja vissza az időjárási körülményeket az elmúlt 24 órából.
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	CurrentConditionsResult	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
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 current weather conditions for a given coordinate location

Mintakérelem

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Mintaválasz

Állapotkód:: 200

{
  "results": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Definíciók

Name	Description
CurrentConditions
CurrentConditionsResult
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.
PastHoursTemperature	Az elmúlt órákhoz képest bekövetkező hőmérséklet-ingadozások összegzése.
PrecipitationSummary
PressureTendency
TemperatureSummary
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.
WindDetails	A szél részletei, beleértve a sebességet és az irányt.
WindDirection	Szélirány

CurrentConditions

Name	Típus	Description
apparentTemperature	WeatherUnit	A levegő hőmérséklete, a relatív páratartalom és a szélsebesség adott egységben való kombinációja által okozott külső hőmérséklet.
ceiling	WeatherUnit	Felhő felső határa a megadott egységben. A felső határ a legalacsonyabb felhők alapmagasságának mérése.
cloudCover	integer	Felhőfedés százalékos aránya.
dateTime	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.
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.
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.
iconCode	IconCode	A képet megjelenítő `iconPhrase`numerikus érték. A részletekért tekintse meg a Weather Servicest az Azure Mapsben .
isDayTime	boolean	A nap időpontját jelzi. Az igaz érték a "nap", a hamis pedig az "éjszaka" értéket jelöli.
obstructionsToVisibility	string	A korlátozott láthatóság oka. Lehetséges értékek: A = erős zivatar/jégeső BD = porfúvás BN = homokfúvás BS = hófúvás D = por F = köd GF = földfelszíni köd HZ = köd I = jég IC = jégkristályok HA = jég köd IP = jégpelletek IPW = jég pellet zuhany K = füst L = szitáló R = eső RS = eső/hó RW = esőzápor S = hó SG = hó granulátum SP = hó pellet SW = hózápor T = zivatar UP = nem definiált csapadék ZL = fagyásos szitálás ZR = fagyos eső + = nehéz - = fény
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Eltérés a megadott egységben 24 órával ezelőtt megfigyelt hőmérséklettől.
phrase	string	Az aktuális időjárási feltétel kifejezésleírása. Megadott nyelven jelenik meg.
precipitationSummary	PrecipitationSummary	Az elmúlt 24 óra csapadékmennyiségeinek összegzése.
pressure	WeatherUnit	Légköri nyomás a megadott egységben.
pressureTendency	PressureTendency	Légköri nyomásváltozás.
realFeelTemperature	WeatherUnit	A RealFeel™ Hőmérséklet vissza lesz adva.
realFeelTemperatureShade	WeatherUnit	A RealFeel™ Hőmérséklet vissza lesz adva. Leírja, hogy milyen a hőmérséklet valójában az árnyékban.
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.
temperature	WeatherUnit	A hőmérséklet vissza lesz adva.
temperatureSummary	TemperatureSummary	Az elmúlt 6, 12 és 24 óra hőmérséklet-ingadozásainak összegzése.
uvIndex	integer	A nap ultraibolya sugárzásának erőssége. A támogatott értékek a következők: `0-2` - Alacsony veszély a nap UV-sugaraitól vagy az átlagembertől. `3-5` - Mérsékelt veszély a védelem nélküli napozásból. `6-7` - Nagy a veszély a védelem nélküli napozásból. `8-10` - Nagyon nagy a veszély a védelem nélküli napozásból. `11+` - Rendkívüli veszély a védelem nélküli napozásból.
uvIndexPhrase	string	A következőhöz `uvIndex`társított kifejezés: .
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ő.
wetBulbTemperature	WeatherUnit	Az a hőmérséklet, amelyre a levegő lehűthető, ha a vizet állandó nyomáson elpárologtatjuk, amíg el nem éri a telítettséget.
wind	WindDetails	A szél részletei, beleértve a sebességet és az irányt.
windChillTemperature	WeatherUnit	Érzékelt levegő hőmérséklet a kitéve bőr miatt a szél.
windGust	WindDetails	Széllökés. A széllökés a szél hirtelen, rövid sebességnövekedése.

CurrentConditionsResult

Name	Típus	Description
results	CurrentConditions[]	Az aktuális időjárási körülmények részletes adatai.

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

PastHoursTemperature

Az elmúlt órákhoz képest bekövetkező hőmérséklet-ingadozások összegzése.

Name	Típus	Description
maximum	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Name	Típus	Description
pastEighteenHours	WeatherUnit	Az elmúlt 18 órában csökkent csapadék mennyisége (folyékony egyenérték).
pastHour	WeatherUnit	Az elmúlt órában csökkent csapadék mennyisége (folyékony egyenérték).
pastNineHours	WeatherUnit	A csapadék mennyisége (folyékony egyenérték), amely az elmúlt kilenc órában csökkent.
pastSixHours	WeatherUnit	A csapadék mennyisége (folyékony egyenérték), amely az elmúlt hat órában csökkent. Metrikát és birodalmi értékeket tartalmaz.
pastThreeHours	WeatherUnit	A csapadék mennyisége (folyékony egyenérték), amely az elmúlt három órában csökkent.
pastTwelveHours	WeatherUnit	Az elmúlt 12 órában csökkent csapadék mennyisége (folyékony egyenérték).
pastTwentyFourHours	WeatherUnit	Az elmúlt 24 órában csökkent csapadék mennyisége (folyékony egyenérték).

PressureTendency

Name	Típus	Description
code	string	Nyomás tendenciakód nyelvtől függetlenül. Az egyik F=Falling, S=Steady, R=Rising.
localizedDescription	string	A nyomás tendenciája a megadott nyelven

TemperatureSummary

Name	Típus	Description
pastSixHours	PastHoursTemperature	Az elmúlt 6 óra hőmérséklet-ingadozásainak összegzése.
pastTwelveHours	PastHoursTemperature	Az elmúlt 12 óra hőmérséklet-ingadozásainak összegzése.
pastTwentyFourHours	PastHoursTemperature	Az elmúlt 24 óra hőmérséklet-ingadozásainak összegzése.

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.

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: