Search topic

The Search module provides fast, flexible address and place discovery for map-driven Flutter apps. Use this system to resolve addresses, find nearby points of interest, browse category hierarchies, and perform guided hierarchical address lookups — all while tuning behaviour with preferences for fuzziness, result limits, overlays and local vs online data. It is designed for high‑quality geocoding, POI discovery, and contextual searches (around a position, inside an area, or along a route).

• SearchService: The main search entrypoint for free‑text, around‑position, area, and along‑route searches. Use it to run synchronous user searches or long‑running, cancellable queries that return Landmark results.
• SearchPreferences: Central search configuration used by text and area searches. It encapsulates filters, overlays, category constraints, fuzzy matching and maximum result counts to tailor relevance and performance.
• GuidedAddressSearchService: Hierarchical address lookup service for progressive search workflows (countries → regions → streets → addresses). It’s ideal for building address pickers and localized address entry flows where users drill down step‑by‑step.
• GuidedAddressSearchPreferences: Tuning options for guided address searches such as automatic level skipping and onboard‑only mode. Apply preferences to shape the guided experience and balance speed vs completeness.

Search is the bridge between raw map data and discoverable user experiences. By combining guided address flows, category-driven filtering, and configurable preferences with a robust service for spatial queries, the Search module enables consistent, high‑quality discovery and selection of places — improving relevance, reducing user friction, and supporting both online and offline scenarios.

Prefer GuidedAddressSearchService for form‑style address entry where stepwise refinement improves accuracy and UX. For direct user queries, use SearchService with a tailored SearchPreferences to control result volume, fuzziness and overlay filters.

Learn more about search: https://developer.magiclane.com/docs/flutter/guides/category/search