Weather - Get Tropical Storm Locations
Gebruik om de locatie van tropische stormen op te halen van afzonderlijke nationale weersvoorspellingsbureaus.
De Get Tropical Storm Locations
API is een HTTP-aanvraag GET
die de locatie van afzonderlijke door de overheid uitgegeven tropische stormen retourneert. Informatie over de tropische stormen omvat, locatiecoördinaten, geometrie, bekken-ID, datum, winddetails en windstralen.
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-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
format
|
path | True |
Gewenste indeling van het antwoord. Alleen |
|
api-version
|
query | True |
string |
Versienummer van Azure Maps-API. |
basin
|
query | True |
Bekken-id |
|
gov
|
query | True |
integer int32 |
Storm-id van de overheid |
year
|
query | True |
integer int32 |
Jaar van de cycloon(s) |
current
|
query |
boolean |
Als dit waar is, retourneert u de huidige stormlocatie |
|
details
|
query |
boolean |
Als dit waar is, worden de samenvattingsgegevens van windstralen opgenomen in het antwoord |
|
radii
|
query |
boolean |
Indien waar, worden samenvattingsgegevens van windradii en geoJSON-details opgenomen in het antwoord |
|
unit
|
query |
Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde. |
Aanvraagkoptekst
Name | Vereist | Type | Description |
---|---|---|---|
x-ms-client-id |
string |
Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps-beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps wilt gebruiken, raadpleegt u de volgende artikelen voor hulp. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Er is een onverwachte fout opgetreden. |
Beveiliging
AADToken
Dit zijn de Microsoft Entra OAuth 2.0-stromen . Wanneer het wordt gekoppeld met op rollen gebaseerd toegangsbeheer van Azure , kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.
Voor het implementeren van scenario's raden we u aan verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.
Notities
- Voor deze beveiligingsdefinitie is het gebruik van de
x-ms-client-id
header vereist om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen via de Kaarten-beheer-API .
De Authorization URL
is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties.
* Op rollen gebaseerd toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
* Gebruik van de Azure Maps Web SDK maakt het mogelijk om een toepassing op basis van configuraties in te stellen voor meerdere gebruiksvoorbeelden.
- Zie Overzicht van Microsoft Identity Platform voor meer informatie over Microsoft Identity Platform.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Dit is een gedeelde sleutel die wordt ingericht wanneer u een Azure Maps-account maakt in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.
Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze zijn uitgegeven.
Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om de benadering van vertrouwelijke clienttoepassingen te gebruiken voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.
Type:
apiKey
In:
query
SAS Token
Dit is een Shared Access Signature-token dat is gemaakt op basis van de SAS-bewerking List op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
Met dit token is elke toepassing gemachtigd om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle tot de vervaldatum, frequentie en gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.
Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane origins te configureren voor de resource van het kaartaccount om misbruik van rendering te beperken en het SAS-token regelmatig te vernieuwen.
Type:
apiKey
In:
header
Voorbeelden
Get Tropical Storm Current Location |
Get Tropical Storm Locations |
Get Tropical Storm Current Location
Voorbeeldaanvraag
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=2¤t=True
Voorbeeldrespons
{
"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
Voorbeeldaanvraag
GET https://atlas.microsoft.com/weather/tropical/storms/locations/json?api-version=1.1&year=2021&basinId=NP&govId=1
Voorbeeldrespons
{
"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"
}
]
}
Definities
Name | Description |
---|---|
basin |
Bekken-id |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Geo |
Een geldig |
Json |
Gewenste indeling van het antwoord. Alleen |
Lat |
Een locatie die wordt weergegeven als een breedtegraad en lengtegraad. |
Radius |
Dragend 0-90 = NE kwadrant; 90-180 = KWAdrant SE; 180–270 = ZW-kwadrant; 270–360 = NW kwadrant. |
Storm |
Locatie voor een afzonderlijke door de overheid uitgegeven storm |
Storm |
Locaties voor een afzonderlijke door de overheid uitgegeven storm |
Storm |
Weergegeven wanneer details=true of radiiGeometry=true in de aanvraag. |
Unit |
Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie. |
Weather |
Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde. |
Weather |
Specifieke waarde van een bepaalde eenheid met betrekking tot het weer. |
Wind |
Winddetails die worden geretourneerd, inclusief snelheid en richting. |
Wind |
Windrichting |
basinId
Bekken-id
Name | Type | Description |
---|---|---|
AL |
string |
Atlantisch |
CP |
string |
Centraal-Pacific |
EP |
string |
Oostelijke Stille Oceaan |
NI |
string |
Noord-Indische Oceaan |
NP |
string |
Noordwest-Pacific |
SI |
string |
Zuidwestelijke Indische Oceaan |
SP |
string |
Australië en Oceanië |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het type aanvullende informatie. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
GeoJsonGeometry
Een geldig GeoJSON
geometrieobject. Het type moet een van de zeven geldige GeoJSON-geometrietypen zijn: Punt, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon en GeometryCollection. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
type |
Geo |
Hiermee geeft u het |
GeoJsonGeometryCollection
Een geldig GeoJSON GeometryCollection
objecttype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Bevat een lijst met geldige |
type |
string:
Geometry |
Hiermee geeft u het |
GeoJsonLineString
Een geldig GeoJSON LineString
geometrietype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
Coördinaten voor de |
type |
string:
Line |
Hiermee geeft u het |
GeoJsonMultiLineString
Een geldig GeoJSON MultiLineString
geometrietype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
Coördinaten voor de |
type |
string:
Multi |
Hiermee geeft u het |
GeoJsonMultiPoint
Een geldig GeoJSON MultiPoint
geometrietype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
Coördinaten voor de |
type |
string:
Multi |
Hiermee geeft u het |
GeoJsonMultiPolygon
Een geldig GeoJSON MultiPolygon
objecttype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
Bevat een lijst met geldige |
type |
string:
Multi |
Hiermee geeft u het |
GeoJsonPoint
Een geldig GeoJSON Point
geometrietype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
A |
type |
string:
Point |
Hiermee geeft u het |
GeoJsonPolygon
Een geldig GeoJSON Polygon
geometrietype. Raadpleeg RFC 7946 voor meer informatie.
Name | Type | Description |
---|---|---|
coordinates |
number[] |
Coördinaten voor het |
type |
string:
Polygon |
Hiermee geeft u het |
JsonFormat
Gewenste indeling van het antwoord. Alleen json
de indeling wordt ondersteund.
Name | Type | Description |
---|---|---|
json |
string |
LatLongPair
Een locatie die wordt weergegeven als een breedtegraad en lengtegraad.
Name | Type | Description |
---|---|---|
latitude |
number |
De eigenschap Breedtegraad |
longitude |
number |
De eigenschap Lengtegraad |
RadiusSector
Dragend 0-90 = NE kwadrant; 90-180 = KWAdrant SE; 180–270 = ZW-kwadrant; 270–360 = NW kwadrant.
Name | Type | Description |
---|---|---|
beginBearing |
number |
Het dragen, in graden, van het begin van het kwadrant. |
endBearing |
number |
Het dragen, in graden, van het einde van het kwadrant. |
range |
number |
De straal van het kwadrant, in zeemijlen. |
StormLocation
Locatie voor een afzonderlijke door de overheid uitgegeven storm
Name | Type | Description |
---|---|---|
dateTime |
string |
De datum/tijd waarop de prognose geldig is, wordt weergegeven in ISO8601 indeling. |
hasTropicalPotential |
boolean |
Waar wanneer storm zich kan ontwikkelen tot een tropisch systeem. |
isPostTropical |
boolean |
Het is waar wanneer de storm afzwakt en niet langer een tropisch systeem wordt. |
isSubtropical |
boolean |
Waar wanneer de depressie wordt geclassificeerd als een subtropische cycloon. |
location |
Coördinaten van de storm |
|
maxWindGust |
Maximale windvlaagsnelheid die verband houdt met de storm. Kan NULL zijn. |
|
minimumPressure |
Minimale druk die aan de storm is gekoppeld. Kan NULL zijn. |
|
movement |
De informatie over stormverplaatsing. |
|
status |
string |
Stormstatus, in het Engels. |
sustainedWind |
Maximale aanhoudende windsnelheid in verband met de storm. Kan NULL zijn. |
|
windRadiiSummary |
Weergegeven wanneer details=true of radiiGeometry=true in de aanvraag. |
StormLocationsResult
Locaties voor een afzonderlijke door de overheid uitgegeven storm
Name | Type | Description |
---|---|---|
nextLink |
string |
De is de koppeling naar de volgende pagina van de geretourneerde functies. Als het de laatste pagina is, geen dit veld. |
results |
Locaties voor een afzonderlijke door de overheid uitgegeven storm |
StormWindRadiiSummary
Weergegeven wanneer details=true of radiiGeometry=true in de aanvraag.
Name | Type | Description |
---|---|---|
dateTime |
string |
Datum/tijd waarvoor de samenvattingsgegevens van de windstralen geldig zijn, weergegeven in ISO8601-indeling. |
radiiGeometry | GeoJsonGeometry: |
GeoJSON-object. Weergegeven wanneer radiiGeometry=true in aanvraag. Beschrijft de omtrek van de kwadranten van de windstraal. |
radiusSectorData |
Bevat de informatie die nodig is om kwadranten van windradius uit te tekenen. Dragend 0-90 = NE kwadrant; 90-180 = KWAdrant SE; 180–270 = ZW-kwadrant; 270–360 = NW kwadrant. |
|
windSpeed |
Windsnelheid die is gekoppeld aan de radiusSectorData. |
UnitType
Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie.
Name | Type | 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
Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde.
Name | Type | Description |
---|---|---|
imperial |
string |
Gegevens retourneren in keizerlijke eenheden. Enkele voorbeelden van keizerlijke systeem zijn Fahrenheit en mijl. |
metric |
string |
Gegevens retourneren in metrische eenheden. Enkele voorbeeldeenheden van een metriek systeem zijn Celsius en kilometer. |
WeatherUnit
Specifieke waarde van een bepaalde eenheid met betrekking tot het weer.
Name | Type | Description |
---|---|---|
unit |
string |
Type eenheid voor de geretourneerde waarde. |
unitType |
Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie. |
|
value |
number |
Afgeronde waarde. |
WindDetails
Winddetails die worden geretourneerd, inclusief snelheid en richting.
Name | Type | Description |
---|---|---|
direction |
Windrichting |
|
speed |
Snelheid van de wind in opgegeven eenheid. |
WindDirection
Windrichting
Name | Type | Description |
---|---|---|
degrees |
integer |
Windrichting in Azimuth graden, beginnend bij het ware noorden en doorgaand in rechtsom. Noord is 0 graden, oost is 90 graden, zuid 180 graden, west 270 graden. Mogelijke waarden 0-359. |
localizedDescription |
string |
Richting afkorting in de opgegeven taal. |