MAPS & PLACES API
Maps & Places, seen clearly.
Predictive location search and self-hosted vector maps behind one API key. Fast, GB-first, and priced per request — no black boxes.
curl "https://api.goggleplaces.com/predict?q=Trafalgar" \
-H "x-api-key: gk_live_pk_••••4f2a"
→ 200 "We see 14 places."WHAT IT DOES
Everything you need to place things on a map.
Predictive search
Typeahead over GB place names, postcodes and POIs — ranked, typo-tolerant, sub-50ms from the edge.
Nearby lookup
Reverse-geocode and “what’s around here” from a lat/lng, tuned for the way people actually search.
Self-hosted vector maps
Your own Protomaps tiles + a MapLibre style and JS SDK. No per-tile surprises, attribution baked in.
Keys that behave
Publishable + secret keys, scoped, rotatable, origin-locked, rate-limited and metered per request.
Usage you can see
Every call metered and visible. Free allowance, then transparent per-1,000 overage. No estimates.
Gated at the edge
Keys validated in CloudFront before origin — even cache hits are authorised. Abuse stops early.
HOW IT WORKS
Three steps to your first result.
Get a key
Create an organisation in the dashboard and mint a publishable or secret key in seconds.
gk_live_pk_9f2a…Call the API
Point /predict or /nearby at your key. Restrict browser keys to your origins.
GET /predict?q=York&key=gk_live_pk_…Drop in a map
Two lines of the SDK mounts a search box or a self-hosted map, attribution included.
import { map } from '@goggleplaces/sdk'
map({ container: 'map', key })