Counties Tiles

Vector tiles for US county boundaries and labels. Use for county-level choropleths, administrative boundaries, and regional analysis.

Endpoint

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

Returns a Mapbox Vector Tile containing county polygon geometries and label points. Zoom range: 0 – 12.

URL Parameters

Parameters

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

Source Layers

countiesCounty polygon boundaries.z2-14

counties_labelsCounty label points (centroids).z0-12

Attributes

Available Attributes

Attribute	Type	Description
id	number	Unique internal feature identifier.
NAME	string	County name (e.g. "Story").
COUNTYFP	string	Three-digit FIPS county code (e.g. "169").
STATEFP	string	Two-digit FIPS state code for the parent state (e.g. "19").
STATE_NAME	string	Full name of the parent state (e.g. "Iowa").
COUNTYNS	string	GNIS (Geographic Names Information System) identifier for the county.

Code Examples

curl

curl "https://api.landmapmagic.com/v1/tiles/counties/6/15/23.mvt?key=YOUR_API_KEY" \
  --output tile.mvt

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/tiles/counties/6/15/23.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/counties/6/15/23.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.

Styles

Fetch a renderer-ready style for the Counties layer from the unified /v1/styles endpoint. The response includes sources, layers, attribution, zoom ranges, and label deduplication baked in. Use the landmapmagic npm package for one-line install per target, or call the API directly.

MapLibre / Mapbox

Identical payload either way — Mapbox GL JS consumes a MapLibre Style Spec v8 doc as-is. Pick the keyword that reads best in your codebase.

URL (maplibre)

GET https://api.landmapmagic.com/v1/styles?target=maplibre&layers=counties&key=YOUR_API_KEY

URL (mapbox)

GET https://api.landmapmagic.com/v1/styles?target=mapbox&layers=counties&key=YOUR_API_KEY

JavaScript

const style = await fetch(
  'https://api.landmapmagic.com/v1/styles?' +
    new URLSearchParams({
      key: 'YOUR_API_KEY',
      target: 'maplibre', // or 'mapbox' — same response
      layers: 'counties',
    })
).then((r) => r.json());

map.setStyle(style);

Leaflet

URL

GET https://api.landmapmagic.com/v1/styles?target=leaflet&layers=counties&key=YOUR_API_KEY

JavaScript

import { mountLeafletLandMap } from 'landmapmagic/leaflet';

await mountLeafletLandMap({
  apiKey: 'YOUR_API_KEY',
  map,
  layers: ['counties'],
});

Google + deck.gl

URL

GET https://api.landmapmagic.com/v1/styles?target=google&layers=counties&key=YOUR_API_KEY

JavaScript

import { mountGoogleLandMap } from 'landmapmagic/google';

await mountGoogleLandMap({
  apiKey: 'YOUR_API_KEY',
  map,
  overlay,
  layers: ['counties'],
});

County boundaries cover all counties and county-equivalents in the 50 US states and the District of Columbia. US territories (Puerto Rico, Guam, US Virgin Islands, American Samoa, and Northern Mariana Islands) are excluded from this layer.