Weather - Get Minute Forecast

Reference

Služba:: Maps

Verze rozhraní API:: 1.1

Slouží k získání předpovědi na příštích 120 minut minutu po minutě v intervalech 1, 5 a 15 minut.

API Get Minute Forecast je požadavek HTTP GET , který vrací minutové předpovědi pro dané místo na příštích 120 minut. Uživatelé si mohou vyžádat 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), čas zahájení a hodnota intenzity srážek (dBZ). Další informace najdete v tématu Vyžádání dat předpovědi počasí minutu po minutě.

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

S volitelnými parametry:

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	JsonFormat	Požadovaný formát odpovědi Podporuje se pouze `json` formát.
api-version	query	True	string	Číslo verze rozhraní API služby 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říklad 47,641268–122,125679. Informace o počasí jsou obecně dostupné pro místa na pevnině, vodní plochy obklopené pevninou a oblasti oceánu, které jsou do přibližně 50 námořních mil od pobřeží.
interval	query		integer	Určuje časový interval v minutách pro vrácenou předpověď počasí. Podporované hodnoty jsou `1` - Načtení předpovědi na 1minutové intervaly. Vrátí se ve výchozím nastavení. `5` - Navíjejte předpovědi na 5minutové intervaly. `15` - Načítejte předpovědi na 15minutové intervaly.
language	query		string	Jazyk, ve kterém mají být vráceny výsledky hledání. Měla 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 dostupná, použije se výchozí jazyk. Podrobnosti najdete v podporovaných jazycích.

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 pro účet Azure Maps a dá se načíst z rozhraní API účtu roviny správy Azure Maps. Informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v následujících článcích s pokyny.

Odpovědi

Name	Typ	Description
200 OK	MinuteForecastResult	OK
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě.

Zabezpečení

AADToken

Jedná se o Microsoft Entra OAuth 2.0 Flow. Při spárování s přístupu na základě role Azure se dá řídit přístup k rozhraním REST API služby Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo více účtům prostředků Nebo dílčím prostředkům Azure Maps. 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 složené z jednoho nebo více oprávnění k rozhraním REST API služby Azure Maps.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování . Stručně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a rozsahy.

Poznámky

Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému prostředku Azure Maps aplikace žádá o přístup. Můžete ho získat z rozhraní API pro správu Maps.

Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné adresy URL autorizace a konfigurace MICROSOFT Entra ID. * Řízení přístupu na základě role Azure se konfiguruje z roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad AZURE SDK nebo rozhraní REST API. * Použití webové sady SDK služby Azure Maps umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

Další informace o platformě Microsoft Identity Platform najdete v tématu Přehled platformy Microsoft Identity Platform.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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 vytvoření účtu Azure Maps na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

Díky tomuto klíči má každá aplikace přístup ke všem rozhraní REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, ve který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat důvěrných klientských aplikací přístup k rozhraním REST API služby Azure Maps, aby bylo možné klíč bezpečně uložit.

Typ: apiKey
V: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace Vypsat SAS v prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure 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 Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze 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ů na prostředku účtu Map omezit zneužití vykreslování a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Successfully retrieve minute-by-minute forecasts for a given location

Ukázkový požadavek

HTTP

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Ukázková odpověď

Stavový kód:: 200

