Soils

Retrieve soil map unit boundaries and attributes for a geographic area. Returns GeoJSON polygons with soil productivity data from SSURGO.

Endpoint

GEThttps://api.landmapmagic.com/api/soils/bounds

This endpoint also supports POST requests with an AOI (Area of Interest) GeoJSON body for more precise queries.

Parameters

Name	Type	Description
bounds*	string	Bounding box as "min_lat,min_lng,max_lat,max_lng". Defines the geographic area to query.
year	integer	Survey year for soil data. Defaults to the most recent available year.

Response Attributes

Feature Properties

Attribute	Type	Description
smu	string	Soil Map Unit identifier.
description	string	Human-readable soil map unit description (e.g. soil series name and texture).
acres	number	Total acres covered by this soil map unit in the queried area.
percentage	number	Percentage of the queried area covered by this soil map unit.
productivity	number	Soil productivity index rating.

Code Examples

cURL

curl -G "https://api.landmapmagic.com/api/soils/bounds" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "bounds=41.98,-93.68,42.08,-93.58" \
  --data-urlencode "year=2024"

JavaScript

const params = new URLSearchParams({
  bounds: "41.98,-93.68,42.08,-93.58",
  year: "2024",
});

const response = await fetch(
  `https://api.landmapmagic.com/api/soils/bounds?${params}`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);

const geojson = await response.json();
for (const feature of geojson.features) {
  console.log(feature.properties.smu, feature.properties.description);
}

Python

import requests

response = requests.get(
    "https://api.landmapmagic.com/api/soils/bounds",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "bounds": "41.98,-93.68,42.08,-93.58",
        "year": 2024,
    },
)

geojson = response.json()
for feature in geojson["features"]:
    props = feature["properties"]
    print(f"{props['smu']}: {props['description']} ({props['acres']} acres)")

Response

The response is a GeoJSON FeatureCollection. Each Feature contains a Polygon geometry representing a soil map unit boundary.

Example Response

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "smu": "55B2",
        "description": "Clarion loam, 2 to 5 percent slopes, moderately eroded",
        "acres": 34.7,
        "percentage": 18.2,
        "productivity": 82
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -93.6319,
              42.0308
            ],
            [
              -93.6319,
              42.038
            ],
            [
              -93.625,
              42.038
            ],
            [
              -93.625,
              42.0308
            ],
            [
              -93.6319,
              42.0308
            ]
          ]
        ]
      }
    }
  ]
}

Loading documentation...

Name

Type

Description

bounds*

string

Bounding box as "min_lat,min_lng,max_lat,max_lng". Defines the geographic area to query.

year

integer

Survey year for soil data. Defaults to the most recent available year.