SIGMETs

Overview

  • Domain Portfolio: Weather Imagery
  • Domain: Aviation
  • API Name: Vector Aviation SIGMETs - v2 Restricted
  • Geography: Global
  • Attribution Required: NO
  • Attribution Requirements: N/A

The Feature Data Service (FDS) API provides geographic features for a number of products. The client can use these features to render a visual representation of data.

  • FDS provides geometric vector data where each feature can be a set of points, a polygon or set of polygons, a linestring or set of linestrings, or any other valid GeoJSON type
  • Each feature is described by a set of geographic coordinates and a set of properties.
  • Each feature is uniquely identified by the combination of its product key, feature key and valid time; the valid time is used to assign the feature to a unique feature set.
  • For additional details about FDS, please see the Weather Company Data | Data Visualization - Weather Imagery | Common Usage Guide

Using FDS products requires a multi-step workflow to retrieve the necessary data for the specific product data request. Step 2 requires the ‘time’ value parameter, found in the response from Step 1.

  • Step 1: Get Product Info - Provides time-based labels for the feature sets that are currently available.
  • Step 2: Get Features for a Single Tile - Provides all geographic features for a single tile, taken from a single feature set within a specific product.

HTTP Headers and Data Lifetime - Caching and Expiration

For details on appropriate header values as well as caching and expiration definitions, please see The Weather Company Data | API Common Usage Guide.

URL Construction

Step 1: Get Product Info
The [/products/{productKey}/info] request provides the labels for the feature sets that are currently available. These labels are required as input for the subsequent [/products/{productKey}/features] request, and they are invoked in that request’s ‘time’ parameter.
https://api.weather.com/v2/vector-api/products/6003/info?meta=true&max-times=12&apiKey=yourApiKey
Step 2: Get Features for a Single Tile

Required Parameters:productKey, time, lod, x, y, apiKey=yourApiKey || Optional Parameters: declutter, tile-size

https://api.weather.com/v2/vector-api/products/<productKey>/features?time=<time>&lod=<lod>&x=<x>&y=<y>&apiKey=yourApiKey

The [/products/{productKey}/features] request provides a set of features for a single tile, from a particular feature set within a particular product. Each feature contains a small set of key metadata properties, including its ID and valid time, which are required as input for any subsequent [/products/{productKey}/feature-details] request, as the ‘feature-id’ and ‘valid-time’ parameters.
https://api.weather.com/v2/vector-api/products/6003/features?time=1492016701805&lod=10&x=175&y=409&tile-size=256&apiKey=yourApiKey

Required Parameters:productKey, apiKey=yourApiKey || Optional Parameters: meta, max-times

https://api.weather.com/v2/vector-api/products/<productKey>/info?apiKey=yourApiKey

Product Data Dictionary: 6003 - Aviation SIGMETs

The source of the data includes NOAAport, NWS FTP, WxWire and UKMO feed of WMO bulletins. The product is an active state product such that the last transmission in obsoletes any previous issuance. The disappearance of a feature can be inferred as a cancellation or aging out of the prior feature.

The JSON data includes the following fields:

Field

Found in the GeoJSON response, in each feature’s properties field

Description
Valid_time Unix Timestamp when the Sigmet was queried
Issuing_station ICAO ID of the station that disseminated the WMO bulletin
Issue_time Timestamp in ISO-8601 format when the WMO bulletin was issued from the source.
Icao_site_id ICAO ID of the station that issued the WMO bulletin
Sigmet_id ID for the Sigmet
geometry GeoJSON Polygon lat/lon coordinates.
Fir_ids Array of FIR region IDs that intersect the geographic region of the Sigmet
Conv_sigmet_region Convective Sigmet region for US issued Sigmets. E(ast), C(entral), or W(est)
Raw_type Non-standardized type string as it was parsed from the raw format
Type Standardized Type (see table below)
Phenomenon Standardized Phenomenon (see table below)
Active_at Timestamp in ISO-8601 format when the Sigmet becomes active
Expire_at Timestamp in ISO-8601 format when the Sigmet is no longer active
Lower_level Lower Altitude Boundary in FL units or SFC
Upper_level Upper Altitude Boundary in FL units
Moving_dir Direction of Movement in degrees
Moving_speed Speed of Movement in Knots
Data Raw Bulletin Text

Standardized Type/Phenomenon Mapping Table

Phenomenon Type Description
CAT Clear Air Turbulence  
MTW Mountain Waves  
ICING RIME Rime Ice
FZRA Freezing Rain  
FZDZ Freezing Drizzle  
FZFG Freezing Fog  
ICE Ice  
CONV SQL TSGR Squall Thunderstorm with Hail
EMBD TSGR Embedded Thunderstorm with Hail  
ISOL TSGR Isolated Thunderstorm with Hail  
OCNL TSGR Occasional Thunderstorm with Hail  
FRQ TSGR Frequent Thunderstorm with Hail  
SQL TS Squall Thunderstorm  
EMBD TS Embedded Thunderstorm  
ISOL TS Isolated Thunderstorm  
OCNL TS Occasional Thunderstorm  
FRQ TS Frequent Thunderstorm  
TSGR Thunderstorm with Hail  
TS Thunderstorm  
TC Tropical Cyclone  
TCU Towering Cumulus  
CB Cumulonimbus  
FC Funnel Cloud  
WATERSPOUT Waterspout  
VA VA CLD Volcanic Ash Cloud
VA Volcanic Ash  
RDOACT CLD Radioactive Cloud  
DUST DS Dust Storm
BLDU Blowing Dust  
PO Dust/Sand Whirls  
SAND SS Sand Storm
BLSA Blowing Sand  
WINDS WINDS Winds
WS Wind Shear  
GUSTS Wind Gusts  
VIS CIG Ceiling
MT OBSC Mountain Obscuration  
BKN CLD Broken Clouds  
OVC CLD Overcast  
CLD Clouds  
BLSN Blowing Snow  
SN Snow  
VIS Visibility/Mist/Rain  
IFR Instrument Flight Rules  
LOW CLD Low Clouds/Fog  
TURB TURB Turbulence