Weather - Get Tropical Storm Forecast

Dienst:: Maps

API-Version:: 1.1

Verwenden Sie diese Option, um eine Liste der tropischen Stürme abzurufen, die von nationalen Wettervorhersageagenturen vorhergesagt wurden.
Bei der Get Tropical Storm Forecasts API handelt es sich um eine HTTP-Anforderung GET , die einzelne von der Regierung herausgegebene Vorhersagen für tropische Stürme zurückgibt. Zu den Informationen über die vorhergesagten tropischen Stürme gehören Standort, Status, Datum der Erstellung der Vorhersage, Fenster, Windgeschwindigkeit und Windradien.

GET {endpoint}/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}

Mit optionalen Parametern:

GET {endpoint}/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}&unit={unit}&details={details}&radiiGeometry={radiiGeometry}&windowGeometry={windowGeometry}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string
format	path	True	JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
basinId	query	True	BasinId	Die `basinId` Enumeration kategorisiert die verschiedenen Ozeanbecken, in denen tropische Stürme entstehen können. Jedem Becken wird eine eindeutige Kennung zugewiesen, mit der der Ort des Ursprungs des Sturms angegeben werden kann.
govId	query	True	integer (int32)	Sturm-ID der Regierung
year	query	True	integer (int32)	Jahr des Zyklons/der Zyklone
details	query		boolean	Wenn true, sind die Zusammenfassungsdaten der Windradien in der Antwort enthalten
radiiGeometry	query		boolean	Bei true sind die Zusammenfassungsdaten der Windradien und die geoJSON-Details in der Antwort enthalten
unit	query		WeatherDataUnit	Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.
windowGeometry	query		boolean	Bei true sind Fenstergeometriedaten (geoJSON) in der Antwort enthalten

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt das Konto an, das für die Nutzung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann aus der Azure Maps Management-Plane-Konto-API abgerufen werden. Weitere Informationen zur Nutzung Microsoft Entra ID Sicherheit in Azure Maps finden Sie unter Authentifizierung verwalten in Azure Maps.

Antworten

Name	Typ	Beschreibung
200 OK	StormForecastResult	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

AadToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. In Kombination mit Azure rollenbasierten Zugriffs Steuerung kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Azure-rollenbasierte Zugriffskontrollen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jeder Benutzer, jede Gruppe oder jeder Service-Principal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle erhalten, die aus einer oder mehreren Berechtigungen besteht, REST-APIs zu Azure Maps.\n\nUm Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepte anzusehen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zur Modellierung von Anwendungen über Objekte, die Zugriff auf spezifische APIs und Scopes ermöglichen.\n\n#### Anmerkungen\n* Diese Sicherheitsdefinition re die Verwendung des x-ms-client-id Headers, um anzuzeigen, auf welche Azure Maps Ressource die Anwendung Zugriff bittet. Dies kann über die Maps Management API erworben werden.\n* \nDas Authorization URL ist spezifisch für die Azure Public Cloud-Instanz. Souveräne Clouds verfügen über einzigartige Autorisierungs-URLs und Microsoft Entra ID-Konfigurationen. \n* \nDie Azure rollenbasierte Zugriffskontrolle wird von der Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.\n* \nNutzung der Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.\n* Für weitere Informationen zu Microsoft Identity Platform siehe Microsoft Identity Platform Übersicht.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://atlas.microsoft.com/.default

subscription-key

Dies ist ein gemeinsamer Schlüssel, der bereitgestellt wird, wenn Sie ein Azure Maps Konto im Azure Portal oder mit PowerShell, CLI, Azure SDKs oder REST API erstellen.\n\n Mit diesem Schlüssel kann jede Anwendung auf alle REST-APIs zugreifen. Mit anderen Worten: Dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgegeben werden.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, den Ansatz confidential Client Applications zu verwenden, um auf Azure Maps REST-APIs zuzugreifen, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: header

SAS Token

Dies ist ein Shared-Access-Signaturtoken, das aus der List SAS-Operation auf der Azure Maps Ressource über die Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.\n\n Mit diesem Token ist jede Anwendung autorisiert, mit Azure rollenbasierte Zugriffskontrollen und feine Kontrolle über Ablauf, Rate und Nutzungsregion des jeweiligen Tokens. Mit anderen Worten: Der SAS-Token kann verwendet werden, um Anwendungen die Zugriffskontrolle auf sicherere Weise als der gemeinsame Schlüssel zu ermöglichen.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, eine spezielle Liste erlaubter Ursprünge auf der Map-Konto-Ressource zu konfigurieren, um Rendering-Missbrauch zu begrenzen, und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Get Tropical Storm Forecasts

