Struct Shape 

pub struct Shape {
    pub lon: f64,
    pub lat: f64,
    pub kind: Kind,
    pub unit: Unit,
}

What is being searched for, and around where.

Fields

lon: f64

The centre longitude.

lat: f64

The centre latitude.

kind: Kind

A circle or a rectangle, with its size in unit.

unit: Unit

What kind’s numbers are measured in.

Implementations

impl Shape

pub fn reach(&self) -> f64

The radius, or the half diagonal of the rectangle, in metres.

The half diagonal and not the half width, because the step estimate has to cover the corners of the rectangle and not just its sides.

pub fn bounds(&self) -> Area

The smallest longitude and latitude rectangle that contains the shape.

The left and right edges of a shape on the sphere are curved, so the widest part of it is the edge nearer the equator. That is why the two hemispheres take their width from different edges rather than both from the centre.

pub fn covers(&self, lon: f64, lat: f64) -> Option<f64>

Whether a point is inside the shape, and how far away it is in metres.

Nothing at all if it is outside, so the caller never has to compare a distance against a radius itself and get the boundary case wrong. The boundary is inclusive on both shapes.

Trait Implementations

impl Clone for Shape

fn clone(&self) -> Shape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Shape

impl Debug for Shape

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

Formats the value using the given formatter.