Weather - Get Quarter Day Forecast

Referencia

Service:: Maps

API Version:: 1.1

A használatával Quarter-Day előrejelzést kaphat a következő 1, 5, 10 vagy 15 napra vonatkozóan.

Az Get Quarter-Day Forecast API egy HTTP-kérés GET , amely egy adott hely következő 1, 5, 10 vagy 15 napjára vonatkozó részletes időjárás-előrejelzést ad vissza negyedévente. A válaszadatokat a nap negyede jeleníti meg – reggel, délután, este és éjszaka. A rendszer olyan részleteket ad vissza, mint a hőmérséklet, a páratartalom, a szél, a csapadék és az UV-index.

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

With optional parameters:

GET https://atlas.microsoft.com/weather/forecast/quarterDay/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	A 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	Azt adja meg, hogy a rendszer hány napig adja vissza a quester-day előrejelzési válaszokat. A támogatott é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. `15` – Előrejelzési adatokat ad vissza a következő 15 napra vonatkozóan.
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 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	QuarterDayForecastResult	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és 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 egy alkalmazás 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és.

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 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 azt javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével férhessen hozzá Azure Maps REST API-khoz, 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, amely a Azure Maps erőforrás SAS listázási műveletéből jön létre 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 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.

Type: apiKey
In: header

Példák

Successfully retrieve detailed weather forecast by a given location

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

Sample Response

Status code:: 200

{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definíciók

Name	Description
DayQuarter	A nap negyede.
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 az időjárási szolgáltatásokat Azure Maps.
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
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.
QuarterDayForecast
QuarterDayForecastResult
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.
WeatherUnitRange	Visszaadott hőmérsékleti értékek.
WindDetails	A visszaadott széladatok, beleértve a sebességet és az irányt.
WindDirection	Szélirány

DayQuarter

A nap negyede.

Name	Típus	Description
0	Integer
1	Integer
2	Integer
3	Integer

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 az időjárási szolgáltatásokat Azure Maps.

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

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.

Name	Típus	Description
Ice	string	Ice
Mix	string	Vegyes
Rain	string	Eső
Snow	string	Hó

QuarterDayForecast

Name	Típus	Description
cloudCover	integer	A felhőfedés százalékos aránya.
date	string	Az előrejelzés dátuma például: 2019-10-27T00:00: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.
effectiveDate	string	Az ISO 8601 formátumban megjelenített előrejelzési negyedév kezdetének dátuma és időpontja, például 2019-10-27T19:39:57-08:00.
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.
ice	WeatherUnit	Ice
iconCode	IconCode	A képet megjelenítő `iconPhrase`numerikus érték. A részletekért tekintse meg az időjárási szolgáltatásokat Azure Maps.
iconPhrase	string	Az ikon kifejezésleírása. Megadott nyelven jelenik meg. Például: "Sunny".
phrase	string	A negyedév rövid összefoglaló kifejezésének összefoglalása.
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.
quarter	DayQuarter	A nap negyede.
rain	WeatherUnit	Eső
realFeelTemperature	WeatherUnitRange	RealFeel™ Temperature értékek a negyedévben.
relativeHumidity	integer	A relatív páratartalom a levegőben található vízpára mennyisége, amely az azonos hőmérsékleten történő telítettséghez szükséges mennyiség százalékában van kifejezve.
snow	WeatherUnit	Hó
temperature	WeatherUnitRange	A negyedév hőmérsékleti értékei.
thunderstormProbability	integer	A zivatar valószínűségét jelölő százalék. Például: "10".
totalLiquid	WeatherUnit	A csapadék teljes folyadékegyenértéke az előrejelzési időszakban.
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 felismerhető.
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.

QuarterDayForecastResult

Name	Típus	Description
forecasts	QuarterDayForecast[]	A válaszban szereplő negyedévek adatainak előrejelzé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 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.

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 visszaadott széladatok, 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, a valódi északtól kezdve és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugat 270 fok. Lehetséges értékek: 0-359.
localizedDescription	string	Irány rövidítése a megadott nyelven.

Share via