Maps Marker Pro is a WordPress plugin built on the javascript framework leaflet.js, which supports maps from OpenStreetMap and other free providers out of the box without any additional configuration or mandatory API keys.

If you want to use Azure Maps though, you need to register a Azure Maps API key.

Step-by-step tutorial

This tutorial will show you how to enable Azure Maps in Maps Marker Pro by generating a Azure Maps API key.

Prerequisite: you must have a Microsoft account

Step 1: Sign in to the Azure Portal

Go to Azure Portal and log in with your Microsoft account.

Step 2: Create an Azure Maps Account

1. In the navigation menu, click on Create a resource:
   
2. In the search bar, type Azure Maps and select Azure Maps from the results.
3. Click Create:
   
4. Fill in the required details:
   • Subscription: Select your Azure subscription.
   • Resource Group: Choose an existing resource group or create a new one.
   • Name: Provide a unique name for your Azure Maps account.
   • Pricing Tier: Select a pricing tier that suits your needs.
5. Click Review + Create, then Create to deploy the Azure Maps resource.

Step 3: Retrieve the API Key

1. Once the resource is created, navigate to Resource Groups and open the newly created Azure Maps account.
2. In the left-hand menu, select Authentication.
3. Under Primary Key and Secondary Key, copy one of the keys for use in your application:
   

Step 4: Restrict API Key Usage (optional)

To enhance security, you can restrict the API key usage: in the Authentication section, configure Allowed Referrers to restrict usage to your specific domains.

Step 5: Add your key in Maps Marker Pro admin backend

Log in on your WordPress Admin and navigate to Maps Marker Pro / Settings / Layers / “Azure Maps” and paste your API key into the field “Google Maps JavaScript API key”

Finish configuration by clicking the “Save” Button – you are now able to use Azure Maps for maps in Maps Marker Pro:

Additional Notes

• Billing Setup: Some Azure Maps services require a billing account. Ensure your Subscription has a valid payment method.
• Quota Management: Monitor API usage under Metrics in your Azure Maps resource.
• Documentation: Refer to the Azure Maps API Documentation for additional guidance.

Terms of services

All Azure Maps´s related infos can be found at https://learn.microsoft.com/en-us/azure/azure-maps/

• Step-by-step tutorial
• Optional steps (recommended)
• Terms of Services
• Usage Limits

Maps Marker Pro has a built-in geocoding framework which allows you to choose which geocoding provider to use. If you want to use Google for geocoding, you have to generate a Google Maps API key for Places API and Geocoding API.

Step-by-step tutorial

This tutorial will show you how to enable Google Geocoding in Maps Marker Pro by generating a Google Maps API key for Places API and Geocoding API.

We recommend to create a unique key for Google Geocoding in Maps Marker Pro only – even if you already registered a key for Google basemaps (as other methods for securing your Google geocoding key e.g. against quota theft are needed, see “Optional steps (Recommended)” below for details!)

Prerequisite: you must have a Google account to generate a Google Maps API key for Places API and Geocoding API.

Step 1: Access the Google Cloud Console

Go to the Google Cloud Console and log in with your Google account.

Step 2: Select or Create a Project

• If you already have a project for your application, select it.
• If not, click Create Project, enter a project name, and follow the setup instructions.

Step 3: Enable the Required APIs

1. In the left-hand menu, navigate to APIs & Services > Library.
2. Use the search bar to find the following APIs or use the following direct links:
   • Places API (New)
   • Geocoding API
3. Click on each API and press Enable/Activate:
   
   

Step 4: Create an API Key

1. Go to APIs & Services > Credentials.
2. Click on Create Credentials and select API Key:
   
3. Copy the generated API key for use in your application.

Step 5: Restrict API Key Usage (Recommended)

For security reasons, restrict the API key to prevent unauthorized use:

1. In the Credentials section, click on your API key.
2. Under Application Restrictions, choose:
   • HTTP referrer (websites) for client-side applications.
   • IP addresses for server-side applications.
