# geolith Tiles docs: vector tile API documentation

> geolith Tiles docs: the hosted vector tile API at api.geolith.app (India tile set today; planet tiles in development; TileJSON, Mapbox Vector Tiles, the india tile set, keys, limits, a MapLibre example) and the self-hosted edge tile server in development.

Status: Live. The hosted tile API is live. The self-hosted edge tile server (geolith/tiles) is in design: it has no server code yet.

Vector tiles that geolith builds from OpenStreetMap and Overture Maps, served from api.geolith.app with your key (India tile set today; planet tiles in development). The self-hosted edge server is in development.

Endpoints: GET https://api.geolith.app/v1/tiles/india.json?api_key=YOUR_API_KEY (TileJSON 3.0.0) and GET https://api.geolith.app/v1/tiles/india/{z}/{x}/{y}.mvt?api_key=YOUR_API_KEY (Mapbox Vector Tile, 204 when empty). Free plan: 200,000 map tiles a month (India tile set today; planet tiles in development).

## Features

- TileJSON 3.0.0: One URL gives MapLibre the tile URL, zooms, bounds and layers.
- Protomaps schema: Earth, water, roads, buildings, places, POIs and more, zoom 0 to 15.
- The india tile set: India tile set today; planet tiles in development. Built by geolith from OpenStreetMap and Overture Maps.
- Gzip and caching: Tiles go out gzipped when the client accepts it, cacheable for a day.
- Keys and origins: The same keys as geocoding. Publishable keys answer only listed origins.
- Hard limits: 200,000 free tiles a month (India tile set today; planet tiles in development), 20 tile requests a second per visitor.

## Docs

- [Hosted API](https://docs.geolith.app/tiles/hosted/overview.md): Endpoints, the tile set and its layers, TileJSON, responses and caching.
- [MapLibre](https://docs.geolith.app/tiles/hosted/maplibre.md): Add the tile set to a MapLibre GL JS map with a publishable key.
- [Keys and limits](https://docs.geolith.app/tiles/hosted/limits.md): Keys, allowed origins, monthly allowances, rate limits and errors.
- [Edge tile server](https://docs.geolith.app/tiles/self-hosting/edge-server.md): In development: the planned Cloudflare Worker that serves PMTiles from R2.