Interface SourceProfileGeometryExperimental

interface SourceProfileGeometry {
    bboxColumn?: string;
    column: string;
    coordinateEpoch?: number;
    crsState?:
        | "value"
        | "null"
        | "absent"
        | "missing-metadata"
        | "invalid-metadata";
    crsValue?: unknown;
    encoding: GeometryEncoding;
    epochState?: "valid" | "invalid" | "absent";
    epochValue?: unknown;
    geometryTypes?: readonly string[];
    geometryTypesState?:
        | "valid"
        | "invalid"
        | "missing"
        | "conflicting";
    metadataState?: "valid" | "invalid" | "missing";
    runtimeSupported?: boolean;
}

Hierarchy (view full)

Properties

bboxColumn?: string

Optional GeoParquet 1.1 "bbox covering" struct column (typically bbox with xmin/ymin/xmax/ymax fields). When present, an envelope filter can prune row groups without decoding any geometry.

column: string

Geometry column name in the parquet file.

coordinateEpoch?: number

Valid coordinate epoch from the column metadata.

crsState?:
    | "value"
    | "null"
    | "absent"
    | "missing-metadata"
    | "invalid-metadata"

Distinguishes a valid GeoParquet CRS84 default from absent/invalid geo metadata.

crsValue?: unknown

Raw parsed PROJJSON/string value, retained only for v2 normalization.

Physical encoding of that column.

epochState?: "valid" | "invalid" | "absent"
epochValue?: unknown

Invalid raw epoch retained as bounded native evidence by schema v2.

geometryTypes?: readonly string[]

GeoParquet geometry_types; an empty array explicitly means unknown.

geometryTypesState?:
    | "valid"
    | "invalid"
    | "missing"
    | "conflicting"
metadataState?: "valid" | "invalid" | "missing"

Whether the containing GeoParquet document passed the bounded 1.0/1.1 projection checks required by this normalizer. This is deliberately not a GeoParquet conformance result: in particular, the focused source-schema runtime validates PROJJSON separately before exposing a portable CRS. valid only means it is safe to apply the metadata semantics projected by this module (including the absent-CRS default).

runtimeSupported?: boolean

False when DuckDB exposed a raw GeoArrow nested value that this SQL compiler cannot execute safely.