Map

We support two map providers. Choose the one that best fits your needs:

Google Maps (Paid Option)

Pros: High accuracy, detailed layers, Street View, familiar UI
Cons: Requires billing setup and API key

How to enable:

1. Go to: Dashboard → Settings → Map Options
2. Under Map Provider, select Google Maps.
3. Enter your Google Maps API Key → Get your API key here
4. Adjust the Zoom, Latitude, and Longitude to set the default center location.
5. Save changes.

Note: Make sure billing is enabled on your Google Cloud account to prevent service interruptions.

Important: Enable Required APIs for Google Maps

To ensure the map features work correctly with Google Maps, make sure the necessary APIs are enabled in your Google Cloud Console.

Steps to Check & Enable APIs:

1. Go to: Google Cloud Console – Enabled APIs
2. Select your project (top bar).
3. Check if the following APIs are listed:
   • Maps JavaScript API
   • Places API
   • (Optional but recommended) Geocoding API

If any are missing:

1. Go to the API Library.
2. Search for each API by name.
3. Click Enable.

These APIs are essential for rendering maps, auto-completing addresses, and placing location markers.

---

OpenStreetMap via Leaflet (Free Option)

Pros: Free to use, no API key or billing required
Cons: Slightly less detail in remote areas, no Street View

How to enable:

1. Navigate to: Dashboard → Settings → Map Options
2. Under Map Provider, select Leaflet.
3. No API key is needed.
4. Set your preferred Zoom, Latitude, and Longitude to define the map’s center.
5. Save changes.

Tip: Leaflet is lightweight and great for basic map functionality without recurring costs.

---

Additional Settings

• Use GPS Coordinates: Enable this to auto-locate listings on the map based on their coordinates.
• Measure Distance Unit: Choose between kilometers (km) or miles (mi) for distance calculations between user and listing.

Display Location on Map

Show each listing’s exact location directly on an interactive map. This helps users visualize where the place is and how to get there. The map supports zooming, dragging, and clicking markers to view listing details.

Search Address & Auto-Detect Coordinates

Easily search for an address and let the system automatically fetch the exact latitude and longitude. This saves time and ensures accurate map placement without manually entering GPS coordinates.

Migration Guide: Version 2 → Latest

In the latest version of our theme/plugin, the location (latitude and longitude) data is now stored in a new, dedicated database table instead of post meta. If you’re upgrading from version 2, you’ll need to migrate your existing data.

You must run the following WP-CLI command to migrate old location data:

wp listar-migrate coordinates

What this command does:

• It scans all posts with location metadata from version 2.
• It transfers this data into the new wp_listar_coordinates for improved performance and flexibility.

How to Run the Command

1. Access your server via SSH.
2. Navigate to your WordPress installation directory.
   cd /var/www/html/
3. Run the migration command:
   wp listar-migrate coordinates

Make sure WP-CLI is installed on your server. If not, here’s how to install it:
https://wp-cli.org/#installing