PlanetScope surface reflectance (Planet Labs)#

planetscope · theme optical · not checked

PlanetScope 3 m 4- and 8-band imagery with the UDM2 usable-data mask (clear / snow / shadow / haze / cloud), ordered clipped to the AOI through the Orders API or read scene-by-scene through the Data API. Commercial: needs a Planet account with data access, and every order spends quota.

import easysnowdata as esd

aoi = (-121.94, 46.72, -121.54, 46.99)   # Mount Rainier
data = esd.optical.planetscope.load(aoi, time="2024-03")

Credentials

The default route needs planet; see the credentials page for the setup.

Sources#

2 routes serve this product; the first is the default and source= picks another. The return contract is the same either way.

source

provider

credentials

resolution

extent

temporal

latency

notes

orders-api (default)

planet

planet

3 m

global

2016/present

hours to a day

Data API search plus an Orders API clip: Planet delivers COGs cut to the AOI and charges the clipped area. Ordering is explicit (order=True)

data-api

planet

planet

3 m

global

2016/present

hours

activate and read a whole scene; the full scene area is charged and the AOI is applied client-side. Quick looks and single scenes only

Where each route points#

orders-api — Planet Orders API (clip) not checked

https://api.planet.com/compute/ops/orders/v2

data-api — Planet Data API (whole scene) no data

https://api.planet.com/data/v1/

Variables#

variable

units

dtype

nodata

categorical

blue

1

uint16

0

no

green

1

uint16

0

no

red

1

uint16

0

no

nir

1

uint16

0

no

snow

—

uint8

—

yes (2 classes)
snow classes (2)

value

meaning

0

not_snow

1

snow

Provenance#

Licence · Planet licence (not redistributable; Education & Research programme)

Cite the data as

Planet Team (2017). Planet Application Program Interface: In Space for Life on Earth. San Francisco, CA. https://api.planet.com

Documentation

Loader · easysnowdata.optical.planetscope.load