1. Home
  2. Knowledge Base
  3. Advanced
  4. Import Content to your Map

Import Content to your Map

Import is a powerful feature to add and edit data on your interactive map.

With Import, you can pull lots of content into your map all at once. We recommend using this feature if you want to add more than 20 locations on your map.

You can also use the import for bulk updates or to change the order of locations on your map.

With the Import and Export feature, you can:

 

How to import new locations

1. Generate a template

We recommend you first generate a template. To create a template, add at least a few locations on your map using the editor and then use the Export button to generate your template.

Important: In order to generate the template from the Export, you must first publish your map, otherwise the Export will return an empty file. To publish your map for the first time, click on the “Embed/Share” button on top of the editor.

2. Add your data in the template

Add your data to the template. See below the specifications for each field.

The order of the locations in your map and categories will follow the order of the locations in the import file.

Save the file as CSV with utf8

Important: Do not change the names of the import fields in the template header. The import will NOT work.

3. Import the data

Click on the import button and select the CSV file.

The order of the locations in your map and categories will follow the order of the locations in the import file.

The import fields

The following fields are supported for import. Please check carefully each field before creating your import file.

FieldsTypeDescriptionFormatRangeNote
mapmeIdoptionalId  This field is used ONLY used when updating existing locations.
It is generated with the data Export.
namerequiredThe name of the locationtext up to 128 characters  
descriptionoptionalThe description of the locationtext up to 8192 characters Can include HTML. We recommend no more than 1000 chars
categoriesoptionalThe category assigned to the locationtext up to 128 characters per category To select multiple categories, separate with “;” sign as in:
category1;category2;category3
addressoptionalThe address of the locationtext up to 256 characters You can either enter the address or the lat/long.
If you enter both the lat/long will be used to place the marker
latitudeoptionalThe longitude of the locationnumber-90 to 90 
longitudeoptionalThe latitude of the locationnumber-180 to 180 
pitchoptionalThe 3D effect of the location viewnumber0 to 600: the map is flat
60: the map is set at a 60 degree angle
zoomoptionalThe zoom of the location viewnumber2 to 222: the map shows the entire world
22: the map is fully zoomed in
3D building are displayed at 15 and above
bearingoptionalThe angle of the location view number0 to 360 
actionTextoptionalThe action button texttext up to 128 characters Example: Book now
actionUrloptionalThe action button URLURL up to 1024 characters Example: https://mywebsite.com
Need to start with https://
imageUrloptionalThe image URLURL up to 1024 characters Example: https://mywebsite.com/myimage.jpg
Need to start with https://

 

 

ADD Vs. SYNC import options

Note: the ADD or SYNC options are only relevant for maps with existing data. When importing data to a new map, both options will lead to the same result.

Map-import-export

Import with the ADD option

When selecting the ADD option, the import will add new locations to the map.

Existing locations that are NOT in the import file will not be removed by the import and will remain on the map.

Import with the SYNC option

When selecting the SYNC option, the map will reflect exactly the content of the import file after the import.

All locations that were on the map prior to the import and which were not included in the import file will be removed.

Be aware that this cannot be undone.

Update, Delete or Sort your Locations

You can use the import and export feature to edit, delete or sort existing locations in your map. This can save you time if you want to make a large number of similar edits (bulk edit) such as change the 3D effect or zoom level of your location.

Update your locations

To update your locations, please use the following steps:

  • Export the locations
  • Edit your locations in the CSV file using Excel or Google docs. Make sure you save your file as CVS utf8
  • Do not modify or delete the mapmeId field. It is used to identify the locations to be updated
  • Select either the ADD or SYNC mode
  • Import the updated file

Mass Delete Locations 

  • Export the locations
  • Delete the locations you want to remove from your map in the CSV file using Excel or Google docs. Make sure you save your file as CSV utf8
  • Select SYNC mode
  • Import the updated file

Sort your locations

  • Export the locations
  • Change the order of your locations in the CSV file using Excel or Google docs. Make sure you save your file as CSV
  • Do not modify or delete the mapmeId field. It is used to identify the locations to be updated
  • Select the SYNC mode
  • Import the updated file

Click here for more info on sorting locations in categories

 Import of images

Online images can be imported by adding in the header the field “imageUrl”.

The image URL needs to start with https, for example:  https://upload.wikimedia.org/wikipedia/commons//Tour_Eiffel_Wikimedia_Commons.jpg

Export your Map Locations

You can use the Export feature to get a file with all your location data. The file will be in a CSV format.

The Export feature will always reflect the data from the published version of the map, not from the draft version. Make sure to publish the map if you want to export the latest data.

To export your locations, on the Import and Export tab, simply click on the Export option.

Important note about editing using Excel

If you are using non-English or special characters, your CSV file must be encoded in the UTF-8 or UTF-16.  Excel 2011 and beyond do not have options to encode UTF files.

Before importing, you can change Excel ANSI encoding to UTF-8 with Notepad. Open the .csv file in notepad then select File > Save As. At the bottom you will see encoding set to ANSI, change it to UTF-8 and save the file.

You can also use Google Sheet to save your import data as CSV files.

If you have a KML file (e.g generated from a Google My Map), you can use one of the online converters to generate a CSV file. Note that Mapme will only import locations and not drawing.

Text with Double quotes

If you want to import text with a double-quote, you will need to escape the double quote using another double quote as in this example:

Beautiful house in the heart of the “”hells kitchen””, lots to eat, and drinks in that block.

Related Articles