wpsWatch Event Type

The wpsWatch integration adds tag information to camera trap events. If the site doesn't have a Camera Trap event type yet, create it with the EarthRanger CLI.

Who is this article for? This guide is for EarthRanger Support and technical staff who are comfortable using a command-line terminal. If that's not you, no worries — just reach out to the Support team and they'll set up the Camera Trap event type for you.

 

1. Install the CLI and log in to the site

Prerequisites: a terminal with git and uv installed, and an EarthRanger account on the target site.

git clone https://github.com/PADAS/earthranger-cli   # download the tool's code
cd earthranger-cli                                   # go into the downloaded folder
uv pip install -e .                                  # install it; this gives you the 'er' command

er profile add sitename --server sitename --username you   # save the site as a profile ('sitename' is the site's subdomain, e.g. 'grumeti' for grumeti.pamdas.org)
export ER_PROFILE=sitename                                  # tell 'er' to use that profile in this terminal
er auth login                                               # asks for your EarthRanger password and signs you in
Important: The account you log in with must have permissions on the Event Category that will host this event type.

2. Save this spec as cameratrap.yaml

Set category to the category that should host Camera Trap on this site (e.g., security or monitoring).

category:
  value: security
  display: Security

event_types:
- value: cameratrap_rep
  display: Camera Trap
  icon_id: cameratrap_rep
  default_priority: red
  default_state: active
  sections:
  - label: ''
    columns: 2
    fields:
    - key: cameratraprep_camera-name
      label: Deployment Name
      type: string
    - key: cameratraprep_camera-version
      label: Camera Version
      type: string
    - key: cameratraprep_camera-make
      label: Camera ID
      type: string
      column: right
    - key: cameratraprep_battery-level
      label: Battery Level (%)
      type: number
      min: 0
      max: 100
      column: right
  - label: ''
    fields:
    - key: tag_count_array
      label: Detections
      type: collection
      item_name: Detection
      button_text: Add
      fields:
      - key: tag
        label: Tag
        type: string
      - key: count
        label: Count
        type: number
  - label: ''
    fields:
    - key: tags
      label: Tags
      type: multiselect
      choices_field: cameratrap_tags
      options: []          # starts empty; the integration adds tags as they arrive

3. Preview, then apply

er events apply cameratrap.yaml --dry-run   # shows what will be created
er events apply cameratrap.yaml             # actually does it

4. Verify

er events show event-type cameratrap_rep

CLI tool and full spec documentation: https://github.com/PADAS/earthranger-cli