WordPress Travel Map Plugin (CMMRM) - Troubleshooting

Troubleshooting

Back to User Guides

This guide covers the most common issues with the WordPress Travel Map plugin.

Table of Contents

• Map canvas is blank
• Error message about using direct travel mode when 23 waypoints limit has been reached
• Altitude is incorrect or elevation graph is not showing up
• I cannot search for places on the edit map page
• Geolocation error shows up on the map page
• "404 Page Not Found" error
• Imported KML/GPX file seems to be incorrect
• I cannot change the travel mode
• I cannot draw a route - I can only add a marker
• Some icons are not being displayed or there's a rectangle in some text labels
• Instructions are not showing up on the edit route page
• Google Maps Javascript API Error - "RefererNotAllowedMapError"
• Index, Dashboard and Add Route pages are blank

Map canvas is blank

1. Make sure there is a valid Google Maps App Server Key entered (not the browser key) in the plugin settings. Check Key restrictions: None.

   

2. Make sure all required APIs are enabled in your Google Maps App (the APIs list can be found in the Setup article).

   

3. Check if a WordPress plugin or theme didn't embed another Google Maps Javascript API on the same page within your website: open your browser's web console (Ctrl + Shift + J in Google Chrome or Ctrl + Shift + K in Firefox) and check if there's an error message indicating that the multiple Google APIs has been called.

   Since our plugin embeds the Google API only when it's needed and other plugins often do this on each page, you may need to disable the conflicting plugin or change your theme to fix this issue.

4. Open your browser's web console (as described above) and check for the Javascript errors. Some error (which comes from other plugins or the theme) can stop processing our script which is responsible for loading the map.

   

5. If your theme or some other plugin have "Google PageSpeed Optimization" option - please disable it. It crashes the JavaScript variables embedded in the HTML code and can be the reason your map doesn't show up.

Error message about using direct travel mode when 23 waypoints limit has been reached

This error message reads "This website has reached the limit of the Google Maps API waypoints number per directions request. The total allowed waypoints is 23, plus the origin and destination. Please use the Direct Travel Mode if using more waypoints."

Fix

Under Settings → Dashboard tab → Map section.

Set Default travel mode to direct.

Altitude is incorrect or elevation graph is not showing up

Make sure the Elevation API is enabled in your Google Maps App settings. Then it may be necessary to edit the specific route and press the "Save" button to calculate the altitude values again.

Also, check in your theme's settings if there's a "defer script loading" (or similar) option enabled. The option helps optimize your website's load speed but it doesn't work well with Google libraries and can prevent the elevation graph from showing.

I cannot search for places on the edit map page

Make sure the Places API is enabled on your Google Maps App settings.

Geolocation error shows up on the map page

From the recent web browsers versions, the Geolocation Web API works only on websites that use  HTTPS protocol. It won't work with the standard HTTP websites without SSL/TLS encryption.

So SSL / HTTPS must be running on your website.

"404 Page Not Found" error

It seems your Wordpress doesn't recognize the routes pages' permalink correctly.

1. Make sure you don't have a page or post with the same slug (name) as you gave for the plugin's permalink part in the plugin settings. If there's a post with the same slug you may need to change its slug or the maps permalink part in the plugin settings.

2. Go to wp-admin → Settings → Permalinks make sure that the Post name has been set as the permalink structure.

   

3. Install the "Rewrite Rules Inspector" plugin. Then go to wp-admin → Tools → Rewrite Rules and press the Flush rules button.
4. Make sure that your post pages are loading correctly using pretty URLs. This is a rare issue but if not this means that your server doesn't support URL rewrite, the htaccess files are not set up correctly on Apache server or you're using another HTTP server where you need to set up the rewrite manually. Please contact your server administrator to solve this.

Imported KML/GPX file seems to be incorrect

Our plugin imports only the trail path from the KML/GPX file and doesn't import the markers. It has been designed to import simple GPS tracker data and doesn't support complex KML/GPX maps. It creates a start and end marker automatically but you need to add other markers manually.

I cannot change the travel mode

For the imported KML/GPX files you can use only the Direct travel mode because the imported route path is accurate enough that you don't need to use Google Directions Service to find a path between waypoints as you do when drawing a route manually. Besides that Google Maps' Direction Service won't accept a request with such a huge number of waypoints when switching the travel mode.

I cannot draw a route - I can only add a marker

For the imported routes when the number of the waypoint is greater than 200 there's no option to draw a route or change position of the existing waypoints. In the past, it caused performance issues for our users and crashed the web browser. Even "My Maps" service from Google doesn't allow you to edit routes imported from the KML/GPX files. You can add only the locations' markers.

Some icons are not being displayed or there's a rectangle in some text labels

Our plugin uses the Wordpress' build-in Dashicons set. However, on some themes the dash icons are not displayed properly on the front-end. It's not the plugin's issue, but as of yet, we haven't worked out what is causing this problem.

Instructions are not showing up on the edit route page

Go to wp-admin → CM Maps Routes Manager Pro → Settings → Labels tab. There's an Instructions field that you can fill in with the instructions or link to the plugin's documentation for your users. 

Google Maps Javascript API Error - "RefererNotAllowedMapError"

When you see a message like on the screenshot below instead of the map, check the console. It can be caused by the error RefererNotAllowedMapError. 

It happens because the site which is loading the Maps JavaScript API is not in the list of allowed referrers. It demands additional configuration of your API, so navigate to your account in Google Cloud Platform Console to the Credentials section.

Find needed API and click on it to edit:

There you need:

1. Choose None under the section Set an application restriction.
2. Choose Don't restrict key under the section API restrictions.
3. Click Save.

It will take up to 5 minutes to apply the changes. After that you can check the map integrated to your site - it should work.

Now you can enable the restrictions back (in case if you don't want any unauthorized users to use your API key). Get back to the editing of API.

Do the following under the section Set an application restriction:

1. Choose the needed restriction type - for example Websites.
2. Enter your domain without www part.
3. Click Done.

Choose Restrict key under the section API restrictions, then click on the dropdown Select APIs.

Choose Geolocation API and Maps JavaScript API. Click OK, then - Save.

The changes will be applied with 5 minutes.

Index, Dashboard and Add Route Pages Are Blank

This issue can appear as a conflict with the block themes such as Twenty Twenty-Two, Twenty Twenty-Three, Twenty Twenty-Four, etc.

The solution is you need to replace the default index.php file by the custom one, which you can download using This Link. The steps are (as example, we use the theme Twent Twenty-Two):

1. Unzip the downloaded index.php file.
2. Use file manager to access the following path: /wp-content/themes/twentytwentytwo/
3. Replace the file index.php file by the one you downloaded.

Now head to Admin Dashboard → CM Maps Routes Pro → Settings → General tab. In the field Other page template file add index.php as shown on the screenshot below:

Then save the changes. The issue should be gone.

	More information about the WordPress Travel Map Plugin Other WordPress products can be found at CreativeMinds WordPress Store
	Let us know how we can Improve this Product Documentation Page To open a Support Ticket visit our support center