Skip to documentation
Developer documentation
Get API key
REST API v1

Intelligence map tiles

Overlay Energy, Federal Land or Texas intelligence and style tiles using data values.

On this page
Energy Tiles API

Vector Tiles

The Energy pack's map layers as vector tiles: state-regulator wells, FracFocus, orphaned wells, pipelines, sage-grouse habitat, solar zones, wind turbines, and federal subsurface minerals. Served from the maps CDN, authenticated with an api_key query parameter.

Tile URL Pattern

https://maps.townshipamerica.com/energy/{archive}/{z}/{x}/{y}.mvt?api_key=... https://maps.townshipamerica.com/energy/{archive}.json?api_key=... (TileJSON)
Available Archives

Every archive's vector source-layer equals the archive name (MapLibre needs it in source-layer). Anything outside this list returns 403.

Archive Source Layer Layer
co_wellsco_wellsColorado wells (ECMC)
co_wells_labelsco_wells_labelsColorado wells (labels)
nd_wellsnd_wellsNorth Dakota wells (DMR)
nd_wells_labelsnd_wells_labelsNorth Dakota wells (labels)
ok_wellsok_wellsOklahoma wells (OCC)
ok_wells_labelsok_wells_labelsOklahoma wells (labels)
wy_wellswy_wellsWyoming wells (WOGCC)
wy_wells_labelswy_wells_labelsWyoming wells (labels)
nm_wellsnm_wellsNew Mexico wells (OCD)
nm_wells_labelsnm_wells_labelsNew Mexico wells (labels)
fracfocusfracfocusFracFocus chemical disclosures
fracfocus_labelsfracfocus_labelsFracFocus (labels)
usgs_orphaned_wellsusgs_orphaned_wellsUSGS documented orphaned wells
usgs_orphaned_wells_labelsusgs_orphaned_wells_labelsUSGS orphaned wells (labels)
usgs_wind_turbinesusgs_wind_turbinesUSGS wind turbines
usgs_wind_turbines_labelsusgs_wind_turbines_labelsUSGS wind turbines (labels)
sage_grouse_hmasage_grouse_hmaBLM Sage-Grouse habitat management areas
sage_grouse_hma_labelssage_grouse_hma_labelsSage-Grouse HMA (labels)
western_solarwestern_solarBLM Western Solar Plan zones
western_solar_labelswestern_solar_labelsWestern Solar (labels)
nrel_land_of_opportunitynrel_land_of_opportunityNREL Land of Opportunity (CC-BY 4.0)
nrel_land_of_opportunity_labelsnrel_land_of_opportunity_labelsNREL Land of Opportunity (labels)
fed_subsurface_mineralsfed_subsurface_mineralsFederal subsurface mineral estate
fed_subsurface_minerals_labelsfed_subsurface_minerals_labelsFederal subsurface minerals (labels)
og_pipelines_natgasog_pipelines_natgasHIFLD natural gas pipelines
og_pipelines_nglog_pipelines_nglHIFLD NGL pipelines
og_pipelines_crudeog_pipelines_crudeHIFLD crude oil pipelines
tx_pipelinestx_pipelinesTexas RRC T-4 pipelines

The _labels archives are the same footprint rendered as a label layer. Add them as their own source alongside the geometry archive when you want text; the pipeline archives carry their labels inline.

MapLibre Usage
const KEY = "YOUR_API_KEY";
const base = "https://maps.townshipamerica.com/energy";

// State-regulator wells: point archive + companion _labels archive.
// Every archive's source-layer equals the archive name.
map.addSource("co-wells", {
  type: "vector",
  tiles: [`${base}/co_wells/{z}/{x}/{y}.mvt?api_key=${KEY}`],
  minzoom: 0,
  maxzoom: 14
});

map.addLayer({
  id: "co-wells-points",
  type: "circle",
  source: "co-wells",
  "source-layer": "co_wells",
  paint: { "circle-radius": 3, "circle-color": "#b5651d" }
});

// TileJSON works too, and carries the bounds and zoom range
map.addSource("og-pipelines-natgas", {
  type: "vector",
  url: `${base}/og_pipelines_natgas.json?api_key=${KEY}`
});
Federal Land Tiles API

Vector Tiles

The Federal Land pack's map layers as vector tiles: surface management, mining claims, SSURGO soils, firesheds, wildfire risk, and wetlands. Served from the maps CDN, authenticated with an api_key query parameter.

