WordPress Travel Map Plugin (CMMRM) - 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

  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.

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

    Checking if required APIs are enabled
    Checking if required APIs are enabled
  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.

    Checking JavaScript errors
    Checking JavaScript errors
  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."

Google Maps API waypoints limits - WordPress Plugin Show Route
Google Maps API waypoints limits


Under Settings → Dashboard tab → Map section.

Dashboard settings - Route Display WordPress
Dashboard settings

Set Default travel mode to direct.

Switching the default travel mode to 'direct' - Route Display Plugin
Switching the 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.

Checking if the Elevation API is enabled
Checking if the Elevation API is enabled

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.

Checking if the Places API is enabled
Checking if the Places API is enabled

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.

    Choosing the 'Post name' permalinks structure
    Choosing the 'Post name' permalinks 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. 

Setting up the instructions - Travel Plugins For WordPress
Setting up the instructions

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

"RefererNotAllowedMapError" error

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.

Google API credentials
Google API credentials

Find needed API and click on it to edit:

Checking needed API
Checking needed API

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.
Disabling API restrictions
Disabling API restrictions

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.
Enabling API restrictions for your website
Enabling API restrictions for your website

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

Enabling the key restriction for selected APIs
Enabling the key restriction for selected APIs

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

Choosing needed APIs
Choosing needed APIs

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.
Path for replacing index.php - WordPress Plugin Show Route
Path for replacing index.php

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:

Specifying custom template file - Route Display WordPress
Specifying custom template file

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
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.