Skip to main content

Extract land properties

Extract land properties

Header Parameters
X-API-KEY string
Request Body

The request boundary

year integer REQUIRED

Possible values: 2009 ≤ value ≤ 2018

year of interest

units string

Possible values: [metric, imperial]

measurement units system to use

static boolean

if true, static (date independent) variables will be reported

annual boolean

if true (default), annual variables will be reported

Responses
200

Success

Schema OPTIONAL
object[]
id integer OPTIONAL

field identifier

landcover string OPTIONAL

Possible values: [Open Water, Perennial Ice Snow, Developed, Open Space, Developed, Low Intensity, Developed, Medium Intensity, Developed, High Intensity, Barrend Land (Rock/Sand/Clay), Deciduous Forest, Evergreen Forest, Mixed Forest, Dwarf Scrub, Shrub/Scrub, Grassland/Herbaceous, Sedge/Herbaceous, Lichens, Moss, Pasture/Hay, Cultivated Crops, Woody Wetlands, Emergent Herbaceous Wetlands]

Describes the physical material at the surface of the Earth. Typical land cover types include grass, trees, bare ground, water, etc.

majorityCropType string OPTIONAL

majority crop at a given location

tilableFraction number OPTIONAL

Possible values: value ≤ 100

Fraction of field covered by cultivation

forestFraction number OPTIONAL

Possible values: value ≤ 100

Fraction of field covered by woody vegetation

waterFraction number OPTIONAL

Possible values: value ≤ 100

Fraction of field covered by water

buildings integer OPTIONAL

Number of buildings of any type

elevation integer OPTIONAL

Elevation above mean sea level (MSL), [m] or [feet]

slope number OPTIONAL

Inclination of land from horizontal surface, in [%]

topoComplexity number OPTIONAL

Describes the diversity and arrangement of three‐dimensional structural elements over a surface. Calculated from changes in slope over a defined distance, [unitless].

topoWetness number OPTIONAL

Describes steady state wetness index calculated from upstream contributing area and local slope, [unitless].

soilTexture integer OPTIONAL

Describes the relative content of particles of various sizes, such as sand, silt and clay in the soil, [categorical].

aws number OPTIONAL

Possible values: value ≤ 500

Describes the amount of water that a given soil can hold for crop use. Defined as mm of water per meter of soil; units [mm/m] or [inches].

soc number OPTIONAL

Possible values: value ≤ 2000

Describes the measureable component of soil organic matter. Organic matter makes up just 2–10% of most soil's mass and has an important role in the physical, chemical and biological function of agricultural soils. Given in [mg/ha] or [tons/acre].

spi number OPTIONAL

Possible values: value ≤ 1

National Commodity Crop Productivity Index is a method of arraying the soils of the United States for non-irrigated commodity crop production based on their inherent soil properties. The rating a soil is assigned is the highest one of three basic crop group indices, which are based on the climate where the crop is typically grown. Cooler climates are represented by winter wheat, moderate climates are represented by corn and soybeans, and warmer climates are represented by cotton; [unitless].

floodplain number OPTIONAL

Possible values: value ≤ 1

An area of land adjacent to a stream or river which stretches from the banks of its channel to the base of the enclosing valley walls, and which experiences flooding during periods of high discharge. Calculated from a digital elevation model.

400

Invalid input

Schema OPTIONAL
string[]