User Guide

Table of Contents

  1. Getting Started
  2. Editing Maps with QGIS
    1. Map Layers
    2. Drawing Features
  3. Printing Territory Cards
  4. Advanced Topics
    1. Importing City Suburb Boundaries
    2. Locating Staircase Entrances

Getting Started

  1. Visit https://beta.territorybro.com and register a new congregation in Territory Bro. You will need to login using your Google or Facebook account.

  2. After registering the congregation, there is a link to download a QGIS project file for your congregation. Save the project file on your computer.

  3. Download and install QGIS 3.4 (Long Term Release). This program will be used to edit the territory maps.

  4. Use QGIS to open your congregation’s QGIS project file (which you saved in step 2). You should see a world map and you can zoom to your city.

After this the next steps are to draw your congregation’s boundaries on the map and then start drawing individual territories.

Editing Maps with QGIS

Map Layers

After opening your congregation’s project file in QGIS, you should see a layers panel. If it is not visible, select View | Panels | Layers from the main menu.

Layers panel

On these layers you can draw features. A feature is what QGIS calls a shape and any attributes which describe shape.

What the features on these layers mean is best understood by looking at a printed territory card:

Territory card

A feature on the territory layer is shown in the map as a red border ①, its number attribute is shown in the right corner ②, its addresses attribute is shown on the right side ③, and its subregion attribute is shown in the heading ④.

The minimap ⑤ is composed from multiple layers: The territory layer’s feature is shown as a dot. The congregation_boundary layer’s feature(s) are shown as a black border. The subregion layer’s feature which contains the current territory, is shown as a dark gray area.

The card_minimap_viewport layer determines the minimap’s ⑤ zoom level. By default the whole congregation_boundary is shown in the minimap, but if the card_minimap_viewport layer contains features and the current territory is inside one of them, the minimap will zoom to that card_minimap_viewport.

Only the congregation_boundary and territory layers are mandatory. The other layers can be left empty.

In the layers panel there are also various map rasters. The default is OpenStreetMap, which has street maps for the whole world, but for some countries there are also additional maps. These same maps can be used for printing the territory cards inside Territory Bro.

Drawing Features

In QGIS, to draw a feature on one of the layers, first select the layer in the Layers panel and choose Layer | Toggle Editing from the main menu.

Now the layer is editable and you can choose the Edit | Add Polygon Feature tool. Left-click on the map to draw the polygon’s corners. Right-click when you’re finished, after which you can type the feature’s attributes.

The feature is saved to the database only after you select Layer | Save Layer Edits. To avoid losing work, it’s best to save after each new territory you add, in case QGIS crashes and you need to restart QGIS (it is known to happen).

After you are done editing a layer, you can choose Layer | Toggle Editing again to make the layer read-only.

Printing Territory Cards

Note: This video is a bit old, so you can skip the beginning and start watching from 4:00. The export/import phase is no more needed, because you can now login to Territory Bro and it will show your territories directly. Also the experimental web browser features mentioned in the video are no more experimental.

Log in to https://beta.territorybro.com, choose your congregation and to go printouts. You should see your territories ready to be printed using various card templates. You can print multiple territories by holding down Ctrl or Shift to select them from the territories list.

By default, the map rasters from OpenStreetMap are used, but Territory Bro can support also other freely available maps. Create an issue if you know about a map you wish to use.

You can do minor adjustments to the maps: drag with mouse to move, scroll mouse wheel to zoom, hold Alt+Shift while dragging to rotate. These adjustments are not saved after you leave the page, so do them right before printing the cards.

Using the latest Chrome or Firefox, save the territory cards page as PDF. Open the PDF in Adobe Reader, print one page with 100% scale on paper (one A4 sheet fits 2 cards) and measure the distance between the printed crop marks. Then measure that what the dimensions of the card should really be, so that it would fit inside your protective plastic cases. Calculate the correct scale for printing the cards by dividing those two measures and try printing again.

Print the territory cards with the correct scale on thick paper. Cut the cards along the crop marks using a ruler and a sharp knife. Optionally cover the cards with adhesive book covering film (before cutting them out).

TODO: Update this section of the user guide (the video).

Advanced Topics

Importing City Suburb Boundaries

Note: This video is a bit old. It shows an older version of QGIS. With QGIS 3 some things may work differently, and some things you might be able to do without installing plugins.

The above video shows starting at 4:45 that how to use QGIS to copy city suburb boundaries from a WFS service to your subregion layer. The video shows an old version of QGIS and Territory Bro, but the basic idea is the same.

TODO: Update this section of the user guide (importing WFS/OSM/KML).

Locating Staircase Entrances

Note: This video is a bit old. It shows an older version of QGIS. With QGIS 3 some things may work differently, and some things you might be able to do without installing plugins.

The above video shows at time 1:05-3:40 that how to use OpenStreetMap to find out the staircase entrance letters/numbers easily. You could also use Google Street View.

TODO: Update this section of the user guide.