WP Go Maps (v9)
Importing and Exporting Data

Importing Files

8min

ο»Ώ

Overview

This article covers importing map data and settings into WP Go Maps

Setup

Prerequisites

The Following Plugins need to be installed and active

  • WP Go Maps
  • WP Go Maps Pro Addon

Please see ourΒ Importer Demo PageΒ for an example of imported data, and examples of the various formats supported.

Download Example Files

Importing Files

To Import map data and settings please navigate to:

WP Go Maps -> Tools -> Import

Select the File as the Source, then Choose file and then Press "Upload"

File Upload
File Upload
ο»Ώ

The Following files are accepted: *.txt|asc|c|cc|h|srt|csv|json, *.csv, *.gpx, *.kml, *.geojson, *.wpgmza-settings

Note not all Data types are available for every file type (please refer to Exporting Data and Settingsο»Ώ for a summary of which data types are generally associated with each file type)

CSV import file - Important upload guidance

To ensure imported markers display on the front end:

Set the Approved field to '1' - All blank Boolean fields in the upload file will default to a value of β€˜0’ on upload, this includes the β€œapproved” field which correlates to the β€œDisplay marker on front end” setting. Please set this field to '1' for each marker that should be displayed on the the front end, if this is left blank this will be interpreted as unapproved and the corresponding marker will not be displayed.

Adding custom fields to the import file:

If you would like to include a new custom field in the import please ensure the header for that field is included in the following format Custom Field:Custom field name in the example below the custom field name is "Date of Enrolment"

Adding a new custom field, via the import file
Adding a new custom field, via the import file
ο»Ώ

If a custom field has already been created for the map you are importing to, you can map any header to that field by using the "Remap Columns" Option in the the upload, in this case the custom field format described above does not need to be adhered to.

CSV Upload options

CSV import Options
CSV import Options
ο»Ώ

Find Addresses :You can use theΒ Find Addresses setting to geocode addresses or coordinates where needed. If your import source has addresses, but no latitude and longitude coordinates, please use this setting. If your import source has coordinates, but no addresses, you can use this setting to guess the nearest street address when importing data.

If you you receive a Geocode Failed message when importing your markers, while using the Find Addresses option, please see the following troubleshooting guide "Geocode failed (Request denied)" errorο»Ώο»Ώ

Use map ID's specified in file: The import will only be applied to the map IDs specified in the File.

Use the "Use map ID's specified in file" option when running an import with the intention of updating existing markers on the map specified in the upload file

Apply import data to: Use this option to disregard the Map IDs specified in the upload file. Multiple maps can be selected to update when this option is selected. Remap Columns: If your CSV file does not match the format and labelling of the Sample file provided, here you are able to remap your column headers to the expected headers.

Batch Import Size: This specifies the Maximum number of rows to import in each batch, only adjust this if you are experiencing issues with imports Mode:

  • Create & Update - If a matching ID is found, it will be updated. If no matches are found, a new item will be created
  • Replace All - All items will be removed from the map, and the data within the CSV will be used to create new items

Delete import file after import: Remove this file from the media library after the import has completed

Completing the import

Once import options have been selected, you can complete your import by selecting the "Import" button or selecting "Schedule" to schedule the import for a later time. The Schedule option is especially useful when you want to import data from a remote source, where the source data changes periodically (best used with the URL import)