Position

Current position of government-issued storm by year, basin, and government Id

GET

https://dataservice.accuweather.com

/tropical/v1/gov/storms/{year}/{basin}/{govId}/positions/current

Returns current position information for a government-issued tropical cyclone by year, basin and government id.

Basins

Name	Id
Atlantic	AL
Central Pacific	CP
Eastern Pacific	EP
North Indian Ocean	NI
Northwest Pacific	NP
South Indian Ocean	SI
Southwest Pacific	SP

Current position of government-issued storm by year, basin, and government Id › path Parameters

year

integer · int32 · required

A numerical value indicating the four digit year.

Example: 2024

basin

string · required

A unique ID that designates a specific basin (NP, CP, SP, EP, NI, SI, AL).

Example: AL

govId

integer · int32 · required

A numerical ID that matches the depression ID.

Example: 2

Current position of government-issued storm by year, basin, and government Id › query Parameters

includeLandmarks

boolean

A boolean value that specifies whether or not to include landmark-specific information.

Default: true

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

radiiGeometry

boolean

A boolean value that specifies whether or not to include wind radii summary data.

Default: false

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

Current position of government-issued storm by year, basin, and government Id › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Current position of government-issued storm by year, basin, and government Id › Responses

API.Tropical.Gov.Entities.OpenAPI.PositionSummary

status

string · minLength: 1 · required

Storm status, in English, including category values of hurricanes and tropical cyclones. Some examples are: Hurricane – Category 3, Tropical Depression, Tropical Cyclone - Category 1, Depression, and Typhoon.

localizedStatus

string · minLength: 1 · required

The storm status in the requested language.

validDateTime

string · date-time

The date and time at which the forecast is valid, displayed in ISO 8601 format (yyyy-mm-ddThh:mm:ss±hh:mm).

validEpochDateTime

integer · int64

The date and time at which the forecast is valid, displayed as the number of seconds that have elapsed since midnight UTC/GMT on January 1, 1970.

An object containing the location details.

An object containing information about the maximum short-burst wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.

An object containing information about the maximum sustained wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.

An object containing information about the measured air pressure at ground level with a rounded value for Inches of Mercury and Millibar. The object may be NULL.

An object containing information about the depression movement.

isSubtropical

boolean | null

A boolean flag indicating when the depression is classified as a subtropical cyclone.

name

string | null

The name of the depression.

hasTropicalPotential

boolean

A boolean value determining if the storm could be tropical.

isPostTropical

boolean

A boolean value describing if the storm is post tropical.

array | null

A list of objects containing details of surrounding landmarks.

array | null

A list of objects containing containing wind radii information.

GET/tropical/v1/gov/storms/{year}/{basin}/{govId}/positions/current

curl https://dataservice.accuweather.com/tropical/v1/gov/storms/:year/:basin/:govId/positions/current \
  --header 'Authorization: <api-key>'

Example Responses

{
  "validDateTime": "2024-08-25T15:00:00Z",
  "validEpochDateTime": 0,
  "position": {},
  "maxWindGust": {},
  "sustainedWind": {},
  "minimumPressure": {},
  "movement": {},
  "status": "status",
  "localizedStatus": "localizedStatus",
  "isSubtropical": true,
  "name": "name",
  "hasTropicalPotential": true,
  "isPostTropical": true,
  "landmarkReferences": [
    {
      "landmark": "landmark",
      "direction": {},
      "range": {}
    }
  ],
  "windRadiiSummary": [
    {
      "validDateTime": "2024-08-25T15:00:00Z",
      "validEpochDateTime": 0,
      "windSpeed": {},
      "radiusSectorData": [
        {
          "beginBearing": 0,
          "endBearing": 0,
          "range": 0
        }
      ],
      "radiiGeometry": {}
    }
  ]
}

json

application/json

Positions of government-issued storm by year, basin, and government Id

GET

https://dataservice.accuweather.com

/tropical/v1/gov/storms/{year}/{basin}/{govId}/positions

