Skip to content
Plaza Plaza Docs
GuidesBlogPlaygroundDashboard
Getting Started
Introduction

Introduction

Geospatial data API with billions of features from OpenStreetMap and other open datasets. Geocoding, routing, elevation, search, and spatial queries.

Plaza is a geospatial data API. The full OpenStreetMap planet, curated open datasets, and your own custom data — all queryable through REST or PlazaQL.

All responses are GeoJSON. Coordinates are always [longitude, latitude]. No external services or sidecars — just one API.

Get your API key

Section titled “Get your API key”

Sign up at plaza.fyi and grab a key from the dashboard. It starts with pk_live_.

Your first request

Section titled “Your first request”

Find every cafe within 500m of the Eiffel Tower:

Terminal window
curl -X POST https://plaza.fyi/api/v1/features \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_YOUR_KEY" \
  -d '{"around": {"type": "Point", "coordinates": [2.2945, 48.8584]}, "radius": 500, "tags": {"amenity": "cafe"}}'

You get back a GeoJSON FeatureCollection:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "node/12345678",
      "geometry": { "type": "Point", "coordinates": [2.2938, 48.8579] },
      "properties": {
        "@type": "node",
        "@id": 12345678,
        "amenity": "cafe",
        "name": "Cafe du Trocadero"
      }
    }
  ]
}

Using an SDK

Section titled “Using an SDK”
Terminal window
# TypeScript / Node
npm install @plazafyi/sdk


# Python
uv add plaza


# Go
go get github.com/plazafyi/plaza-go
import Plaza from "@plazafyi/sdk";


const client = new Plaza();
const cafes = await client.features.search({
  around: { type: "Point", coordinates: [2.2945, 48.8584] },
  radius: 500,
  tags: { amenity: "cafe" },
});


for (const cafe of cafes.features) {
  console.log(cafe.properties.name);
}

What you can do

Section titled “What you can do”
FeatureWhat it does
GeocodingAddress → coordinates, coordinates → address, autocomplete, batch
RoutingDirections, turn-by-turn, isochrones, distance matrices
SearchFull-text search across all features and datasets
ElevationPoint lookup, profiles with ascent/descent stats
Map matchingSnap GPS traces to roads
OptimizationSolve traveling salesman for up to 100 stops
PlazaQLPurpose-built query language for geospatial data
Vector tilesMVT tiles for rendering your own maps
DatasetsUpload and query your own feature collections