Creating and editing territory data
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.

Zoom in to edit

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.

Creating features

Creating point features

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].

Creating line features

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].

Creating area features

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.

Adding a category and details to a feature

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.
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 learn more about how data types work in Mapeo configurations, and how to customize these to meet your own needs, see Creating custom configurations.

Viewing and editing a feature

Select a feature

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.

Moving points

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.

Moving lines

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.

Modifying lines or areas

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.

Accessing measurement information for a feature

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.

Deleting features

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.

Editing feature details

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.

Undo & Redo

You can undo any edits to features by clicking the
Undo button, and redo them by clicking the
Redo button.

Confirming feature details

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 .
Also note that to confirm a new feature, you first need to select a category (see Adding a category and details to a feature ).

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!
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).
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.

Automatic Backups

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.