Aviation Radiation API API

by amentum.space

Overview

Our atmosphere protects us from a hostile space radiation environment comprising high energy particles of solar and intergalactic origin. Solar radiation is significant during unpredictable and short lived solar flares and coronal mass ejections (CMEs); however, galactic cosmic radiation (GCR) is omnipresent. The GCR intensity varies with latitude, longitude, and time due to effects of solar activity on the interplanetary magnetic field, as well as the Earth's magnetic field. Space radiation collides with gases in the atmosphere, leading to a complex shower of high energy radiation, the intensity and composition of which varies spatially and temporally. Excessive exposure to radiation can damage DNA and lead to long-term health effects such as an increased risk of cancer. Resulting radiation levels at commercial aircraft altitudes are greater than at sea level. Aircrew are classified as radiation workers in some countries; however, planning to limit their exposure, and monitoring, is generally lacking. Both real-time measurements and predictive models of radiation in the atmosphere are important to mitigate the radiation risk to crew. We host a RESTful API to models of cosmic ray induced ionising radiation in the atmosphere. The CARI7 and PARMA endpoints use models developed by the US Federal Aviation Administration and the Japan Atomic Energy Agency to calculate cosmic radiation doses at a point. The Route Dose API calculates the same quantities along a great circle route between two airports using CARI7. API requests must contain a key "API-Key" in the header (see code samples). Obtain a key from <a href='https://developer.amentum.io'>here</a>. Help us improve the quality of our web APIs by completing our 2 minute survey <a href="https://www.surveymonkey.com/r/CTDTRBN">here</a>. Amentum Pty Ltd is not responsible nor liable for any loss or damage of any sort incurred as a result of using the API. Copyright <a href='https://amentum.space'>Amentum Pty Ltd</a> 2022.

Aviation Radiation API is a geocoding API from amentum.space. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 7 endpoints.

At a glance

Authentication: No auth
HTTPS: Yes
CORS: Unknown
Category: Geocoding
Version: 1.5.0
Endpoints: 7
OpenAPI: Specification ↗
Spec updated: 2023-03-06

Endpoints

Method	Path	What it does
GET	`/cari7/ambient_dose`	The ambient dose equivalent rate calculated for a single particle type, or accumulated over all particle types.
GET	`/cari7/effective_dose`	The effective dose rate calculated for a single particle type, or accumulated over all particle types.
GET	`/parma/ambient_dose`	The ambient dose equivalent rate calculated for a single particle type, or accumulated over all particle types.
GET	`/parma/differential_intensity`	The energy differential intensity of a particle at a given zenith angle.
GET	`/parma/effective_dose`	The effective dose rate calculated for a single particle type, or accumulated over all particle types.
GET	`/route/ambient_dose`	Calculate the ambient equivalent dose along a great circle flight route.
GET	`/route/effective_dose`	Calculate the total effective dose along a great circle flight route.