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

BUY

DEMO

The POLARIS Soils API offers a means to clip the POLARIS dataset to a user-provided area of interest. POLARIS provides a quantitative prediction of soil attributes (including pH, clay %, organic matter %) at different depths across the contiguous United States. It is build using machine learning algorithms that remap the Soil Survey Geographic (SSURGO) database.

Polaris Soils in Ag-Analytics DataLayers.

Documentation

Notebook

Github Repo

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.

GET Request

Parameter

Description

Example

Request

FileName

File name to download. From POST request.
Only request a single file at a time.

raster_polaris_ph_mean_15_
30_20200624-201842_25890.tif

https://ag-analytics.azure-api.net/polaris-new?FileName= raster_polaris_ph_mean_15_30_20200624-201842_25890.tif

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

BUY

DEMO

The POLARIS Soils API offers a means to clip the POLARIS dataset to a user-provided area of interest. POLARIS provides a quantitative prediction of soil attributes (including pH, clay %, organic matter %) at different depths across the contiguous United States. It is build using machine learning algorithms that remap the Soil Survey Geographic (SSURGO) database.

Polaris Soils in Ag-Analytics DataLayers.

Documentation

Notebook

Github Repo

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 Parameter Details

Parameter

Data Type

Required?

Default

Options

Description

aoi

GeoJSONString,
.shp file, GeoTIFF

Yes

--

--

Area of interest, in the case of GeoJSON, can be multipolygon or rings.)

Soil_Parameter

String

Yes

--

See soil parameter
details table

Soil property to generate map of.

Depth_Range

String

Yes

--

"0-5" "5-15"
"15-30" "30-60"
"60-100" "100-200"

Depth range in centimeters of the soil column.

Statistic

String

Yes

--

mean, min,
max, var

Statistics provided per layer and variable.
Includes arithmetic mean, minimum, maximum, and variance.

Legend_Ranges

String

No

3

Any number greater than 0

PNG will have a number of colors corresponding to the number of
legend ranges passed. Each color bin is spaced evenly among the points.

Soil_Parameter Variables ▼

Soil_Parameter Details

The following variables can be used for the "Soil_Parameter"

Variable

Units

Description

Variable

Units

Description

silt

%

Silt percentage

ksat

cm/hr

Saturated hydraulic conductivity

sand

%

Sand percentage

resdt

cm

Depth to restriction layer

clay

%

Clay Percentage

ph

N/A

Soil pH in H2O

bd

g/cm3

Bulk Density

om

%

Organic matter percentage

awc

m3/m3

Available water content

caco3

%

Calcium carbonate percentage

theta_s

m3/m3

Saturated soil water content

cec

meq/100g

Cation exchange capacity in soil

theta_r

m3/m3

Residual soil water content

lambda

N/A

Pore size distribution index
(brooks-corey)

theta_33

m3/m3

Soil water content at field
capacity

hb

cm

Bubbling pressure
(brooks-corey)

theta_1500

m3/m3

Soil water content at the
wilting point

n

N/A

Measure of the pore size
distribution (van genuchten)

alpha

cm-1

Scale parameter inversely
proportional to mean pore
diameter (van genuchten)

Response Parameters ▼

Response Parameters

Parameter

Data Type

Description

CellSize

Int[ ]

The output raster cell size (resolution)

CoordinateSystem

String

The CoordinateSystem defines the projection for the data. A projection specifies how
latitude-longitude coordinates are transformed into 2-dimension x-y coordinates.

Extent

String

The minimum and maximum X and Y coordinates of a bounding box.

Legend

Dictionary

Legend gives the following details for each range of values:
1. color: Hex color used for the soil parameter value
2. Area: Area of certain soil parameter value
3. Count: Number of pixels from the result raster of certain soil parameter value
4. CountAllPixels: Total number of pixels in the result raster
5. Max: maximum soil parameter value
6. Mean: average soil parameter value
7. Min: minimum soil parameter value
8. Area: Area of the soil parameter in acres

Max

Double

Maximum soil parameter value

Mean

Double

Average soil parameter value

Min

Double

Minimum soil parameter value

Percentile5

Double

5th percentile soil parameter value

Percentile95

Double

95th percentile soil parameter value

Product

String

The soil parameter supplied in the request (pH)

Std

Double

Standard deviation for the given soil parameter

pngb64

String

Base64 png string

FileName

String

The tif file that can be downloaded