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

Weather - Get Daily Historical Records

  • Referencia
Szolgáltatás:
Maps
API-verzió:
1.1

A használatával lekérheti a climatológiai adatokat, például a múltbeli napi rekordhőmérsékleteket, a csapadékot és a havazást egy adott helyen.

Az Get Daily Historical Records API egy HTTP-kérés GET , amely olyan climatológiai adatokat ad vissza, mint a múltbeli napi rekordhőmérsékletek, a csapadék és a havazás egy adott koordináta-helyen. A rekordok adatainak rendelkezésre állása helytől függően változik. 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/records/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}
Opcionális paraméterekkel: 
GET https://atlas.microsoft.com/weather/historical/records/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

DailyHistoricalRecordsResult

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

Successful Daily Historical Records Request

Mintakérelem

GET https://atlas.microsoft.com/weather/historical/records/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": 18.3,
          "unit": "C",
          "unitType": 17,
          "year": 1951
        },
        "minimum": {
          "value": -19.4,
          "unit": "C",
          "unitType": 17,
          "year": 1984
        },
        "average": {
          "value": -0.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "maximum": {
          "value": 48,
          "unit": "mm",
          "unitType": 3,
          "year": 1978
        }
      },
      "snowfall": {
        "maximum": {
          "value": 12.19,
          "unit": "cm",
          "unitType": 4,
          "year": 1978
        }
      }
    },
    {
      "date": "2012-01-21T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 16.7,
          "unit": "C",
          "unitType": 17,
          "year": 1959
        },
        "minimum": {
          "value": -21.1,
          "unit": "C",
          "unitType": 17,
          "year": 1985
        },
        "average": {
          "value": -2.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "maximum": {
          "value": 33.5,
          "unit": "mm",
          "unitType": 3,
          "year": 1979
        }
      },
      "snowfall": {
        "maximum": {
          "value": 34.29,
          "unit": "cm",
          "unitType": 4,
          "year": 2014
        }
      }
    },
    {
      "date": "2012-01-22T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 21.1,
          "unit": "C",
          "unitType": 17,
          "year": 1906
        },
        "minimum": {
          "value": -21.7,
          "unit": "C",
          "unitType": 17,
          "year": 1984
        },
        "average": {
          "value": -0.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "maximum": {
          "value": 26.2,
          "unit": "mm",
          "unitType": 3,
          "year": 1987
        }
      },
      "snowfall": {
        "maximum": {
          "value": 22.35,
          "unit": "cm",
          "unitType": 4,
          "year": 1987
        }
      }
    }
  ]
}

Definíciók

Name Description
DailyHistoricalRecords
DailyHistoricalRecordsResult
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.
WeatherUnitYear
WeatherUnitYearMax

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

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

DailyHistoricalRecords

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

WeatherUnitYearMax

Az elesett csapadék maximális mennyisége (folyékony egyenérték).
snowfall

WeatherUnitYearMax

Maximum havazás.
temperature

WeatherUnitYearMaxMinAvg

Hőmérsékleti érték.

DailyHistoricalRecordsResult

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

DailyHistoricalRecords[]

Az egyes kért napok előzményrekordjai.

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.

WeatherUnitYear

Name Típus Description
unit

string

A visszaadott érték egységtípusa.
unitType

integer

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

integer

Az érték előfordulásának éve.

WeatherUnitYearMax

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

Name Típus Description
maximum

WeatherUnitYear

Az időszak maximális hőmérséklete.

WeatherUnitYearMaxMinAvg

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

Name Típus Description
average

WeatherUnit

Az időszak átlagos hőmérséklete.
maximum

WeatherUnitYear

Az időszak maximális hőmérséklete.
minimum

WeatherUnitYear

Az időtartam minimális hőmérséklete.