Search parameters: FuzzySearchParams, GeometrySearchParams or AlongRouteSearchParams
Promise resolving to a collection of matching places
The search service provides:
Results are ranked by relevance with scores and optional distances.
// Free-text search near a location
const results = await discoverPlaces({
query: 'pizza restaurant',
geoBias: { position: [4.9041, 52.3676] }, // Amsterdam
limit: 10
});
// Search within a specific area
const areaResults = await discoverPlaces({
query: 'coffee shop',
geometries: [polygon], // Search within this polygon
limit: 20
});
// Category search
const restaurants = await discoverPlaces({
filters: { poiCategories: ['ITALIAN_RESTAURANT'] },
geoBias: { position: [4.9041, 52.3676], radiusMeters: 5000 } // Within 5km
});
// The same, from a category in words
const italian = await discoverPlaces({
filters: { poiCategoryQuery: 'italian food' },
geoBias: { position: [4.9041, 52.3676], radiusMeters: 5000 }
});
Universal search function for finding places by text query, within geometries or along a route.
Runs one of three searches, picked from its params:
routeis given: places within a detour budget of the routegeometriesis given: places inside those areasgeoBias