Returns all position information for a government-issued tropical cyclone by year, basin and government id.

Basins

Name	Id
Atlantic	AL
Central Pacific	CP
Eastern Pacific	EP
North Indian Ocean	NI
Northwest Pacific	NP
South Indian Ocean	SI
Southwest Pacific	SP

Positions of government-issued storm by year, basin, and government Id › path Parameters

year

integer · int32 · required

A numerical value indicating the four digit year.

Example: 2024

basin

string · required

A unique ID that designates a specific basin (NP, CP, SP, EP, NI, SI, AL).

Example: AL

govId

integer · int32 · required

A numerical ID that matches the depression ID.

Example: 2

Positions of government-issued storm by year, basin, and government Id › query Parameters

details

boolean

A boolean value that specifies whether or not to include extended information.

Default: false

includeLandmarks

boolean

A boolean value that specifies whether or not to include landmark-specific information.

Default: true

radiiGeometry

boolean

A boolean value that specifies whether or not to include wind radii summary data.

Default: false

format

string

A string value that specifies what type of format to provide the response.

Default: json

language

string

A string that indicates the language in which to return the response. More information can be found here.

Default: en-us

Positions of government-issued storm by year, basin, and government Id › Headers

Authorization

string · required

The Authorization header is used to authenticate using your API key. Format is Bearer YOUR_API_KEY.

Positions of government-issued storm by year, basin, and government Id › Responses

API.Tropical.Gov.Entities.OpenAPI.PositionSummary[]

API.Tropical.Gov.Entities.OpenAPI.PositionSummary

status

string · minLength: 1 · required

localizedStatus

string · minLength: 1 · required

The storm status in the requested language.

validDateTime

string · date-time

The date and time at which the forecast is valid, displayed in ISO 8601 format (yyyy-mm-ddThh:mm:ss±hh:mm).

validEpochDateTime

integer · int64

The date and time at which the forecast is valid, displayed as the number of seconds that have elapsed since midnight UTC/GMT on January 1, 1970.

An object containing the location details.

An object containing information about the maximum short-burst wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.

An object containing information about the maximum sustained wind speed with a rounded value for Miles per hour and Kilometer per hour. The object may be NULL.

An object containing information about the measured air pressure at ground level with a rounded value for Inches of Mercury and Millibar. The object may be NULL.

An object containing information about the depression movement.

isSubtropical

boolean | null

A boolean flag indicating when the depression is classified as a subtropical cyclone.

name

string | null

The name of the depression.

hasTropicalPotential

boolean

A boolean value determining if the storm could be tropical.

isPostTropical

boolean

A boolean value describing if the storm is post tropical.

array | null

A list of objects containing details of surrounding landmarks.

array | null

A list of objects containing containing wind radii information.

GET/tropical/v1/gov/storms/{year}/{basin}/{govId}/positions

curl https://dataservice.accuweather.com/tropical/v1/gov/storms/:year/:basin/:govId/positions \
  --header 'Authorization: <api-key>'

Example Responses

[
  {
    "validDateTime": "2024-08-25T15:00:00Z",
    "validEpochDateTime": 0,
    "position": {},
    "maxWindGust": {},
    "sustainedWind": {},
    "minimumPressure": {},
    "movement": {},
    "status": "status",
    "localizedStatus": "localizedStatus",
    "isSubtropical": true,
    "name": "name",
    "hasTropicalPotential": true,
    "isPostTropical": true,
    "landmarkReferences": [
      {
        "landmark": "landmark",
        "direction": {},
        "range": {}
      }
    ],
    "windRadiiSummary": [
      {
        "validDateTime": "2024-08-25T15:00:00Z",
        "validEpochDateTime": 0,
        "windSpeed": {},
        "radiusSectorData": [
          {
            "beginBearing": 0,
            "endBearing": 0,
            "range": 0
          }
        ],
        "radiiGeometry": {}
      }
    ]
  }
]

json

application/json

Search Forecast