Field Surveyor guide

The field app runs in your phone’s browser. You capture properties on site — boundary, claimant, what is on the land and photos — and survey properties the office assigns to you. Everything is saved on the phone first, so you can work with or without signal, and the app sends your work as soon as it can.

Default role: Field Surveyor Permission: survey.field

Set up your phone

  1. Accept your invitation: open the link from your administrator and choose a password. The screen then shows the field app’s address.
  2. Open that address in Chrome (Android) or Safari (iPhone).
  3. Add it to your home screen so it opens like an app:
    • Android, Chrome: menu ⋮ › Add to Home screen (or Install app).
    • iPhone, Safari: Share button › Add to Home Screen.
  4. Allow location and camera when the app asks the first time.
Your account is for the field app only

Field Surveyor accounts cannot log in to the office app. The office app tells you to use your phone instead.

Log in

You need internet to log in. After that the app works offline for up to 30 days before it asks you to log in again.

The two tabs

After logging in, the home screen has two tabs:

TabUse it to
Field captureCapture properties on site in a project: new properties, drafts from the office’s map scan, and properties already on record that still need details. See Field capture.
Assigned surveysSurvey properties the office has assigned to you, with the findings form. This works as before. See Assigned surveys.

Field capture

Choose a project

  1. Open the Field capture tab. It lists the active projects where you have an area (a sub-boundary assigned to you by the office), with your area’s name, whether you lead it, and how far it has got (“12 of ≈40 captured · 85% complete”). A supervisor whose role has field.all_projects sees every active project. Each download is recorded on the project.
  2. Tap a project. The first time, the app downloads it to the phone, so you need signal. After that it opens offline.
  3. The project shows its properties. Search by reference number, address or claimant, or filter: All, Captured here, Incomplete, Not synced.

Your areas

Each property shows its % complete and, where something applies, a marker:

MarkerMeaning
Not syncedSaved on the phone; not yet sent to the office.
Photos waitingThe record has been sent; some photos have not uploaded yet.
Sync problemThe office could not accept it. Open it to read why.
Changed in officeThe office edited this property since your last sync. Your changes still go to the office, which decides which version to keep.
Claimant on holdThe office is deciding a conflict about who the claimant is.
Draft — confirm on siteMade from a map scan by an earlier version. Visit it, walk the boundary and check the details.

Capture a new property

  1. In the project, tap New property.
  2. Choose the property type, then the LGA, ward and area, and type the address or a landmark.
  3. Walk the boundary.
  4. Find or register the claimant.
  5. List what is on the property.
  6. Take the photos.
  7. Tap Save on this phone (Save changes for a property already on record).

To open a property again, tap it in the list, or on the map.

Walk the boundary

  1. Stand at the first corner of the property and tap Add corner here. Keep still: the app takes several GPS fixes and averages them, which takes a few seconds.
  2. Walk to the next corner, in order around the property, and tap Add corner here again. Repeat for every corner.
  3. Three corners or more make a boundary. The app shows its area and number of corners.

The claimant

  1. Tap Find claimant by NIN and type the claimant’s 11-digit NIN. The app looks on the phone first and then, if you are online, in the office’s list.
  2. If they are found, check the name and tap This is the claimant.
  3. If not, tap Register a new claimant. If the claimant has no NIN, tap Claimant has no NIN instead.
  4. Fill in the claimant form: full name, phone or NIN, and a photo of the claimant are needed. Bank, account name, account number and BVN are optional, but fill them in if you can. Tap Save claimant.

What is on the property

  1. Tap Add an item.
  2. From the list: search for the item (for example a mango tree, a zinc roof or maize), choose the exact kind, and enter the quantity.
  3. Custom: for anything not on the list, say what it is, add details (size, material), the unit and the quantity. Custom items are flagged for the office to review.

To correct an item, tap its pencil: change the quantity or the notes (and, for a custom item, its name, details and unit). The change goes to the office with your next sync. An item in a compensation case cannot change.

The app lists what is there, with no prices or values: the valuer values each item on the compensation case.

If there is nothing on the land — no trees, crops or structures — tick Nothing on this land to list. That counts as listing the items.

Photos

Completeness and saving

The Completeness panel at the top of the form updates as you work. It lists what is still missing, and marks what is needed to save.

RecordNeeded to save in the field
PropertyProperty type, at least one GPS point (or a boundary), at least one photo
ClaimantFull name, phone or NIN, photo

You can save an incomplete record and finish it later, or leave the rest to the office. Everything else on the checklist — boundary, LGA and ward, items, front view photo, NIN, bank details — counts towards 100%, and a compensation case can only open on complete records. The full list is in Data completeness.

Retake notices

After you sync, the server checks your photos. If one is blurred, too dark, a copy of another property’s photo, or (when the office uses AI) does not show the property, the property shows Retake: front view blurred (or similar) at the next sync. Take that photo again while you are still in the area, and sync.

Map view and offline maps

Draft properties from older map scans

Earlier versions could create draft properties from the buildings on the map; the scan no longer does. Any that remain show Draft — confirm on site. Visit each one: walk the real boundary, check the property type and location, find the claimant, list the items and take the photos, then save.

A property with an open case

Once a compensation case is open for a property, you can only add photos and notes to it.

In the office app

With the default Field Surveyor role you can also log in to the office app on a computer, with the same email and password. You see only your own work: the properties in the sub-boundaries assigned to you (and within 200 m of them), those you captured, and those with a survey assigned to you, with their claimants.

Assigned surveys

The Assigned surveys tab shows the properties the office has assigned to you. The number on the tab is how many are waiting.

Status on the listMeaning
AssignedWaiting for you to survey.
Returned for correctionThe office sent it back. Open it to read why.
Waiting to syncSaved on the phone; uploads when there is signal.
Upload problemThe office rejected the upload. Open it to see why, fix it, and save again.
SubmittedReceived by the office, waiting for review.
ApprovedAccepted by the office.

Survey a property

  1. Tap the property. Check the project, location, address and claimant at the top. Tap the claimant’s phone number to call them.
  2. Fill in the findings. Fields marked with an asterisk are required.
  3. Stand on the property and tap Capture GPS here. Wait for the position and accuracy (±metres). Capture again for a better fix if the accuracy is poor.
  4. Tap Take or add photo. Take at least one; front view and boundary beacons are the most useful. Choose what each photo shows.
  5. Tap Save & queue for upload.

The findings form

Saving without a photo is refused. Add at least one and save again.

Surveys returned for correction

  1. Open the property marked Returned for correction. The office’s note is at the top.
  2. Your earlier answers are filled in. Correct them and recapture GPS if asked. Add at least one photo again: photos you sent before stay with the office, so add only new or retaken ones.
  3. Save again. It is resubmitted on the next sync.

Working offline

You do not need signal to capture or survey. Saved work stays on the phone until it is sent.

Do not clear the browser’s data

Saved work lives in the browser’s storage on this phone. Clearing site data, “cleaning” apps, or uninstalling the browser before syncing deletes it. If you log out with work waiting, the app warns you; the work stays on the phone and uploads after you log in again.

Sharing a phone

Tips for good fieldwork

Something not working? See Troubleshooting › Field app.

Office staff trying the field app see this. Surveyors use only the field app; office staff use the main site.