API Documentation

X-Api-Key: latlng_your_key_here

https://tiles.latlng.work/v1/metadata?key=pk_latlng_your_key

curl "https://api.latlng.work/api?q=Seattle,WA" \
  -H "X-Api-Key: your_api_key"

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-122.3321, 47.6062]
      },
      "properties": {
        "name": "Seattle",
        "state": "Washington",
        "country": "United States",
        "type": "city"
      }
    }
  ]
}

curl "https://api.latlng.work/reverse?lat=47.6062&lon=-122.3321" \
  -H "X-Api-Key: your_api_key"

curl "https://api.latlng.work/v1/places/nearby?lat=47.6062&lon=-122.3321&radius=1000&limit=5" \
  -H "X-Api-Key: your_api_key"

{
  "type": "nearby",
  "center": { "lat": 47.6062, "lon": -122.3321 },
  "radius": 1000,
  "count": 2,
  "places": [
    {
      "name": "Pike Place Market",
      "lat": 47.6097,
      "lon": -122.3425,
      "category": "marketplace",
      "distance_m": 328
    },
    {
      "name": "Starbucks Reserve Roastery",
      "lat": 47.6140,
      "lon": -122.3281,
      "category": "cafe",
      "distance_m": 912
    }
  ]
}

curl "https://api.latlng.work/v1/places/search?q=Starbucks&lat=47.60&lon=-122.33&limit=5" \
  -H "X-Api-Key: your_api_key"

{
  "type": "search",
  "query": "Starbucks",
  "count": 2,
  "places": [
    {
      "name": "Starbucks",
      "lat": 47.6101,
      "lon": -122.3420,
      "category": "cafe",
      "distance_m": 845,
      "match_score": 1.0
    }
  ]
}

curl "https://api.latlng.work/v1/places/autosuggest?q=star&lat=47.60&lon=-122.33" \
  -H "X-Api-Key: your_api_key"

{
  "type": "autosuggest",
  "query": "star",
  "suggestions": [
    { "name": "Starbucks", "category": "cafe", "similarity": 0.85 },
    { "name": "Star Nails", "category": "beauty_salon", "similarity": 0.72 }
  ]
}

curl "https://api.latlng.work/v1/places/categories" \
  -H "X-Api-Key: your_api_key"

{
  "categories": [
    { "name": "restaurant", "count": 584210 },
    { "name": "cafe", "count": 312045 },
    { "name": "hotel", "count": 198432 }
  ]
}

<link rel="stylesheet" href="https://unpkg.com/maplibre-gl/dist/maplibre-gl.css">
<script src="https://unpkg.com/maplibre-gl/dist/maplibre-gl.js"></script>
<script src="https://unpkg.com/protomaps-themes-base"></script>

<div id="map" style="width:100%; height:400px;"></div>

<script>
const map = new maplibregl.Map({
  container: 'map',
  style: {
    version: 8,
    glyphs: 'https://protomaps.github.io/basemaps-assets/fonts/{fontstack}/{range}.pbf',
    sprite: 'https://protomaps.github.io/basemaps-assets/sprites/v4/light',
    sources: {
      protomaps: {
        type: 'vector',
        url: 'https://tiles.latlng.work/v1/metadata?key=pk_latlng_YOUR_KEY'
      }
    },
    layers: protomapsL.layers('protomaps', protomapsL.namedFlavor('light'), { lang: 'en' })
  },
  center: [-122.33, 47.61],
  zoom: 13
});
</script>

https://api.latlng.work/v1/static
  ?center=-74.006,40.7128
  &zoom=12
  &width=800&height=400
  &style=dark
  &key=YOUR_KEY

https://api.latlng.work/v1/static
  ?center=-74.006,40.7128
  &zoom=14
  &markers=-74.006,40.7128,22c55e,A
  &key=YOUR_KEY

https://api.latlng.work/v1/static
  ?bbox=-74.25,40.49,-73.7,40.92
  &width=1200&height=600
  &style=light
  &key=YOUR_KEY

const params = new URLSearchParams({
  center: '-74.006,40.7128',
  zoom: '12',
  width: '800',
  height: '400',
  style: 'dark',
  key: 'YOUR_KEY'
});
const img = document.createElement('img');
img.src = `https://api.latlng.work/v1/static?${params}`;
document.body.appendChild(img);

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], 12);

// Base tiles
L.tileLayer(`https://tiles.latlng.work/v1/tiles/{z}/{x}/{y}.pbf?key=${MY_KEY}`).addTo(map);

// Your dataset as a vector tile layer (requires Leaflet.VectorGrid)
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, fillOpacity: 0.4 }
    }
  }
).addTo(map);

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

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: 'my-dataset-layer',
  type: 'fill',
  source: 'my-dataset',
  'source-layer': DATASET_ID,
  paint: {
    'fill-color': '#22c55e',
    'fill-opacity': 0.5
  }
});