Enum Geometry 

#[non_exhaustive]
pub enum Geometry {
    Point(Coord),
    LineString(LineString),
    Polygon(Polygon),
    MultiPoint(Vec<Coord>),
    MultiLineString(Vec<LineString>),
    MultiPolygon(Vec<Polygon>),
    GeometryCollection(Vec<Geometry>),
    Empty(GeometryType),
}

The geometry tree. Marked #[non_exhaustive] so future SemVer-minor releases can add variants (curves, surfaces, Z/M-bearing variants once the IR grows past 2D).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Point(Coord)

LineString(LineString)

Polygon(Polygon)

MultiPoint(Vec<Coord>)

MultiLineString(Vec<LineString>)

MultiPolygon(Vec<Polygon>)

GeometryCollection(Vec<Geometry>)

Empty(GeometryType)

A typed-empty geometry (e.g. POINT EMPTY, POLYGON EMPTY). The tag is preserved so WKB serialization round-trips correctly.

Implementations

impl Geometry

pub fn type_of(&self) -> GeometryType

pub fn is_empty(&self) -> bool

pub fn coord_count(&self) -> usize

Total coordinate count across the geometry tree. O(N) walk.

This is the right number to use when budgeting memory for an operation that scales with vertex density (Hilbert sort, geometry simplification, WKB encode). A single polygon with 100 000 vertices charges 100 000; a MultiPolygon of 50 such parts charges 5 000 000 — feature count alone hides this asymmetry.

pub fn has_z(&self) -> bool

True if any coordinate in the tree carries a Z ordinate.

pub fn bbox(&self) -> Option<[f64; 4]>

Compute the 2D bounding box [xmin, ymin, xmax, ymax].

Returns None for empty geometries (no coordinates to bound). NaN coordinates are skipped, so POINT EMPTY (stored as NaN/NaN) also yields None.

pub fn has_m(&self) -> bool

True if any coordinate in the tree carries an M ordinate.

impl Geometry

pub fn to_wkb(&self) -> Vec<u8>

Encode as OGC Simple Features Well-Known Binary (little-endian, 2D).

pub fn write_wkb_into(&self, buf: &mut Vec<u8>)

Encode WKB into a caller-provided buffer (clears it first). Useful for row-by-row writers that want to reuse a scratch buffer.

impl Geometry

pub fn from_wkb(bytes: &[u8]) -> Result<Self>

Decode OGC Simple Features WKB bytes into a Geometry.

Accepts both little-endian and big-endian, and respects per-nested byte-order bytes inside collections (the ISO WKB rule).

v0.1 returns Error::Unsupported for Z/M variants — the type code is recognized but ordinates beyond X/Y are not decoded.

Trait Implementations

impl Clone for Geometry

fn clone(&self) -> Geometry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Geometry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Geometry

fn eq(&self, other: &Geometry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Geometry