Dataset Tiles API — Serve Your Own GeoData as Vector Tiles

⚙️ How It Works

📤 Upload file in dashboard

→

⚙️ Auto-converted to PMTiles

→

🌐 Served via global CDN

→

🗺️ Overlay on your basemap

Files are processed by tippecanoe on our servers and stored on our edge infrastructure. Tiles are typically ready within 5–10 seconds for small files.

🗺️ Dataset tiles are overlays. They display your data on top of a basemap (streets, labels, terrain). Both use the same pk_latlng_… Maps key — one key for everything.

Basemap tiles → tiles.latlng.work/v1/tiles/{z}/{x}/{y}.pbf?key=pk_…
Your dataset → tiles.latlng.work/v1/datasets/{id}/{z}/{x}/{y}.pbf?key=pk_…

📌 Common Use Cases

🏡

Real Estate

Parcel boundaries, zoning districts, flood zones overlaid on a property search map.

🚚

Logistics

Delivery zones, service areas, route polygons — show customers which zone they’re in.

🏛️

Urban Planning

Census tracts, school districts, city boundaries — without a GIS server.

🌱

Environmental

Field survey points, habitat boundaries, sensor locations on an interactive map.

✨ Live Demo Pre-loaded with a sample NYC dataset

The map below shows a real dataset overlaid on LatLng basemap tiles. Swap in your own key and dataset ID from the Datasets dashboard.

Maps Key (pk_latlng_…)

Dataset ID (ds_…)

🗺️ Loading map…

🔗 Endpoints

Vector Tile (PBF)

GET https://tiles.latlng.work/v1/datasets/{id}/{z}/{x}/{y}.pbf?key=pk_latlng_…

Metadata (TileJSON)

GET https://tiles.latlng.work/v1/datasets/{id}/metadata?key=pk_latlng_…

Parameters

Param	Type	Description
`id` *	string	Dataset ID from the dashboard, e.g. `ds_abc123xyz`
`z` *	integer	Zoom level 0–14
`x` *	integer	Tile column
`y` *	integer	Tile row
`key` *	string	Your Maps key (`pk_latlng_…`) — must belong to the dataset owner

⚠️ Dataset tiles only accept Maps keys (pk_latlng_…). Secret keys are rejected with 403 to prevent accidental exposure.

💻 Code Examples

⚠️ Leaflet's L.tileLayer only renders raster (PNG/JPEG) tiles. LatLng basemap tiles are vector (PBF) — use OpenStreetMap raster tiles for the basemap, or switch to the MapLibre tab to use LatLng tiles for everything.

const MY_KEY = 'pk_latlng_your_maps_key';
const DATASET_ID = 'ds_your_dataset_id';

const map = L.map('map').setView([40.71, -74.01], 11);

// Basemap — OSM raster tiles (Leaflet cannot render vector PBF tiles)
L.tileLayer(
  'https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
  { attribution: '© OpenStreetMap contributors', maxZoom: 19 }
).addTo(map);

// Your dataset as an overlay via leaflet.vectorgrid
const datasetLayer = L.vectorGrid.protobuf(
  `https://tiles.latlng.work/v1/datasets/${DATASET_ID}/{z}/{x}/{y}.pbf?key=${MY_KEY}`,
  {
    vectorTileLayerStyles: {
      [DATASET_ID]: {
        color: '#22c55e',
        weight: 2,
        opacity: 1,
        fill: true,
        fillColor: '#22c55e',
        fillOpacity: 0.25,
      }
    }
  }
).addTo(map);

import maplibregl from 'maplibre-gl';

const MY_KEY = 'pk_latlng_your_maps_key';
const DATASET_ID = 'ds_your_dataset_id';

const map = new maplibregl.Map({
  container: 'map',
  style: `https://tiles.latlng.work/v1/style/dark?key=${MY_KEY}`,
  center: [-74.01, 40.71],
  zoom: 11,
});

map.on('load', () => {
  map.addSource('my-dataset', {
    type: 'vector',
    tiles: [
      `https://tiles.latlng.work/v1/datasets/${DATASET_ID}/{z}/{x}/{y}.pbf?key=${MY_KEY}`
    ],
    minzoom: 0,
    maxzoom: 14,
  });

  map.addLayer({
    id: 'dataset-fill',
    type: 'fill',
    source: 'my-dataset',
    'source-layer': DATASET_ID,
    paint: { 'fill-color': '#22c55e', 'fill-opacity': 0.4 },
  });

  map.addLayer({
    id: 'dataset-line',
    type: 'line',
    source: 'my-dataset',
    'source-layer': DATASET_ID,
    paint: { 'line-color': '#22c55e', 'line-width': 2 },
  });
});

const MY_KEY = 'pk_latlng_your_maps_key';
const DATASET_ID = 'ds_your_dataset_id';

// Fetch metadata (bounds, zoom range, layer name)
const meta = await fetch(
  `https://tiles.latlng.work/v1/datasets/${DATASET_ID}/metadata?key=${MY_KEY}`
).then(r => r.json());
console.log(meta.bounds, meta.minzoom, meta.maxzoom);

// Fetch a single tile as ArrayBuffer
const tile = await fetch(
  `https://tiles.latlng.work/v1/datasets/${DATASET_ID}/7/38/48.pbf?key=${MY_KEY}`
).then(r => r.arrayBuffer());
// Decode with @mapbox/vector-tile or pbf library

📊 Plan Limits

Plan	Datasets	Max file size	Tile requests
Free	3	50 MB	Unlimited (CDN-cached)
Pro	50	1 GB	Unlimited (CDN-cached)
Enterprise	Unlimited	5 GB	Unlimited (CDN-cached)

Dataset tile requests are included in your plan and served via our global edge. High-traffic datasets are edge-cached, keeping costs low for everyone. Contact us for dedicated high-volume tiers.

📦 Dataset Tiles API