EPIC
Number of APIs: 1
EPIC
Earth Polychromatic Imaging Camera
The EPIC API provides information on the daily imagery collected by DSCOVR's Earth Polychromatic Imaging Camera (EPIC) instrument. Uniquely positioned at the Earth-Sun Lagrange point, EPIC provides full disc imagery of the Earth and captures unique perspectives of certain astronomical events such as lunar transits using a 2048x2048 pixel CCD (Charge Coupled Device) detector coupled to a 30-cm aperture Cassegrain telescope.Image metadata and key information are provided by the JSON API and can be requested by date and for the most recent available date. A listing of all available dates can also be retrieved via the API for more granular control.Development of the EPIC API began in 2015, and is supported by the web development team for the Laboratory for Atmospheres in the Earth Sciences Division of the Goddard Space Flight Center. More information regarding the API and retrieval of the imagery for download can be found on the EPIC website.
Retrievable Metadata
The following information is available for every image in the collection:
- Image [name]
- Date
- Caption
- centroid_coordinates
- dscovrj2000position
- lunarj2000position
- sunj2000position
- attitude_quaternions
Example image:
Querying by Date(s)
| Parameter | Type | Default | Description |
|---|---|---|---|
| natural | string | Most Recent Natural Color | Metadata on the most recent date of natural color imagery. |
| natural/date | YYYY-MM-DD | Most Recent Available | Metadata for natural color imagery available for a given date. |
| natural/all | string | Dates for Natural Color | A listing of all dates with available natural color imagery. |
| natural/available | string | Dates for Natural Color | Alternate listing of all dates with available natural color imagery. |
| enhanced | string | Most Recent Enhanced Color | Metadata on the most recent date of enhanced color imagery. |
| enhanced/date | YYYY-MM-DD | Most Recent Available | Metadata for enhanced color imagery for a given date. |
| enhanced/all | string | Dates for Enhanced Imagery | A listing of all dates with available enhanced color imagery. |
| enhanced/available | string | Dates for Enhanced Imagery | Alternate listing of all dates with available enhanced color imagery. |
| api_key | string | DEMO_KEY | API key from api.nasa.gov for expanded usage. |
Example queries
- https://api.nasa.gov/EPIC/api/natural/images?api_key=DEMO_KEY
- https://api.nasa.gov/EPIC/api/natural/date/2019-05-30?api_key=DEMO_KEY
- https://api.nasa.gov/EPIC/api/natural/all?api_key=DEMO_KEY
- https://api.nasa.gov/EPIC/archive/natural/2019/05/30/png/epic_1b_20190530011359.png?api_key=DEMO_KEY
More examples and usage tips can be found on the EPIC API Documentation Page.