Importing and using external geospatial data

Additional data sources to use could be any of the following:

  • .kml / .kmz (A file extension used by Google Earth Pro and related tools, but commonly used by many applications)

  • Shapefile (.shp and several other files, created by Esri for use in their ArcGIS software but commonly used by many applications)

  • .gpx (a GPS data file that contains waypoints, routes, and tracks; generated by handheld GPS devices by Garmin and others)

There are currently three different ways to work with the above kinds of external data.

Importing .GeoJSON or shapefile data as territory data

  • In the Top menu bar, click on File and then select Import territory data.

  • In the file browser pop-up window, navigate to the directory where the file you want to import is located. Select the file you wish to import (in either .GeoJSON or shapefile format).

  • Upon successful import, the data will not show up right away; you may have to reload Mapeo by pressing CTRL-R or restarting.

  • Once imported and refreshed, the data will appear as uncategorized features on your map. Remember that you will need to be zoomed in to the area where they are located in order to see them on the background map.

  • You can then edit the features in the same way as any features that were created directly in Territory mode.

Note: currently, it is not possible to import .kml / .kmz or .gpx data directly into your Territory database. See the next section for more information on how to use these as a map data overlay.

Using geospatial data as a temporary custom map data overlay

You can add geospatial data as a temporary data layer that is displayed on top of your background, as a reference for creating Territory data but without including this data directly into your database. This could be useful if you have some geospatial data that you want to display for reference when creating data, such as place names, rivers and creeks, roads and paths, or zonal data. In Territory mode, this is currently known as custom map data.

There are four types of data that can be added as custom map data: .gpx, .kml, .geojson and .json.

There are two ways to add custom map data to Territory mode:

  • Click on the […] Edit custom data layer button next to Custom Map Data. This button will be grayed out if no custom map data has been added.

  • From here, you can click the Choose File button to select a file, or add a data file URL if it is hosted on a server.

  • If you are adding a file, in the file browser pop-up window, navigate to the directory where the file you want to import is located. Select the file you wish to import.

  • Click Ok. Now, you should be able to check the Custom Map Data option to show or hide the geospatial data that you’ve added.

On the Territory mode map, custom map data is shown with a pink outline and fill. If you hover over or click over any custom map data shapes, you will see attributes of the data in the Edit feature panel.

However, neither the attributes nor the geometries of custom map data can be edited, as this data is only made available as a visual reference for creating territory data. If you want to include this data directly into your territory database, then you need to import the data as described in Importing .GeoJSON or shapefile data as territory data (and if your data is not in either of those formats, you may need to convert it using another software such as QGIS, ArcGIS, or web-based conversion tools such as toGeoJSON).

If you are unable to convert the file, then you can create new features by tracing over these overlain points, lines and areas. If you choose this route, you should make sure you are very zoomed in when you trace features to ensure you are as accurate as possible.

About observation data in Territory mode

While there is a different workflow for working with observation data in Mapeo that is documented in the Mapeo Desktop for managing Mapeo Mobile data (Observations mode) section, you can access Mapeo observation data in the Territory mode as well. Currently, Mapeo observation data will be displayed in the same style as Territory data.

It is also possible to edit Mapeo observations data in Territory mode, to a limited degree: you can edit feature details, and these changes will be reflected in Observation mode, and will also be synchronized with other Mapeo devices. However, if you move the location of a feature, or delete a feature in Territory mode, these changes will not be reflected in Observation mode; and, when you close and open Territory mode again, moved features will reappear in their original location as they were in Observation mode, and deleted features will reappear on the map.

Last updated