3. Under API Restrictions, select Restrict key and check only the APIs you enabled (Places API and Geocoding API).
4. Click Save.

Step 6: enter your API key in Maps Marker Pro WordPress admin backend

Log in on your WordPress Admin and navigate to Settings > Geocoding > Google and  paste the server key you copied earlier into the “Google API server key” field:

Step 7: select Google as Geocoding provider

Navigate to Settings / Geocoding / Provider and select Google as geocoding provider:

Finish by clicking the “Save” button on top of the settings page.

That´s it. Afterwards you can start using Google geocoding when creating a new map or marker:

Additional Notes

• Billing Setup: Google Cloud now requires billing to be enabled for API usage, even for free-tier limits. Make sure you have a valid payment method configured in the Billing section.
• Quota Management: You can monitor usage and adjust quotas under APIs & Services > Quotas.

Terms of services

“In June 2018 Google launched a new pricing plan. Google continues to offer a free tier — all developers will receive $200 of free monthly usage of our core products. In addition, this change will require you to enable billing and associate it with all of your Google Maps Platform projects. (full official announcement)” – for a summary on how this affects you as Maps Marker Pro user, please have a look at our FAQ at https://mapsmarker.com/google-maps-tos-changes

All Google´s related Terms of Services can be found at https://developers.google.com/maps/terms.

Usage limits

If you enable Google Geocoding, the following 2 Google APIs will be used:

1. “Autocomplete per character” with a minimum price of USD 2.83 for 1000 calls for up to 70.000 chars per month (pricing details)
2. “Places Details” – Basic with a minimum price of USD 17.00 for 1000 calls for up to 11,000 calls per month (pricing details)

As Google gives all developers $200 of free monthly usage, only loads which exceed this amount will be directly billed by Google.

For current pricing, please see https://stadiamaps.com/pricing/ (with a “Free” account, 200.000 credits/month are included – April 2024)

Terms of Services: https://stadiamaps.com/terms-of-service/

In order to enable Stadia maps support, you have to do the following steps:

1. sign up a for a free account at https://client.stadiamaps.com/signup/
   
2. after logging in, click on “create a property” on the dashboard:
   
3. Name the property (e.g. your domain) and click create
   
4. You now have the option to either whitelist your domain or to create an API key:
   
   We recommend adding your domain, including subdomains:
   
5. Login to your WordPress site as admin, navigate to Maps Marker Pro / Geocoding / “Stadia Maps” and select “Domain” as “Autentification configuration”:
   
6. Finish by clicking the button “Save”.

Alternatively you can also register an API key in step 4 and add this API key in step 5 (and also selecting “API key” as “Authentification configuration”).

That´s it. Afterwards you are able to use the following Stadia basemaps geocoding:

For current pricing, please see https://stadiamaps.com/pricing/ (with a “Free” account, 200.000 credits/month are included – October 2023)

Terms of Services: https://stadiamaps.com/terms-of-service/

In order to enable Stadia maps support, you have to do the following steps:

1. sign up a for a free account at https://client.stadiamaps.com/signup/
   
2. after logging in, click on “create a property” on the dashboard:
   
3. Name the property (e.g. your domain) and click create
   
4. You now have the option to either whitelist your domain or to create an API key:
   
   We recommend adding your domain, including subdomains:
   
5. Login to your WordPress site as admin, navigate to Maps Marker Pro / Settings / “Stadia maps” and select “Domain” as “Autentification configuration”:
   
   If you created an API key instead, select “API key” and paste your key in the according field.
6. Finish by clicking the button “Save”.

That´s it. Afterwards you are able to use the following Stadia basemaps for your maps:

Lima Labs renders all tiles at a tile size of 512 and a scale factor of 2.0. This gives you crisp high resolution tiles. Check out their demo map at https://maps.lima-labs.com/ol.html.
They do NOT use AWS, Cloudflare or Fastly and provide diversity in the event your current provider’s CDN has issues. They provide anglicized place naming in addition to the local naming and operate a global network.