Beispielanforderung

HTTP

GET {endpoint}/weather/tropical/storms/forecasts/json?api-version=1.1&year=2021&basinId=NP&govId=2

Beispiel für eine Antwort

Statuscode:: 200

{
  "results": [
    {
      "dateTime": "2021-04-25T06:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 22,
        "longitude": 137.8
      },
      "maxWindGust": {
        "unit": "km/h",
        "unitType": 7,
        "value": 92.6
      },
      "status": "Tropical Storm",
      "sustainedWind": {
        "unit": "km/h",
        "unitType": 7,
        "value": 74.1
      },
      "window": {
        "left": {
          "latitude": 22.56387,
          "longitude": 137.739517
        },
        "right": {
          "latitude": 21.4361,
          "longitude": 137.860489
        }
      }
    },
    {
      "dateTime": "2021-04-25T18:00:00+00:00",
      "initializedDateTime": "2021-04-24T18:00:00+00:00",
      "location": {
        "latitude": 23.7,
        "longitude": 142.4
      },
      "maxWindGust": {
        "unit": "km/h",
        "unitType": 7,
        "value": 92.6
      },
      "status": "Tropical Storm",
      "sustainedWind": {
        "unit": "km/h",
        "unitType": 7,
        "value": 74.1
      },
      "window": {
        "left": {
          "latitude": 24.45283,
          "longitude": 142.055313
        },
        "right": {
          "latitude": 22.94641,
          "longitude": 142.744675
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
BasinId	Beckenkennzeichen für tropische Stürme.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
GeoJsonGeometryCollection	Ein gültiger `GeoJSON GeometryCollection` Objekttyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonLineString	Ein gültiger `GeoJSON LineString` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonMultiLineString	Ein gültiger `GeoJSON MultiLineString` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonMultiPoint	Ein gültiger `GeoJSON MultiPoint` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonMultiPolygon	Ein gültiger `GeoJSON MultiPolygon` Objekttyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonObjectType	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.
GeoJsonPoint	Ein gültiger `GeoJSON Point` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
GeoJsonPolygon	Ein gültiger `GeoJSON Polygon` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
LatLongPair	Ein Ort, der als Breiten- und Längengrad dargestellt wird.
RadiusSector	Kurs 0-90 = NE-Quadrant; 90-180 = Südost-Quadrant; 180-270 = SW-Quadrant; 270-360 = NW-Quadrant.
StormForecast	Das StormForecast-Objekt enthält detaillierte, von der Regierung herausgegebene Informationen zu den prognostizierten tropischen Stürmen, einschließlich des Standorts, des Status, des Erstellungsdatums, der Windgeschwindigkeit und der Windradien.
StormForecastResult	Eine Reihe von StormForecast-Objekten , die jeweils einzelne von Regierungsbehörden herausgegebene Sturmvorhersagen aufführen.
StormWindRadiiSummary	Das Objekt StormWindRadiiSummary bietet einen übergeordneten Überblick über die Windverteilung rund um einen tropischen Sturm. Sie umfasst die geometrische Darstellung von Windradien (radiiGeometry), detaillierte sektorbasierte Winddaten (radiusSectorData) und die Windgeschwindigkeiten in verschiedenen Entfernungen vom Zentrum des Sturms (windSpeed). Diese Eigenschaften helfen gemeinsam, die räumliche Ausdehnung und Intensität der mit dem Sturm verbundenen Winde zu verstehen. Angezeigt, wenn die Anfrage oder `details=true`enthält`radiiGeometry=true`.
UnitType	Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services in Azure Maps.
WeatherDataUnit	Messeinheit für Wetterdaten.
WeatherValue	Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.
WeatherWindow	Vorhersagefenster für den Sturm

BasinId

Enumeration

Beckenkennzeichen für tropische Stürme.

Wert	Beschreibung
AL	Der Atlantische Ozean. Entscheidend für die Verfolgung von Hurrikanen, die den amerikanischen Kontinent und die Karibik betreffen. Es ist eine der aktivsten Regionen für tropische Stürme.
CP	Der zentrale Pazifische Ozean. Dieses Becken wird für Stürme verwendet, die Hawaii und die umliegenden Gebiete betreffen.
EP	Der östliche Pazifische Ozean. Dieses Becken verfolgt Stürme, die die Westküste Amerikas, einschließlich Mexiko und Mittelamerika, betreffen. Es grenzt an das Zentralpazifikbecken.
NI	Der nördliche Indische Ozean. Dieses Becken umfasst Stürme, die Südasien betreffen, darunter Länder wie Indien und Bangladesch, die häufig von Wirbelstürmen betroffen sind.
NP	Der Nordwestpazifik. Dieses Becken ist wichtig für die Verfolgung von Taifunen, die Ostasien betreffen, darunter Länder wie China, Japan und die Philippinen. Es ist die aktivste tropische Sturmregion weltweit.
SI	Der südliche Indische Ozean. Dieses Becken, das südlich des Äquators liegt, umfasst Zyklone, die Madagaskar, Afrika und die umliegenden Regionen betreffen.
SP	Der Südpazifik. Dieses Becken, das südlich des Äquators liegt, ist relevant für Zyklone, die Australien und die südpazifischen Inseln betreffen.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info		Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

GeoJsonGeometryCollection

Objekt

Ein gültiger GeoJSON GeometryCollection Objekttyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Enthält eine Liste gültiger `GeoJSON` Geometrieobjekte. Beachten Sie, dass koordinaten in GeoJSON in x, y Reihenfolge (Längengrad, Breitengrad) liegen.
type	string: GeometryCollection	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonLineString

Objekt

Ein gültiger GeoJSON LineString Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Koordinaten für die `GeoJson LineString` Geometrie.
type	string: LineString	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonMultiLineString

Objekt

Ein gültiger GeoJSON MultiLineString Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Koordinaten für die `GeoJson MultiLineString` Geometrie.
type	string: MultiLineString	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonMultiPoint

Objekt

Ein gültiger GeoJSON MultiPoint Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Koordinaten für die `GeoJson MultiPoint` Geometrie.
type	string: MultiPoint	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonMultiPolygon

Objekt

Ein gültiger GeoJSON MultiPolygon Objekttyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Enthält eine Liste gültiger `GeoJSON Polygon` Objekte. Beachten Sie, dass koordinaten in GeoJSON in x, y Reihenfolge (Längengrad, Breitengrad) liegen.
type	string: MultiPolygon	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonObjectType

Enumeration

Gibt den GeoJSON Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

Wert	Beschreibung
Point	`GeoJSON Point` Geometrie.
MultiPoint	`GeoJSON MultiPoint` Geometrie.
LineString	`GeoJSON LineString` Geometrie.
MultiLineString	`GeoJSON MultiLineString` Geometrie.
Polygon	`GeoJSON Polygon` Geometrie.
MultiPolygon	`GeoJSON MultiPolygon` Geometrie.
GeometryCollection	`GeoJSON GeometryCollection` Geometrie.
Feature	`GeoJSON Feature`-Objekt
FeatureCollection	`GeoJSON FeatureCollection`-Objekt

GeoJsonPoint

Objekt

Ein gültiger GeoJSON Point Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Ein `Position` ist ein Array von Zahlen mit zwei oder mehr Elementen. Die ersten beiden Elemente sind Längengrad und Breitengradgenau in dieser Reihenfolge. Altitude/Elevation ist ein optionales drittes Element. Weitere Informationen finden Sie unter RFC 7946-.
type	string: Point	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

GeoJsonPolygon

Objekt

Ein gültiger GeoJSON Polygon Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Koordinaten für den geometrietyp `GeoJson Polygon`.
type	string: Polygon	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

JsonFormat

Enumeration

Gewünschtes Format der Antwort. Nur json Format wird unterstützt.

Wert	Beschreibung
json	das JavaScript Object Notation Data Interchange Format

LatLongPair

Objekt

Ein Ort, der als Breiten- und Längengrad dargestellt wird.

Name	Typ	Beschreibung
latitude	number (double)	Latitude-Eigenschaft
longitude	number (double)	Longitude-Eigenschaft

RadiusSector

Objekt

Kurs 0-90 = NE-Quadrant; 90-180 = Südost-Quadrant; 180-270 = SW-Quadrant; 270-360 = NW-Quadrant.

Name	Typ	Beschreibung
beginBearing	number (double)	Peilung des Anfangs des Quadranten in Graden.
endBearing	number (double)	Peilung des Endes des Quadranten in Grad.
range	number (double)	Der Radius des Quadranten in Seemeilen.

StormForecast

Objekt

Das StormForecast-Objekt enthält detaillierte, von der Regierung herausgegebene Informationen zu den prognostizierten tropischen Stürmen, einschließlich des Standorts, des Status, des Erstellungsdatums, der Windgeschwindigkeit und der Windradien.

Name	Typ	Beschreibung
dateTime	string	Datum und Uhrzeit, an der die aktuelle Vorhersage gültig ist, dargestellt im ISO-8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
initializedDateTime	string	Datum und Uhrzeit der Erstellung der Prognose, dargestellt im ISO-8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
location	LatLongPair	Spezifiziert die geografischen Koordinaten (Breiten- und Längengrad) der vorhergesagten Position des Sturms.
maxWindGust	WeatherValue	Spezifiziert die erwartete maximale Windböengeschwindigkeit und die erwartete Richtung während des Sturms, gemessen in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), basierend auf der angegebenen Einheit. Die Windrichtung wird in Azimut-Grad angegeben, die von 0° (wahrer Norden) bis 359° reichen, im Uhrzeigersinn. Darf NULL sein.
status	string	Gibt den aktuellen Zustand des Sturms an. Diese Eigenschaft liefert Informationen darüber, ob der Sturm aktiv ist, abklingt oder einen anderen bedeutenden Status erreicht hat. Mögliche Werte: Zyklonaler Sturm Sturmtief Depression Extrem schwerer Zyklonsturm Hurrikan-Kategorie (1-5) Intensiver tropischer Wirbelsturm Mäßiger tropischer Sturm Posttropischer Wirbelsturm Potenzieller tropischer Wirbelsturm Schwerer Zyklonsturm Schwerer tropischer Sturm Subtropical Superzyklonaler Sturm Tropischer Wirbelsturm Kategorie tropischer Wirbelstürme (1-5) Tropisches Tiefdruckgebiet Tropische Störung Tropischer Sturm Taifun Sehr intensiver tropischer Wirbelsturm Sehr schwerer Zyklonsturm Sehr starker Taifun Heftiger Taifun
sustainedWind	WeatherValue	Legt die maximal während des Sturms erwartete maximale anhaltende Windgeschwindigkeit fest, gemessen in Kilometern pro Stunde (km/h) oder Meilen pro Stunde (mph), basierend auf der im Antrag angegebenen Einheit. Darf NULL sein.
windRadiiSummary	StormWindRadiiSummary[]	Enthält ein Array von StormWindRadiiSummary-Objekten , die Windradien in verschiedenen Quadranten rund um das Zentrum des Sturms detailliert darstellen. Angezeigt, wenn `details=true` oder `radiiGeometry=true` in der Anfrage.
window	WeatherWindow	Liefert Vorhersagedetails für den Sturm innerhalb des angegebenen Zeitrahmens. Wenn der Parameter `windowGeometry` in der API-Anfrage auf true gesetzt ist, enthält diese Eigenschaft GeoJSON-Details für die Fenstergeometrie.

StormForecastResult

Objekt

Eine Reihe von StormForecast-Objekten , die jeweils einzelne von Regierungsbehörden herausgegebene Sturmvorhersagen aufführen.

Name	Typ	Beschreibung
nextLink	string	Enthält die URL, um die nächste Ergebnisseite abzurufen, wenn die Antwort paginiert ist. Dies ist nützlich, wenn die Antwort zu groß ist, um in einem einzigen Aufruf zurückgegeben zu werden, sodass Nutzer durch mehrere Seiten mit Ergebnissen navigieren können.
results	StormForecast[]	Eine Vielzahl von Vorhersagedaten für tropische Stürme, einschließlich vorhergesagter Bahnen, Intensitäten und anderer relevanter Details. Diese Prognosen werden von Regierungsbehörden herausgegeben.

StormWindRadiiSummary

Objekt

Das Objekt StormWindRadiiSummary bietet einen übergeordneten Überblick über die Windverteilung rund um einen tropischen Sturm. Sie umfasst die geometrische Darstellung von Windradien (radiiGeometry), detaillierte sektorbasierte Winddaten (radiusSectorData) und die Windgeschwindigkeiten in verschiedenen Entfernungen vom Zentrum des Sturms (windSpeed). Diese Eigenschaften helfen gemeinsam, die räumliche Ausdehnung und Intensität der mit dem Sturm verbundenen Winde zu verstehen. Angezeigt, wenn die Anfrage oder details=trueenthältradiiGeometry=true.

Name	Typ	Beschreibung
dateTime	string	Datum und Uhrzeit, an der die Windradien-Zusammenfassungsdaten gültig sind, angezeigt im ISO 8601-Format (yyyy-mm-ddThh:mm:ss-hh:mm). Zum Beispiel 2025-04-29T07:00:00-07:00.
radiiGeometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Ein GeoJSON-Objekt, das zurückgegeben wird, wenn der Parameter `radiiGeometry` in der Anfrage auf true gesetzt wird. Es liefert detaillierte geografische Informationen über die Windradien des Sturms, einschließlich der räumlichen Darstellung der von verschiedenen Windgeschwindigkeiten betroffenen Gebiete.
radiusSectorData	RadiusSector[]	Ein Array von RadiusSector-Objekten . Jedes Objekt enthält detaillierte geografische Informationen (im geoJSON-Format), die benötigt werden, um Windradius-Quadranten darzustellen: 0-90° für NE, 90-180° für SE, 180-270° für SW und 270-360° für NW.
windSpeed	WeatherValue	Die Gesamtwindgeschwindigkeit, die mit den Windradiendaten des Sturms verbunden ist. Dieser einzelne Windgeschwindigkeitswert gilt für alle Sektoren innerhalb des radiusSectorData-Arrays , das detaillierte geografische Informationen für die NE-, SE-, SÜD- und NW-Quadranten der Windradien des Sturms liefert.

UnitType

Enumeration

Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services in Azure Maps.

Wert	Beschreibung
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	Schweben
22	Integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeration

Messeinheit für Wetterdaten.

Wert	Beschreibung
imperial	Geben Sie Daten mit imperialen Einheiten zurück, z. B. Fahrenheit (F) für die Temperatur und Meilen (mi) für die Entfernung.
metric	Geben Sie Daten mit metrischen Einheiten wie Celsius (C) für die Temperatur und Kilometer (km) für die Entfernung zurück.

WeatherValue

Objekt

Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.

Name	Typ	Beschreibung
unit	string	Typ der Einheit für den zurückgegebenen Wert.
unitType	UnitType	Eine ganze Zahl, die den Einheitentyp darstellt. Zum Beispiel 17 für Celsius, 18 für Fahrenheit. Kann für die Einheitenumrechnung verwendet werden. Eine vollständige Liste finden Sie unter Weather Services in Azure Maps.
value	number (float)	Gerundeter Wert.

WeatherWindow

Objekt

Vorhersagefenster für den Sturm

Name	Typ	Beschreibung
beginDateTime	string (date-time)	DateTime des Beginns des Bewegungsfensters, das in ISO8601 Format angezeigt wird.
beginStatus	string	Sturmstatus am Anfang des Fensters.
endDateTime	string (date-time)	DatumUhrzeit des Endes des Bewegungsfensters, das in ISO8601 Format angezeigt wird.
endStatus	string	Sturmstatus am Ende des Fensters.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Wird angezeigt, wenn windowGeometry=true in der Anforderung ist. GeoJSON-Objekt, das Koordinaten enthält, die das Bewegungsfenster während des angegebenen Zeitraums beschreiben.
left	LatLongPair	Position des Punktes auf der linken Seite des Fensters zum Zeitpunkt des Zeitrahmens.
right	LatLongPair	Position des Punktes auf der rechten Seite des Fensters am Ende des Zeitrahmens.

Freigeben über

Weather - Get Tropical Storm Forecast

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

AadToken

Bereiche

subscription-key

SAS Token

Beispiele

Get Tropical Storm Forecasts

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BasinId

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonObjectType

GeoJsonPoint

GeoJsonPolygon

JsonFormat

LatLongPair

RadiusSector

StormForecast

StormForecastResult

StormWindRadiiSummary

UnitType

WeatherDataUnit

WeatherValue

WeatherWindow