Image & Photo Capture
Field staff can capture and upload geo-tagged photos during their site visits. These photos serve as proof-of-visit and are linked to the GPS tracking record for manager review.
Image Upload Flow
Image Data Model
The SiteVisitGPSImagesAPIModel captures:
| Field | Type | Description |
|---|---|---|
| SiteVisitGPSImagesID | long | Auto-generated primary key |
| SiteVisitGPSID | long | Foreign key to parent GPS record |
| SiteVisitGPSDetailId | long | Links to specific GPS waypoint (optional) |
| ImagePath | string | Server-side stored file path |
| CreatedDateAndTime | DateTime | Timestamp of upload |
| ImgBase64String | string | Base64-encoded image data (upload only) |
Image-Location Linkage
Images can optionally be linked to specific GPS waypoints via SiteVisitGPSDetailId. This creates a relationship chain:
The GetSitevisitGPSImageLocationDetail query joins images with their associated GPS detail records, returning only entries where both latitude and longitude are non-zero.
Retrieval Endpoints
| Query | Method | Returns |
|---|---|---|
GetSitevisitGPSImages(id) | SitevisitGPSBO | All images for a GPS record with serial numbers |
GetImageFilePath(imageId) | SitevisitGPSBO | Server file path for a specific image |
GetSitevisitGPSImageLocationDetail(id) | SitevisitGPSBO | Images with linked lat/long coordinates |
API Endpoint
POST /webapi/SiteVisitGPS/SaveReportOnDutyImageRequest Body:
{
"SiteVisitGPSID": 8901,
"SiteVisitGPSDetailId": 0,
"ImgBase64String": "/9j/4AAQSkZJRgABAQ..."
}Response:
{
"Id": 456,
"result": true,
"message": "Successfully Updated"
}