Usage limits

Lima Labs tiles are FREE for any user needing < 20.000.000 tiles yearly (that is a LOT of tiles). Additional tiles can be purchased in blocks of 5,000,000 for $10 and never expire.

Maps Marker Pro users get additional 5.000.000 tiles for free by signing up for an API key here.

Terms of services

The terms of services can be found at https://maps.lima-labs.com/index.php/aup/

Tutorial: How to register an API key

1. Signup for an API key at https://maps.lima-labs.com/index.php/lima-labs-signup-with-special-offer-mapsmaker/
2. Login to your WordPress site with an admin account
3. Navigate to Maps Marker Pro / Settings / Layers / Limalabs and enter your API key:
   
4. Save settings

You are now able to use Lima Lab tiles as optional layer for maps:

1. create new map or edit existing map
2. navigate to tab “Layers” and select “Lima Labs” from basemap dropdown & click “add basemap”:
   
3. Select the radio button for “Lima Labs” and click save:
   
4. This map now uses Lima Labs tiles as default layer.

If your map does not get loaded and you see an error like the one above (error details are only visible for admins), this can have the following reasons:

1. WordPress AJAX endpoint cannot be accessed
   This is the most likely reason and can be either caused by security plugins or c onfiguration in wp-config.php or .htaccess (in root or /wp-admin) which prevent calls to the general WordPress AJAX endpoint at /wp-admin/admin-ajax.php
   Accessing that endpoint is needed for maps to load properly, so if this is the case on your site, please remove those restrictions.

If you do not know the IP of your server, you can

1. install the plugin Server IP & Memory Usage Display (which shows the IP in the admin footer),
2. install the plugin WP Server Health Stats (which shows IP on plugins admin pages) or
3. ask the support of your hosting company for example.

As Algolia Places was the default (keyless) geocoding provider in Maps Marker Pro, you now need to switch to another (keybased) geocoding provider, if you want to continue using the geocoding feature in Maps Marker Pro.

Maps Marker Pro is the only WordPress mapping plugin with an integrated geocoding framework, which allows you to choose from different geocoding provider – selecting the one that best fits your needs:

If you experience any issues with activating an alternative geocoding provider in Maps Marker Pro, please check out our knowledge base or open a support ticket.

Example link: <a href="#" class="mmp-highlight" data-marker="1">Link</a>

Available options:

• data-marker="id" The marker to be highlighted
• data-map="id" Target a map with a specific ID only. Useful when multiple maps are on the same page
• data-scroll="true|false" Whether to scroll the map into view. Defaults to true
• data-open="true|false" Whether to open the popup. Defaults to true

Maps

Markers

Maps

add_filter('mmp_map_settings', 'mmp_add_map_name_prefix');

function mmp_add_map_name_prefix($settings) {
    $settings['name'] = 'This map is called: ' . $settings['name'];

    return $settings;
}

add_filter('mmp_map_1_settings', 'mmp_add_link_to_map_1_name');

function mmp_add_link_to_map_1_name($settings) {
    $settings['name'] = '<a href="https://www.example.com">' . $settings['name'] . '</a>';

    return $settings;
}

add_filter('mmp_map_markers', 'mmp_hide_marker_edit_links');

function mmp_hide_marker_edit_links($markers) {
    foreach ($markers as $key => $marker) {
        $markers[$key]['edit'] = false;
    }

    return $markers;
}

add_filter('mmp_map_1_markers', 'mmp_remove_popups_on_map_1');

function mmp_remove_popups_on_map_1($markers) {
    foreach ($markers as $key => $marker) {
        $markers[$key]['popup'] = false;
    }

    return $markers;
}

Markers

add_filter('mmp_popup', 'mmp_replace_popup_placeholders');

function mmp_replace_popup_placeholders($popup) {
    $popup = str_replace('{{weekday}}', date('l'), $popup);
    $popup = str_replace('{{time}}', date('g:i a'), $popup);

    return $popup;
}

