SSURGO Tiles

2 tokens per tile

Vector tiles for USDA SSURGO (Soil Survey Geographic Database) soil map units. Provides detailed soil properties including farmland classification, hydrology, drainage, slope, and water storage.

Endpoint

GEThttps://api.landmapmagic.com/v1/tiles/ssurgo/{z}/{x}/{y}.mvt

Returns a Mapbox Vector Tile containing soil map unit polygon geometries with key soil properties. Zoom range: 0 – 15.

URL Parameters

Parameters

Name	Type	Description
z*	number	Zoom level (0-15).
x*	number	Tile X coordinate.
y*	number	Tile Y coordinate.
key*	string	Your API key.

Source Layers

ssurgoSoil map unit polygons with pre-joined soil properties.z0-15

Attributes

Available Attributes

Attribute	Type	Description
MUKEY	string	Map unit key — the unique identifier for each soil map unit in the SSURGO database.
MUSYM	string	Map unit symbol — the short code used on soil survey maps (e.g. "138B").
muname	string	Map unit name — the full descriptive name (e.g. "Nicollet clay loam, 2 to 5 percent slopes").
farmlndcl	string	Farmland classification (e.g. "All areas are prime farmland", "Farmland of statewide importance").
hydgrp	string	Hydrologic soil group (A, B, C, D, or dual classes like A/D). Indicates runoff potential.
drainagecl	string	Natural drainage class (e.g. "Well drained", "Poorly drained", "Somewhat poorly drained").
slope_r	number	Representative slope percentage for the map unit.
aws0100wta	number	Available water storage (0-100 cm depth), weighted average in centimeters.

Code Examples

curl

curl "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt?key=YOUR_API_KEY" \
  --output tile.mvt

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt?key=YOUR_API_KEY"
);
const data = await response.arrayBuffer();
console.log("Tile size:", data.byteLength, "bytes");

Python

import requests

response = requests.get(
    "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt",
    params={"key": "YOUR_API_KEY"}
)
print(f"Status: {response.status_code}, Size: {len(response.content)} bytes")

Response

Response Headers

HTTP/1.1 200 OK
Content-Type: application/vnd.mapbox-vector-tile
Content-Encoding: gzip
Cache-Control: public, max-age=86400

The response body is a binary MVT protobuf. Empty tiles return HTTP 204 with no body.

SSURGO data is sourced from the USDA Natural Resources Conservation Service (NRCS). Soil properties are pre-joined from the component and horizon tables using dominant-condition or weighted-average aggregation methods. Coverage includes all areas with completed soil surveys in the contiguous United States. Each tile request costs 2 tokens.

Loading documentation...

Name

Type

Description

number

Zoom level (0-15).

number

Tile X coordinate.

number

Tile Y coordinate.

key*

string

Your API key.

Attributes

Available Attributes

Attribute	Type	Description
MUKEY	string	Map unit key — the unique identifier for each soil map unit in the SSURGO database.
MUSYM	string	Map unit symbol — the short code used on soil survey maps (e.g. "138B").
muname	string	Map unit name — the full descriptive name (e.g. "Nicollet clay loam, 2 to 5 percent slopes").
farmlndcl	string	Farmland classification (e.g. "All areas are prime farmland", "Farmland of statewide importance").
hydgrp	string	Hydrologic soil group (A, B, C, D, or dual classes like A/D). Indicates runoff potential.
drainagecl	string	Natural drainage class (e.g. "Well drained", "Poorly drained", "Somewhat poorly drained").
slope_r	number	Representative slope percentage for the map unit.
aws0100wta	number	Available water storage (0-100 cm depth), weighted average in centimeters.

Code Examples

curl

curl "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt?key=YOUR_API_KEY" \
  --output tile.mvt

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt?key=YOUR_API_KEY"
);
const data = await response.arrayBuffer();
console.log("Tile size:", data.byteLength, "bytes");

Python

import requests

response = requests.get(
    "https://api.landmapmagic.com/v1/tiles/ssurgo/13/2107/3041.mvt",
    params={"key": "YOUR_API_KEY"}
)
print(f"Status: {response.status_code}, Size: {len(response.content)} bytes")