Struct BoundingBox 

pub struct BoundingBox {
    pub min_lat: f64,
    pub max_lat: f64,
    pub min_lon: f64,
    pub max_lon: f64,
}

An axis-aligned geographic bounding box defined by min/max lat and lon.

Coordinates are in degrees (latitude: [-90, 90], longitude: [-180, 180]). This struct does not handle anti-meridian crossing (bounding boxes that wrap around longitude ±180°). For those use cases, split into two boxes.

Examples

use scirs2_spatial::geo::BoundingBox;

let bbox = BoundingBox::new(48.0, 52.0, -1.0, 3.0).unwrap();
assert!(bbox.contains(50.0, 1.0));
assert!(!bbox.contains(53.0, 1.0));

Fields

min_lat: f64

Minimum latitude in degrees

max_lat: f64

Maximum latitude in degrees

min_lon: f64

Minimum longitude in degrees

max_lon: f64

Maximum longitude in degrees

Implementations

impl BoundingBox

pub fn new( min_lat: f64, max_lat: f64, min_lon: f64, max_lon: f64, ) -> SpatialResult<Self>

Create a new BoundingBox.

Arguments

• min_lat - Minimum latitude in degrees
• max_lat - Maximum latitude in degrees
• min_lon - Minimum longitude in degrees
• max_lon - Maximum longitude in degrees

Errors

Returns SpatialError::ValueError if:

• min_lat > max_lat
• min_lon > max_lon
• Any value is out of range (lat ∉ [-90, 90], lon ∉ [-180, 180])

pub fn from_points(points: &[(f64, f64)]) -> SpatialResult<Self>

Create a BoundingBox from a set of geographic points.

Arguments

• points - Slice of (lat, lon) pairs in degrees

Errors

Returns SpatialError::ValueError if the slice is empty.

pub fn contains(&self, lat: f64, lon: f64) -> bool

Test whether a geographic point is inside (or on the boundary of) this box.

Arguments

• lat - Latitude in degrees
• lon - Longitude in degrees

pub fn intersects(&self, other: &BoundingBox) -> bool

Test whether two bounding boxes overlap (share any area or boundary point).

pub fn expand(&self, margin_deg: f64) -> SpatialResult<BoundingBox>

Return a new BoundingBox expanded by margin_deg degrees in all four directions.

Clamps the result to valid lat/lon ranges so the returned box is always valid.

Arguments

• margin_deg - Expansion amount in degrees (must be ≥ 0)

Errors

Returns SpatialError::ValueError if margin_deg is negative.

pub fn center(&self) -> (f64, f64)

Return the center (lat, lon) of the bounding box.

pub fn width_deg(&self) -> f64

Return the width of the bounding box in degrees (longitude span).

pub fn height_deg(&self) -> f64

Return the height of the bounding box in degrees (latitude span).

pub fn area_m2(&self) -> f64

Approximate area of the bounding box in square metres.

Uses the spherical Earth model. Suitable for boxes up to a few hundred km wide.

Trait Implementations

impl Clone for BoundingBox

fn clone(&self) -> BoundingBox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BoundingBox

impl Debug for BoundingBox

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

Formats the value using the given formatter.

impl PartialEq for BoundingBox

fn eq(&self, other: &BoundingBox) -> 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 BoundingBox