Mobile app

App overview

The Trap.NZ app works with the TrapNZ website and allows you to record trapping data on your phone.  With it, you can plot traps, bait stations, monitoring stations, and bird count locations. You can also add records to installations (traps, stations and locations) when you are out in the field.

The app will show you a map of your project area and works offline (when you are out of cell phone or WiFi coverage).  Records are stored and synced automatically whenever there is a data connection available. 

 

Download on the App Store Get it on Google Play

Logging in to the app

To use the app you need an account on the Trap.NZ website which is a member of an existing project.

If you don’t have an account, go to the Create new account page.  After you have created an account and logged into the website, you can then create your own trapping project, or request to join other projects.

As soon as you have an account which belongs to a project, you can use the app. The main app menu allows you to select a project, and from there you can begin adding data or changing the app settings.

Understanding the app map

Map Icons

Trap 

Bait station

Monitoring station

Bird survey site

Layers

 Tap the layers icon to choose between aerial and topographic maps, and to optionally select the type of installations that are visible on the map.

Tap the close drawer icon to close the layers menu. 

Initially, only the installation layers are available.  You can choose additional layers under General Settings (such as the topographic base map, city and street labels and parcel boundaries). See more about the available layers.


 

Use the search tool to find installations by name.  As you type, all installations with matching text are listed below.  You can then tap the installation name to view it on the map, or click the edit icon  to add a new record on it.

App menu overview

You get to the settings menu by clicking on the three horizontal lines in the top right corner (sometimes called the hamburger!).

Project Settings

Re-download files and set offline preferences

Logs

Shows a list of recent updates from the app to the server with problems highlighted. Clicking on these messages gives more detailed information for debugging purposes.

My Projects

Takes you back to your project list where you can switch to another project.

General Settings

Map layer preferences, record defaults, notification settings etc.

About

Links to support and privacy policy, app version number.

Sign out

Log out of the mobile app.

Project settings

Flush Project Cache 

Normally, changes to projects are synced automatically.  For example - if someone else adds a trap or bait station to a project, this will become visible in the app within a few minutes.   

Clicking on the cloud icon will flush the project cache and force a refresh of the entire project.  Depending on the size of your project, this may take some time and use up some data.

Re-fetch project tiles

This will re-download the map tiles for the project. This is usually not necessary but if your map has gaps in it then this button may help to download them.

Tile resolution

Set the default detail level of the map tiles stored for offline use. Low detail is fast to load and uses less storage space, but will look fuzzy when the map is zoomed in. High detail takes longer to load and uses more storage space on your device but retains map detail when zoomed in.

General settings

You can click the question mark next to each option to get some information about what the option does.

Enable base map options

Topographic

Enables the topographic base map. With this setting enabled you can use the layer control on the map to switch between the enabled base maps.

Streets

Enables the streets base map. With this setting enabled you can use the layer control on the map to switch between the enabled base maps.

Enable layer options

Parcel Boundaries

Provides a map of land, road and other parcel boundaries, and is especially useful for displaying property boundaries. This is displayed as a black outline overlaid on top of the current base map.

Labels

Shows labels for regions, cities, towns and street names on top of the current base map.  

Display installation labels

This will turn labels on or off for your traps, bait stations and monitoring sites. The labels only show when you are zoomed in.  

Clustering

Some phones/tablets are very slow to display a map which has many installations on it.  Clustering improves this 

by displaying installations which are close to each other using

 a single icon.  Enabling this option will cluster all installations that are too close together to be individually visible. Clustering is always done if there are more than 150 installations visible on your screen.

Map with clustering turned on

Hi-res tiles on demand

This setting will automatically download higher detail maps when you have an internet connection available (mobile or WiFi). These are only stored temporarily on your device and won't be available offline. To save high detail map tiles for offline use, change the settings for Offline Tiles in Project settings.

Records

Display installation details

Installations can have notes entered against them on the website.  Notes can be used to record hazard or access details. Notes (including some other information like coordinates and when the last record was added) can be automatically displayed when adding a record. Check this box to automatically display the installation notes.

Recorder

The name used to identify records you make. Defaults to your name on Trap.nz.

General

Notifications

Help popups will appear in some situations - you can disable these once you know your way around the app

Auto-sync incoming changes

By default the project will update with incoming changes soon after they occur.

This can be disabled in the General Settings. When disabled a cloud download button  will appear in menu bar when changes are detected. Press this to bring down the changes.

Automatically get updates when other members make updates to your project. With this setting disabled you will still get updates from other members, but this forces the updates to happen more quickly.  We recommend that you leave this setting disabled as it can affect performance (especially on large projects with multiple trappers working simultaneously). You can manually sync at any time by clicking the cloud button on the main header.

Maintenance

After this period installations are highlighted in red to indicate they need attention. Defaults to 90 days.

Checking the sync logs

When the Trap.NZ app is used offline (without internet access) your data is stored locally on the phone until you have internet access again. Your data is synced automatically once the internet connection is available.

Logs show the sync status of your data:

  • Synced (safely on the Trap.NZ website)
  • Queued (to be be synced as soon as internet access is restored), or
  • Failed to sync (something went wrong with the syncing)

The cloud icon indicates items that are queued and have yet to be synced with the Trap.NZ website.

When you click on an entry, the data for that entry will be shown.

  • If an entry has synced, you will see a button to “View Online”, which directs you to the website where you can view and edit the entry.
  • If an entry has failed, you can view the failed message here, and use the retry button to try syncing it again

View your project log

  1. Click on the hamburger menu in the top right corner of your project map to open the app menu
  2. Select "Logs" from the app menu

