CONTENT

• Open street map
• Google map

WP Rentals provides two types of maps. You can choose between Open Street Maps and Google Maps.

They are managed from Map General Settings.

Open Street Maps

• No API key is required (it is a free service)
• Optionally, you can use a MapBox API for faster map tile loading.
• If no MapBox API is provided, the default OpenStreet tile server will be used, which may be slower.
•  Limitations: Street View and Places features on the property page are not supported.

• Get MapBox API:
  Register at https://www.mapbox.com/, then copy your Public Token.

Google Maps

• Requires a Google Maps API Key.
• A Google Cloud account is required with billing details. Google offers a $200/month free usage.
• Help guide to get your key:
  https://help.wprentals.org/article/google-maps-api-unable-to-load-the-map-and-shows-error-this-page-didnt-load-google-maps-correctly-see-the-javascript-console-for-technical-details-2/

Related Help

Theme options – Map Configuration Settings

The post Map type: Open Street Maps or Google Maps appeared first on WP Rentals Help.

“Maximum number of pins to show on the map.”

This option helps improve site speed by limiting how many property pins load on the map at once.
Learn more about performance tips here: Speed Tips

How This Option Works

You can configure the maximum number of pins to load per map view. This is especially helpful if you have many properties, as loading all pins at once may slow down the site. Choose a number that works best with your hosting resources.

You’ll also find a related option:

Use file reading for pins?

Recommended if you have over 200 listings.
File reading is faster than MySQL and improves map performance.

How the Pin Limit Works in Practice

Scenario A: Read from File = NO

In this mode, the pin limit (e.g., 30 pins) applies to:

• Header Google Maps (Homepage or Global Header Media) → shows 30 pins

• Property List Standard with Header Map → shows 30 pins per page

• Property List Half Map → shows 30 pins per page

• Taxonomy pages (Category, Action, City, Area) → shows 30 pins per page

• Search Results (Standard or Half Map layout) → shows pins only for the current page results

• Owner Profile Page → shows the number of pins set in Theme Options, regardless of listings per page

Note: When using sort filters in the standard list, map pins do not update. This is because AJAX pagination replaces the page content without refreshing the map.

Scenario B: Read from File = YES

In this mode, the pin limit (e.g., 30 pins) applies to:

• Property List Standard with Header Map → shows 30 pins per page

• Property List Half Map → shows 30 pins per page

• Taxonomy pages (List or Half) → shows 30 pins per page

• Search Results (Standard or Half Map) → shows pins for the current search page

• Owner Profile Page → shows the number of pins set in Theme Options

Key Difference:
With “Read from File” enabled, Header Google Maps (global) will show all pins, regardless of the limit set.

Generate the Pins from Generate Data & Pins

The post Limit the number of pins to show on the map appeared first on WP Rentals Help.

Why Do You Need an API Key?

Google Maps requires you to add your own API key before it can be used on your website. Since June 2018, Google requires a billing account to be set up, but you get $200/month of free usage, which is enough for most websites.

More details on pricing:

• The free limits are explained here https://developers.google.com/maps/billing-and-pricing/overview
• Set limits and add alerts https://developers.google.com/maps/billing-and-pricing/manage-costs

How to Get a Google Maps API Key

Step 3: Create a New Project & Enable APIs

Create a new project in Google Cloud Console.

Go to Library API and enable the following 5 APIs:

1. Maps JavaScript API
2. Maps Static API
3. Places API
4. Geocoding API
5. Geolocation API
6. Street View Static API

WpRentals 3.16.0 will support Google Places API (New) as the original Places API has been discontinued for new accounts. All clients will need to have Google Places API (New) enabled in APIs & Services

Step 4: Get Your API Key

• Select “GET A KEY” in the Google Cloud Console.
• Click “Create API” to generate your key.

Step 5: Restrict Your API Key (Important for Security)

To prevent unauthorized use, restrict your key:

