Capture & tag site photos
Site photos are the most-used artefact on construction projects. This tutorial covers the three ways to capture them in Planscape, how to attach them to the right thing, and how the auto-geotag / auto-thumbnail / auto-compress pipeline works behind the scenes.
Three capture flows
Flow 1 — Standalone site photo
For documenting progress without tying to a specific issue or element.
- Bottom tab bar → Photos.
- Tap the floating camera button (bottom right).
- Take the photo. The viewfinder shows your current GPS coordinates at the top so you can confirm.
- Tap the checkmark to use it.
- Add an optional caption ("Pour 4 of Level 2 slab, southeast corner").
- Tap Save.
The photo lands in the project's photo stream, geotagged, timestamped, and visible to all project members.
Flow 2 — Attached to an issue
For evidence supporting a defect, RFI, or NCR. See Raise an issue from your phone for the full flow — the photo capture step is the same as above but the photo gets attached to the issue you're creating.
Flow 3 — Attached to a specific element
For commissioning records, asset photos, before/after pairs on a specific piece of equipment.
- Bottom tab bar → Map (or open an element via QR scan).
- Tap the element in the 2D view, or scan its QR tag.
- Element detail panel opens. Scroll to "Photos" section.
- Tap + Add photo.
- Camera opens with the element name pre-filled in the caption prompt.
- Take, confirm, save.
The photo is now part of that element's permanent record. Anyone viewing that element later sees the photo.
Picking from your gallery
Every photo flow has a "From gallery" option alongside "Take photo". Useful for:
- Photos you took with the phone's stock camera before opening Planscape.
- Photos from a DSLR you've airdropped to your phone.
- Screenshots, diagrams, sketches.
Gallery photos still get geotagged if the original photo had GPS metadata. If they don't, the location is recorded as "Unknown".
What happens to each photo
When you tap Save, Planscape does this in roughly 1 second on a typical photo:
- Saves the original (usually 4 MB JPEG, 12 MP) to local storage.
- Generates a 400px-wide thumbnail for fast list-view loading.
- Stamps the file with GPS coordinates, capture time, and your user ID.
- If online: uploads original + thumbnail to the server in the background. You see "Synced" on the photo card within ~10 seconds.
- If offline: queues for upload. You see "Queued (N)" in the status indicator.
Configuring quality / size
Profile → Settings → Photos:
- Quality: High (default, 12 MP, ~4 MB)
- Quality: Standard (1080p, ~1 MB) — recommended on slow networks or limited data plans
- Quality: Low (720p, ~400 KB) — fine for snag-list photos where size matters more than detail
The thumbnail is always 400px regardless of quality setting — affects only the original.
Viewing photos
The Photos tab lists every project photo in reverse chronological order. Each card shows:
- Thumbnail
- Caption (first 2 lines)
- Capture time + author
- Linked entity (issue / element / standalone)
- Sync status chip if not yet uploaded
Tap a thumbnail to open the full-screen viewer with pinch-zoom, swipe-between-photos, share, and "Show on map" actions.
The map view of photos
Map → Layers → enable Photo locations. Every photo appears as a small camera icon at the GPS coordinates of capture. Tap an icon to preview, tap again to open full screen.
Useful for spatial debugging: "where was that crack we photographed last week?" — open the map, find the camera icon, tap to confirm.
Captions worth writing
A caption you'll thank yourself for in three months:
- What's in the frame ("Pour 4, southeast corner of Level 2 slab")
- Which way the camera is pointing if not obvious ("looking south")
- Reference dimension or measurement if relevant ("strip width 60 mm")
- Crew or witness name for sign-off photos ("witnessed by J. Otieno")
Voice-to-text is faster than typing on site — tap the microphone icon in the caption field.
Privacy & storage
Photos taken in the app are NOT saved to your phone's camera roll by default. This avoids leaking client work into your personal photo backup.
To save a copy to your camera roll: open the photo in the full-screen viewer → share → "Save to camera roll". You can also enable auto-save under Profile → Settings → Photos → "Save copies to camera roll: On".
Storage usage on your phone: Profile → Settings → Storage. Tap "Free up space" to delete locally-cached originals (thumbnails stay). The originals are safe on the server and re-download on demand.
Common mistakes
- Blurry photos. The viewfinder shows a green outline when focus is locked. Wait for it before tapping shutter.
- No caption. "Photo 4719" tells you nothing in 6 months. Write a sentence.
- Forgetting to attach. Standalone photos are fine for progress monitoring but for defects/elements, always use the right capture flow so the photo joins the right record.
- High-quality on slow network. Drop to Standard quality before a site visit if your data plan is limited.
What's next
- Raise an issue from your phone
- QR-scan an asset on site
- Photo capture guide for deeper detail