add_filter('mmp_popup', 'mmp_add_marker_data_to_popup', 10, 2);

function mmp_add_marker_data_to_popup($popup, $marker) {
    $popup .= "<p>The coordinates for {$marker->name} are {$marker->lat}, {$marker->lng}</p>";

    return $popup;
}

L10n

add_filter('mmp_l10n_map_strings', 'mmp_change_search_placeholder');

function mmp_change_search_placeholder($map_strings) {
    $map_strings['list']['search'] = 'Search stores';

    return $map_strings;
}

Attention: this tutorial is only valid for Maps Marker Pro version 4.9 or higher! The tutorial for version 4.0 to 4.8 can be found at https://www.mapsmarker.com/kb/user-guide/import-export-40-to-48/

Supported formats

By default, the import and export feature supports GeoJSON and CSV for export and import.

back to index

Copying maps from another site

If you want to transfer your maps and markers from one site to another, it is recommended to use the “Backup/Restore database”-feature from the tools page instead:

back to index

Permissions / Capabilities

By default, only administrators can use the import and export feature on the tools page. If you want other users to also use these features, please navigate to Settings / Capabilities and enable the capability “Use tools” for the required role:

back to index

Export markers

Existing markers can be exported to GeoJSON or CSV format.

In order to export your markers, please navigate to “Import & Export” and select the “Export markers” first:

Select the file type you would like to export, and optionally choose which to export all markers (default) or use the “Filter mode” to export markers from selected maps only or exclude markers from selected maps.

Finish the export by clicking the “Start export” button.

back to index

Import markers

You can use the import feature to bulk add or update markers.

In order to import your markers, please navigate to “Import & Export” and select the Import-tab:

Choose your import file in CSV or GeoJSON format and start the import by clicking the button “start import”. The available options will be explained below.

back to index

File type

• Download example CSV (data from demo.mapsmarker.com)
• Download example GeoJSON file (data from demo.mapsmarker.com)

Additional remarks:

• A CSV file must contain at least latitude and longitude columns
• If other colums are missing, the values for new marker defaults are used

back to index

Test mode

Marker mode options

• “Add markers”:
  Every entry in your input file will be used to create a new marker.
• “Update Markers”:
  If the ID of an entry in your input file exists, the existing marker will be updated, if the ID does not exist, the marker will be skipped.
• “Update existing, add remaining”:
  If the ID of an entry in your input file exists, the existing marker will be updated, if the ID does not exist, a new marker will be created.

back to index

Geocoding options

• “Off”:
  If the values for coordinates (latitude or longitude values) are missing, geocoding for this marker will be skipped
• “Missing”:
  If the values for coordinates (latitude or longitude values) are missing, the address will be used for geocoding
• “On”:
  The address given in the input file will be used for geocoding, regardless of latitude or longitude values available (existing latitute and longitude values will be overwritten by the geocoding results).

Assign to map options

• “Off”:
  markers will only be assigned according to their assignment info in the input file
• “Missing”:
  markers with missing assignment info in the input file will be assigned to this map
• “On”:
  all markers will be assigned to this map, even if they have assignment info in the input file

Error handling

We integrated several checks which should prevent the import to fail. Anyway if something goes wrong, you will be shown exactly what went wrong, e.g.

Available error messages

• Security check failed:
• File missing
• File could not be read
• File could not be parsed
• Invalid GeoJSON/CSV
• No geographical data found
• Missing geometry type
• Missing or incomplete coordinates
• Missing address for geocoding

If you cannot resolve the issue by yourself, please open a support ticket at https://mapsmarker.com/helpdesk and we will be glad to help!

back to index

FAQ (Frequently asked questions)

Please see our knowledge base for related FAQ

back to index

If your track does not contain a description, you can manually add one by adding the tag the GPX file accordingly:

You can customize the color, weight and opacity of full tracks or track segments by changing your GPX files according to the examples below.

In order to use the extensions, you also have to add the following namespace declaration to the header of the file:

