Light Pollution
All endpoints are prefixed with /v1/light-pollution/.
Coverage: Global land + coastal areas, 5-arcminute (~9 km) resolution.
Source: Pxie
Update frequency: Annual — based on VIIRS Day/Night Band satellite composites. Data reflects nighttime artificial light levels averaged over the year.
Common Parameters
Section titled “Common Parameters”| Param | Type | Required | Description |
|---|---|---|---|
lat |
float | yes | Latitude (-90 to 90) |
lon |
float | yes | Longitude (-180 to 180) |
GET /level
Section titled “GET /level”Credits: 2 | Tier: All
Light pollution level for a location — returns the Bortle class (1–9), sky brightness in mag/arcsec² (SQM-equivalent), and VIIRS radiance.
curl -H "X-API-Key: YOUR_KEY" \ "https://api.pxie.ai/v1/light-pollution/level?lat=45.5&lon=-75.5"{ "lat": 45.5, "lon": -75.5, "bortle_class": 6, "bortle_name": "Bright suburban sky", "description": "Milky Way only visible near zenith. Sky within 35° of horizon is grey-white.", "sqm_mag_arcsec2": 18.6, "radiance_nw": 4.12, "artificial_brightness_ratio": 21.93, "data_year": "2023", "source": "Pxie"}Bortle Scale
Section titled “Bortle Scale”A pristine sky with no artificial light reads 22.0 mag/arcsec² (Bortle 1). Open ocean and ice sheets, where there is no artificial light, read the same.
| Class | Name | SQM (mag/arcsec²) | What You Can See |
|---|---|---|---|
| 1 | Excellent dark site | ≥ 21.75 | Zodiacal light, gegenschein, M33 naked eye |
| 2 | Typical dark site | 21.45–21.75 | Airglow visible, Milky Way highly structured |
| 3 | Rural sky | 21.0–21.45 | Some light on horizon, Milky Way still complex |
| 4 | Rural/suburban | 20.25–21.0 | Light domes visible, Milky Way lacks detail |
| 5 | Suburban | 19.25–20.25 | Milky Way very weak, clouds brighter than sky |
| 6 | Bright suburban | 18.25–19.25 | Milky Way only near zenith, horizon grey-white |
| 7 | Suburban/urban | 17.25–18.25 | Entire sky grey-white, Milky Way invisible |
| 8 | City sky | 16.25–17.25 | Only brightest stars and planets visible |
| 9 | Inner-city | < 16.25 | Only Moon, planets, and a few bright stars |
Fields
Section titled “Fields”| Field | Description |
|---|---|
bortle_class |
Bortle Dark-Sky Scale class (1–9) |
bortle_name |
Human-readable class name |
sqm_mag_arcsec2 |
Sky brightness in magnitudes per square arcsecond (higher = darker) |
radiance_nw |
VIIRS DNB radiance in nW/cm²/sr (lower = darker) |
artificial_brightness_ratio |
Ratio of artificial light to natural sky brightness (0 = no light pollution) |
data_year |
Year of the VIIRS annual composite used |
Use Cases
Section titled “Use Cases”- Astronomy apps: Show observing site quality, recommend dark-sky locations
- Light pollution awareness: Map artificial light levels for environmental monitoring
- Observing score: Combine with cloud cover, transparency, and seeing for a full sky quality assessment
- Tourism: Dark-sky tourism planning and site selection
Source: Pxie
