) : null}
- {!mapFeatureCollection ? (
+ {!mapFeatureCollection && !viewportVectorEnabled ? (
No active vector or result layer
Open a dataset, detection run, segmentation run or change result to draw it here.
diff --git a/frontend/src/config/vectorDelivery.ts b/frontend/src/config/vectorDelivery.ts
new file mode 100644
index 00000000..6effa90a
--- /dev/null
+++ b/frontend/src/config/vectorDelivery.ts
@@ -0,0 +1,4 @@
+export const VECTOR_VIEWPORT_FEATURE_THRESHOLD = 5_000
+export const VECTOR_VIEWPORT_MIN_ZOOM = 14
+export const VECTOR_VIEWPORT_FEATURE_LIMIT = 1_000
+export const VECTOR_VIEWPORT_DEBOUNCE_MS = 250
diff --git a/frontend/src/hooks/useDatasetWorkflow.ts b/frontend/src/hooks/useDatasetWorkflow.ts
index ff408606..b39adea8 100644
--- a/frontend/src/hooks/useDatasetWorkflow.ts
+++ b/frontend/src/hooks/useDatasetWorkflow.ts
@@ -12,6 +12,7 @@ import type {
} from '../types'
import { formatError } from '../lib/formatError'
import { isPrimaryFocusMunicipalityBoundaryDataset } from '../config/primaryFocus'
+import { VECTOR_VIEWPORT_FEATURE_THRESHOLD } from '../config/vectorDelivery'
interface DatasetWorkflowOptions {
selectedProjectId: string | null
@@ -165,12 +166,13 @@ export function useDatasetWorkflow({
setJobs([])
try {
if (isVectorDatasetType(dataset.dataset_type)) {
- const [content, summary] = await Promise.all([
- datasetsApi.getContent(projectId, dataset.id),
- datasetsApi.vectorSummary(projectId, dataset.id),
- ])
- setDatasetContent(content)
+ const summary = await datasetsApi.vectorSummary(projectId, dataset.id)
setSelectedDatasetSummary(summary)
+ const featureCount = summary.feature_count ?? dataset.feature_count
+ if (featureCount == null || featureCount <= VECTOR_VIEWPORT_FEATURE_THRESHOLD) {
+ const content = await datasetsApi.getContent(projectId, dataset.id)
+ setDatasetContent(content)
+ }
} else if (dataset.dataset_type === 'raster') {
try {
const rasterInspection = await datasetsApi.rasterInspect(projectId, dataset.id)
diff --git a/frontend/src/hooks/useMapWorkspaceState.ts b/frontend/src/hooks/useMapWorkspaceState.ts
index e90283dd..ac914503 100644
--- a/frontend/src/hooks/useMapWorkspaceState.ts
+++ b/frontend/src/hooks/useMapWorkspaceState.ts
@@ -8,6 +8,7 @@ interface MapWorkspaceStateOptions {
detectionGeoJson: GeoJSON.FeatureCollection | null
datasetContent: GeoJSON.FeatureCollection | null
selectedDataset: DatasetCreateResponse | null
+ datasetLayerActive?: boolean
}
export function useMapWorkspaceState({
@@ -17,6 +18,7 @@ export function useMapWorkspaceState({
detectionGeoJson,
datasetContent,
selectedDataset,
+ datasetLayerActive = Boolean(datasetContent),
}: MapWorkspaceStateOptions) {
const [mapLayerVisible, setMapLayerVisible] = useState(true)
const [mapLayerOpacity, setMapLayerOpacity] = useState(0.4)
@@ -72,11 +74,11 @@ export function useMapWorkspaceState({
if (detectionGeoJson) {
return 'Detection result'
}
- if (datasetContent && selectedDataset) {
+ if (datasetLayerActive && selectedDataset) {
return selectedDataset.name
}
return 'No active vector layer'
- }, [changeDetectionGeoJson, datasetContent, detectionGeoJson, segmentationGeoJson, selectedDataset])
+ }, [changeDetectionGeoJson, datasetLayerActive, detectionGeoJson, segmentationGeoJson, selectedDataset])
const mapFeatureCount = mapFeatureCollection?.features.length ?? 0
const areaFeatureCount = areaFeatureCollection?.features.length ?? 0
diff --git a/frontend/src/hooks/useViewportVectorLayer.ts b/frontend/src/hooks/useViewportVectorLayer.ts
new file mode 100644
index 00000000..5bf754c2
--- /dev/null
+++ b/frontend/src/hooks/useViewportVectorLayer.ts
@@ -0,0 +1,134 @@
+import { useEffect, useMemo, useRef, useState } from 'react'
+import {
+ VECTOR_VIEWPORT_DEBOUNCE_MS,
+ VECTOR_VIEWPORT_FEATURE_LIMIT,
+ VECTOR_VIEWPORT_FEATURE_THRESHOLD,
+ VECTOR_VIEWPORT_MIN_ZOOM,
+} from '../config/vectorDelivery'
+import { formatError } from '../lib/formatError'
+import { datasetsApi } from '../services/api/datasets'
+import type { DatasetCreateResponse, MapViewportState } from '../types'
+
+interface ViewportVectorLayerOptions {
+ selectedProjectId: string | null
+ selectedDataset: DatasetCreateResponse | null
+ featureCount: number | null
+ isVectorDatasetType: (datasetType: string) => boolean
+}
+
+export function useViewportVectorLayer({
+ selectedProjectId,
+ selectedDataset,
+ featureCount,
+ isVectorDatasetType,
+}: ViewportVectorLayerOptions) {
+ const [viewport, setViewport] = useState
(null)
+ const [data, setData] = useState(null)
+ const [loading, setLoading] = useState(false)
+ const [error, setError] = useState(null)
+ const [truncated, setTruncated] = useState(false)
+ const [loadedFeatureCount, setLoadedFeatureCount] = useState(0)
+ const requestSequence = useRef(0)
+
+ const enabled = Boolean(
+ selectedProjectId &&
+ selectedDataset &&
+ isVectorDatasetType(selectedDataset.dataset_type) &&
+ (featureCount ?? 0) > VECTOR_VIEWPORT_FEATURE_THRESHOLD,
+ )
+ const zoom = viewport?.zoom ?? null
+ const zoomRequired = enabled && (zoom === null || zoom < VECTOR_VIEWPORT_MIN_ZOOM)
+
+ useEffect(() => {
+ requestSequence.current += 1
+ setData(null)
+ setLoading(false)
+ setError(null)
+ setTruncated(false)
+ setLoadedFeatureCount(0)
+ }, [enabled, selectedDataset?.id, selectedProjectId])
+
+ useEffect(() => {
+ if (!enabled || !selectedProjectId || !selectedDataset || !viewport) {
+ return
+ }
+ if (viewport.zoom < VECTOR_VIEWPORT_MIN_ZOOM) {
+ requestSequence.current += 1
+ setData(null)
+ setLoading(false)
+ setError(null)
+ setTruncated(false)
+ setLoadedFeatureCount(0)
+ return
+ }
+
+ const sequence = requestSequence.current + 1
+ requestSequence.current = sequence
+ const timer = window.setTimeout(async () => {
+ setLoading(true)
+ setError(null)
+ try {
+ const response = await datasetsApi.selectVectorFeatures(selectedProjectId, selectedDataset.id, {
+ bbox: viewport.bbox,
+ limit: VECTOR_VIEWPORT_FEATURE_LIMIT,
+ })
+ if (requestSequence.current !== sequence) {
+ return
+ }
+ setData(response.geojson)
+ setLoadedFeatureCount(response.feature_count)
+ setTruncated(response.truncated)
+ } catch (requestError) {
+ if (requestSequence.current !== sequence) {
+ return
+ }
+ setData(null)
+ setLoadedFeatureCount(0)
+ setTruncated(false)
+ setError(formatError(requestError, 'Unable to load visible vector features'))
+ } finally {
+ if (requestSequence.current === sequence) {
+ setLoading(false)
+ }
+ }
+ }, VECTOR_VIEWPORT_DEBOUNCE_MS)
+
+ return () => {
+ window.clearTimeout(timer)
+ }
+ }, [enabled, selectedDataset, selectedProjectId, viewport])
+
+ const statusMessage = useMemo(() => {
+ if (!enabled) {
+ return null
+ }
+ if (zoomRequired) {
+ return `Zoom in to level ${VECTOR_VIEWPORT_MIN_ZOOM} to load buildings from PostGIS.`
+ }
+ if (loading) {
+ return 'Loading visible features from PostGIS...'
+ }
+ if (error) {
+ return error
+ }
+ if (truncated) {
+ return `${loadedFeatureCount.toLocaleString()} visible features loaded; zoom in further because this view exceeds the ${VECTOR_VIEWPORT_FEATURE_LIMIT.toLocaleString()} feature limit.`
+ }
+ return `${loadedFeatureCount.toLocaleString()} visible of ${(featureCount ?? 0).toLocaleString()} total features loaded from PostGIS.`
+ }, [enabled, error, featureCount, loadedFeatureCount, loading, truncated, zoomRequired])
+
+ return {
+ enabled,
+ data,
+ loading,
+ error,
+ truncated,
+ loadedFeatureCount,
+ featureLimit: VECTOR_VIEWPORT_FEATURE_LIMIT,
+ minZoom: VECTOR_VIEWPORT_MIN_ZOOM,
+ zoom,
+ zoomRequired,
+ statusMessage,
+ setViewport,
+ }
+}
diff --git a/frontend/src/styles/app.css b/frontend/src/styles/app.css
index 681f277b..34cbe2c2 100644
--- a/frontend/src/styles/app.css
+++ b/frontend/src/styles/app.css
@@ -2611,6 +2611,33 @@ button.entity-card {
font-size: 0.84rem;
}
+.map-status .viewport-vector-status {
+ grid-column: 1 / -1;
+ padding: 0.5rem 0.65rem;
+ border: 1px solid #bae6fd;
+ background: #f0f9ff;
+ color: #075985;
+ font-weight: 700;
+}
+
+.map-status .viewport-vector-status-ready {
+ border-color: #bbf7d0;
+ background: #f0fdf4;
+ color: #166534;
+}
+
+.map-status .viewport-vector-status-warning {
+ border-color: #fde68a;
+ background: #fffbeb;
+ color: #92400e;
+}
+
+.map-status .viewport-vector-status-error {
+ border-color: #fecaca;
+ background: #fef2f2;
+ color: #991b1b;
+}
+
.layer-provenance-rail {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(10rem, 1fr));
diff --git a/frontend/src/types.ts b/frontend/src/types.ts
index 5f67f326..0f1f512f 100644
--- a/frontend/src/types.ts
+++ b/frontend/src/types.ts
@@ -292,6 +292,11 @@ export interface VectorSelectionBBox {
crs?: 'EPSG:4326'
}
+export interface MapViewportState {
+ bbox: VectorSelectionBBox
+ zoom: number
+}
+
export interface VectorSelectionRequest {
bbox: VectorSelectionBBox
limit?: number
diff --git a/scripts/README.md b/scripts/README.md
index 908e8e6f..8b6196ee 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -167,6 +167,28 @@ REAL_REFERENCE_VECTOR_PATH=/mnt/user/appdata/geointel/storage/operator-data/geel
bash scripts/verify_real_data_detection_qa_workflow.sh http://192.168.10.150:1202
```
+Reuse the definitive Mol municipality project for a bounded Mol-Centrum
+analysis zone while keeping the municipality-wide reference layer distinct:
+
+```bash
+REAL_PROJECT_ID=d74c1f87-29c0-4c67-adfc-560764f2b80e \
+REAL_PROJECT_NAME='Mol Municipality Workbench' \
+REAL_PROJECT_REGION='Mol, Kempen' \
+REAL_AREA_NAME='Mol Centrum - AI analysezone 500m' \
+REAL_AREA_BBOX='5.113116,51.189653,5.120284,51.194147' \
+REAL_DATASET_NAME_PREFIX='mol_center_ai_500m' \
+REAL_RASTER_PATH=/mnt/user/appdata/geointel/storage/operator-data/mol_orthophoto_wms_512.tif \
+REAL_REFERENCE_VECTOR_PATH=/mnt/user/appdata/geointel/storage/operator-data/mol_grb_gbg_buildings.geojson \
+bash scripts/verify_real_data_detection_qa_workflow.sh http://192.168.10.150:1202
+```
+
+`REAL_PROJECT_ID` is validated through the canonical project endpoint; it does
+not create a shadow validation project. When `REAL_AREA_BBOX` is present, both
+the raster and matching reference upload persist that new Area id. The optional
+safe filename prefix prevents the bounded sample from sharing a display name
+with the complete Mol GRB dataset. The workflow still performs no data fetch or
+model download: the files and configured local model asset must already exist.
+
Those files are runtime artifacts generated from Digitaal Vlaanderen's
OMWRGBMRVL WMS `Ortho` layer and GRB OGC API Features `GBG` building collection
for a small Geel AOI. They are intentionally not repository fixtures.
diff --git a/scripts/verify_real_data_detection_qa_workflow.sh b/scripts/verify_real_data_detection_qa_workflow.sh
index 8f7d1abd..2e86af25 100644
--- a/scripts/verify_real_data_detection_qa_workflow.sh
+++ b/scripts/verify_real_data_detection_qa_workflow.sh
@@ -18,8 +18,10 @@ Required inputs:
Optional environment:
REAL_PROJECT_NAME Project name for the validation run.
REAL_PROJECT_REGION Persisted project region, default: Kempen.
+ REAL_PROJECT_ID Existing project id to reuse instead of creating a validation project.
REAL_AREA_NAME Persisted AOI name when REAL_AREA_BBOX is set.
REAL_AREA_BBOX Optional EPSG:4326 minx,miny,maxx,maxy AOI bounds.
+ REAL_DATASET_NAME_PREFIX Safe filename prefix for raster/reference uploads in a reused project.
REAL_MODEL_ASSET_ID Specific /api/v1/detection/model-assets id to use.
REAL_TILE_SIZE Raster tile size, default 640.
REAL_TILE_OVERLAP Raster tile overlap, default 64.
@@ -33,8 +35,10 @@ REAL_RASTER_PATH="${2:-${REAL_RASTER_PATH:-}}"
REAL_REFERENCE_VECTOR_PATH="${3:-${REAL_REFERENCE_VECTOR_PATH:-}}"
REAL_PROJECT_NAME="${REAL_PROJECT_NAME:-GeoIntel Real Data Validation}"
REAL_PROJECT_REGION="${REAL_PROJECT_REGION:-Kempen}"
+REAL_PROJECT_ID="${REAL_PROJECT_ID:-}"
REAL_AREA_NAME="${REAL_AREA_NAME:-${REAL_PROJECT_NAME} AOI}"
REAL_AREA_BBOX="${REAL_AREA_BBOX:-}"
+REAL_DATASET_NAME_PREFIX="${REAL_DATASET_NAME_PREFIX:-}"
REAL_TILE_SIZE="${REAL_TILE_SIZE:-640}"
REAL_TILE_OVERLAP="${REAL_TILE_OVERLAP:-64}"
REAL_CONFIDENCE_THRESHOLD="${REAL_CONFIDENCE_THRESHOLD:-0.5}"
@@ -62,6 +66,13 @@ if [ ! -f "${REAL_REFERENCE_VECTOR_PATH}" ]; then
exit 2
fi
+case "${REAL_DATASET_NAME_PREFIX}" in
+ *[!a-zA-Z0-9._-]*)
+ echo "REAL_DATASET_NAME_PREFIX may contain letters, numbers, dot, underscore and dash only" >&2
+ exit 2
+ ;;
+esac
+
case "${REAL_RASTER_PATH,,}" in
*.tif|*.tiff|*.geotiff) ;;
*)
@@ -136,7 +147,16 @@ echo "Base URL: ${BASE_URL}"
echo "Raster: ${REAL_RASTER_PATH}"
echo "Reference vector: ${REAL_REFERENCE_VECTOR_PATH}"
-"${PYTHON_BIN}" - "${TMP_DIR}/project_request.json" "${REAL_PROJECT_NAME}" "${REAL_PROJECT_REGION}" <<'PY'
+if [ -n "${REAL_PROJECT_ID}" ]; then
+ curl -fsS "${BASE_URL%/}/api/v1/projects/${REAL_PROJECT_ID}" > "${TMP_DIR}/project.json"
+ require_json_data "${TMP_DIR}/project.json"
+ project_id="$(json_field "${TMP_DIR}/project.json" "data.id")"
+ if [ "${project_id}" != "${REAL_PROJECT_ID}" ]; then
+ echo "Existing project lookup returned the wrong project id" >&2
+ exit 1
+ fi
+else
+ "${PYTHON_BIN}" - "${TMP_DIR}/project_request.json" "${REAL_PROJECT_NAME}" "${REAL_PROJECT_REGION}" <<'PY'
import json
import sys
from datetime import datetime, timezone
@@ -152,14 +172,15 @@ with open(path, "w", encoding="utf-8") as handle:
json.dump(payload, handle)
PY
-curl -fsS -X POST "${BASE_URL%/}/api/v1/projects" \
- -H "Content-Type: application/json" \
- --data-binary "@${TMP_DIR}/project_request.json" > "${TMP_DIR}/project.json"
-require_json_data "${TMP_DIR}/project.json"
-project_id="$(json_field "${TMP_DIR}/project.json" "data.id")"
-if [ -z "${project_id}" ] || [ "${project_id}" = "None" ] || [ "${project_id}" = "null" ]; then
- echo "Project creation did not return a project id" >&2
- exit 1
+ curl -fsS -X POST "${BASE_URL%/}/api/v1/projects" \
+ -H "Content-Type: application/json" \
+ --data-binary "@${TMP_DIR}/project_request.json" > "${TMP_DIR}/project.json"
+ require_json_data "${TMP_DIR}/project.json"
+ project_id="$(json_field "${TMP_DIR}/project.json" "data.id")"
+ if [ -z "${project_id}" ] || [ "${project_id}" = "None" ] || [ "${project_id}" = "null" ]; then
+ echo "Project creation did not return a project id" >&2
+ exit 1
+ fi
fi
area_id=""
@@ -197,14 +218,29 @@ PY
fi
fi
+area_upload_args=()
+if [ -n "${area_id}" ]; then
+ area_upload_args=(-F "area_id=${area_id}")
+fi
+
+raster_form_file="file=@${REAL_RASTER_PATH}"
+reference_form_file="file=@${REAL_REFERENCE_VECTOR_PATH}"
+if [ -n "${REAL_DATASET_NAME_PREFIX}" ]; then
+ raster_extension="${REAL_RASTER_PATH##*.}"
+ reference_extension="${REAL_REFERENCE_VECTOR_PATH##*.}"
+ raster_form_file="${raster_form_file};filename=${REAL_DATASET_NAME_PREFIX}_orthophoto.${raster_extension}"
+ reference_form_file="${reference_form_file};filename=${REAL_DATASET_NAME_PREFIX}_grb_buildings.${reference_extension}"
+fi
+
curl -fsS -X POST "${BASE_URL%/}/api/v1/projects/${project_id}/datasets/upload" \
- -F "file=@${REAL_RASTER_PATH}" \
+ -F "${raster_form_file}" \
-F "dataset_type=raster" \
-F "source=user_upload" \
-F "dataset_role=source" \
-F "source_name=manual" \
-F 'source_metadata_json={"validation_workflow":"real_data_detection_qa","input_kind":"orthophoto"}' \
-F 'provenance_metadata_json={"operator_supplied":true,"no_external_fetch":true}' \
+ "${area_upload_args[@]}" \
> "${TMP_DIR}/raster_upload.json"
require_json_data "${TMP_DIR}/raster_upload.json"
raster_dataset_id="$(json_field "${TMP_DIR}/raster_upload.json" "data.id")"
@@ -226,7 +262,7 @@ if not data.get("bounds_json"):
PY
curl -fsS -X POST "${BASE_URL%/}/api/v1/projects/${project_id}/datasets/upload" \
- -F "file=@${REAL_REFERENCE_VECTOR_PATH}" \
+ -F "${reference_form_file}" \
-F "dataset_type=vector" \
-F "source=user_upload" \
-F "dataset_role=reference" \
@@ -234,6 +270,7 @@ curl -fsS -X POST "${BASE_URL%/}/api/v1/projects/${project_id}/datasets/upload"
-F "reference_layer_name=buildings" \
-F 'source_metadata_json={"validation_workflow":"real_data_detection_qa","input_kind":"reference_buildings"}' \
-F 'provenance_metadata_json={"operator_supplied":true,"no_external_fetch":true}' \
+ "${area_upload_args[@]}" \
> "${TMP_DIR}/reference_upload.json"
require_json_data "${TMP_DIR}/reference_upload.json"
reference_dataset_id="$(json_field "${TMP_DIR}/reference_upload.json" "data.id")"