# Vector Document

## Purpose
Geometric features with attributes to be displayed as overlays (roads, AOIs, polygons of analysis results).

## GeoJSON (DB metadata)
```json
{
  "type": "Feature",
  "geometry": {"type": "MultiPolygon", "coordinates": [[[[30.10, 59.90], [30.20, 59.90], [30.20, 60.00], [30.10, 60.00], [30.10, 59.90]]]]},
  "properties": {
    "type": "Vector",
    "title": "AOI Boundaries",
    "created_at": "2025-08-01T10:00:00Z",
    "updated_at": "2025-08-01T10:00:00Z",
    "source": {
      "url": "/s3/<bucket>/<ResultKey>/<filename>",
      "type": "GeoJSON"
    },
    "style": {"stroke": "#ff6600", "fill": "#ff660055", "stroke_width": 2},
    "legend": {"title": "AOI"}
  }
}
```

## Required properties
- `properties.type` = `Vector`
- Vector geometry footprint or representative geometry
- If the vector dataset is external, link via `properties.source.url`; otherwise inline features can be embedded in an external GeoJSON that `properties.source.url` points to.

## Publishing workflow
1. Export vector dataset as GeoJSON or FlatGeobuf.
2. Upload payload and record the URL.
3. Publish Feature with type `Vector` referencing dataset.

## Validation checklist
- CRS is WGS84 or convertible by the UI service.
- Attributes align with styling rules if any.

See [Common properties](../common.md) for shared fields like legend, metadata, and classification.
See also: [GeoJSON Strategy](../../Geojson_strategy.md) and [Upload Strategy](../../Upload_strategy.md).