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 https://atlas.microsoft.com/weather/tropical/storms/forecasts/json?api-version=1.1&year={year}&basinId={basinId}&govId={govId}

Mit optionalen Parametern:

GET https://atlas.microsoft.com/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
format	path	True	JsonFormat	Gewünschtes Format der Antwort. Nur `json` Format wird unterstützt.
api-version	query	True	string	Versionsnummer der Azure Maps-API.
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 Verwendung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann über die Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Weitere Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie unter Verwalten der Authentifizierung in Azure Maps.

Antworten

Name	Typ	Beschreibung
200 OK	StormForecastResult	OK
Other Status Codes	ErrorResponse	Ein unerwarteter Fehler ist aufgetreten.

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. Bei Kombination mit rollenbasierten Azure-Zugriff Steuern kann es verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerungen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Notes

Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltung API erworben werden.

Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra-ID-Konfigurationen. * Die rollenbasierte Azure-Zugriffssteuerung wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

Weitere Informationen zur Microsoft Identity Platform finden Sie unter Übersicht über die Microsoft Identity Platform.

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

Bereiche

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

subscription-key

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, die vertraulichen Clientanwendungen Ansatz für den Zugriff auf Azure Maps-REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: query

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von Missbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Get Tropical Storm Forecasts

Beispielanforderung

HTTP

GET https://atlas.microsoft.com/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": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "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": {
        "value": 92.6,
        "unit": "km/h",
        "unitType": 7
      },
      "sustainedWind": {
        "value": 74.1,
        "unit": "km/h",
        "unitType": 7
      },
      "status": "Tropical Storm",
      "window": {
        "left": {
          "latitude": 24.45283,
          "longitude": 142.055313
        },
        "right": {
          "latitude": 22.94641,
          "longitude": 142.744675
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
basinId	Kennung des Beckens
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
GeoJsonGeometry	Ein gültiges `GeoJSON` Geometry-Objekt. Der Typ muss einer der sieben gültigen GeoJSON-Geometrietypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon und GeometryCollection. Weitere Informationen finden Sie unter RFC 7946-.
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-.
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 `radiiGeometry=true`enthält`details=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 Wetterdienste in Azure Maps.
WeatherDataUnit	Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.
WeatherUnit	Spezifischer Wert einer bestimmten Einheit in Bezug auf das Wetter.
WeatherWindow	Vorhersagefenster für den Sturm

basinId

Enumeration

Kennung des Beckens

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	object	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

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

GeoJsonGeometry

Objekt

Ein gültiges GeoJSON Geometry-Objekt. Der Typ muss einer der sieben gültigen GeoJSON-Geometrietypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon und GeometryCollection. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
type	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.

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.

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	WeatherUnit	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. Kann 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 Typhoon Sehr intensiver tropischer Wirbelsturm Sehr schwerer Zyklonsturm Sehr starker Taifun Heftiger Taifun
sustainedWind	WeatherUnit	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. Kann 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 radiiGeometry=trueenthältdetails=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	WeatherUnit	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 Wetterdienste 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	float
22	integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeration

Gibt an, dass die Daten entweder in metrischen Einheiten oder in britischen Einheiten zurückgegeben werden sollen. Der Standardwert ist die Metrik.

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.

WeatherUnit

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 (int32)	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 Wetterdienste 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

Notes

Bereiche

subscription-key

SAS Token

Beispiele

Get Tropical Storm Forecasts

Beispielanforderung

Beispiel für eine Antwort

Definitionen

basinId

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonPoint

GeoJsonPolygon

JsonFormat

LatLongPair

RadiusSector

StormForecast

StormForecastResult

StormWindRadiiSummary

UnitType

WeatherDataUnit

WeatherUnit

WeatherWindow