Weather - Get Current Conditions
Slouží k získání aktuálních povětrnostních podmínek.
Rozhraní Get Current Conditions
API je požadavek HTTP GET
, který vrací podrobné aktuální povětrnostní podmínky, jako jsou srážky, teplota a vítr pro danou polohu souřadnic. Můžete také načíst pozorování z posledních 6 nebo 24 hodin pro konkrétní místo. Základní informace vrácené v odpovědi zahrnují podrobnosti, jako jsou datum a čas pozorování, stručný popis povětrnostních podmínek, ikona počasí, příznaky indikátoru srážek a teplota. Vrátí se také další podrobnosti, jako je teplota RealFeel™ Temperature a UV index. Další informace najdete v tématu Žádost o data o počasí v reálném čase.
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
format
|
path | True |
Požadovaný formát odpovědi. Podporuje se pouze |
|
api-version
|
query | True |
string |
Číslo verze rozhraní API Azure Maps. |
query
|
query | True |
number[] |
Příslušný dotaz zadaný jako řetězec oddělený čárkami složený podle zeměpisné šířky následované zeměpisnou délkou, např. "47.641268,-122.125679". |
details
|
query |
string |
Vraťte úplné podrobnosti o aktuálních podmínkách. Dostupné hodnoty jsou
|
|
duration
|
query |
integer |
Časový rámec vrácených povětrnostních podmínek. Ve výchozím nastavení se vrátí nejaktuálnější povětrnostní podmínky. Výchozí hodnota je 0. Podporované hodnoty jsou:
|
|
language
|
query |
string |
Jazyk, ve kterém se mají vracet výsledky hledání. Měl by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole k dispozici, použije se výchozí jazyk. Podrobnosti najdete v části Podporované jazyky . |
|
unit
|
query |
Určuje, že se mají vracet data buď v jednotkách metrik, nebo v jednotkách impéria. Výchozí hodnota je metrika. |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Určuje, který účet je určen pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a dá se načíst z rozhraní API účtu Azure Maps roviny správy. Pokud chcete použít zabezpečení Microsoft Entra ID v Azure Maps pokyny najdete v následujících článcích. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Došlo k neočekávané chybě. |
Zabezpečení
AADToken
Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role, která se skládá z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.
Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu k určitým rozhraním API a oborům.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. To je možné získat z rozhraní API pro správu map .
Je Authorization URL
specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
* Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
* Použití sady Azure Maps Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
- Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.
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
Jedná se o sdílený klíč, který se zřídí při Create účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem má každá aplikace přístup ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve který je vystavený.
U veřejně vystavených aplikací doporučujeme používat pro přístup k rozhraním REST API Azure Maps přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.
Type:
apiKey
In:
query
SAS Token
Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role v Azure a podrobného řízení k vypršení platnosti, četnosti a oblastem použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.
U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku mapového účtu , aby se omezilo zneužití vykreslování a pravidelně obnovovali token SAS.
Type:
apiKey
In:
header
Příklady
Successfully retrieve detailed current weather conditions for a given coordinate location
Sample Request
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
Sample Response
{
"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
}
}
}
}
]
}
Definice
Name | Description |
---|---|
Current |
|
Current |
|
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Icon |
Číselná hodnota představující obrázek, který zobrazuje |
Json |
Požadovaný formát odpovědi Podporuje se pouze |
Past |
Souhrn teplotních výkyvů v počtu posledních hodin |
Precipitation |
|
Pressure |
|
Temperature |
|
Unit |
Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v tématu Služby počasí v Azure Maps. |
Weather |
Určuje, že se mají vracet data v metrických nebo imperiálních jednotkách. Výchozí hodnota je metrika. |
Weather |
Konkrétní hodnota dané jednotky související s počasím. |
Wind |
Vrací se podrobnosti o větru, včetně rychlosti a směru. |
Wind |
Směr větru |
CurrentConditions
Name | Typ | Description |
---|---|---|
apparentTemperature |
Vnímaná venkovní teplota způsobená kombinací teploty vzduchu, relativní vlhkosti a rychlosti větru v zadané jednotce. |
|
ceiling |
Horní mez cloudu v zadané jednotce. Strop je měřítkem výšky základny nejnižších mraků. |
|
cloudCover |
integer |
Procento představující cloudové pokrytí. |
dateTime |
string |
Datum a čas aktuálního pozorování zobrazeného ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00. |
dewPoint |
Rosný bod teploty v zadané jednotce Rosný bod teploty je teplota, na kterou musí být vzduch ochlazen, aby dosáhl nasycení. |
|
hasPrecipitation |
boolean |
Označuje přítomnost nebo nepřítomnost srážek. True označuje přítomnost srážek, false označuje nepřítomnost srážek. |
iconCode |
Číselná hodnota představující obrázek, který zobrazuje |
|
isDayTime |
boolean |
Určuje denní čas. True označuje "den", "false" označuje "noc". |
obstructionsToVisibility |
string |
Příčina omezené viditelnosti Možné hodnoty:
|
pastTwentyFourHourTemperatureDeparture |
Odlet z teploty pozorované před 24 hodinami v zadané jednotce. |
|
phrase |
string |
Frázi popis aktuálního počasí. Zobrazuje se v zadaném jazyce. |
precipitationSummary |
Souhrn množství srážek za posledních 24 hodin |
|
pressure |
Atmosférický tlak v zadané jednotce. |
|
pressureTendency |
Změna atmosférického tlaku. |
|
realFeelTemperature |
Vrácená hodnota RealFeel™ Temperature. |
|
realFeelTemperatureShade |
Vrácená hodnota RealFeel™ Temperature. Popisuje, jaká je skutečně teplota ve stínu. |
|
relativeHumidity |
integer |
Relativní vlhkost je množství vodní páry přítomné ve vzduchu vyjádřené jako procento množství potřebného pro nasycení při stejné teplotě. |
temperature |
Vrácená teplota. |
|
temperatureSummary |
Shrnutí kolísání teplot za posledních 6, 12 a 24 hodin |
|
uvIndex |
integer |
Měření síly ultrafialového záření ze slunce. Podporované hodnoty jsou:
|
uvIndexPhrase |
string |
Fráze přidružená k |
visibility |
Viditelnost v zadané jednotce Míra vzdálenosti, ve které lze objekt nebo světlo jasně rozlišit. |
|
wetBulbTemperature |
Teplota, na kterou může být vzduch ochlazen odpařováním vody při konstantním tlaku, dokud nedosáhne nasycení. |
|
wind |
Vrací se podrobnosti o větru, včetně rychlosti a směru. |
|
windChillTemperature |
Vnímaná teplota vzduchu na vystavené kůži v důsledku větru. |
|
windGust |
Poryvy větru. Poryvy větru jsou náhlé, krátké zvýšení rychlosti větru. |
CurrentConditionsResult
Name | Typ | Description |
---|---|---|
results |
Podrobné informace o aktuálním počasí. |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
IconCode
Číselná hodnota představující obrázek, který zobrazuje iconPhrase
. Podrobnosti najdete v Azure Maps ve službách Počasí.
Name | Typ | 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
Požadovaný formát odpovědi Podporuje se pouze json
formát.
Name | Typ | Description |
---|---|---|
json |
string |
PastHoursTemperature
Souhrn teplotních výkyvů v počtu posledních hodin
Name | Typ | Description |
---|---|---|
maximum |
Maximum |
|
minimum |
Minimum |
PrecipitationSummary
Name | Typ | Description |
---|---|---|
pastEighteenHours |
Množství srážek (ekvivalent kapaliny), které kleslo za posledních 18 hodin. |
|
pastHour |
Množství srážek (ekvivalent kapaliny), které v poslední hodině kleslo. |
|
pastNineHours |
Množství srážek (ekvivalent kapaliny), které kleslo v posledních devíti hodinách. |
|
pastSixHours |
Množství srážek (ekvivalent kapaliny), které kleslo v posledních šesti hodinách. Obsahuje metrické a imperiální hodnoty. |
|
pastThreeHours |
Množství srážek (ekvivalent kapaliny), které kleslo v posledních třech hodinách. |
|
pastTwelveHours |
Množství srážek (ekvivalent kapaliny), které kleslo za posledních 12 hodin. |
|
pastTwentyFourHours |
Množství srážek (ekvivalent kapaliny), které kleslo za posledních 24 hodin. |
PressureTendency
Name | Typ | Description |
---|---|---|
code |
string |
Kód sklonu tlaku bez ohledu na jazyk. Jeden z F=Falling, S=Steady, R=Rising. |
localizedDescription |
string |
Popis sklonu tlaku v zadaném jazyce |
TemperatureSummary
Name | Typ | Description |
---|---|---|
pastSixHours |
Souhrn teplotních výkyvů za posledních 6 hodin |
|
pastTwelveHours |
Souhrn teplotních výkyvů za posledních 12 hodin |
|
pastTwentyFourHours |
Souhrn teplotních výkyvů za posledních 24 hodin |
UnitType
Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v tématu Služby počasí v Azure Maps.
Name | Typ | 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
Určuje, že se mají vracet data v metrických nebo imperiálních jednotkách. Výchozí hodnota je metrika.
Name | Typ | Description |
---|---|---|
imperial |
string |
Vrátí data v imperiálních jednotkách. Mezi příklady jednotek císařského systému patří Fahrenheita a míle. |
metric |
string |
Vrátí data v metrických jednotkách. Mezi ukázkové jednotky metrického systému patří stupně Celsia a kilometry. |
WeatherUnit
Konkrétní hodnota dané jednotky související s počasím.
Name | Typ | Description |
---|---|---|
unit |
string |
Typ jednotky pro vrácenou hodnotu. |
unitType |
Číselná hodnota ID přidružená k typu zobrazené jednotky. Lze použít k překladu jednotek. Podrobnosti najdete v Azure Maps ve službách Počasí. |
|
value |
number |
Zaokrouhlená hodnota. |
WindDetails
Vrací se podrobnosti o větru, včetně rychlosti a směru.
Name | Typ | Description |
---|---|---|
direction |
Směr větru |
|
speed |
Rychlost větru v zadané jednotce. |
WindDirection
Směr větru
Name | Typ | Description |
---|---|---|
degrees |
integer |
Směr větru ve stupních Azimuth začíná na pravém severu a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ je 90 stupňů, jih je 180 stupňů, západ je 270 stupňů. Možné hodnoty 0–359. |
localizedDescription |
string |
Zkratka směru v zadaném jazyce. |