Skip to content

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.

Param Type Required Description
lat float yes Latitude (-90 to 90)
lon float yes Longitude (-180 to 180)

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.

Terminal window
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"
}

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
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
  • 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