# GEOG

> Vector tile provider SaaS platform with authentication, organization management, and usage-based billing.

## API

Base URL: https://api.geog.dev

Authentication: Bearer token (JWT) in Authorization header.

### Endpoints

- GET /v1/tiles/{tileset}/{z}/{x}/{y}.mvt — Retrieve a vector tile (scope: tiles:read)
- POST /v1/places/search — Search places by query and location (scope: places:read)
- POST /v1/auth/token — Exchange long-lived token for short-lived access token (1–4 hours)
- GET /.well-known/jwks.json — Public JWKS endpoint for JWT validation

### Token Scopes

- tiles:read — Read vector tiles
- places:read — Search places
- billing:manage — Manage organization billing

### Rate Limits (Free Tier)

- Vector tiles: 2,000 requests/day
- Places API: 500 requests/day
- Paid plans: unlimited

### Token Exchange

POST /v1/auth/token with Authorization: Bearer {long_lived_token} and JSON body {"ttl": 3600, "scope": "tiles:read"} returns a short-lived access token.

## Resources

- Documentation: https://geog.dev/docs
- Full LLM context: https://geog.dev/llms-full.txt
- OpenAPI spec: https://geog.dev/openapi.yaml