Function createGeoParquetNativeGeometryBatch

  • Experimental

    Encode one GeoParquet 1.1 native geometry column into a ColumnarBatchV1 and hand the batch back.

    This is the inverse of decodeGeoParquetNativeGeometryColumn: the same reviewed src/columnar/geoarrow.ts validation runs (every position, vertex, ring, closure, finiteness, and dimension rule), but no row object is materialized on the way out — the result is packed typed arrays the caller can transfer, cache, or render directly.

    Only the encodings with a 1:1 GeoArrow kind are accepted. multipoint, multilinestring, and multipolygon are refused with GEOPARQUET_COLUMNAR_UNSUPPORTED_ENCODING rather than being re-labelled as a single-part column, which would misreport the geometry type; the object decoder still serves them by flattening and regrouping.

    The identity is supplied by the caller and is expected to come from columnarBatchIdentityFromPlan in @honua/sdk-js/query-planner. There is no placeholder identity on this path.

    Returns CreatedGeoArrowBatch