OpenStreetMap Search
[TOC]
Purpose
The OpenStreetMap Search (also called the OpenStreetMap Locator) is an advanced, interactive map-based property search feature powered by OpenStreetMap and the Leaflet mapping library. It allows visitors to search for properties by entering an address, browsing an interactive map, or searching within a defined radius around a location. Unlike a standard list-based search, this feature gives users a visual and geographic way to discover available properties.
How It Works
When the OpenStreetMap Search page loads, an interactive map is displayed, centered on the site's default location as configured by the administrator. Published properties that have geographic coordinates are shown as map pins or clustered markers. As the user interacts with the map — searching for an address, adjusting filters, or setting a radius — the displayed pins update to reflect only the matching properties.
If a user types in an address and submits the search, the system uses OpenStreetMap's geocoding service to look up the location and pan the map to that place. Properties within the map's current view, or within the specified radius, are then shown as pins.
Clicking on a property pin opens a popup with key details and a link to the full property page.
The search panel also includes optional filters (property type, category, price range, bedrooms, and bathrooms) that allow users to narrow the results further without leaving the map view.
How to Use It
- Open the OpenStreetMap Search page from the site menu. The map will load, showing the default area set by the administrator.
- Search by address — Type an address, city, or place name in the search field and press Enter or click the Search button. The map will pan to the entered location.
- Browse the map — Drag to pan the map, and use the scroll wheel or zoom buttons to zoom in and out. Property pins appear for available listings in the current view.
- Click a property pin — Select any pin to see a popup with the property name, price, and a link to its detail page.
- Set a search radius (if available) — Adjust the radius slider to define the distance from the searched location in which you want to see properties.
- Apply filters — Use the filter panel to narrow results by property type, category, price range, bedrooms, or bathrooms.
- Click "View Details" in a popup to open the full property listing page.
Practical Use Cases
- Neighborhood search — A buyer wants to see all available apartments in a specific neighborhood. They type the neighborhood name in the search field, and the map zooms to that area showing nearby pins.
- Radius-based search — A renter wants to live within 3 km of their workplace. They search for the office address, set the radius to 3 km, and the map shows only properties within that range.
- Visual area browsing — A visitor wants to compare what is available in two different districts. They navigate between the districts on the map to visually compare listing density and types.
- Quick mobile search — A user on a mobile device wants to see what is available near a specific landmark. They type the landmark's name and browse the result pins on the touchscreen map.
- Filtered map search — A buyer is looking specifically for 3-bedroom homes under a certain price in a particular city. They type the city, apply the bedrooms and price filters, and the map shows only qualifying properties.
Key Elements on the Screen
Interactive map
The main element of the page. Displays an OpenStreetMap-based map with property pins:
- Single pins — Represent individual properties
- Clustered pins — Represent groups of nearby properties; clicking a cluster zooms in to show individual pins
- Popups — Appear when clicking a pin, showing the property name, price, and a link to the property detail page
Address search field
A text input where users type an address, city, or place name to navigate the map to that location. The search uses the OpenStreetMap geocoding service.
Radius control (if available)
A slider or input that sets the search radius (distance) around the searched or current location. Adjusting this expands or restricts which properties are included.
Filter panel
Dropdown and range controls for filtering visible properties by:
- Property type — Filter by sale, rent, or other property type categories
- Category — Filter by the property's category
- Price range — Minimum and maximum price
- Bedrooms — Minimum number of bedrooms
- Bathrooms — Minimum number of bathrooms
Results list (may appear below the map)
A list of properties matching the current map view or search criteria, each with a summary and a link to the full listing.
Expected Results
As the user navigates, searches, or applies filters, the map updates to display matching property pins. Clicking a pin opens a popup with a brief property summary. Users can then follow the link in the popup to view the full property details page. The filter panel allows users to progressively narrow results without reloading the page.
Important Notes
- For a property to appear as a pin on the map, it must have geographic coordinates (latitude and longitude) stored in the system. Properties without location data will not appear on the map, even if they meet other filter criteria.
- The map requires an internet connection to load tile images from OpenStreetMap.
- The availability of the radius slider and advanced filter controls may depend on the site configuration and any customizations applied by the administrator.
- Clustered pins group nearby listings together at lower zoom levels. Zoom in to expand clusters and see individual property markers.
- The address search depends on the OpenStreetMap geocoding service. If an address is not found or the format is unclear, try entering a more specific address or a well-known landmark.
- On mobile devices, the map supports touch gestures (pinch to zoom, swipe to pan) like a standard mobile map.
- The maximum number of properties shown on the map at one time may be limited by the administrator's configuration for performance reasons.