Online Help > Placemarks > How to import and export placemarks in CSV/TSV files?

How to import and export placemarks in CSV/TSV files?


The import and export CSV/TSV files support allows the application to import placemarks from and export placemarks to CSV files (comma-separated values, *.csv) and more generally to delimiter-separated values files (like tab-separated values, or TSV).

Because this format is not primarily designed to store geographic data, you'll need to manually specify what type of data is stored by each column, especially in which columns are stored the latitudes and longitudes of the geographic points.

How to import CSV/TSV files?


To import a CSV/TSV file:

  • Tap on the Placemarks menu icon and on Explore placemarks . The default placemark folder is listed;
  • Select the folder in which the file to import is located. If needed, tap on the top left menu to list the main folders of your device. For example, tap on My downloads to select the folder /storage/emulated/0/Download/.

local-import-xsv-1.jpg


Once the file to import is displayed , tap on it to display the import settings :

  • If needed, tap on Folder to import the file in the current folder instead of the default import folder;
  • If needed, tap on Charset to select the file charset if it's different from the device charset;
  • If needed, tap on Placemark to select the type of placemark to create from the imported locations;
  • If needed, tap on Separator to select the column separator character;
  • If needed, tap on Location format to select the coordinates format of the file;
  • If needed, un-check Headers in first row if the first line of the file is not used to store headers (column labels);
  • For each column, tap on the assignment button to select a corresponding type (you must select at least a Coordinates column or a Latitude / Y and a Longitude / X column);

Some of the columns may already be assigned since the application tries to detect them from the headers.

local-import-xsv-2.jpg


When you've assigned an import type to all the columns you want, tap on Ok to start the import. In this example, the application will read the location longitudes from the first column, the latitudes from the second one, and the names from the third column.

Wait some time for the file to be imported. When it's done, you can:

  • Choose Browse to list the content of the imported file, for example if you want to display only few items;
  • Choose Display to display the entire file content on the map.

local-import-xsv-3.jpg


How to export CSV/TSV files?


To export a placemark in a .csv or .tsv file and use it in an external application:

  • Tap on a displayed placemark on the map and on its icon (you can either tap the waypoint icon to only export the selected waypoint or tap the set icon to export all the waypoints of the set);
  • Choose Export as… ;

In the list of available export formats, choose CSV file for comma-separated values, or TSV file for tabulation-separated values.

local-export-xsv-1.jpg


In the export settings, select all the columns you want to export , and tap on Ok to export the placemark.

Among available fields (depending on what is recorded in the exported placemark), you'll find:

  • Longitude and Latitude, the coordinates of the points in the WGS84 (GPS) datum;
  • Coordinates, the coordinates of the points in another datum you can select;
  • Elevation, the elevations of the points, either in the WGS84 (GPS) datum or in the EGM96 (Geoid) reference;
  • Time, the dates and times recorded of the points in millisecond (unix time format);
  • Accuracy, the accuracies of the points in meters, with a 68% confidence;
  • Pressure, the pressures recorded of the points, in hectopascal (hPa);
  • Distance from the center, the distances from the current map center of the points, in meter (m).

Once the placemark has been exported, the full path of the exported file is displayed.

  • Tap on Share to share the file (send it as email, upload it on Dropbox, etc.), available actions depend on the applications installed on your device;
  • Tap on Open to open the file with a compatible application installed on your device;
  • Tap on Ok to close the dialog.

Be careful when trying to access the exported file from a computer using an USB cable, Android takes time to update the file list of your device, and newly created ones may not be immediately visible.

local-export-xsv-2.jpg