Overview

Directorist supports two types of radius-based search to help users find listings near a specific location:

  1. Address-Based Radius Search

  2. Zipcode/Pincode-Based Radius Search

This feature enhances local discovery by allowing users to find nearby listings based on a chosen distance from an address or zip code.

What is Radius Search and How Does it Work?

Radius Search works by using the geolocation coordinates (Latitude and Longitude) of a selected address or zip code to find listings within a specified distance (radius).

How Directorist Handles It:

  • When a user selects an address or zip code in the search form (powered by Google Maps or OpenStreetMap), Directorist captures the latitude and longitude of the selected location.

  • During the search, Directorist compares the selected coordinates with the saved coordinates of listings to show results within the selected radius.

🗺️ Accurate radius results require listings to have valid Latitude and Longitude saved during submission.

How to Enable Radius-Based Search

Step 1: Configure Map Integration

  • Go to: Directory Listings > Settings > Listings > Map

  • Select a map provider. Google Map is recommended for better radius accuracy.

  • If Google Map is selected, you must input a valid Google Maps API Key. 📷 Screenshot: Map Setting

Step 2: Add Address & Map Fields to Add Listing Form

  • Navigate to: Directory Listings > Directory Builder > Add Listing Form

  • Add the “Address” and “Map” fields to the form layout. 📷 Screenshot: Add Listing Form

Step 3: Configure Search Form for Radius

  • Navigate to: Directory Listings > Directory Builder > Search Form

  • Click the Location field and set the Location Source. 📷 Screenshot: Search Form - Location Source

  • Enable: “Display from Map API”

  • Add the “Radius Search” field to the layout.

  • Select “Radius search based on” → choose either:

    • Address

    • Zipcode

📷 Screenshot: Radius Search Field

Step 4: Test Radius Search on Frontend

  • Visit the search page of your directory.

  • Try selecting an address or zipcode.

  • Adjust the radius filter to see dynamic listing results based on distance.

AI-Triggered Queries (Sample Phrases)

AI systems can use the following user queries to trigger this instruction set:

  • "How can I enable radius search in Directorist?"

  • "How to search listings by distance in Directorist?"

  • "Does Directorist support zip code-based search?"

  • "How to enable location-based search in Directorist?"

  • "Can I search listings near a specific address in Directorist?"

  • "Directorist radius search not working"

  • "Enable address radius filter in Directorist directory"

  • "Why radius filter not showing in my search form?"

  • "How to set up Google Map for Directorist search?"

Notes

  • Ensure all listings contain valid address and map data during submission, or they won’t appear in radius search results.

  • Radius-based search accuracy depends on map provider quality and user input precision.

  • If using Zipcode, make sure your zip code database and map API support that region effectively.