Leaf integrates with Planet to deliver PlanetScope imagery at 3-meter resolution with near-daily revisit times. Leaf handles the subscription process internally, fetching both back-fill and forward-fill images based on the dates you specify.
PlanetScope imagery is billed by area.
providers: ["planet"], Leaf first checks whether Planet is enabled for your API owner. If Planet is not enabled, field creation fails before the subscription is created.
Supported item and asset types
Leaf supports the PSScene item type with these asset types:
ortho_analytic_8b_sr
Atmospherically corrected surface reflectance. This is the default and the most commonly used asset type. Leaf produces 13 images per pass.
| Band | Name |
|---|
| 1 | Coastal Blue |
| 2 | Blue |
| 3 | Green I |
| 4 | Green |
| 5 | Yellow |
| 6 | Red |
| 7 | Red Edge |
| 8 | Near-infrared |
ortho_analytic_8b
Radiometrically calibrated analytic image stored as 16-bit scaled radiance. Same 8 bands as ortho_analytic_8b_sr. Leaf produces 13 images per pass.
ortho_visual
Color-corrected visual image with 3 bands (Red, Blue, Green). Leaf produces 2 images per pass.
ortho_udm2
Usable data mask (Cloud 2.0). Contains 8 bands:
| Band | Description |
|---|
| 1 | Clear map |
| 2 | Snow map |
| 3 | Shadow map |
| 4 | Light haze map |
| 5 | Heavy haze map |
| 6 | Cloud map |
| 7 | Confidence map |
| 8 | Unusable pixels |
ortho_analytic_8b_xml
Radiometrically calibrated analytic image metadata.
Requesting multiple asset types
You can request more than one asset type per satellite field. Specify them in the assetTypes array when creating the field:
{
"externalId": "my-field-001",
"providers": ["planet"],
"assetTypes": ["ortho_analytic_8b_sr", "ortho_udm2"],
"geometry": {
"type": "MultiPolygon",
"coordinates": [...]
}
}
assetTypes, Leaf defaults to ortho_analytic_8b_sr.
Checking the subscription
GET /services/satellite/api/fields/{id}/subscription
Returns the active subscription details for a Planet-enabled field, including planetAssetTypes, planetItemTypes, and startDate.
Geometry requirements
Planet has stricter geometry requirements than Sentinel-2:
- The geometry must be valid (no self-intersections).
- Maximum vertices: 1,500.
- Minimum inner ring area: 1.0 m².
Field creation fails if these requirements are not met.
What to do next
