Weather - Get Tropical Storm Locations
Pomocí můžete získat polohu tropických bouří od jednotlivých národních agentur pro předpověď počasí.
Rozhraní Get Tropical Storm Locations
API je požadavek HTTP GET
, který vrací umístění jednotlivých tropických bouří vystavených vládou. Informace o tropických bouřích zahrnují souřadnice umístění, geometrii, ID kotliny, datum, podrobnosti o větru a poloměry větru.
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&details={details}&radiiGeometry={radiiGeometry}&unit={unit}¤t={current}
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 služby Azure Maps |
basin
|
query | True |
Identifikátor umyvadla |
|
gov
|
query | True |
integer int32 |
ID stormu pro státní správu |
year
|
query | True |
integer int32 |
Rok cyklonu(ů) |
current
|
query |
boolean |
Pokud je hodnota true, vrátí aktuální umístění bouře. |
|
details
|
query |
boolean |
V případě hodnoty true jsou v odpovědi zahrnuta souhrnná data o poloměrech větru. |
|
radii
|
query |
boolean |
V případě hodnoty true jsou v odpovědi zahrnuta souhrnná data o poloměrech větru a podrobnosti geoJSON. |
|
unit
|
query |
Určuje, že se mají vracet data v metrických nebo imperiálních jednotkách. 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 je možné ho načíst z rozhraní API účtu roviny správy Služby Azure Maps. Informace o použití zabezpečení Microsoft Entra ID v Azure Maps 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 toky Microsoft Entra 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 rozhraním Azure Maps REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika úč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 několika oprávnění k rozhraním REST API služby Azure Maps.
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 pro konkrétní rozhraní API a obory.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení prostředku Azure Maps, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
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 webu 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 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 vytváření účtu Azure Maps na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem může každá aplikace přistupovat ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve kterému je vystavený.
U veřejně vystavených aplikací doporučujeme pro přístup k rozhraním Rest API služby Azure Maps použít přístup k důvěrným klientským aplikacím , aby se váš klíč mohl 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 List SAS prostředku Azure Maps prostřednictvím roviny správy Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečený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 účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.
Typ:
apiKey
V:
header
Příklady
Get Tropical Storm Current Location |
Get Tropical Storm Locations |
Get Tropical Storm Current Location
Ukázkový požadavek
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=2¤t=True
Ukázková odpověď
{
"results": [
{
"dateTime": "2021-04-24T18:00:00+00:00",
"location": {
"latitude": 21.7,
"longitude": 134.1
},
"maxWindGust": {
"value": 92.6,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 115,
"localizedDescription": "ESE"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
}
]
}
Get Tropical Storm Locations
Ukázkový požadavek
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=1
Ukázková odpověď
{
"results": [
{
"dateTime": "2021-02-22T00:00:00+00:00",
"location": {
"latitude": 10.4,
"longitude": 125.7
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 305,
"localizedDescription": "NW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-21T18:00:00+00:00",
"location": {
"latitude": 10.2,
"longitude": 125.9
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 300,
"localizedDescription": "WNW"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-21T12:00:00+00:00",
"location": {
"latitude": 10.3,
"longitude": 125.8
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 300,
"localizedDescription": "WNW"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-19T06:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 129.8
},
"maxWindGust": {
"value": 101.9,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 18.5,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-19T00:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 131.2
},
"maxWindGust": {
"value": 101.9,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 7.4,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T18:00:00+00:00",
"location": {
"latitude": 7.2,
"longitude": 131.7
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 3.7,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T12:00:00+00:00",
"location": {
"latitude": 7.3,
"longitude": 131.8
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 5.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T06:00:00+00:00",
"location": {
"latitude": 7.3,
"longitude": 132.1
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 305,
"localizedDescription": "NW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-18T00:00:00+00:00",
"location": {
"latitude": 7,
"longitude": 132.6
},
"maxWindGust": {
"value": 83.3,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 290,
"localizedDescription": "WNW"
},
"speed": {
"value": 5.6,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Storm"
},
{
"dateTime": "2021-02-17T18:00:00+00:00",
"location": {
"latitude": 7,
"longitude": 132.7
},
"maxWindGust": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 55.6,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 290,
"localizedDescription": "WNW"
},
"speed": {
"value": 9.3,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-17T12:00:00+00:00",
"location": {
"latitude": 6.8,
"longitude": 132.4
},
"maxWindGust": {
"value": 74.1,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 55.6,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 285,
"localizedDescription": "WNW"
},
"speed": {
"value": 13,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
},
{
"dateTime": "2021-02-17T06:00:00+00:00",
"location": {
"latitude": 6.6,
"longitude": 133.1
},
"maxWindGust": {
"value": 64.8,
"unit": "km/h",
"unitType": 7
},
"sustainedWind": {
"value": 46.3,
"unit": "km/h",
"unitType": 7
},
"movement": {
"direction": {
"degrees": 270,
"localizedDescription": "W"
},
"speed": {
"value": 22.2,
"unit": "km/h",
"unitType": 7
}
},
"status": "Tropical Depression"
}
]
}
Definice
Name | Description |
---|---|
basin |
Identifikátor pánve |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Odpověď na chybu |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Json |
Požadovaný formát odpovědi. Podporuje se pouze |
Lat |
Umístění reprezentované jako zeměpisná šířka a délka. |
Radius |
Ložisko 0–90 = NE kvadrant; 90–180 = SE kvadrant; 180–270 = SW kvadrant; 270–360 = NW kvadrant. |
Storm |
Místo pro jednotlivé bouře vydané vládou |
Storm |
Umístění jednotlivých vládou vydaných bouří |
Storm |
Zobrazí se, když v požadavku details=true nebo radiiGeometry=true. |
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 buď v jednotkách metrik, nebo v jednotkách impéria. 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 |
basinId
Identifikátor pánve
Name | Typ | Description |
---|---|---|
AL |
string |
Atlantik |
CP |
string |
Střední Tichomoří |
EP |
string |
Východní Tichomoří |
NI |
string |
Severní Indický oceán |
NP |
string |
Severozápadní Tichomoří |
SI |
string |
Jihozápad Indického oceánu |
SP |
string |
Jižní Tichomoří |
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. |
GeoJsonGeometry
Platný GeoJSON
objekt geometrie. Typ musí být jeden ze sedmi platných typů geometrie GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon a GeometryCollection. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
type |
Geo |
Určuje |
GeoJsonGeometryCollection
Platný GeoJSON GeometryCollection
typ objektu. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Obsahuje seznam platných |
type |
string:
Geometry |
Určuje |
GeoJsonLineString
Platný GeoJSON LineString
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Line |
Určuje |
GeoJsonMultiLineString
Platný GeoJSON MultiLineString
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Multi |
Určuje |
GeoJsonMultiPoint
Platný GeoJSON MultiPoint
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Souřadnice |
type |
string:
Multi |
Určuje |
GeoJsonMultiPolygon
Platný GeoJSON MultiPolygon
typ objektu. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Obsahuje seznam platných |
type |
string:
Multi |
Určuje |
GeoJsonPoint
Platný GeoJSON Point
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
A |
type |
string:
Point |
Určuje |
GeoJsonPolygon
Platný GeoJSON Polygon
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Souřadnice typu |
type |
string:
Polygon |
Určuje |
JsonFormat
Požadovaný formát odpovědi. Podporuje se pouze json
formát.
Name | Typ | Description |
---|---|---|
json |
string |
LatLongPair
Umístění reprezentované jako zeměpisná šířka a délka.
Name | Typ | Description |
---|---|---|
latitude |
number |
Vlastnost Zeměpisná šířka |
longitude |
number |
Zeměpisná délka – vlastnost |
RadiusSector
Ložisko 0–90 = NE kvadrant; 90–180 = SE kvadrant; 180–270 = SW kvadrant; 270–360 = NW kvadrant.
Name | Typ | Description |
---|---|---|
beginBearing |
number |
Ložisko ve stupních začátku kvadrantu. |
endBearing |
number |
Ložisko ve stupních konce kvadrantu. |
range |
number |
Poloměr kvadrantu v námořních mílích. |
StormLocation
Místo pro jednotlivé bouře vydané vládou
Name | Typ | Description |
---|---|---|
dateTime |
string |
Datum a čas, kdy je prognóza platná a zobrazuje se ve formátu ISO8601. |
hasTropicalPotential |
boolean |
Pravda, když se bouře může stát tropickým systémem. |
isPostTropical |
boolean |
Pravda, když bouře slábne a už se nebude stát tropickým systémem. |
isSubtropical |
boolean |
Platí, když je deprese klasifikována jako subtropický cyklón. |
location |
Souřadnice bouře |
|
maxWindGust |
Maximální rychlost nárazů větru spojená s bouří. Může mít hodnotu NULL. |
|
minimumPressure |
Minimální tlak spojený s bouří. Může mít hodnotu NULL. |
|
movement |
Informace o pohybu bouře. |
|
status |
string |
Stav stormu v angličtině. |
sustainedWind |
Maximální trvalá rychlost větru spojená s bouří. Může mít hodnotu NULL. |
|
windRadiiSummary |
Zobrazí se, když v požadavku details=true nebo radiiGeometry=true. |
StormLocationsResult
Umístění jednotlivých vládou vydaných bouří
Name | Typ | Description |
---|---|---|
nextLink |
string |
Je odkaz na další stránku vrácených funkcí. Pokud je to poslední stránka, toto pole není. |
results |
Umístění jednotlivých vládou vydaných bouří |
StormWindRadiiSummary
Zobrazí se, když v požadavku details=true nebo radiiGeometry=true.
Name | Typ | Description |
---|---|---|
dateTime |
string |
DateTime, pro který jsou platná souhrnná data poloměrů větru, zobrazená ve formátu ISO8601. |
radiiGeometry | GeoJsonGeometry: |
Objekt GeoJSON. Zobrazí se při radiiGeometry=true v požadavku. Popisuje obrys kvadrantů poloměru větru. |
radiusSectorData |
Obsahuje informace potřebné k vykreslení kvadrantů poloměru větru. Ložisko 0–90 = NE kvadrant; 90–180 = SE kvadrant; 180–270 = SW kvadrant; 270–360 = NW kvadrant. |
|
windSpeed |
Rychlost větru přidružená k radiusSectorData. |
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 buď v jednotkách metrik, nebo v jednotkách impéria. 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 jednotkách metrik. Mezi příklady jednotek metrické soustavy patří Celsia a kilometr. |
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 tématu Služby počasí v Azure Maps . |
|
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. |