Weather - Get Daily Historical Normals

Referencia

Service:: Maps

API Version:: 1.1

A használatával climatológiai adatokat kaphat, például a múltbeli napi normál hőmérsékleteket, a csapadék- és hűtési/fűtési fok napi adatait egy adott helyre vonatkozóan.

Az Get Daily Historical Normals API egy HTTP-kérés GET , amely climatológiai adatokat ad vissza, például a múltbeli napi normál hőmérsékleteket, a csapadék- és hűtési/fűtési fok napi adatait 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. A klimatológia szokásos gyakorlatához hasonlóan a 30 éves átlag az 1991–2020-as évekre is kiterjed, ezeket az adatokat egy évtizedre használjuk fel, 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}

With optional parameters:

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	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 nem haladja meg a legfeljebb 31 napot (például: startDate=2012-01-01&endDate=2012-01-31).
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".
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 nem haladja meg a legfeljebb 31 napot (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 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	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 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

Successful Daily Historical Normals Request

Sample Request

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

Sample Response

Status code:: 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 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	Egy 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 ISO 8601 formátumban megjelenített jelenlegi megfigyelés dátuma és időpontja, 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	A csapadék mennyisége (folyékony egyenérték), amely leesett.
temperature	WeatherUnitMaxMinAvg	Hőmérsékleti értékek.

DailyHistoricalNormalsResult

Name	Típus	Description
nextLink	string	A 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	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.

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

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

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 az időjárási szolgáltatásokat Azure Maps.
value	number	Kerekített érték.

WeatherUnitMaxMinAvg

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

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

Share via