Adding installations on the app

To add an installation to your project:

  1. Locate where you want to add the installation on the map. You can do this by:
    • Using the pan and zoom controls to the desired location on the map, and press the Add button in the bottom right of the screen.
    • If you are physically at the installation site, use the GPS button to locate yourself on the map.
  2. If the location appears wrong, drag the reticule (black crosshairs with red dot in the middle) to the correct spot and press the green tick to confirm (or the red cross to cancel). 
  3. Choose which type of installation to add: Bait Station, Trap or Monitoring Site

Map features


By default only the Filters list is shown.  This allows you to select which kind of stations are visible on the map.

To enable additional map features visit the General Settings screen.

Base maps

Satellite

Shows photographic satellite images.

Topographic

Shows a topographic elevation map.  This must be enabled by selecting Topology in General settings.

Streets

Shows a street map.  This must be enabled by selecting Topology in General settings.

Layers

Parcel boundaries

Provides an outline of land, road and other parcel boundaries, and is especially useful for displaying property boundaries. Enabled by selecting Parcel boundaries in General settings.

Labels

Shows labels for regions, cities, towns and street names on top of the current base map. Enabled by selecting Labels in General settings.

Filters

Allows you to adjust the default map view showing traps, bait, and monitoring stations.

Records overview

Using the map, tap on the icon for any installation to add a record to it. 

If the installation is part of a trap/bait line you will see a representation of the current line at the top of the screen:

The arrow indicates the position of the installation you are currently adding a record to. Installations that haven't been updated within the maintenance period (see General Settings) are red.  Installations that have been updated within the maintenance period are green. 

The navigation arrows at the bottom of the screen will take you to the next or previous installation on the line.  This makes it easy to update traps in order as you walk a trap line.

Press and hold the save button until you see the ‘SAVED’ message, this will to upload the record to Trap.NZ. The close button will take you back to the project map.

Trap records

 

 

 

 

image-1633571540949.pngDate

Defaults to the current date and time. Tap it to change it.

Species caught 

Select a species from the list or leave as None.

Trap status 

Select a status from the list.

Condition 

Select a maintenance condition from the list.

Re-baited 

If you re-baited the trap, check this box and select the bait type from the list.

Bait notes

If you used a bait type which is not on the list you can note it here.

Notes 

Add any notes about the check here.

Installation details 

Tapping this will display additional details about the installation and display the Add colocated installation button. This allows you to create another installation at the same location. You can pin this open by checking the Display installation details checkbox in General settings.

image-1633571634204.png

When saved, the record indicator at the top will turn green, as will the border around the trap on the map.

 

 

Bait station records

Date

Defaults to the current date and time. Tap it to change it.

Target species 

Select a species from the list or leave as None.

Formulation 

Select a bait formulation from the list.

Active ingredient 

Select the active ingredient for the bait from the list.

Concentration % 

Enter the % concentration of the active ingredient.

Bait remaining

Drag the slider to select the amount of bait remaining when you checked it.

Bait removed

Drag the slider to select the amount of bait removed after checking.

Bait added

Drag the slider to select the amount of bait added after you checked it.

Notes 

Add any notes about the check here.

Installation details 

Tapping this will display additional details about the installation and display the Add colocated installation button. This allows you to create another installation at the same location. You can pin this open by checking the Display installation details checkbox in General settings.

When saved, the record indicator at the top will turn green, as will the border around the station on the map.

 

Monitoring station records

Date

Defaults to the current date and time. Tap it to change it.

Target species 

Select a species from the list or leave as None.

Formulation 

Select a bait formulation from the list.

Active ingredient 

Select the active ingredient for the bait from the list.

Concentration % 

Enter the % concentration of the active ingredient.

Bait remaining

Drag the slider to select the amount of bait remaining when you checked it.

Bait removed

Drag the slider to select the amount of bait removed after checking.

Bait added

Drag the slider to select the amount of bait added after you checked it.

Notes 

Add any notes about the check here.

Installation details 

Tapping this will display additional details about the installation and display the Add colocated installation button. This allows you to create another installation at the same location. You can pin this open by checking the Display installation details checkbox in General settings.

When saved, the record indicator at the top will turn green, as will the border around the station on the map.

Bird count records


Settings

Tap the cog icon  to set the type of observations (seen, or seen and heard) and to add historical records.

Species 

Tap the bird icon  to select species to observe from the list. You need to select at least one species to start.

 

 

Observation types 

Select whether your observations are only for birds you have Seen or whether you want to include ones you've only Heard as well.

Add historical bird count 

Allows you to add observations without running the timer.

Start 

Tap the Start button  to start the timer and record observations

Pause

Tapping the Pause button  allows you to

temporarily pause the timer countdown so that you

can add new species or change your settings.

Stop

Tapping the Stop button  cancels the count, removes all counts made in the current session and resets the timer. 

Seen

Tapping the Seen icon  increases adds a Seen observation and increases the observation counter for that species. To remove a count, press and hold until the number decrements.

Heard

Tapping the Heard icon  adds a Heard observation and increases the observation counter for that species. To remove a count, press and hold until the number decrements.

Moving installations in the app

Open any installation record form and expand the Installation Details panel. Use the Move location button to reposition the installation. 

If the installation has prior records and you are moving it a significant distance (greater than 10 metres) the app will offer two options:

  1. Move location - this will clone the installation and retire the original installation. Use this option if you are physically moving the installation. Retired installations can be reactivated at any time.
  2. Correct position - this simply updates the coordinates of the existing installation meaning all prior installation records will appear at the new position. For this reason only this option if you are correcting the mapped position.

image-1633571818764.png