---
title: "Use to get the location of tropical storms from individual national weather
forecasting agencies."
method: GET
path: "/weather/tropical/storms/locations/{format}"
---

# Use to get the location of tropical storms from individual national weather
forecasting agencies.

`GET /weather/tropical/storms/locations/{format}`

The `Get Tropical Storm Locations` API is an HTTP `GET` request that returns
the location of individual government-issued tropical storms. Information about
the tropical storms includes, location coordinates, geometry, basin ID, date,
wind details and wind radii.

## Path parameters

- `format` 'json', required

## Query parameters

- `api-version` string, required
- `year` integer, required
- `basinId` 'AL' | 'CP' | 'EP' | 'NI' | 'NP' | 'SI' | 'SP', required
- `govId` integer, required
- `details` boolean
- `radiiGeometry` boolean
- `unit` 'imperial' | 'metric'
- `current` boolean

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- StormLocationsResult — Contains an array of [StormLocation](#stormlocation) objects, representing government-issued active storm events. Includes details such as latitude and longitude coordinates, wind speed and direction, wind radii, basin identifier, minimum pressure, movement, status, and other relevant attributes.
  - `results` StormLocation[] — Array of data points, each detailing the location of an individual government-issued storm, including coordinates, geometry, basin ID, date, wind details, and wind radii.
    - `dateTime` string — Date and time that the forecast is valid, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*.
    - `location` LatLongPair — A location represented as a latitude and longitude.
      - `latitude` number, double — Latitude property
      - `longitude` number, double — Longitude property
    - `maxWindGust` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `sustainedWind` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `minimumPressure` WeatherValue — Specific value of a given unit related to weather.
      - `value` number, float — Rounded value.
      - `unit` string — Type of unit for the returned value.
      - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `movement` WindDetails — Wind details being returned including speed and direction.
      - `direction` WindDirection — Wind direction
        - `degrees` integer — Wind direction in Azimuth degrees, starting at true North and continuing in clockwise direction. North is 0 degrees, east is 90 degrees, south is 180 degrees, west is 270 degrees. Possible values 0-359.
        - `localizedDescription` string — Direction abbreviation in the specified language.
      - `speed` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
    - `status` string — Returns the current classification or stage of the storm in English, such as a tropical depression, tropical storm, or hurricane.
    - `isSubtropical` boolean — A return value of true indicates that the storm is classified as a subtropical cyclone, meaning it has both tropical and extratropical features.
    - `hasTropicalPotential` boolean — True when storm may develop into a Tropical System.
    - `isPostTropical` boolean — Returns true if the storm has transitioned from a tropical cyclone to a post-tropical cyclone, aiding in understanding the storm's lifecycle phase.
    - `windRadiiSummary` StormWindRadiiSummary[] — Contains an array of [StormWindRadiiSummary](#stormwindradiisummary) objects, detailing wind radii in different quadrants around the storm's center. Displayed when `details=true` or `radiiGeometry=true` in the request.
      - `dateTime` string — Date and time that the wind radii summary data is valid, displayed in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (yyyy-mm-ddThh:mm:ss-hh:mm). For example, *2025-04-29T07:00:00-07:00*.
      - `windSpeed` WeatherValue — Specific value of a given unit related to weather.
        - `value` number, float — Rounded value.
        - `unit` string — Type of unit for the returned value.
        - `unitType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 31 — An integer representing the unit type. For example, 17 for Celsius, 18 for Fahrenheit. Can be used for unit translation. For a complete list, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#unit-types).
      - `radiusSectorData` RadiusSector[] — An array of [RadiusSector](#RadiusSector) objects. Each object contains detailed geographical information (in geoJSON format) needed to plot wind radius quadrants: 0-90° for NE, 90-180° for SE, 180-270° for SW, and 270-360° for NW.
        - `beginBearing` number, double — Bearing, in degrees, of the beginning of the quadrant.
        - `endBearing` number, double — Bearing, in degrees, of the end of the quadrant.
        - `range` number, double — The radius of the quadrant, in nautical miles.
      - `radiiGeometry` GeoJsonGeometry — A valid `GeoJSON` geometry object. The type must be one of the seven valid GeoJSON geometry types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1) for details.
        - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.
  - `nextLink` string — Contains the URL to fetch the next page of results if the response is paginated. This is useful when the response is too large to be returned in a single call, allowing users to navigate through multiple pages of results.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/maps-weather.md) · [All operations](https://skmtc.net/azure/apis/maps-weather/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/maps-weather/versions/3c076fdd2918/schema)