2b Search Parcels (Forest Fallback)
Submit a parcel search with "forest_fallback": true. The single point sits
outside national cadastral coverage (Amazonas, Brazil), so without the flag it
would fail with Unsupported country โฆ. With the flag on, the API resolves a
forest polygon for the point and returns it as a completed result.
The task id is captured into {{forest_parcel_task_id}}, so it does not replace
the {{parcel_task_id}} that Steps 3โ7 address. Inspect the result via
GET /cadastral/parcels/results/{{forest_parcel_task_id}} โ the forest-fallback
row carries label: "Forest segment (AEF)", a forest:{lon},{lat}:{year}
parcel_id, an empty country_code, and raw_properties.source.
See the Forest fallback section of Search Parcels for the full contract.
โถWhat this step does
It runs the same parcel search as Step 1, but with forest_fallback: true added to
the request. For any point that falls outside national cadastral coverage โ where the
normal lookup would fail with Unsupported country โฆ โ the API resolves a forest
polygon for that point instead of returning a miss, so the point still yields a
usable completed result.
โถWhy it's needed
Cadastral data only exists for supported countries (e.g. US / CA). Sourcing coordinates in regions like the Amazon have no registered parcel to return, so a plain search would leave them as failures with no geometry. Forest fallback fills that gap: it gives those out-of-coverage points a boundary polygon derived from forest data, so they can still flow through review and ingest rather than being dropped.
โถWhy you'd choose this
Turn the flag on when your points span regions without cadastral coverage and you'd
rather have an approximate forest-derived boundary than nothing at all. Leave it off
(the default) when you only want official registered parcels and would prefer
out-of-coverage points to fail explicitly so you can handle them separately. Note it is
moot under geometry_source: "segmentation" (Step 2c), which derives geometry a
different way.
โถNext Step
โ Step 2c: Search Parcels Segmentation (variant), or Step 3: Poll Task Status for the main search