Map

Map feature — retrieve facilities based on geographic location or viewport.

This interface provides operations to search for facilities near a specific point (latitude/longitude) or within a bounding box (viewport). Results may include facilities not yet associated with the current member, allowing discovery and optional enrollment.

Capabilities

• Nearby search: find facilities near a given coordinate.

• Viewport search: get facilities within a rectangular map area.

Platform & threading

• All functions are suspend and must be called from a coroutine.

• Errors surface as Throwable and should be handled at call sites.

Typical flows

• Discover facilities: call getNearbyFacilities when a user searches near their location.

• Map browsing: call getFacilitiesByViewPort as the user pans/zooms a map view.