States Tiles

Vector tiles for US state boundaries and labels. Ideal for thematic maps, state-level aggregations, and administrative overlays.

Endpoint

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

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

URL Parameters

Parameters

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

Source Layers

statesState polygon boundaries.z0-6

states_labelsState label points (centroids).z0-6

Attributes

Available Attributes

Attribute	Type	Description
id	number	Unique internal feature identifier.
NAME	string	Full state name (e.g. "Iowa").
STUSPS	string	Two-letter USPS state abbreviation (e.g. "IA").
STATEFP	string	Two-digit FIPS state code (e.g. "19").

Code Examples

curl

curl "https://api.landmapmagic.com/v1/tiles/states/4/3/6.mvt?key=YOUR_API_KEY" \
  --output tile.mvt

JavaScript

const response = await fetch(
  "https://api.landmapmagic.com/v1/tiles/states/4/3/6.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/states/4/3/6.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. Use a vector tile library such as deck.gl MVTLayer, Mapbox GL JS, or maplibre-gl to decode and render the tile.

State boundaries cover 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.