Live map example
Loading the Mapsource map…
Request / Response
Look up a business near the map
Bias suggestions toward a current map center while preserving ambiguity and source coverage.
API call
curl --fail-with-body --get "https://api.mapsource.io/places/lookup" \
-H "Authorization: Bearer $MAPSOURCE_API_KEY" --data-urlencode "q=coffee" --data-urlencode "lat=45.52" --data-urlencode "lon=-122.68" --data-urlencode "limit=3"Example response
{"schema":"mapsource-lookup.v1","query":"coffee","bestMatchId":"openstreetmap:node/1234567890","ambiguous":false,"results":[{"id":"openstreetmap:node/1234567890","kind":"business","name":"Example Coffee","coordinate":{"lat":45.5212,"lon":-122.6794},"match":{"type":"fuzzy","score":0.91}}],"warnings":[]}Search with geographic context
Bias suggestions toward a map center, restrict by bounds when required, preserve ambiguity for user choice and read the coverage metadata before treating a result as complete.
Discover mapped POIs in a region
Find categories such as coffee, restaurants or pharmacies inside a bounded area, then optionally rank candidates by routing travel time.
Service details
Built around a published contract
Inputs, outputs and limits remain inspectable in the generated API reference.
- Lookup
- GET /api/places/lookup
- Discovery
- POST /api/places/discover
- Context
- Focus, bounds, category and language
- Output
- Ranked places with source coverage