<gpx [...] xmlns:mmp="https://www.mapsmarker.com/GPX/1/">

Example for customizing full track:

<trk>
    <extensions>
        <mmp:color>#f00</mmp:color>
        <mmp:weight>3</mmp:weight>
        <mmp:opacity>1</mmp:opacity>
    </extensions>
    <trkseg>
        <trkpt></trkpt>
        ...
    </trkseg>
</trk>

Example for customizing track segments:

<trk>
    <trkseg>
        <extensions>
            <mmp:color>#f00</mmp:color>
            <mmp:weight>3</mmp:weight>
            <mmp:opacity>1</mmp:opacity>
        </extensions>
        <trkpt></trkpt>
        ...
    </trkseg>
    <trkseg>
        <extensions>
            <mmp:color>#00f</mmp:color>
            <mmp:weight>2</mmp:weight>
            <mmp:opacity>0.5</mmp:opacity>
        </extensions>
        <trkpt></trkpt>
        ...
    </trkseg>
</trk>

First you need to create a map, before adding a marker to it. To do so, please select “Add new map” from the menu first:

As a result you will see a new map preview using the default settings:

If you want to use the geolocation feature, you have to activate a geocoding provider first. For a comparison of available geocoding providers and activation tutorials please click here.

Start the geolocation search by entering the address into the field “Find a location” to center the map on the desired location (you can also use manaully zoom and pan the map by using your mouse directly on the map as an alternative, if geocoding is disabled for example):

The map then gets centered on that location and optionally you can also adjust basic parameters of the map like width, height or zoom level and give the map a name:

For advanced customisation, e.g. which Layer to use (like Google Maps, for which a mandatory API registration is necessary), please switch through the available tabs Layers, Controls, Markers etc. You can also tick the radio button “Show advanced settings” for advanced customisation options – for this tutorial though we will continue with basic map settings.

So as next step, finish creating this map by clicking on the Save button. The map now gets reloaded and you can easily add a marker to this map by clicking the link “Add marker”:

This will load the page “Add new marker” where the new marker is already assigned to be displayed on the newly created map with ID78. You can then either use the geolocation search again for setting the exact location of the marker or use drag and drop with your mouse. It is also advised to set a name for this marker and if you want you can customise the icon. Adding an infotext to the popup is also possible by using the editor:

Finish this step again by clicking on the “Save” button to actually create the marker.

If you switch back to the map created before and reload the page, you will see that the marker has now been added to your map:

You can now further customise this map (e.g. hiding the list of markers below the map on the tab “List”) or continue to add this map to your site. The easiest way to do so is to copy the highlighted shortcode and paste it into a post, page or widget:

If you are using the WordPress Gutenberg editor, you can also paste the shortcode as new block or use the dedicated maps block:

Gutenberg step 1 (click on the plus icon to show available blocks):

Gutenberg step 2 (select Maps Marker Pro block):

Gutenberg step 3 (select your map from the dropdown):

Either way finish by publishing your post or page or saving your widget. As a result, the map will now also be displayed on frontend:

That´s it. You´ve now successfully created your first map and added a marker. Optionally you can now further customise your map or add further markers to your map by repeating the steps above, starting from “Add new marker”. There are often several ways in achieving the desired result, this tutorial described the most basic ones.

For further tutorial on how to customise your maps, please have a look at the other content in our knowledge base – if a specific tutorial is missing or if anything is unclear for you, please open a support ticket and we will be glad to help!

Your Maps Marker Pro team

By default, this control is disabled, if you want to enable it, please proceed as follows: open your map on backend and switch to the tabs “Controls” (clicking the radio button “Show advanced settings” for advanced customisation is recommended):

To enable the geolocation control, just select 1 of the 4 possible locations of the control under the section “Locate Button”.

Please be aware that this feature only works (in modern browsers) if your site is accessible via https (as the HTML5 geolocation API is used).

