Struct NetworkRef 

pub struct NetworkRef { /* private fields */ }

RAII guard providing zero-cost access to a cached RoadNetwork.

Implementations

impl NetworkRef

pub fn cache_key(&self) -> &str

Methods from Deref<Target = RoadNetwork>

pub async fn compute_matrix( &self, locations: &[Coord], progress: Option<&Sender<RoutingProgress>>, ) -> TravelTimeMatrix

pub async fn compute_geometries( &self, locations: &[Coord], progress: Option<&Sender<RoutingProgress>>, ) -> HashMap<(usize, usize), Vec<Coord>>

pub fn nodes_iter(&self) -> impl Iterator<Item = (f64, f64)> + '_

Iterate over all nodes as (lat, lng) pairs.

pub fn edges_iter(&self) -> impl Iterator<Item = (usize, usize, f64, f64)> + '_

Iterate over all edges as (from_idx, to_idx, travel_time_s, distance_m) tuples.

pub fn snap_to_road(&self, coord: Coord) -> Option<NodeIdx>

Snap a coordinate to the nearest node in the road network.

Returns None if the network is empty.

pub fn snap_to_road_detailed( &self, coord: Coord, ) -> Result<SnappedCoord, RoutingError>

Snap a coordinate to the road network with detailed information.

Returns a SnappedCoord containing both original and snapped coordinates, the snap distance, and an internal node index for routing.

pub fn snap_to_edge( &self, coord: Coord, ) -> Result<EdgeSnappedLocation, RoutingError>

Snap a coordinate to the nearest road segment (edge-based snapping).

This is production-grade snapping that projects the coordinate onto the nearest road segment rather than snapping to the nearest intersection.

pub fn route(&self, from: Coord, to: Coord) -> Result<RouteResult, RoutingError>

Find a route between two coordinates.

This method snaps the coordinates to the nearest road network nodes and then finds the shortest path by travel time.

pub fn route_edge_snapped( &self, from: &EdgeSnappedLocation, to: &EdgeSnappedLocation, ) -> Result<RouteResult, RoutingError>

Find a route between two edge-snapped locations.

This handles the case where start and end are on road segments, not necessarily at intersections.

pub fn route_snapped( &self, from: &SnappedCoord, to: &SnappedCoord, ) -> Result<RouteResult, RoutingError>

pub fn route_with( &self, from: Coord, to: Coord, objective: Objective, ) -> Result<RouteResult, RoutingError>

pub fn node_count(&self) -> usize

pub fn edge_count(&self) -> usize

pub fn strongly_connected_components(&self) -> usize

pub fn largest_component_fraction(&self) -> f64

pub fn is_strongly_connected(&self) -> bool

Trait Implementations

impl Deref for NetworkRef

type Target = RoadNetwork

The resulting type after dereferencing.

fn deref(&self) -> &RoadNetwork

Dereferences the value.