discovery

Find businesses and POIs in a region

Select OSM shops, offices, amenities and visitor facilities inside a viewport, polygon or travel-time region. Uses the local Overpass database, polygon filtering and, optionally, Valhalla. No geocoder index is required. Each internal Overpass, isochrone or matrix request consumes its normal quota; the composition adds no separate request charge.

When to use: Find coffee within a 15-minute drive, list businesses in a map viewport, or filter POIs by an existing isochrone. Paginate bounded results; narrow the area when coverage.truncated is true.

When not to use: Use lookupPlaces for ranked address/name suggestions. Discovery uses feature centers, not full-geometry intersections. It does not guarantee a complete real-world business directory: only mapped OSM records are available. Travel-time ranking compares at most the 25 nearest candidates.

post/places/discover

Request

  • Base URL: https://api.mapsource.io
  • URL: https://api.mapsource.io/places/discover
  • Auth: HTTP bearer

Request body

qstring

Optional business name or brand filter.

categorystring

Optional category alias, such as coffee, pharmacy, restaurants, hotels or shops.

minutesinteger

Generate a reachable region from lat/lon.

latnumber

Latitude in decimal degrees.

lonnumber

Longitude in decimal degrees.

costing'auto' | 'bicycle' | 'pedestrian' | 'truck'

Travel mode for isochrone and matrix requests.

rankBy'distance' | 'travel_time'

distance sorts from lat/lon or the region center. travel_time requires lat/lon, limit <=25 and offset=0; unreachable times remain null.

limitinteger

Page size.

offsetinteger

Offset into the bounded candidate results; re-query after dataset updates may change ordering.

languagestring

Preferred source name language.

Response

Find businesses and POIs in a region

schema'mapsource-discovery.v1'
querystring
regionobject

Search polygon.

rankingobject
warningsstring[]

Changes

No recorded changes to this operation across all 1 revision of this API.