Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Requirements:
Both devices must be using the same configuration It is only possible to synchronize with devices that use the same configuration. For more on how to import configurations, see Importing configurations to Mapeo Desktop.
To synchronize, follow the steps below:
For more on how to create a local Wi-Fi network or connect to Wi-Fi, see I want to create local Wi-Fi networks I want to connect to Wi-Fi
In order to synchronize, both devices must have the Synchronize screen open.
Devices available for syncing will be listed on the Synchronize screen.
Remember that in order for a device to appear in the list, it must be connected to the same Wi-Fi network, have the Synchronize screen open, and be using the same project configuration. You can confirm which configuration Mapeo Desktop is currently using by consulting the white bar at the bottom of the Synchronize screen. For troubleshooting on this step, see I have sync issues.
Once available devices appear in the list, confirm the identity of the device you plan to synchronize with by consulting the unique identification number on the other user's device.
To see the unique identification number of a Mapeo Mobile device, check the right side of the navy blue bar on the Synchronize screen in Mapeo Mobile.
Important: Keep the Synchronize screen open on both devices until the synchronization process is complete.
To learn about viewing and managing synchronized data:
In Mapeo Desktop, continue to Viewing observations
In Mapeo Mobile, see #view-synced-observations
Mapeo Desktop can synchronize data via Wi-Fi with other computers or smartphones that use Mapeo. This is a good sync option when devices are near each other and it works with no internet connection.
Both devices need to be connected to the same Wi-Fi network For devices to sync, both need to be connected to the same Wi-Fi network. This Wi-Fi network does not need to have an internet connection.
Connect both Mapeo devices to the same Wi-Fi network. In offline environments, a local Wi-Fi network can be created using a mobile wireless router or a third device capable of serving as an offline hotspot.
In Mapeo Desktop: Click on Synchronize in the Mapeo modes panel.
In Mapeo Mobile: Tap the Synchronize button on the home screen.
In Mapeo Desktop, click on the SYNCHRONIZE button below the device name to begin the exchange of data.
This section explores how to use Mapeo Desktop to view and manage Mapeo Mobile data, as well as the available options for exporting data into different formats. The information is contained in the following pages:
To edit an observation, open its full details in the View observation window.
With the View observation window open, click on a field to add or edit information. Click SAVE to save changes.
In Mapeo Desktop you cannot modify the creation date, category type or geographic location of an observation.
Deleting observations cannot be undone, so exercise caution when using delete.
By deleting observations, you will permanently remove them from your device and all devices you synchronize data with in the future. For more on synchronization, see Peer-to-peer & Mapeo sync
To view and manage synchronized observations in Mapeo Desktop, click on Observations in the Mapeo modes panel on the left side of the screen.
Observations mode offers 3 different options for viewing observations in your database. In the Toolbar, you can choose between the following views:
To view observations as a gallery of images, click on Media in the Toolbar. Click on an individual image to view the details of that observation in the View observation window.
To view observations in the form of a report, click on Report in the Toolbar. Report view displays one observation per page and includes the category, coordinates, date, a map of the location, and any images associated with the observation.
For more on how to hide fields and save a report, see#save-as-pdf-report.
To look at a subset of your observations in Map, Media or Report view, use the Filter panel. Observations can be filtered by date, category, and some details fields used to collect the data.
Click ALL to reset the filter and show observations for all dates.
Use the checkboxes to select the categories that you want to make visible.
Click ONLY to show observations for a single selected category.
Click ALL to reset the filter and show observations for all categories.
You may also have the option to filter by some of the details fields used in your project. Only details that are "select one" fields (ie. you can only select one of the available answer options) will be available in the Filter panel.
For more on creating custom details fields, see Custom configurations.
Mapeo allows you to synchronize collected data with other Mapeo users or devices that are members of the same project. Synchronizing is used regularly throughout the course of projects to aggregate data collected by different participants and ensure that multiple copies of the complete database exist. Syncing data does not always require an internet connection and can be done in entirely offline areas.
Please note that by synchronizing with another Mapeo user, ALL DATA is shared in both directions. You will receive all of the observations present on the other Mapeo device and they will receive all of the observations present on your device. Only synchronize with members of your project whom you trust with all of your data. For more on synchronization, see: Peer-to-peer & Mapeo sync.
Any edits that have been made to the data will also be transferred to the other device during synchronization. For example, if a person deletes or edits an observation and then syncs with other devices, this observation will be deleted or edited on all synced devices.
It is important to create project synchronization protocols to ensure that all data becomes part of the project database.
There are 2 ways to synchronize with Mapeo Desktop:
If devices are in the same place, even without a Wi-Fi network.
If devices are not in the same place and both have an internet connection.
Mapeo Desktop is a computer application that can be used for two different purposes:
This section covers the available options and formats for exporting data from Observations mode in Mapeo Desktop.
In Mapeo Desktop you can view your data as a report. Each page of the report contains the details of one observation. From the Report view, you can:
To export your observation data as .GeoJSON
:
Select Export observations...
3. In the Export Observations pop-up window:
For the Data format field, select GeoJSON.
In the Only filtered data or all data? field, choose if you want the exported file to contain only filtered data or all data.
In the Also export photos? field, choose between including no photos, full-size photos, or preview-size photos in the exported file.
4. Click on SAVE.
5. In the pop-up window, give a name to the .GeoJSON
file and choose where to save it. Once you are done, click on Save.
You can now load and use this file in mapping software.
To export your observation data as .csv
:
Select Export observations...
3. In the Export Observations pop-up window:
For the Data format field, select CSV.
In the Only filtered data or all data? field, choose if you want the exported file to contain only filtered data or all data.
In the Also export photos? field, choose between including no photos, full-size photos, or preview-size photos in the exported file.
4. Click on SAVE.
5. In the pop-up window, give a name to the .csv
file and choose where to save it. Once you are done, click on Save.
You can now load and use this file in other software.
This is a useful export option if you want to publish an interactive online map with the observation data. To export observation data to a Web Map:
Select Export Webmap...
In the pop-up window, give a title and a description to the map and click on SAVE.
4. In the pop-up window, give a name to the Mapeo Web Package (.mapeomap
) file and choose where to save it. Once you are done, click on SAVE.
Click on + ADD MAP.
3. In the pop-up window, navigate in your computer's file system to locate the Mapeo Web Package (.mapeomap
) file. Select it and click on Open. Wait until the uploading process is complete.
5. Copy the URL link of the online map to share it with other people
You can also:
From Map or Media view, click on a dot or image to open the View observation window for the associated observation. From Report view, use the EDIT button in the grey toolbar to open the View observation window for the observation shown in the current page of the report.
To delete an observation, go to the View observation window and click on theMore options menu. Select Delete observation and confirm deletion by clicking Yes, delete in the pop-up window.
In the default Map view, observations are displayed as dots on a map. Use your computer's mouse or the Zoom controls at the top right of the map to zoom in and zoom out and navigate to different locations on the map.
Hover your mouse over an individual dot on the map to preview the associated observation. Click on a dot to view the full details of that observation in the View observation window. Click on the Expand button to view all fields in each section.
Use the Next and Previous buttons at the bottom of the screen to step through each page of the report.
You can filter observations included in the report using the Filter panel, and hide additional data fields using the Hide fields controls in the grey panel above the report.
To apply a filter, click the Expand button beside the desired filter section and adjust the filter criteria. Multiple filters can be used at the same time.
To filter observations by a specific date range, click Expand beside Date of observation to open the filter section. Click on the From and To date fields and use the pop-up calendar to define the start date and end date for the timeframe you would like to view. Only observations collected between these dates will be visible.
To filter observations by a category, click Expand beside Category to open the list of the categories used in your project.
To load observations into Mapeo Desktop for the first time, you will need to synchronize data with another computer or smartphone that uses Mapeo.
Synchronization via Wi-Fi () For syncing with another computer or smartphone Can be used if both devices are in the same place and have access to a Wi-Fi network. (An internet connection is not required.)
Synchronization with a file () Only for syncing between computers Useful in these two contexts:
Mapeo Desktop allows you to aggregate, view, and manage data collected with Mapeo Mobile. Observations mode offers options to filter and export data into multiple formats, such as GeoJSON, CSV, and PDF, and also allows the publication of online interactive maps containing data collected with Mapeo Mobile.
Mapeo Desktop also offers an interface for adding or creating territory data directly within the Desktop application. Territory mode provides a basic toolkit for mapping features that are more accessible to new tech users than other available geographic information systems (GIS) tools. It also offers the option to import geographic information from an external source, and export map data in a .GeoJSON
file format. Further manipulation or visualization of exported map data requires knowledge of other software.
: if you want to download or print a PDF report with the observations collected.
: if you want to continue working on your data in another mapping software (such as QGIS, ArcGIS, and others)
: if you want to view and manage your data using a spreadsheet in Microsoft Excel, Google Sheets, or other data analysis tools.
: if you want to publish an interactive online map with the observation data.
Edit the details of the observation on the current report page by clicking on EDIT in the grey panel above the report.
Control which observations are included in the report using the Filters panel. For more on filtering, see .
Decide which detail fields you want to show or hide. To do so, click on the Hide Fields button in the grey panel above the report and toggle on off/on the fields that you want to hide/show. Click on SHOW ALL to show all fields and click on HIDE ALL to hide them all.
To save the report as a PDF, click on Save PDF in the grey panel above the report. In the pop-up window, give a name to the PDF file and choose where to save it. Once you are done, click on Save. To view, share or print the report, locate the saved file on your computer and click on it to open it.
This is a useful export option if you want to continue working on your data in another mapping software (such as QGIS, ArcGIS, or others).
In the Observations mode of Mapeo Desktop, click on Export options in the Toolbar on the top right of the Mapeo Desktop window.
This is a useful export option if you want to view and manage your data using a spreadsheet and doing graphs and statistic analysis in software such as Microsoft Excel, Google Sheets, and others.
In the Observations mode of Mapeo Desktop, click on theExport Observation Data menu at the top right corner of the screen.
In the Observations mode of Mapeo Desktop, on the toolbar, click on Export options.
Go to the website and sign in or sign up. It's free and you only need an e-mail account and a password.
4. Click on Publish link to Map to open the website with your published map!
Click on Edit map details to edit the title, description, terms & limitations, and style of the background map.
Click on Menu to delete the map.
This section explores how to use Mapeo Desktop to create, edit and manage mapping data directly within the Desktop application, using Territory mode. The information is contained in the following pages:
While other options allow the synchronization between smartphones and computers, synchronizing with a file is only possible between computers.
In this option, a sync file is created in Mapeo Desktop on one computer and then it is used by another computer with Mapeo to exchange data. During the synchronization, all data contained in the sync file is transferred to the computer that is syncing with it, and all data in the Mapeo database of the computer will also be transferred to the sync file. It uses the same two-way method as synchronization via Wi-Fi. To learn more about how synchronization works, see Peer-to-peer & Mapeo sync.
Other requirements:
Both devices must be using the same configuration It is only possible to sync with sync files created by devices that use the same configuration. For more on how to import configurations, seeImporting configurations to Mapeo DesktopImporting configurations into Mapeo Mobile.
Click on Synchronize on the Mapeo modes panel
3. Click on the Create a sync file button and choose the name and location where the generated file will be saved.
There are two options for sharing a sync file:
Click on Synchronize in the Mapeo modes panel.
4. Click on the Sync from a file button and in the pop-up window, navigate until you find the desired sync file. Then click on it and click Open.Start synchronization
The synchronization with the file will automatically begin.
Important: Keep the Synchronize screen open on both devices until the synchronization process is complete.
To learn about viewing and managing synchronized data in Mapeo Desktop Observations mode, continue to:
The background map that appears underneath the territory data is a vitally important resource for creating features. This map serves as your primary reference to where features might be located when you are creating or editing data.
You move around the map by dragging it and by pressing and holding down the left mouse button and moving the mouse around. You can also use the ↓, ↑, ←, → arrow keys on your keyboard.
You can zoom in or out by scrolling with the mouse wheel or trackpad, or by clicking the + Zoom in and - Zoom out buttons in the Map controls menu on the right side of the map. You can also use the +
and -
keys on your keyboard.
You can also zoom to a set of geographic coordinates (in decimal degrees) by accessing the Zoom to Coordinates feature located in the View menu. Enter a pair of longitude and latitude coordinates separated by a comma and with longitude going first, and then click Submit. The background map should travel to the coordinates.
The + Zoom in to edit button appears at the top of your screen when you are not sufficiently zoomed in. You can press it to zoom in to a minimum high zoom level where editing is possible. Once you have created territory data, you can also use the Zoom to Data feature located in the View menu to zoom to the maximum extent of your territory data on the map.
Lastly, it is possible to activate an overview map at the top of the map, by pressing the /
key.
You can change the background map used in Territory mode at any time. For more information on this, visit Changing background maps in Territory mode.
The standard background map that appears in Territory mode when you are connected to the internet is an imagery map provided by Bing, composed of various sources of satellite imagery and aerial photography.
For territory mapping, high resolution imagery is frequently one of the best background maps because you can clearly identify features in the landscape.
You can change your background map at any time while you are adding or editing features in Territory mode.
Some of the standard background maps include:
Bing aerial imagery: An excellent source of satellite and aerial imagery at low, mid and high resolutions provided by the company Bing. Satellite imagery can be helpful for mapping both natural and artificial features in many different kinds of landscapes.
Esri World Imagery: An alternative imagery layer provided by the company Esri, sometimes providing different imagery sources.
Mapbox Satellite: Yet another alternative imagery layer provided by the company Mapbox; as with the Esri imagery layer, it is possible that there are different sources from the other two.
OpenStreetMap: A vector map composed of data from the OpenStreetMap service. Depending on where you are creating territory mapping data and the quality of OpenStreetMap data there, this may be a helpful reference for orientation or direct mapping, especially in urban settings or anywhere where there is a lot of human infrastructure.
OpenTopoMap: a vector map composed of data from OpenStreetMap combined with a multi-directional hillshade layer which highlights the landscape topography, and can be helpful for mapping features in mountainous regions. The available background maps will vary depending on your map location in the world. In some countries, there will be additional regional maps made available for you to use as a map background.
There are several additional options in the Background map window that may be useful to you:
You can enable and disable a Minimap which will show a small-scale (more zoomed out) map to give you an overview of your location. This minimap will use the same map as the Background map you have selected.
You can enable and disable Overlays which may add additional layers to contextualize your background map. The most useful of these to use in conjunction with satellite imagery background maps is the Locator Overlay option, which adds administrative boundaries, roads, and labels on top of your background map.
You can also provide your own custom background map, with the information most relevant to your project. This can be an online map source, or a directory composed of offline map tiles. There are two different ways to do this:
(1) Add a path to your map tiles (typically a directory of files in a {z}/{x}/{y}.jpg
format, or a singular .asar
file) using the Custom background option. Map tiles can either be hosted online, or offline on your machine, and so the path could either be an online path (with an http protocol) or a local file path.
To use a map tiles path as a custom background, click on the [...]Edit custom background button next to the Custom option in the Background map window.
Then, enter a path in the text field in the pop-up window, click on OK and then select the option Custom in the Background map window.
(2) You can also add background map options by specifying them in a custom configuration. Learn more about this by visiting Creating custom background maps.
To learn more about custom and offline maps in Mapeo, visit Creating custom background maps and Adding custom background maps to Mapeo Desktop.
We use the word features to describe things that appear on the map, such as rivers, buildings, or points of interest. In Territory mode, you can create features in the form of points, lines and areas by drawing these directly on a background map.
Points are features associated with a single location (coordinate). These could be specific places of interest like a building, place name, plant, or rapid.
Lines are features associated with a linear path (composed of a set of coordinates). Lines are used to represent features such as roads, trails, and rivers.
Areas are features associated with a bounded area (composed of a set of coordinates, and sometimes also called a “polygon”). Areas are used to show the boundaries of features like lakes, natural zones, and settlement areas.
In order to get started creating features in Territory mode, you first have to zoom in on the map until you get to a sufficiently high zoom level at which your data will be precise.
You can either navigate the map using your mouse or keyboard as described in Navigating around the map, or you can click on the Zoom in to edit button that will show at the top if you are not yet at a high enough zoom level. Clicking this button will zoom in the map at the center of your current view.
Note: if you already have territory data in Mapeo, this data will disappear from view if you are no longer zoomed in to a level where you can make edits. It will appear again once you return to a sufficiently high zoom level. You can also use the Zoom to data feature (located in the View menu) to zoom to the maximum extent of your data to help find your way back to your data at a sufficiently high zoom level.
To create a new point feature, click the Point button [or press the 1
key on your keyboard]. This will change the mouse cursor to a cross symbol. Also, the point button will now be highlighted in blue.
To place the new point on the map, position the mouse cursor where the point should go, then left-click [or press Space
on your keyboard].
To add a line, click the Line button on the toolbar above the map [or press the 2
key on the keyboard]. This will change the mouse cursor to a cross symbol.
Next, position the mouse cursor where the line should begin and left-click [or press Space
on the keyboard] to begin automatically placing nodes along the line of your mouse. Continue placing more nodes by clicking on the map [or pressing Space
on your keyboard]. While drawing, you can zoom in or drag the map in order to add more detail.
To finish a line, click again on the last node [or press Enter
on your keyboard].
To add an area, click the Area button on the toolbar above the map [or press the 3
key on your keyboard]. This will change the mouse cursor to a cross symbol.
Next, position the mouse cursor at one of the corners of the feature you want to create and left-click [or press Space
to begin placing nodes around the outer edge of the area]. Continue placing more nodes by clicking on the map [or pressing Space
in your keyboard]. While drawing, you can zoom in or drag the map in order to add more detail.
To finish an area, click again on either the first or last node [or press Enter
]. Mapeo will automatically join your last point to your first point to create a closed area.
After you create a feature on the map, the Select category panel will appear on the left, and you will be able to assign a category to the feature. Scroll down the list of categories to find the right one, or if you know its name you can search by starting to type its name in the search box. Recently used categories will appear at the top of the list, and the others are listed in alphabetical order.
Select the category that best represents what you are documenting in the feature you are creating. Mapeo comes with a default set of categories and associated icons that can be used for collecting and classifying data.
It is possible to create custom categories and icons to tailor Mapeo to your specific data collection needs. This customization currently requires significant technical knowledge. For more on customization, see Custom configurations.
Depending on the category you have selected, you may see specific questions associated with the category. These could be text fields, “select one” buttons, or “select multiple” checkboxes. All of these fields are optional.
Depending on the Mapeo configuration you are using, different types of features may be mapped using the same category. For example, in the current default configuration of Mapeo, you can assign the Lake category for both point and area features, depending on your use case: you may want to create a point dataset of all the names of lakes across a region, or, you may want to draw the boundaries of lakes to show them on a cartographic map.
To learn more about how data types work in Mapeo configurations, and how to customize these to meet your own needs, see Creating custom configurations.
Left-click on a feature to select it. This will highlight it with a pulsing glow, and the Edit feature panel will display details about that feature.
Right-click on a feature to display the Feature commands menu, which shows the commands that are available, such as rotating, moving, and deleting.
To move a point, place the mouse cursor over the point, then press and hold the left mouse button while dragging the point to its new location.
To move an entire line, right-click the line and select the Move command from the Feature commands menu. Then move the mouse, and left-click to place the line in a new location.
To adjust the shape of a line or area, first left-click to select it. All nodes of the feature will be drawn as small circles. You can then drag the nodes to better locations.
You can also create new nodes along a line or area either by double-clicking on the line or edge of the area, or by dragging the small triangles at the midpoints between nodes.
It is possible to activate a box of measurement information for a feature, such as the geometry type (point, line, area), the length or area, and the coordinates, by pressing Ctrl + I while a feature is selected.
Once you have selected a feature, you can also edit the feature details, such as the category and any of the detail fields, shown on the Edit feature panel left to the map.
To change the category, click on the category that is currently selected. This will show the same list of categories available when creating a feature. Select the category that you want to change the feature to by clicking on one of them.
Also note that to confirm a new feature, you first need to select a category (see #adding-a-category-and-details-to-a-feature).
On the Save your edits panel, you'll have a chance to review what you've done. Mapeo will also perform some basic checks for missing data and may offer helpful suggestions and warnings if something doesn't seem right (for example, if there is any data that is missing a category).
If you can't finish your edits in one sitting, for example if your computer crashes or you close the browser tab, your edits are still saved by Mapeo. When you open Mapeo again later and access the Territory mode, Mapeo will offer to restore your work.
Mapeo Desktop allows you to synchronize collected data with other Mapeo users or devices that are members of the same project. Synchronizing is used regularly throughout the course of projects to aggregate data collected by different participants and ensure that multiple copies of the complete database exist. Syncing data does not always require an internet connection and can be done in entirely offline areas.
Please note that by synchronizing with another Mapeo user, ALL DATA is shared in both directions. You will receive all of the observations present on the other Mapeo device and they will receive all of the observations present on your device. Only synchronize with members of your project whom you trust with all of your data. For more on synchronization, see: Peer-to-peer & Mapeo sync.
Any edits that have been made to the data will also be transferred to the other device during synchronization. For example, if a person deletes or edits an observation and then syncs with other devices, this observation will be deleted or edited on all synced devices.
It is important to create project synchronization protocols to ensure that all data becomes part of the project database.
There are 2 ways to synchronize with Mapeo Desktop:
If devices are in the same place, even without a Wi-Fi network.
If devices are not in the same place and both have an internet connection.
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.
.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.
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.
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.
.GeoJSON
file Once you are finished creating and editing data in Territory mode, you may export your data to a .GeoJSON
file format. This is a commonly used file format which can be opened using other GIS or cartography software or platforms such as QGIS, Mapbox Studio, or ArcGIS.
Note: this will export all of your territory data at once. There currently is no way to export a selection of your territory data.
If devices are near each other, this is a good sync option when you can't create a local Wi-Fi network. You can instead use a USB drive to copy and paste the sync file between different devices. It works with no internet connection.
If devices are not near each other, this is also a good sync option. In this case, you will either need to transport a USB drive to the location of the second device or have access to an internet connection.
Open Mapeo Desktop on computer 1, the computer on which you want to create a sync file. The generated sync file will include all the Mapeo data from that computer.
Send sync file via email or file sharing service (Requires an internet connection)
Copy and paste sync file using a USB drive (Works with no internet connection)
Locate the generated sync file on computer 1.
In your email app (Gmail, Hotmail, etc.), create a new email and attach the sync file. Send it to the user of the computer 2, the computer with which you want to sync.
Computer 2 must receive the sync file and save it. It is important to remember where has it been saved.
If the sync file is too large to be sent by email, you can use other platforms such as WeTransfer, Google Drive, or Dropbox. You can send files up to 2GB for free using these apps.
Connect a USB drive to computer 1, where you generated the sync file.
Locate the generated sync file on computer 1 and click on it using the right button of the mouse. Select Copy.
Navigate to the USB drive in the file system. Right-click on the location and select Paste to paste the sync file onto the drive.
Disconnect the USB drive and connect it to the computer you want to sync with ( computer 2).
Navigate to the USB drive folder and locate the sync file. Right-click on the file and select Copy. Navigate to where you would like to save the sync file on computer 2. Right-click on the location and select Paste.
Locate the received or pasted sync file on computer 2, the computer you want to sync with.
Open Mapeo Desktop on computer 2.
When the synchronization is complete, computer 2 and the sync file will have identical copies of the Mapeo database. To complete a 2-way synchronization between the two computers, repeat the process to copy the sync file back to computer 1 and use it to Sync from a file.
If your computer provides your geolocation, you can also click on theShow my Location button to pan to your location on the map.
There are also other background map options available in the Background map window, which you can open by clicking on the Background settings icon or pressing the B
key on your keyboard.
After selecting a category and filling in any information you can click on the confirm button in the top right of the Select category panel to stop editing that point. Clicking elsewhere on the map will also navigate you away from the panel.
To delete a feature (point, line, or area), right-click on the point to select it and show the Feature commands menu, then use the Delete command.
You can undo any edits to features by clicking the Undo button, and redo them by clicking the Redo button.
To confirm a feature after adding or editing, simply click on the Confirm located at the top right of Edit feature panel. Note that this will not save the feature in your Territory database until you go through the next step of #saving-all-of-your-changes.
Click Save to finish your edits and save them permanently to your computer. You should remember to save your work frequently!
Before saving your changes you must enter a Changeset Comment, or a short description of the changes you have made. Then click Save so your changes will be saved on the map, and can be synchronized with other devices or exported.
Synchronization via Wi-Fi () For syncing with another computer or smartphone Can be used if both devices are in the same place and have access to a Wi-Fi network. (An internet connection is not required.)
Synchronization with a file () Only for syncing between computers Useful in these two contexts:
When creating data in Territory mode, you may want to incorporate or utilize geospatial data from a source outside of Mapeo Desktop Territory Mode.
One key source of data that you may want to access in Mapeo Desktop Territory mode is data that was collected via Mapeo Mobile, synchronized with your Mapeo Desktop device, and available in Mapeo Desktop Observations mode.
.GeoJSON
(a commonly used format by many GIS tools such as QGIS or Mapbox, and also available as an export option in both Mapeo Desktop Territory and Observations modes)
You can import a file containing geospatial data (in .GeoJSON
and shapefile formats) directly into your Mapeo Desktop Territory mode database. This will add all of the data (points, lines, and areas) to your Mapeo Desktop territory data set as uncategorized features. You can then edit the features in the same way as any features that were created directly in Territory mode.
Currently, Mapeo does not provide any messaging once you have done so, but if the file you have selected has geospatial data that can be imported, Mapeo will begin importing the data. You may see a processing icon at the bottom right of the map, indicating that data is being imported.
Note: to import a shapefile, Mapeo Desktop is configured to look for .shp
file. However, a shapefile consists of a number of additional files with other extensions including .shx
, .dbf
, .sbn
and several additional optional files. Make sure these files are in the same directory as your .shp
file or the import will fail.
(1) Using the Map Data window
Click on Map Data [or use the F
key shortcut on your keyboard].
(2) You also can drag the files from a file explorer window directly onto the map view. This will automatically add the file to the Custom Map Data option in the Map Data panel.
To export territory data, click on the Export map data button on the top right of your screen, and select Export Territory Data as GeoJSON. Next, in the pop-up window, rename and save the .GeoJSON
file where you want.
It is possible to synchronize data created using Mapeo Desktop Territory mode with other devices:
If two Mapeo Desktop devices synchronize with each other in the Mapeo Desktop Synchronize mode, they will each exchange all of their territory data (as well as the observation data) with each other.
If a Mapeo Desktop device (computer 1) synchronizes with a Mapeo Mobile device (phone 1), then that Mapeo Mobile device will receive all of the territory data from the Mapeo Desktop device, and will store this data. The Mapeo Mobile device will not display this data on the map nor show any of the features in the Observations list screen. However:
When this Mapeo Mobile device synchronizes with another Mapeo Desktop device (computer 2), it will share all of the territory data from that first device (computer 1), and the second device will be able to see, edit, export, and synchronize that data as well.
When this Mapeo Mobile device (phone 1) synchronizes with another Mapeo Mobile device (phone 2), that second device (phone 2) will receive all of the territory data that was synchronized with the first device (phone 1), but won’t be able to see it or edit it. The second Mapeo Mobile device (phone 2) may now synchronize this data with other Mapeo devices.
Note: Synchronized territory data will also include any external geospatial data that was added to Mapeo Territory mode; see .
To learn more about how synchronizing data works in Mapeo, see.