1. Login to the TomTom developer account
2. Create a new application or edit your existing application and make sure to the related APIs are active:
   
3.  Login to your WordPress site and navigate to Maps Marker Pro / Settings / Layers / Custom and click on “add new layer”:
   
4. As next step a popup opens:
   
5. For TomTom traffic flow fill in this form as follows:Type: Overlay
   Name: TomTom traffic flow
   URL: https://api.tomtom.com/traffic/map/4/tile/flow/absolute/{z}/{x}/{y}.png?key=add_your_tomtom_api_key_here
   Attribution: @ 1992-2019 TomTom

   For TomTom traffic incidents overlay please use the following values:

   Type: Overlay
   Name: TomTom traffic incidents
   URL: https://api.tomtom.com/traffic/map/4/tile/incidents/s3/{z}/{x}/{y}.png?key=add_your_tomtom_api_key_here
   Attribution: @ 1992-2019 TomTom

   Finish by clicking on Save.

6. The newly configured overlays can then be added to maps:
   

Please be aware that the layers can be customised, e.g. by setting a different style. For more Information on how to Change the URL accordingly, please have a look at the traffic flow details or traffic incident details.

TomTom is a leading independent location technology specialist, shaping mobility with highly accurate maps, navigation software, real-time traffic information and services. Their geocoding service can also be used within Maps Marker Pro since v4.6 after signing up for an API key.

Tutorial: How to register an API key

1. Register an account at https://developer.tomtom.com/user/register
2. Login with your account at https://developer.tomtom.com/user/login
3. Select “Keys” from the menu on the left and click on the button “Add new key”:
   
4. Enter a name for the key and tick the checkbox for “Search API”:
   
5. Make sure “Domain whitelist” is disabled, then finish by clicking “CREATE A KEY”:
   
6. Copy the created key to your clipboard:
   
7. Login to your WordPress site, head to Maps Marker Pro / Settings / Geocoding / TomTom and paste the key there:
   
8. Navigate to Settings / Geocoding / Provider and select TomTom as the default geocoding provider:
   
9. Save settings

Terms of services

TomTom can be used after registering a mandatory API key. The related terms of services can be found at https://developer.tomtom.com/terms-and-conditions

Usage limits

With their free plan, TomTom allows up to 2.500 requests/day for all of their APIs. The limit is set to 5 calls per second for non-tile based APIs and 1,000 for tile based APIs. If you’re using the TomTom Maps APIs for free and you exceed the daily free credit limit of 2,500 API transactions, you will receive an “HTTP 403 – Over the limit error”.

Larger plans are are available for higher usage limits.

Reference for all TomTom settings

Location biasing

You can provide latitude and longitude values as well as a radius in meters – please note that configuring these settings biases the resulted to the indicated area, the results may not be fully restricted to this specified area though.

Language

Changes the language of the results. You can pass IETF language tags (IETF BCP 47).
If empty, the language set in WordPress will be used.

Countries

Changes the countries to search in. You can pass two letters country codes (ISO 639-1).
If empty, the entire planet will be searched.

TomTom is a leading independent location technology specialist, shaping mobility with highly accurate maps, navigation software, real-time traffic information and services. Their maps can also be used within Maps Marker Pro since v4.6 after signing up for an API key.

Tutorial: How to register an API key

1. Register an account at https://developer.tomtom.com/user/register
2. Login with your account at https://developer.tomtom.com/user/login
3. Select “Keys” from the menu on the left and click on the button “Add new key”:
   
4. Enter a name for the key and tick the checkbox for “Map Display API”:
   
5. Enable “Domain whitelist” and enter your website’s domain (optional, but recommended), then finish by clicking “CREATE A KEY”:
   
6. Copy the created key to your clipboard:
   
7. Login to your WordPress site, head to Maps Marker Pro / Settings / Layers / TomTom and paste the key there:
   
8. Save settings

Terms of services

TomTom can be used after registering a mandatory API key. The related terms of services can be found at https://developer.tomtom.com/terms-and-conditions

