# info.description
Crop Land Data Layers, also known as CDLs, are published by USDA and provide estimates of
historical crops cover.

# paths./get.get.description
Please note, this is the trial version of this API. Please purchase a subscription key for continued use.

Back to Subscription Version

Powered by CROPAI™

The Cropland Data Layer (CDL), produced by the USDA, provides a raster, geo-referenced, crop-specific land cover map for the continental United States. The CDL also includes a crop mask layer and planting frequency layers, as well as boundary, water and road layers. The Boundary Layer options provided are County, Agricultural Statistics Districts (ASD), State, and Region. The data is created annually using moderate resolution satellite imagery and extensive agricultural ground truth.

The purpose of the Cropland Data Layer Program is to use satellite imagery to (1) provide planted acreage estimates to the Agricultural Statistics Board for each state's major commodities and (2) produce digital, crop-specific, categorized geo-referenced output products (Information from here).

Cropland Data Layers in Ag-Analytics FarmScope.

Click the Jupyter Notebook Static Sample to view a static rendition of this APIs Jupyter Notebook.
Click the Jupyter Notebook Github Repo to access the Jupyter Notebook .ipynb files and
instructions needed in order to run this APIs Jupyter Notebook.

Request Parameters ▼

Request Parameters

Parameter

Data Type

Required?

Description

year

integer

Yes

Year of desired result

inputShape

Esri Polygon Shape

Yes

The shape information for field in esriGeometryPolygon format.
Standard open source JavaScript front-end libraries
(e.g., Leaflet) can be used to structure the shape.

env:outSR

String

Yes

Output Spatial Reference. Return features in the specified spatial
reference by supplying specific wkid (eg. 4326).

Response Parameters ▼

Response Parameters

Parameter

Data Type

Description

results

List

The GP Result resource represents a result parameter for a GP Job.
It provides information about the result parameter such as its name, data type and value.

fields

List

In ArcGIS, rows are known as records and columns are referred to as fields. Each field in a table can store a specific type of data, such as a number, date, or piece of text. Fields form the attribute info for a layer.

fields.GRIDCODE

Integer

Each GRIDCODE corresponds to a specific crop.

features

List

An array of features. Each feature contains fields.

features.geometry

Points, lines or polygons

The structure for the geometries is same as the structure of the
JSON geometry objects returned by the ArcGIS REST API.

features.attributes

List

Key-value pairs where the key is a field name in the list of fields
of the record set and the value is the value of the corresponding field.

GridCode / CropName Table ▼

GridCode / CropName Table

GridCode

CropName

GridCode

CropName

GridCode

CropName

1

Corn

55

Caneberries

207

Asparagus

2

Cotton

56

Hops

208

Garlic

3

Rice

57

Herbs

209

Cantaloupes

4

Sorghum

58

Clover/Wildflowers

210

Prunes

5

Soybeans

59

Sod/GrassSeed

211

Olives

6

Sunflower

60

Switchgrass

212

Oranges

10

Peanuts

61

Fallow/IdleCropland

213

HoneydewMelons

11

Tobacco

63

Forest

214

Broccoli

12

SweetCorn

64

Shrubland

216

Peppers

13

PoporOrnCorn

65

Barren

217

Pomegranates

14

Mint

66

Cherries

218

Nectarines

21

Barley

67

Peaches

219

Greens

22

DurumWheat

68

Apples

220

Plums

23

SpringWheat

69

Grapes

221

Strawberries

24

WinterWheat

70

ChristmasTrees

222

Squash

25

OtherSmallGrains

71

OtherTreeCrops

223

Apricots

26

DblCropWinWht/Soybeans

72

Citrus

224

Vetch

27

Rye

74

Pecans

225

DblCropWinWht/Corn

28

Oats

75

Almonds

226

DblCropOats/Corn

29

Millet

76

Walnuts

227

Lettuce

30

Speltz

77

Pears

229

Pumpkins

31

Canola

81

Clouds/NoData

230

DblCropLettuce/DurumWht

32

Flaxseed

82

Developed

231

DblCropLettuce/Cantaloupe

33

Safflower

83

Water

232

DblCropLettuce/Cotton

34

RapeSeed

87

Wetlands

233

DblCropLettuce/Barley

35

Mustard

88

Nonag/Undefined

234

DblCropDurumWht/Sorghum

36

Alfalfa

92

Aquaculture

235

DblCropBarley/Sorghum

37

OtherHay/NonAlfalfa

111

OpenWater

236

DblCropWinWht/Sorghum

38

Camelina

112

PerennialIce/Snow

237

DblCropBarley/Corn

39

Buckwheat

121

Developed/OpenSpace

238

DblCropWinWht/Cotton

41

Sugarbeets

122

Developed/LowIntensity

239

DblCropSoybeans/Cotton

42

DryBeans

123

Developed/MedIntensity

240

DblCropSoybeans/Oats

43

Potatoes

124

Developed/HighIntensity

241

DblCropCorn/Soybeans

44

OtherCrops

131

Barren

242

Blueberries

45

Sugarcane

141

DeciduousForest

243

Cabbage

46

SweetPotatoes

142

EvergreenForest

244

Cauliflower

47

MiscVegs&Fruits

143

MixedForest

245

Celery

48

Watermelons

152

Shrubland

246

Radishes

49

Onions

176

Grassland/Pasture

247

Turnips

50

Cucumbers

190

WoodyWetlands

248

Eggplants

51

ChickPeas

195

HerbaceousWetlands

249

Gourds

52

Lentils

204

Pistachios

250

Cranberries

53

Peas

205

Triticale

254

DblCropBarley/Soybeans

54

Tomatoes

206

Carrots

# paths./get.get.parameters[].description
Output Spatial Reference. Return features in the specified spatial reference
by supplying specific wkid (eg. 4326).

# paths./get.get.parameters[].description
(ESRI Polygon shape): The shape information for field in esriGeometryPolygon format.
Standard open source JavaScript front-end libraries (e.g., Leaflet) can be used to structure the
shape