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 #
Download Example CSV Download Example KML Download Example JSON
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
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 Enrollement”
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.
Column Meanings #
Import Columns #
- id (Required): This refers to the ID given to your marker.
- map_id: This allows you to specify the ID of the map you would like the markers to be imported into.
- address (Not Required if lat/lng present): This is the physical address of the marker. E.g. 123 Imaginary Drive, Los Angeles, California, USA.
- description: The description is the paragraph in the Infowindow which gives a description of your location or what your marker represents.
- pic: The pic column allows you to add an image to your marker by specifying the image URL. You can only add one image per marker when importing.
- link: The link column allows you to specify the link for the “More Details” button in the Infowindow.
- lat (Not Required if Address is present): The lat column refers to the latitude value for the marker’s position.
- lng (Not Required if Address is present): The lng column refers to the longitude value for the marker’s position.
- icon: The icon column allows you to set the marker’s icon that will display on the map. This is done by entering the URL for the icon you want to use.
- anim: The anim column refers to the animation of the marker. Depending on the value the animation will either be None (0), Bounce (1), or Drop (2).
- title: The title column refers to the Title given to the marker/Name of the marker. E.g. Beijing Railway Station.
- infoopen: The infoopen column refers to whether you want the infowindow for that marker to be open by default or not. Setting it to 0 will mean the infowindow will be closed by default, whereas setting it to 1 will open the infowindow by default.
- category: The category column allows you to set which categories your marker belongs to. This is done by entering the category id into the column.
- approved (Required): The approved column refers to sets whether the marker is allowed to be displayed on the frontend of your site or not. Setting it to 1 means that the marker will be displayed on the frontend, whereas setting it to 0 means it will not be displayed on the frontend.
- retina (Required): The retina column refers to whether or not the Retina is enabled to disabled. Setting it as 1 will enable the Retina, whereas setting it to 0 will disable the Retina.
CSV Upload options #
CSV import
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 the 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 labeling 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)