{
  "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
ColorValue
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ForecastInterval
IconCode	Číselná hodnota představující obrázek, který zobrazuje .`iconPhrase` Podrobnosti najdete v části Služby počasí v Azure Maps .
IntervalSummary
JsonFormat	Požadovaný formát odpovědi Podporuje se pouze `json` formát.
MinuteForecastResult
MinuteForecastSummary	Souhrny frází za celé prognózované období.
PrecipitationType	Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud dbz je nula, precipitationType není v odpovědi k dispozici.

ColorValue

Objekt

Name	Typ	Description
blue	integer (int32)	Modrá složka hodnoty RGB
green	integer (int32)	Zelená složka hodnoty RGB.
hex	string	Hexadecimální hodnota barvy.
red	integer (int32)	Červená složka hodnoty RGB.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ForecastInterval

Objekt

Name	Typ	Description
cloudCover	integer (int32)	Procento představující oblačnost.
color	ColorValue	Barva celého spektra, která se mapuje na dBZ (decibel vzhledem k Z). Pokud je dbz nula, barva není v odpovědi přítomna.
dbz	number (double)	Jednotka, která představuje předpokládanou intenzitu srážek.
iconCode	IconCode (int32)	Číselná hodnota představující obrázek, který zobrazuje .`iconPhrase` Podrobnosti najdete v části Služby počasí v Azure Maps .
minute	integer (int32)	První minuta pro přestávku.
precipitationType	PrecipitationType	Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud dbz je nula, precipitationType není v odpovědi k dispozici.
shortPhrase	string	Krátká fráze popisující srážkové podmínky pro daný interval.
simplifiedColor	ColorValue	Barva pásma, která se mapuje na typ srážek a prahovou hodnotu. Pokud je dbz nula, v odpovědi se nenachází.
startTime	string (date-time)	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, v odpovědi se nenachází.

IconCode

Výčet

Číselná hodnota představující obrázek, který zobrazuje .iconPhrase Podrobnosti najdete v části Služby počasí v Azure Maps .

Hodnota	Description
1	Slunečný
10
11	Mlha
12	Sprchy
13	Většinou zkažené se sprchami
14	Částečně slunečno se sprchami
15	Bouře
16	Většinou cloudy s bouřlivci
17	Částečně slunečno s bouřlivci
18	Déšť
19	Přívaly
2	Většinou Slunečno
20	Většinou Cloudy s Flurries
21	Částečně slunečno s Flurries
22	Sníh
23	Většinou mražený s sněhem
24	Led
25	Plískanice
26	Mražení deště
27
28
29	Déšť a sníh
3	Částečně slunečno
30	Horký
31	Chladný
32	Větrný
33	Jasný
34	Většinou vymazat
35	Částečně cloudy
36	Občasná oblačnost (noc)
37	Mlhavý měsíční svit
38	Převážně zataženo (noc)
39	Částečně zataženo se sprchami
4	Přerušované cloudy
40	Převážně zataženo s přeháňkami (noc)
41	Částečně zataženo s thunderstorms
42	Převážně zataženo s bouřkami (noc)
43	Převážně zataženo s bouřkami (noc)
44	Převážně zataženo se sněhem (noc)
5	Mlhavé sluneční světlo
6	Většinou Cloudy
7	Zamračený
8	Dreary (overcast)
9

IntervalSummary

Objekt

Name	Typ	Description
briefPhrase	string	Stručná shrnující fráze. Délka fráze je přibližně 60 znaků.
endMinute	integer (int32)	Poslední minuta, na kterou se souhrn vztahuje.
iconCode	IconCode (int32)	Číselná hodnota představující obrázek, který zobrazuje .`iconPhrase` Podrobnosti najdete v části Služby počasí v Azure Maps .
longPhrase	string	Dlouhá shrnující fráze. Délka fráze je 60+ znaků.
shortPhrase	string	Krátká shrnující fráze. Délka fráze je přibližně 25 znaků.
startMinute	integer (int32)	První minuta, na kterou se souhrn vztahuje.
totalMinutes	integer (int32)	Počet minut, po které souhrn platí.

JsonFormat

Výčet

Požadovaný formát odpovědi Podporuje se pouze json formát.

Hodnota	Description
json	formát výměny dat javascriptového objektu

MinuteForecastResult

Objekt

Name	Typ	Description
intervalSummaries	IntervalSummary[]	Souhrnné informace pro každý interval v prognóze. Souhrny rozdělují každý potenciální interval, ve kterém srážky začínají a končí.
intervals	ForecastInterval[]	Data předpovědi pro každý interval v prognóze.
summary	MinuteForecastSummary	Souhrny frází za celé prognózované období.

MinuteForecastSummary

Objekt

Souhrny frází za celé prognózované období.

Name	Typ	Description
briefPhrase	string	Souhrnná fráze na dalších 120 minut. Délka fráze je přibližně 60 znaků.
briefPhrase60	string	Souhrnná fráze na dalších 60 minut. Délka fráze je přibližně 60 znaků.
iconCode	IconCode (int32)	Číselná hodnota představující obrázek, který zobrazuje .`iconPhrase` Podrobnosti najdete v části Služby počasí v Azure Maps .
longPhrase	string	Dlouhá shrnující fráze na dalších 120 minut. Délka fráze je 60+ znaků.
shortPhrase	string	Krátká souhrnná fráze na dalších 120 minut. Délka fráze je přibližně 25 znaků.

PrecipitationType

Výčet

Určuje typ srážek ("Déšť", "Sníh", "Led" nebo "Mix"). Pokud dbz je nula, precipitationType není v odpovědi k dispozici.

Hodnota	Description
Ice	Led
Mix	Míchat
Rain	Déšť
Snow	Sníh

Sdílet prostřednictvím

Weather - Get Minute Forecast

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

AADToken

Poznámky

Rozsahy

subscription-key

SAS Token

Příklady

Successfully retrieve minute-by-minute forecasts for a given location

Ukázkový požadavek

Ukázková odpověď

Definice

ColorValue

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForecastInterval

IconCode

IntervalSummary

JsonFormat

MinuteForecastResult

MinuteForecastSummary

PrecipitationType