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
- Accept your invitation: open the link from your administrator and choose a password. The screen then shows the field app’s address.
- Open that address in Chrome (Android) or Safari (iPhone).
- 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.
- Allow location and camera when the app asks the first time.
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:
| Tab | Use it to |
|---|---|
| Field capture | Capture 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 surveys | Survey properties the office has assigned to you, with the findings form. This works as before. See Assigned surveys. |
Field capture
Choose a project
- 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_projectssees every active project. Each download is recorded on the project. - Tap a project. The first time, the app downloads it to the phone, so you need signal. After that it opens offline.
- The project shows its properties. Search by reference number, address or claimant, or filter: All, Captured here, Incomplete, Not synced.
Your areas
- The phone downloads the properties in your areas and within 200 m of them (so a parcel on the edge is never missed), plus everything you captured yourself.
- When your position is outside your areas, a yellow note says so, with the nearest of your areas and how far it is. You can still capture there.
- Saving a new property outside your areas asks first: it names your nearest area and the distance. Save anyway keeps it; the office is told (a Captured outside the agent’s areas flag) and decides who looks after it.
- A property outside your areas that someone else registered cannot be changed from your phone (“outside your assigned areas — the office can change it”). Your own captures always stay editable.
- When the office gives you a new area, or ends one, the next sync brings the whole picture again. Records the office removed (for example a duplicate merged into another) leave the phone too; the sync message says how many. Work not sent yet is never removed.
Each property shows its % complete and, where something applies, a marker:
| Marker | Meaning |
|---|---|
| Not synced | Saved on the phone; not yet sent to the office. |
| Photos waiting | The record has been sent; some photos have not uploaded yet. |
| Sync problem | The office could not accept it. Open it to read why. |
| Changed in office | The office edited this property since your last sync. Your changes still go to the office, which decides which version to keep. |
| Claimant on hold | The office is deciding a conflict about who the claimant is. |
| Draft — confirm on site | Made from a map scan by an earlier version. Visit it, walk the boundary and check the details. |
Capture a new property
- In the project, tap New property.
- Choose the property type, then the LGA, ward and area, and type the address or a landmark.
- Walk the boundary.
- Find or register the claimant.
- List what is on the property.
- Take the photos.
- 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
- 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.
- Walk to the next corner, in order around the property, and tap Add corner here again. Repeat for every corner.
- Three corners or more make a boundary. The app shows its area and number of corners.
- Each corner shows its accuracy (±metres). A corner weaker than ±10 m is marked weak fix: stand in the open and add it again if you can.
- No GPS, or the corners come from a plan? Tap Type a corner, choose Latitude, longitude or UTM zone 32N (easting then northing), and type one corner per line.
- On the map you can drag a corner to move it, or add a corner between two others. In the list of corners you can move a corner up or remove it.
- The app warns you if the boundary is outside the project area (or partly outside), or if it overlaps another property. You can still save; the office checks it.
The claimant
- 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.
- If they are found, check the name and tap This is the claimant.
- If not, tap Register a new claimant. If the claimant has no NIN, tap Claimant has no NIN instead.
- 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.
- Offline, the app can only search the phone. The office will spot a duplicate later.
- On a claimant already on record, Edit claimant lets you fill in what is missing. A value different from the office record is sent to the office to confirm.
- Account numbers, BVNs and NINs on record are shown masked (
••••6789). Leave a box empty to keep the stored value.
What is on the property
- Tap Add an item.
- 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.
- 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
- Tap Take or add photo. Take at least one; the first is labelled Front view, which the checklist asks for.
- Choose what each photo shows (front view, side view, boundary / beacon and so on).
- Photos upload after their record has been sent. A photo the office cannot read is marked remove and retake: delete it and take it again.
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.
| Record | Needed to save in the field |
|---|---|
| Property | Property type, at least one GPS point (or a boundary), at least one photo |
| Claimant | Full 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
- In a project, switch from List to Map to see the project boundary and its properties, coloured by how complete they are. Tap a property to open it.
- Map areas you look at while online are kept on the phone, so they show offline too.
- Your areas are outlined; the rest of the project is greyed, and the map opens on your areas.
- If KADGIS runs its own map server, a Download the map for KCH-S01 button appears for each of your areas (a supervisor gets one for the whole project). Use it on Wi-Fi before going to site.
- If the map cannot load offline, you can still capture corners: they are listed below the map.
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.
- My tasks lists your areas, your surveys, what was returned to you and what you captured recently. Its badge in the menu counts what is waiting on you: surveys to do, returned surveys, change clashes and flags on your captures.
- If you lead an area, Field work shows the people of the areas you lead: what each one captured, their surveys and flags, and everything they did. You cannot assign or end areas there; the office does that.
- Properties › Register property adds a property in a project you work on. The system gives it its reference number.
- In a property's file you can edit its details, draw or type its outline, list its items, link or register its claimant and add photos and documents, as on the phone.
- A property placed outside your areas is still saved; the office is told, as from the phone.
- Properties elsewhere, compensation cases, money and the dictionary rates are not shown to you.
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.
- To survey — properties waiting for you, including any returned for correction.
- Submitted · last 30 days — work you have sent; it can no longer be edited.
- Search by reference number, address or claimant, or filter by ward.
| Status on the list | Meaning |
|---|---|
| Assigned | Waiting for you to survey. |
| Returned for correction | The office sent it back. Open it to read why. |
| Waiting to sync | Saved on the phone; uploads when there is signal. |
| Upload problem | The office rejected the upload. Open it to see why, fix it, and save again. |
| Submitted | Received by the office, waiting for review. |
| Approved | Accepted by the office. |
Survey a property
- Tap the property. Check the project, location, address and claimant at the top. Tap the claimant’s phone number to call them.
- Fill in the findings. Fields marked with an asterisk are required.
- 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.
- Tap Take or add photo. Take at least one; front view and boundary beacons are the most useful. Choose what each photo shows.
- Tap Save & queue for upload.
The findings form
Surveys returned for correction
- Open the property marked Returned for correction. The office’s note is at the top.
- 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.
- 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.
- The bar under the header shows Online or Offline, how much work is waiting, and when the app last synced.
- The app syncs automatically when signal returns, every minute while work is waiting, and whenever you open it. Tap Sync to try now.
- Sync sends records first and their photos after. It also downloads new assignments and the office’s changes to the projects on the phone. Sync at the start of the day while you have good signal.
- Until an assigned survey uploads, you can open it to change it (Update saved survey) or Discard saved survey (tap twice). A new property that has never been sent can be removed with Discard this property (tap twice).
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
- Before handing the phone to another surveyor, make sure the bar shows 0 waiting (sync first), then log out.
- If unsent work belongs to someone else, the app will not let a different surveyor log in until the first one logs in and syncs.
Tips for good fieldwork
- Capture GPS outside, away from tall buildings and trees; accuracy under 10 m is good.
- Walk the corners in order around the property, so the outline does not cross itself.
- Ask for the claimant’s NIN first: it is the surest way to avoid registering the same person twice.
- Photograph the front, each boundary beacon, and the claimant with the property if they agree.
- Use Notes or Remarks for anything the office should know: disputes over boundaries, absent claimant, crops being harvested.
- Keep the phone charged; GPS and the camera use a lot of battery.
Something not working? See Troubleshooting › Field app.