Tile URL Pattern

https://maps.townshipamerica.com/federal-land/{archive}/{z}/{x}/{y}.mvt?api_key=... https://maps.townshipamerica.com/federal-land/{archive}.json?api_key=... (TileJSON)
Available Archives

Every archive's vector source-layer equals the archive name. Anything outside this list returns 403.

Archive Source Layer Layer
surface_managementsurface_managementBLM Surface Management Agency
surface_management_labelssurface_management_labelsSurface management (labels)
mining_claimsmining_claimsBLM MLRS mining claims
mining_claims_labelsmining_claims_labelsMining claims (labels)
nrcs_ssurgo_soilsnrcs_ssurgo_soilsNRCS SSURGO soils
nrcs_ssurgo_soils_labelsnrcs_ssurgo_soils_labelsSSURGO soils (labels)
usfs_fireshedsusfs_fireshedsUSFS firesheds
usfs_firesheds_labelsusfs_firesheds_labelsFiresheds (labels)
usfs_wrcusfs_wrcUSFS Wildfire Risk to Communities
usfs_wrc_labelsusfs_wrc_labelsWildfire risk (labels)
usfws_wetlandsusfws_wetlandsUSFWS National Wetlands Inventory
usfws_wetlands_labelsusfws_wetlands_labelsWetlands (labels)
MapLibre Usage
const KEY = "YOUR_API_KEY";
const base = "https://maps.townshipamerica.com/federal-land";

// Surface management polygons. Every archive's source-layer equals
// the archive name; _labels archives are companion label layers.
map.addSource("surface-management", {
  type: "vector",
  tiles: [`${base}/surface_management/{z}/{x}/{y}.mvt?api_key=${KEY}`],
  minzoom: 0,
  maxzoom: 14
});

map.addLayer({
  id: "surface-management-fill",
  type: "fill",
  source: "surface-management",
  "source-layer": "surface_management",
  paint: { "fill-color": "#3d6b99", "fill-opacity": 0.4 }
});

// TileJSON works too, and carries the bounds and zoom range
map.addSource("usfws-wetlands", {
  type: "vector",
  url: `${base}/usfws_wetlands.json?api_key=${KEY}`
});
Texas Tiles API

Vector Tiles

The Texas pack's map layers as vector tiles: the abstract/block/survey grid, GLO leases and units, PSF lands, RRC wells, permits, pipelines, coastal hazard layers, and the RRC production heatmap. Served from the maps CDN, authenticated with an api_key query parameter.

Tile URL Pattern

https://maps.townshipamerica.com/texas/{archive}/{z}/{x}/{y}.mvt?api_key=... https://maps.townshipamerica.com/texas/{archive}.json?api_key=... (TileJSON)
Available Archives

Every archive's vector source-layer equals the archive name, except the tx_production_grid_* family, whose three archives all share the source-layer tx_production_grid. Anything outside this list returns 403.