Usage limits

With their free plan, TomTom allows up to 2.500 requests/day for all of their APIs. The limit is set to 5 calls per second for non-tile based APIs and 1,000 for tile based APIs. If you’re using the TomTom Maps APIs for free and you exceed the daily free credit limit of 2.500 API transactions, you will receive an “HTTP 403 – Over the limit” error.

Larger plans are are available for higher usage limits.

You can separate the GPX elevation chart from the map though by following these steps:

1. create a <div> element with the ID, width & height attributes where you want the elevation chart to appear,
   e.g. <div id="chart-area" style="width:600px;height:400px;"></div>
2. on this page, use the following shortcode, example for map with ID 1:
   [mapsmarker map="1" chart="chart-area"]

As a result, the elevation chart will be loaded within this <div>.

Maps Marker Pro has teamed up with LocationIQ to offer enhanced mapping and geocoding capabilities to its users.

When you install Maps Marker Pro, you automatically gain access to LocationIQ’s geocoding APIs, allowing you to perform up to 1.000 geocoding requests per day right out of the box, no additional registration needed. If you’re looking to extend this limit to 5.000 requests per day for free, all you need to do is sign up for an account at https://locationiq.com/register to obtain your personal access token. This access token should then be integrated into your Maps Marker Pro configuration settings. Should you require even larger request limits, LocationIQ offers a range of paid plans at https://locationiq.com/pricing.

LocationIQ’s suite of location-related APIs encompasses various APIs like geocoding, reverse geocoding, map tiles, routing, geolocation, and more. For geocoding specifically, LocationIQ offers a combination of multiple datasets including OSM, OpenAddress, Geonames, and others, providing comprehensive geolocation APIs with global coverage.

Forward Geocoding

Geocoding takes a human-readable location, such as an address or place name, and turns it into specific latitude and longitude coordinates. This helps us locate things on a map.

• Data update Frequency: Daily
• Address Level: Street level data worldwide

Best Practices:

• Geocoder works best when addresses are in the format: <house_number>, <street>, <neighborhood>, <city>, <state>, <country>, <postcode>
• Coordinates have to be passed in the format [Latitude, Longitude]

Maps

LocationIQ uses OpenStreetMap data to power its Dynamic and Static map APIs. LocationIQ Maps include support for Street, Dark and Light Map themes. LocationIQ Maps allow adding markers, lines, polygons, pop-ups and more.

• Data Source: OSM
• Data update Frequency: Monthly

Tutorial: How to sign up for a free personalized access token

In order to increase your daily limit from 1.000 to 5.000 requests/day/IP you need to sign up as follows:

1. Register a user account at https://locationiq.com/register
2. Login at https://my.locationiq.com/dashboard/login (FYI password free login using Email and token)
3. Navigate to Account / “API Access Tokens” (one access token should automatically have been created already on registration – if not create one please) – then copy the “Access token” to your clipboard:
   
4. Login to your WordPress site and head to Maps Marker Pro / Settings / Geocoding / LocationIQ and paste that key there:
   
5. Navigate to Settings / Geocoding / Provider and select LocationIQ as geocoding provider:
   
6. Save Settings.

That´s it. Afterwards you can start using LocationIQ geocoding when creating a new map or marker:

Youtube tutorial

Usage limits

Keyless geocoding offers 1.000 requests/day/IP and a maximum of 2 requests per second. With a personalised access token, those limits increase to 5.000 requests/day. Larger plans are are available for higher usage limits.

FAQ

1. What is LocationIQ and how does it integrate with Maps Marker Pro?
LocationIQ is a robust geocoding and maps service. With its integration into Maps Marker Pro, you can effortlessly convert location descriptions into precise coordinates, enriching your mapping experience.

2. Do I need a separate LocationIQ account for integration?
No, you don’t. As a Maps Marker Pro user, you’ll have direct access to LocationIQ’s geocoding APIs without needing a separate LocationIQ account.

