Contrails API

Contrails API is a RESTful interface to the open source pycontrails library and other datasets. It provides all of the basic functionality of pycontrails in a web service with automatic weather data retrieval and pre-computed contrail forecasts.

See the Get Started notebook for a comprehensive introduction and the API Reference for a complete list of endpoints and parameters.

APIs

Research API

The Research API includes endpoints for calculating model outputs on specific flight trajectories and meteorology grids.

These endpoints are subject to unannounced updates and potentially backward incompatible changes.

Forecast API

The Forecast API includes endpoints for retrieving global contrail forecasts. Forecasts are produced on a regular latitude x longitude grid with standard flight levels. Forecasts are provided in a NetCDF format (/grids) or as GeoJSON polygon avoidance regions for specific impact thresholds (/regions)

These endpoints are intended for use in flight planning and other prototype production integrations.

ADS-B API

The ADS-B API includes endpoints for searching and downloading ADS-B telemetry.

These endpoints are intended to provided a common ADS-B source for research into contrail modeling, detection, and tracking.

References