WPRentals provides two map systems. You can choose between OpenStreetMap and Google Maps.
The map system is managed from:
WPRentals Options > Map Configuration > Map General Settings
Map General Settings
From Map General Settings, you can select the map provider used by the theme.
Use the option:
What Map System do you want to use?
You can choose:
- OpenStreetMaps
- Google Maps
This setting affects the maps used in the theme, including property pages, search results pages, half map pages, and map widgets.
OpenStreetMap
OpenStreetMap can be used without a Google Maps API key.
Main notes:
- No Google Maps API key is required.
- You can optionally use a MapBox API key for faster map tile loading.
- If no MapBox API key is added, the default OpenStreetMap tile server is used.
- Street View is not available with OpenStreetMap.
- Google Places features are not available when using OpenStreetMap.
If you want to use MapBox, register at:
Then copy your Public Token and add it in the WPRentals map settings.
Google Maps
Google Maps requires a valid Google Maps API key.
To use Google Maps:
- Create a Google Cloud account.
- Create a Google Maps API key.
- Enable billing in Google Cloud.
- Enable the required Google Maps APIs.
- Add the website domain in the API key restrictions.
- Add the API key in WPRentals Options > Map Configuration.
Google manages billing, quotas, API access, and key restrictions from Google Cloud. WPRentals can only use the key after it is valid and accepted by Google.
Help guide to get and configure the key:
Google Maps – How to add Google API Key
When the Map Does Not Show
If the map does not show, check these items first:
- Check that the correct map system is selected in WPRentals Options > Map Configuration.
- If using Google Maps, check that the Google Maps API key is valid.
- If using Google Maps, check the browser console for Google Maps errors.
- If using Google Maps, check billing, enabled APIs, domain restrictions, and quota in Google Cloud.
- Check that listings have latitude and longitude saved.
- Check that the map is enabled on the page where you expect to see it.
- For Advanced Search Results pages, make sure the page loads a map as the hero media/header when needed.
- For Elementor or WPBakery map widgets, check the widget settings and the global map configuration.
For listing pins to show on the map, each listing needs correct map coordinates.
When editing a listing, check the location section and make sure Property Latitude and Property Longitude are saved.
Help for property coordinates:
How to set the location of a property on the map
After Changing Map Settings
After changing map settings, listing locations, coordinates, pins, or map provider, regenerate the theme map data.
Go to:
WPRentals Options > Map Configuration > Generate Data & Pins
Click Save Changes.
Then clear the website cache and browser cache.
This helps refresh the files used for map pins and map display.
Related Help
Map type: OpenStreetMap or Google Maps
Theme Options – Map Configuration Settings
Google Maps – How to add Google API Key
How to set the location of a property on the map
Listing Location Options for the Submission Form
Custom Hero Media Header Options For Pages
Global Hero Header Media Options
How to Manage the WPRentals Map with Listings Widget
Limit the Number of Pins to Show on the Map
Map Configuration: How Read From File Works