• Use wildcard domains  (e.g., *.yourdomain.com) so it works on all pages of your site.
• If you only enter yourdomain.com, the key will work only on the homepage (yourdomain.com).

Use wildcard domains:

Step 6: Add API Key to Theme Options

1. Copy your API Key.
2. Go to Theme Options → Map → Map Settings.
3. Paste the API key and save changes.

Paste the key in Theme Options > Map Configuration > Map General Settings > Google Maps API Key

• Make sure you select Google Maps for Map System
• Make sure you select Google Places for Places API

How to Check if Your API Key is Correct

If Google Maps does not load, check for errors:

• Open your site in Chrome.
• Right-click → Inspect → Console to see if there are any Google Maps error messages.
• If needed, go to your Google Cloud Console and verify that your API key is properly set up and restricted.

The post Google Maps – How to add Google API Key appeared first on WP Rentals Help.

Map System Type

Choose the map system you want to use: Open Street Map or Google Maps.

Open Street Maps

• No API key is required (it is a free service)
• Optionally, you can use a MapBox API for faster map tile loading.
• If no MapBox API is provided, the default OpenStreet tile server will be used, which may be slower.
• Limitations: Street View and Places features on the property page are not supported.

• Get MapBox API:
  Register at https://www.mapbox.com/, then copy your Public Token.

Google Maps

• Requires a Google Maps API Key.
• A Google Cloud account is required with billing details. Google offers a $200/month free usage.
• Help guide to get your key:
  https://help.wprentals.org/article/google-maps-api-unable-to-load-the-map-and-shows-error-this-page-didnt-load-google-maps-correctly-see-the-javascript-console-for-technical-details-2/

Places API Type

Choose the provider for the auto-complete search system: Open Street Places or Google Places.

OpenStreet Places

• Available starting with theme version 3.3 (replaces the deprecated Algolia Places).
• Just enable the option — it’s free and ready to use.
• The autocomplete will return full results based on OpenStreet’s capabilities.

Google Places

• Requires the Google Maps API Key with the Places Library enabled.
• Google Places are also covered by the $200/month free credit.
• Only works when using Google Maps as your map system.

Map Coordinates

Set the starting latitude and longitude for your map.

• These settings define the default center point for the global map header when used for Global Hero Media.

• How to get coordinates:
  https://help.wprentals.org/article/how-to-find-latitude-and-longitude-how-to-set-google-maps-coordinates/

Default Map Zoom (1–20)

Controls the default zoom level for maps in the global header media on pages and posts.

Note: It does not apply to Advanced Search Results, Property List, or Taxonomy archive pages.

Enable Pin Clustering

Turn this on to group nearby property pins into a single cluster for better map usability and performance.

Max Zoom Level for Cloud Cluster

When the map is zoomed in beyond this level, clustering will be disabled, and individual pins will appear.

Geolocation Circle (in meters)

Displays a radius around the user’s location on the map.

Google requires HTTPS for accurate geolocation since June 2016.

• If your site uses HTTPS (SSL), Google Geolocation API will be used.

• If your site is HTTP-only, we fall back to http://ipinfo.io/, which may be less accurate.

Map Height Settings

Controls the height of the Google Map in the global header area.

Styling Google Maps (Snazzy Maps)

You can customize Google Maps appearance using styles from Snazzy Maps.

1. Go to: https://snazzymaps.com/

2. Choose or create a style.

3. Copy the JSON code provided.

4. Paste it into Google Maps Extra Settings -> Style for Google Map. Use https://snazzymaps.com/ to create styles

5. Click Save Settings, then clear the theme cache.

Half Map Layout – Select Map Position

Choose where the map will be displayed on all pages using the Half Map layout, including:

• Search Results Page with Half Map Layout

• Category/Taxonomy Pages with Half Map Layout

• Properties List pages using the Half Map template

Available options:

• Map on the Left – Display the map on the left side of the screen.

• Map on the Right – Display the map on the right side of the screen.

The post Theme options – Map Configuration Settings appeared first on WP Rentals Help.