3. What are the default usage limits for LocationIQ within Maps Marker Pro?
You’ll enjoy a daily limit of 1.000 geocoding requests per IP and a rate limit of 2 requests per second.

4. How can I increase my daily geocoding limit to 5.000/day?
To expand your daily limit to 5.000 geocoding requests per day, you can sign up for a LocationIQ account and integrate your API key into Maps Marker Pro’s settings.

5. Are there paid plans available for limits higher than 5.000/day?
Yes, LocationIQ offers various paid plans with increased limits for users with extensive geocoding needs.

6. How do I get started with the LocationIQ integration?
For existing Maps Marker Pro users, integration is automatic. To increase your daily limit and explore higher capacities, follow our simple guide to sign up for a LocationIQ account and integrate your API key.

7. Can I still use other geocoding providers?
Absolutely! While LocationIQ is the default, you can still choose from other geocoding providers within Maps Marker Pro based on your specific requirements.

8. Where can I find more information about LocationIQ’s offerings and plans?
Visit www.locationiq.com for details about LocationIQ’s services, plans, and capabilities.

9. What level of data can I expect with LocationIQ?
LocationIQ uses a combination of community datasets behind its Geocoder and Map APIs. You can expect excellent street level data worldwide and rooftop level data in certain regions

10. How do I troubleshoot any issues with the integration?
If you encounter any difficulties during the integration process or while using LocationIQ within Maps Marker Pro, feel free to contact our support team. We’re here to assist you.

Terms of services

The related terms of services can be found at https://locationiq.com/tos

Error codes

Reference for all LocationIQ settings

Geocoding bounds

When using batch geocoding or when ambiguous results are returned, any results within the provided bounding box will be moved to the top of the results list.

language

Change the default language of the results. You can pass two letters country codes (ISO 639-1). By default the language will be retrieved from the WordPress global variable $locale (with a fallback to en if not supported)

This is caused by the theme´s style.css – we already contacted the support and hope that the issue will be fixed with a new release of Newspaper theme soon.

Until this fix is available, you can workaround this issue by navigating to Newspaper / Theme Panel, select the tab “Custom code” and add the following CSS to the section “Custom CSS”:

body.td-animation-stack-type0 .td-animation-stack .entry-thumb,
body.td-animation-stack-type0 .post img {
    opacity: unset !important;
}

as an alternative you can also add the following CSS:

.maps-marker-pro img {
    opacity: 1 !important;
}

If you want to use their styles for Google basemaps within Maps Marker Pro, please proceed as follows:

1. Register for an account at Snazzy Maps and login
2. Navigate to the details page of your desired style, e.g. https://snazzymaps.com/style/237789/hcre
   
3. Copy the Javascripy style array into the clipboard
4. Open your map on backend, enable the advanced editor, switch to the “layers” tab and paste the Javascript style array into the field “Google styles”:
   
   Make also sure to select a Google layer.
5. Save the map and reload (new maps automatically get reloaded, manual reload is needed for existing maps)
6. Map with desired styles should be displayed:
   

If the “Save”-button on map or marker edit pages is disabled and cannot be clicked, it is likely that this is caused by a plugin conflict. To verify this, please disable all other plugins but Maps Marker Pro and try again.

If this does not help, it is likely that there might be an issue with your general WordPress AJAX endpoint. Have a look into the browser console (can be opened with key F11 for example) to see if there are any error messages. Send us these error messages in a support ticket so that we can have a closer look.

If you want to disable the responsive feature for a map, please open the map on backend, switch to the tab “Interaction” and disable the option “Responsive”:

The link to those QR codes can be found on the backend at “List all maps” when hovering the map name:

Clicking on this link shows the actual QR code for the map, which you can download and save as image with a right click for example:

If you activated your license on a subdomain first, please follow the tutorial on how to transfer a license to a new domain – once finished, activate your license key on your main domain first (like www.mydomain.com) and you will be able to use Maps Marker Pro on subdomains (like staging.mydomain.com) afterwards too automatically.