Archive Source Layer Layer
texas-land-surveystexas-land-surveysTexas land surveys (abstract / block / survey grid)
texas-land-surveys-labelstexas-land-surveys-labelsTexas land surveys (labels)
tx_otlstx_otlsTexas land surveys (legacy slug)
tx_otls_labelstx_otls_labelsTexas land surveys labels (legacy slug)
tx_leasestx_leasesGLO active O&G leases
tx_leases_labelstx_leases_labelsGLO leases (labels)
tx_glo_unitstx_glo_unitsGLO pooled units
tx_glo_units_labelstx_glo_units_labelsGLO pooled units (labels)
tx_glo_poolingtx_glo_poolingGLO pooling agreements
tx_glo_pooling_labelstx_glo_pooling_labelsGLO pooling (labels)
tx_glo_land_typestx_glo_land_typesGLO land types
tx_glo_land_types_labelstx_glo_land_types_labelsGLO land types (labels)
tx_psf_landstx_psf_landsPermanent School Fund lands
tx_psf_lands_labelstx_psf_lands_labelsPSF lands (labels)
tx_state_agency_landstx_state_agency_landsState agency lands
tx_state_agency_lands_labelstx_state_agency_lands_labelsState agency lands (labels)
tx_upland_leasestx_upland_leasesGLO upland surface leases
tx_upland_leases_labelstx_upland_leases_labelsUpland leases (labels)
tx_non_mineral_leasestx_non_mineral_leasesGLO non-mineral leases
tx_non_mineral_leases_labelstx_non_mineral_leases_labelsNon-mineral leases (labels)
tx_hard_mineralstx_hard_mineralsGLO hard mineral leases
tx_hard_minerals_labelstx_hard_minerals_labelsHard minerals (labels)
tx_wells_surfacetx_wells_surfaceRRC wells (surface hole)
tx_wells_surface_labelstx_wells_surface_labelsRRC surface wells (labels)
tx_wells_bottomtx_wells_bottomRRC wells (bottom hole)
tx_wells_bottom_labelstx_wells_bottom_labelsRRC bottom-hole wells (labels)
tx_uic_wellstx_uic_wellsRRC UIC injection/disposal wells
tx_uic_wells_labelstx_uic_wells_labelsUIC wells (labels)
tx_permitstx_permitsRRC approved drilling permits (W-1)
tx_permits_labelstx_permits_labelsDrilling permits (labels)
tx_pipelinestx_pipelinesRRC T-4 pipelines
tx_bay_tractstx_bay_tractsGLO bay tracts
tx_bay_tracts_labelstx_bay_tracts_labelsBay tracts (labels)
tx_coastal_leasestx_coastal_leasesGLO coastal leases
tx_coastal_leases_labelstx_coastal_leases_labelsCoastal leases (labels)
tx_oyster_leasestx_oyster_leasesOyster leases
tx_oyster_leases_labelstx_oyster_leases_labelsOyster leases (labels)
tx_critical_erosiontx_critical_erosionGLO critical erosion areas
tx_critical_erosion_labelstx_critical_erosion_labelsCritical erosion (labels)
tx_shoreline_change_ratestx_shoreline_change_ratesShoreline change rates
tx_shoreline_change_rates_labelstx_shoreline_change_rates_labelsShoreline change (labels)
tx_flood_hazardtx_flood_hazardFEMA flood hazard (Texas)
tx_flood_hazard_labelstx_flood_hazard_labelsFlood hazard (labels)
tx_production_grid_countytx_production_gridRRC production heatmap (county rollup)
tx_production_grid_blocktx_production_gridRRC production heatmap (block rollup)
tx_production_grid_abstracttx_production_gridRRC production heatmap (abstract)
Zoom-Banded Rollup Family

The RRC production heatmap ships as three archives covering different zoom bands (abstract geometry is far too dense to draw at state scale). Add all three as separate sources and let the zoom ranges hand off; a client that adds only the abstract archive sees an empty map below z9. All three share the source-layer tx_production_grid.

Zoom Archive Granularity
z4-7tx_production_grid_countyCounty
z7-9tx_production_grid_blockBlock
z9+tx_production_grid_abstractAbstract

The _labels archives are the same footprint rendered as a label layer. tx_pipelines is the exception: its archive carries both geometry and labels.

MapLibre Usage
const KEY = "YOUR_API_KEY";
const base = "https://maps.townshipamerica.com/texas";

// The RRC production heatmap is a zoom-banded family: add all three
// sources. They SHARE the source-layer "tx_production_grid"; a client
// that adds only the abstract archive sees an empty map below z9.
map.addSource("txprod-county", {
  type: "vector",
  tiles: [`${base}/tx_production_grid_county/{z}/{x}/{y}.mvt?api_key=${KEY}`],
  minzoom: 4,
  maxzoom: 7
});
map.addSource("txprod-block", {
  type: "vector",
  tiles: [`${base}/tx_production_grid_block/{z}/{x}/{y}.mvt?api_key=${KEY}`],
  minzoom: 7,
  maxzoom: 9
});
map.addSource("txprod-abstract", {
  type: "vector",
  tiles: [`${base}/tx_production_grid_abstract/{z}/{x}/{y}.mvt?api_key=${KEY}`],
  minzoom: 9,
  maxzoom: 14
});

map.addLayer({
  id: "txprod-abstract-fill",
  type: "fill",
  source: "txprod-abstract",
  "source-layer": "tx_production_grid", // shared across all three archives
  minzoom: 9,
  paint: { "fill-color": "#fd8d3c", "fill-opacity": 0.55 }
});

// Every other archive's source-layer equals the archive name.
// TileJSON works too, and carries the bounds and zoom range
map.addSource("texas-land-surveys", {
  type: "vector",
  url: `${base}/texas-land-surveys.json?api_key=${KEY}`
});