| Tile |
A single satellite imagery square (typically 256×256 px) at a specific zoom level and coordinate |
modules/services_tile_service.md |
| Region |
A square geographic area defined by center point and size in meters; the unit of work for batch tile downloads |
modules/services_region_service.md |
| Route |
An ordered sequence of geographic waypoints with interpolated intermediate points |
modules/services_route_service.md |
| Route Point |
A single lat/lon coordinate on a route; either "original" (user-provided waypoint) or "intermediate" (system-generated) |
modules/dataaccess_models.md |
| Geofence |
A rectangular geographic boundary (NW + SE corners) used to filter which route points receive map tile coverage |
components/05_route_management/description.md |
| Zoom Level |
Google Maps tile resolution level (1–20); higher = more detail, smaller ground coverage per tile |
modules/common_configs.md |
| Stitch |
Compositing multiple tiles into a single larger image with optional markers/borders |
modules/services_region_service.md |
| Layer 1 |
Historic name for satellite imagery from external providers (provider-agnostic; first implementation: Google Maps). Generalised in AZ-484 to one of N values of Tile Source; the term is retained for continuity with earlier docs and tickets. |
user clarification, AZ-484 |
| Layer 2 |
Historic name for UAV-captured nadir camera imagery (orthogonal tiles uploaded post-flight). Generalised in AZ-484 to the uav Tile Source value; the term is retained for continuity with earlier docs and tickets. |
user clarification, AZ-484 |
| Tile Source |
The producer of a tile row, persisted in tiles.source as a contract-defined string (google_maps, uav, …). Each cell may have at most one row per source; reads return the most-recent across sources. Adding a new source requires a new TileSource enum member and a tile-storage contract version bump. |
_docs/02_document/contracts/data-access/tile-storage.md (v1.0.0) |
| Captured At |
Producer-defined UTC timestamp ("the moment this tile imagery represents") persisted in tiles.captured_at. For Google Maps it is DateTime.UtcNow at download time (provider does not expose original imagery date); for UAV it is the capture timestamp supplied by the upload client. Drives the most-recent-across-sources read selection rule. |
_docs/02_document/contracts/data-access/tile-storage.md (v1.0.0) |
| UAV Tile Upload |
POST /api/satellite/upload batch endpoint (AZ-488) that ingests UAV-captured tiles. Multipart envelope with a JSON metadata field and an aligned files collection; per-item results returned in a single HTTP 200 response. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| Quality Gate |
The 5-rule validator (UavTileQualityGate) applied to every UAV tile before persistence: Format, Size band, Dimensions, Captured-at age, Blank/uniform. The first failing rule produces a reject reason from the closed UavTileRejectReasons enumeration. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| INVALID_FORMAT |
UAV reject reason — content-type is not image/jpeg OR the file's first three bytes are not the JPEG magic FF D8 FF OR the bytes fail to decode as JPEG. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| SIZE_OUT_OF_BAND |
UAV reject reason — image byte length outside [UavQualityConfig.MinBytes, MaxBytes] (defaults 5 KiB … 5 MiB). |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| WRONG_DIMENSIONS |
UAV reject reason — image width or height does not equal MapConfig.TileSizePixels. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| CAPTURED_AT_FUTURE |
UAV reject reason — capturedAt is more than CapturedAtFutureSkewSeconds ahead of the server clock. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| CAPTURED_AT_TOO_OLD |
UAV reject reason — capturedAt is older than UavQualityConfig.MaxAgeDays. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| IMAGE_TOO_UNIFORM |
UAV reject reason — pixel-luminance variance on the downsampled image is below MinLuminanceVariance. |
_docs/02_document/contracts/api/uav-tile-upload.md (v1.0.0) |
| Nadir Camera |
Downward-facing camera on a UAV capturing ground imagery during flight |
user clarification |
| GPS-Denied Service |
The consuming system: a UAV navigation service operating without GPS, using satellite/UAV imagery for positioning |
user clarification |
| Slippy Map Coordinates |
Tile X/Y indices in the Web Mercator projection grid (standard for web map tile servers) |
data_model.md |
| Version |
Integer year (e.g., 2025) used to invalidate tile cache when Google Maps imagery is updated |
data_model.md |
Oleksandr Bezdieniezhnykh
1802d32107