Weather - Get Minute Forecast
Umožňuje získat minutovou předpověď na dalších 120 minut v intervalech 1, 5 a 15 minut.
Rozhraní Get Minute Forecast
API je požadavek HTTP GET
, který vrací minutu po minutách prognózy pro dané umístění po dobu dalších 120 minut. Uživatelé mohou požádat o předpověď počasí v intervalech 1, 5 a 15 minut. Odpověď bude obsahovat podrobnosti, jako je typ srážek (včetně deště, sněhu nebo kombinace obojího), počáteční čas a hodnota intenzity srážek (dBZ). Další informace najdete v tématu Žádost o data předpovědi počasí po minutách.
GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&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ý čárkou složený podle zeměpisné šířky následované délkou, například 47.641268,-122.125679. |
interval
|
query |
integer |
Určuje časový interval v minutách pro vrácenou předpověď počasí. Podporované hodnoty jsou:
|
|
language
|
query |
string |
Jazyk, ve kterém se mají vrátit 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 . |
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 minute-by-minute forecasts for a given location
Sample Request
GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15
Sample Response
{
"summary": {
"briefPhrase60": "Rain ending in 25 min",
"shortPhrase": "Rain ending in 25 min",
"briefPhrase": "Rain ending in 25 min",
"longPhrase": "Rain ending in 25 min",
"iconCode": 12
},
"intervalSummaries": [
{
"startMinute": 0,
"endMinute": 24,
"totalMinutes": 25,
"shortPhrase": "Rain ending in %minute_value min",
"briefPhrase": "Rain ending in %minute_value min",
"longPhrase": "Rain ending in %minute_value min",
"iconCode": 12
},
{
"startMinute": 25,
"endMinute": 119,
"totalMinutes": 95,
"shortPhrase": "No precip for %MINUTE_VALUE min",
"briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
"longPhrase": "No precipitation for at least %MINUTE_VALUE min",
"iconCode": 7
}
],
"intervals": [
{
"startTime": "2019-11-14T15:18:00-08:00",
"minute": 0,
"dbz": 23,
"shortPhrase": "Light Rain",
"threshold": "LIGHT",
"color": {
"red": 8,
"green": 98,
"blue": 2,
"hex": "#086202"
},
"simplifiedColor": {
"red": 35,
"green": 190,
"blue": 39,
"hex": "#23BE27"
},
"precipitationType": "Rain",
"iconCode": 12,
"cloudCover": 100
},
{
"startTime": "2019-11-14T15:33:00-08:00",
"minute": 15,
"dbz": 18,
"shortPhrase": "Light Rain",
"threshold": "LIGHT",
"color": {
"red": 32,
"green": 133,
"blue": 9,
"hex": "#208509"
},
"simplifiedColor": {
"red": 35,
"green": 190,
"blue": 39,
"hex": "#23BE27"
},
"precipitationType": "Rain",
"iconCode": 12,
"cloudCover": 100
},
{
"startTime": "2019-11-14T15:48:00-08:00",
"minute": 30,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
},
{
"startTime": "2019-11-14T16:03:00-08:00",
"minute": 45,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
},
{
"startTime": "2019-11-14T16:18:00-08:00",
"minute": 60,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
},
{
"startTime": "2019-11-14T16:33:00-08:00",
"minute": 75,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
},
{
"startTime": "2019-11-14T16:48:00-08:00",
"minute": 90,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
},
{
"startTime": "2019-11-14T17:03:00-08:00",
"minute": 105,
"dbz": 0,
"shortPhrase": "No Precipitation",
"iconCode": 7,
"cloudCover": 100
}
]
}
Definice
Name | Description |
---|---|
Color |
|
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Odpověď na chybu |
Forecast |
|
Icon |
Číselná hodnota představující obrázek, který zobrazuje |
Interval |
|
Json |
Požadovaný formát odpovědi. Podporuje se pouze |
Minute |
|
Minute |
Souhrny frází za celé období prognózy. |
Precipitation |
Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud je dbz nula, není v odpovědi přítomen typ precipitationType. |
ColorValue
Name | Typ | Description |
---|---|---|
blue |
integer |
Modrá součást hodnoty RGB |
green |
integer |
Zelená součást hodnoty RGB. |
hex |
string |
Šestnáctková hodnota barvy. |
red |
integer |
Červená součást hodnoty RGB. |
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
Odpověď na chybu
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
ForecastInterval
Name | Typ | Description |
---|---|---|
cloudCover |
integer |
Procento představující cloudový kryt. |
color |
Barva celého spektra, která se mapuje na dBZ (decibel vzhledem k Z). Pokud je dbz nula, barva není v odpovědi. |
|
dbz |
number |
Jednotka, která představuje předpokládanou intenzitu srážek. |
iconCode |
Číselná hodnota představující obrázek, který zobrazuje |
|
minute |
integer |
První minuta intervalu. |
precipitationType |
Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud je dbz nula, není v odpovědi přítomen typ precipitationType. |
|
shortPhrase |
string |
Krátká fráze popisující podmínky srážek pro interval. |
simplifiedColor |
Barva pásu, která se mapuje na typ a prahovou hodnotu srážek. Pokud je dbz nula, není k dispozici v odpovědi. |
|
startTime |
string |
Datum a čas začátku intervalu ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00. |
threshold |
string |
Klíč, který určuje prahovou hodnotu. Spolu s precipitationType, lze použít k určení simplifiedColor. Pokud je dbz nula, není k dispozici v odpovědi. |
IconCode
Číselná hodnota představující obrázek, který zobrazuje iconPhrase
. Podrobnosti najdete v tématu Služby počasí v Azure Maps.
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 |
IntervalSummary
Name | Typ | Description |
---|---|---|
briefPhrase |
string |
Stručná souhrnná fráze. Délka fráze je přibližně 60 znaků. |
endMinute |
integer |
Poslední minuta, na kterou se souhrn vztahuje. |
iconCode |
Číselná hodnota představující obrázek, který zobrazuje |
|
longPhrase |
string |
Dlouhá souhrnná fráze. Délka fráze je 60+ znaků. |
shortPhrase |
string |
Krátká souhrnná fráze. Délka fráze je přibližně 25 znaků. |
startMinute |
integer |
První minuta, na kterou se souhrn vztahuje. |
totalMinutes |
integer |
Počet minut, pro které se souhrn vztahuje. |
JsonFormat
Požadovaný formát odpovědi. Podporuje se pouze json
formát.
Name | Typ | Description |
---|---|---|
json |
string |
MinuteForecastResult
Name | Typ | Description |
---|---|---|
intervalSummaries |
Souhrnné informace pro každý interval v prognóze. Souhrny rozdělují všechny potenciální intervaly, ve kterých srážky začínají a zastavují. |
|
intervals |
Data prognózy pro každý interval v prognóze. |
|
summary |
Souhrny frází za celé období prognózy. |
MinuteForecastSummary
Souhrny frází za celé období prognózy.
Name | Typ | Description |
---|---|---|
briefPhrase |
string |
Souhrnná fráze pro dalších 120 minut. Délka fráze je přibližně 60 znaků. |
briefPhrase60 |
string |
Souhrnná fráze pro dalších 60 minut. Délka fráze je přibližně 60 znaků. |
iconCode |
Číselná hodnota představující obrázek, který zobrazuje |
|
longPhrase |
string |
Dlouhá souhrnná fráze pro dalších 120 minut. Délka fráze je 60+ znaků. |
shortPhrase |
string |
Krátká souhrnná fráze pro dalších 120 minut. Délka fráze je přibližně 25 znaků. |
PrecipitationType
Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud je dbz nula, není v odpovědi přítomen typ precipitationType.
Name | Typ | Description |
---|---|---|
Ice |
string |
Ice |
Mix |
string |
Kombinace |
Rain |
string |
Déšť |
Snow |
string |
Sníh |