Weather - Get Daily Historical Normals

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

Olyan climatológiai adatok lekérésére szolgál, mint a múltbeli napi normál hőmérsékletek, a csapadék és a hűtési/fűtési fok napi adatai egy adott helyre vonatkozóan.

Az Get Daily Historical Normals API egy HTTP-kérés GET , amely olyan climatológiai adatokat ad vissza, mint a múltbeli napi normál hőmérsékletek, a csapadék és a hűtési/fűtési fok napi adatai egy adott koordináta-helyen. A korábbi normálértékek egy adott hely hőmérsékletének és csapadékának 30 éves átlaga. Ahogy a climatológia szokásos gyakorlata is, a 30 éves átlag az 1991–2020-as évet fedi le, ezeket az adatokat egy évtizedig felhasználjuk, majd 2030-ban visszaállítjuk. Az előzményadatok általában az elmúlt 5–40 év során érhetők el a helytől függően.

GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}

Opcionális paraméterekkel:

GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}&unit={unit}

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.
endDate	query	True	string date	Záró dátum ISO 8601 formátumban, például 2019-10-28. A támogatott dátumtartomány 1–31 naptári nap, ezért mindenképpen adjon meg egy olyan startDate és endDate értéket, amely legfeljebb 31 nap (például: startDate=2012-01-01&endDate=2012-01-31).
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".
startDate	query	True	string date	Kezdő dátum ISO 8601 formátumban, például 2019-10-27. A támogatott dátumtartomány 1–31 naptári nap, ezért mindenképpen adjon meg egy olyan startDate és endDate értéket, amely legfeljebb 31 nap (például: startDate=2012-01-01&endDate=2012-01-31).
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	DailyHistoricalNormalsResult	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

Successful Daily Historical Normals Request

Mintakérelem

HTTP

GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query=39.952583,-75.165222&startDate=2012-01-20&endDate=2012-01-22

Mintaválasz

Állapotkód:: 200

{
  "results": [
    {
      "date": "2012-01-20T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.4,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.5,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2012-01-21T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.5,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.5,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2012-01-22T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.5,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.3,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definíciók

Name	Description
DailyHistoricalNormals
DailyHistoricalNormalsResult
DegreeDaySummary
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
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.
WeatherUnitMaxMinAvg	Visszaadott hőmérsékleti értékek.

DailyHistoricalNormals

Name	Típus	Description
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.
degreeDaySummary	DegreeDaySummary	A fűtési vagy hűtési fok napi adatainak összegzése
precipitation	WeatherUnit	Az elesett csapadék mennyisége (folyékony egyenérték).
temperature	WeatherUnitMaxMinAvg	Hőmérsékleti értékek.

DailyHistoricalNormalsResult

Name	Típus	Description
nextLink	string	Az a hivatkozás, amely a visszaadott funkciók következő oldalára mutató hivatkozás. Ha ez az utolsó oldal, akkor nem ez a mező.
results	DailyHistoricalNormals[]	Az egyes kért napok előzményei.

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.

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

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.

WeatherUnitMaxMinAvg

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

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

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