Weather - Get Tropical Storm Locations
Az egyes országos időjárás-előrejelzési ügynökségektől származó trópusi viharok helyének lekéréséhez használható.
Az Get Tropical Storm Locations
API egy HTTP-kérés GET
, amely az egyes kormányzati trópusi viharok helyét adja vissza. A trópusi viharokkal kapcsolatos információk közé tartoznak a földrajzi koordináták, a geometria, a medence azonosítója, a dátum, a szél részletei és a szél sugarai.
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}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
format
|
path | True |
A válasz kívánt formátuma. Csak |
|
api-version
|
query | True |
string |
Az Azure Maps API verziószáma. |
basin
|
query | True |
Medence azonosítója |
|
gov
|
query | True |
integer int32 |
Kormányzati vihar azonosítója |
year
|
query | True |
integer int32 |
A ciklon(ok) éve |
current
|
query |
boolean |
Ha igaz, adja vissza az aktuális viharhelyet |
|
details
|
query |
boolean |
Ha igaz, a szélsugár összegző adatai szerepelnek a válaszban |
|
radii
|
query |
boolean |
Ha igaz, a szélsugár összegző adatai és a geoJSON részletei szerepelnek a válaszban |
|
unit
|
query |
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 használatban a Microsoft Entra ID biztonsági modellel együtt. Az Azure Maps-fiók egyedi azonosítóját jelöli, és lekérhető az Azure Maps felügyeleti síkjának Fiók API-jából. A Microsoft Entra ID-biztonság Azure Mapsben való használatához tekintse meg az alábbi cikkeket . |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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 szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. 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 Azure Maps REST API-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ások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.
Jegyzetek
- Ez a biztonsági definíció megköveteli a fejléc használatát
x-ms-client-id
annak jelzéséhez, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.
Ez Authorization URL
az Azure nyilvános felhőpéldányára jellemző. 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 az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.
* Az 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ásplatformról további információt a Microsoft identitásplatform áttekintése című témakörben talál.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
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 Azure Maps-fiókot hoz létre az Azure Portalon, 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 javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével érje el az Azure Maps REST API-kat, hogy a kulcs biztonságosan tárolható legyen.
Típus:
apiKey
In:
query
SAS Token
Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázási műveletéből jön létre az Azure Felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.
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.
Típus:
apiKey
In:
header
Példák
Get Tropical Storm Current Location |
Get Tropical Storm Locations |
Get Tropical Storm Current Location
Mintakérelem
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=2¤t=True
Mintaválasz
{
"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
Mintakérelem
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=1
Mintaválasz
{
"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"
}
]
}
Definíciók
Name | Description |
---|---|
basin |
Medence azonosítója |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Geo |
Érvényes |
Json |
A válasz kívánt formátuma. Csak |
Lat |
Földrajzi szélességként és hosszúságként megadott hely. |
Radius |
Csapágy 0–90 = NE kvadráns; 90–180 = SE negyed; 180–270 = SW negyed; 270–360 = NW negyed. |
Storm |
Az egyes kormányzati viharok helye |
Storm |
Az egyes kormányzati viharok helyszínei |
Storm |
Akkor jelenik meg, ha details=true vagy radiiGeometry=true a kérelemben. |
Unit |
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 a Weather Servicest az Azure Mapsben . |
Weather |
Megadja, hogy az adatokat metrikaegységekben vagy angolszász egységekben adja vissza. Az alapértelmezett érték a metrika. |
Weather |
Adott egység adott, időjárással kapcsolatos értéke. |
Wind |
A szél részletei, beleértve a sebességet és az irányt. |
Wind |
Szélirány |
basinId
Medence azonosítója
Name | Típus | Description |
---|---|---|
AL |
string |
Atlanti |
CP |
string |
Csendes-óceán középső régiója |
EP |
string |
Csendes-óceán keleti régiója |
NI |
string |
Észak-Indiai-óceán |
NP |
string |
Északnyugati Csendes-óceán |
SI |
string |
Délnyugat-Indiai-óceán |
SP |
string |
Dél-Csendes-óceán |
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 információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
GeoJsonGeometry
Érvényes GeoJSON
geometriai objektum. A típusnak a hét érvényes GeoJSON-geometriatípus egyikének kell lennie : Pont, MultiPoint, Vonallánc, MultiLineString, Polygon, MultiPolygon és GeometryCollection. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
type |
Geo |
Megadja a típust |
GeoJsonGeometryCollection
Érvényes GeoJSON GeometryCollection
objektumtípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Érvényes geometriai objektumok listáját |
type |
string:
Geometry |
Megadja a típust |
GeoJsonLineString
Érvényes GeoJSON LineString
geometriatípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
A geometria koordinátái |
type |
string:
Line |
Megadja a típust |
GeoJsonMultiLineString
Érvényes GeoJSON MultiLineString
geometriatípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
A geometria koordinátái |
type |
string:
Multi |
Megadja a típust |
GeoJsonMultiPoint
Érvényes GeoJSON MultiPoint
geometriatípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
A geometria koordinátái |
type |
string:
Multi |
Megadja a típust |
GeoJsonMultiPolygon
Érvényes GeoJSON MultiPolygon
objektumtípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
Az érvényes |
type |
string:
Multi |
Megadja a típust |
GeoJsonPoint
Érvényes GeoJSON Point
geometriatípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
Az A |
type |
string:
Point |
Megadja a típust |
GeoJsonPolygon
Érvényes GeoJSON Polygon
geometriatípus. A részletekért tekintse meg az RFC 7946-ot .
Name | Típus | Description |
---|---|---|
coordinates |
number[] |
A geometriatípus koordinátái |
type |
string:
Polygon |
Megadja a típust |
JsonFormat
A válasz kívánt formátuma. Csak json
a formátum támogatott.
Name | Típus | Description |
---|---|---|
json |
string |
LatLongPair
Földrajzi szélességként és hosszúságként megadott hely.
Name | Típus | Description |
---|---|---|
latitude |
number |
Latitude tulajdonság |
longitude |
number |
Hosszúság tulajdonság |
RadiusSector
Csapágy 0–90 = NE kvadráns; 90–180 = SE negyed; 180–270 = SW negyed; 270–360 = NW negyed.
Name | Típus | Description |
---|---|---|
beginBearing |
number |
A kvadráns elejét fokban csapágyazva. |
endBearing |
number |
A kvadráns végének fokban csapágyazva. |
range |
number |
A kvadráns sugara, tengeri mérföldben. |
StormLocation
Az egyes kormányzati viharok helye
Name | Típus | Description |
---|---|---|
dateTime |
string |
Az előrejelzés érvényes dátumideje, ISO8601 formátumban jelenik meg. |
hasTropicalPotential |
boolean |
Igaz, amikor vihar alakulhat ki egy trópusi rendszer. |
isPostTropical |
boolean |
Igaz, amikor a vihar elgyengül, és többé nem lesz trópusi rendszer. |
isSubtropical |
boolean |
Igaz, ha a depressziót szubtrópusi ciklonként sorolják be. |
location |
A vihar koordinátái |
|
maxWindGust |
A viharhoz kapcsolódó maximális széllökés sebesség. Lehet, hogy NULL értékű. |
|
minimumPressure |
A viharhoz kapcsolódó minimális nyomás. Lehet, hogy NULL értékű. |
|
movement |
A vihar mozgási információi. |
|
status |
string |
Storm állapot, angol nyelven. |
sustainedWind |
A viharhoz kapcsolódó maximális tartós szélsebesség. Lehet, hogy NULL értékű. |
|
windRadiiSummary |
Akkor jelenik meg, ha details=true vagy radiiGeometry=true a kérelemben. |
StormLocationsResult
Az egyes kormányzati viharok helyszínei
Name | Típus | Description |
---|---|---|
nextLink |
string |
Az a hivatkozás, amely a visszaadott funkciók következő oldalára mutató hivatkozás. Ha ez az utolsó oldal, akkor nem ez a mező. |
results |
Az egyes kormányzati viharok helyszínei |
StormWindRadiiSummary
Akkor jelenik meg, ha details=true vagy radiiGeometry=true a kérelemben.
Name | Típus | Description |
---|---|---|
dateTime |
string |
DateTime, amelynél a szélsugár összegzési adatai érvényesek, ISO8601 formátumban jelennek meg. |
radiiGeometry | GeoJsonGeometry: |
GeoJSON-objektum. A radiiGeometry=true kéréskor jelenik meg. A szélsugár-kvadránsok körvonalát ismerteti. |
radiusSectorData |
A szélsugár-kvadránsok ábrázolásához szükséges információkat tartalmazza. Csapágy 0–90 = NE kvadráns; 90–180 = SE negyed; 180–270 = SW negyed; 270–360 = NW negyed. |
|
windSpeed |
A radiusSectorData-hoz társított szélsebesség. |
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 a Weather Servicest az Azure Mapsben .
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
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 |
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 a Weather Servicest az Azure Mapsben . |
|
value |
number |
Kerekített érték. |
WindDetails
A szél részletei, beleértve a sebességet és az irányt.
Name | Típus | Description |
---|---|---|
direction |
Szélirány |
|
speed |
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, az igaz északi iránytól kezdve és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugaton 270 fok. Lehetséges értékek: 0-359. |
localizedDescription |
string |
Irány rövidítése a megadott nyelven. |