TAFs
Overview
- Domain Portfolio: Weather Imagery
- Domain: Aviation
- API Name: Vector Aviation TAFs - v2
- 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/6017/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/6017/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: 6017 - Aviation TAFs
The source of the data includes WMO Bulletins received over various feeds such as NOAAPort and UKMO. A Terminal Aerodrome Forecast (TAF) is a concise statement of the expected meteorological conditions at an airport during a specified period. TAFs are made available as they are received.
The JSON data includes the following fields:
|
Field Found in the GeoJSON response, in each feature’s properties field |
Description |
|---|---|
| change_type |
Reason for updated TAF ROU - Routine, AMD - Amendment, COR - Correction, CNL - Cancellation, ROUA - Routine Amendment, ROUC - Routine Correction |
| end_time | ISO-8601 Timestamp of the TAF ending time |
| icao_site_id | ICAO airport code |
| id | Unique identifier of the record |
| raw_data | Raw TAF data |
| source_id | Provider of the forecast data |
| start_time | ISO-8601 Timestamp of the TAF starting time |
| valid_time | ISO-8601 Timestamp of when the TAF was issued |