Look up addresses, businesses and places
Local OSM address/name lookup for map search and routing destination pickers. Supports business categories, partial names, accent normalization and typo matching. Coordinates bias ranking; bounded=true is required to restrict results to bbox. When the global index is unavailable, coverage identifies the regional Overpass and place-name-index fallback. Included in every subscription plan: one successful lookup counts as one request, plus an interpreter request if regional Overpass fallback is used. Search index freshness is independent of the Overpass dataset; read coverage.dataTimestamp.
When to use: Find an address, business, brand, landmark, street or populated place. Use a location qualifier such as Starbucks in Portland to search away from the map focus.
When not to use: Use discoverPlaces to enumerate businesses in a viewport or travel-time region. Ranking scores are not probabilities; bestMatchId is null for ambiguous matches. House numbers are never substituted.
Request
- Base URL: https://api.mapsource.io
- URL: https://api.mapsource.io/places/lookup
- Auth: HTTP bearer
Query parameters
Search text; addresses retain the requested house number.
Latitude in decimal degrees.
Longitude in decimal degrees.
Maximum results.
Preferred language code. Unavailable translations fall back to source names with a warning.
Comma-separated address,business,landmark,street,place filters.
Business/POI category or alias, such as coffee, pharmacy, restaurants, groceries, hotels, shops or parks.
Comma-separated two-letter country codes. Records without a source country code do not satisfy this filter.
west,south,east,north. A focus hint unless bounded=true; no dateline crossing.
Restrict results to bbox. A bias point alone never requests this restriction.
Response
Look up addresses, businesses and places
Changes
No recorded changes to this operation across all 1 revision of this API.