Struct NominatimClient 

pub struct NominatimClient { /* private fields */ }

Client for Nominatim (OpenStreetMap Geocoding)

Provides access to:

• Address to coordinates (geocoding)
• Coordinates to address (reverse geocoding)
• Place name search

IMPORTANT: STRICT rate limit of 1 request/second is enforced. See: https://operations.osmfoundation.org/policies/nominatim/

Example

use ruvector_data_framework::NominatimClient;

let client = NominatimClient::new()?;
let coords = client.geocode("1600 Pennsylvania Avenue, Washington DC").await?;
let address = client.reverse_geocode(38.8977, -77.0365).await?;
let places = client.search("Eiffel Tower", 5).await?;

Implementations

impl NominatimClient

pub fn new() -> Result<Self>

Create a new Nominatim client

pub async fn geocode(&self, address: &str) -> Result<Vec<SemanticVector>>

Geocode an address to coordinates

Arguments

• address - Address string (e.g., “1600 Pennsylvania Avenue, Washington DC”)

Example

let coords = client.geocode("Eiffel Tower, Paris").await?;

pub async fn reverse_geocode( &self, lat: f64, lon: f64, ) -> Result<Vec<SemanticVector>>

Reverse geocode coordinates to address

Arguments

• lat - Latitude
• lon - Longitude

Example

let address = client.reverse_geocode(48.8584, 2.2945).await?;

pub async fn search( &self, query: &str, limit: usize, ) -> Result<Vec<SemanticVector>>

Search for places by name

Arguments

• query - Search query (e.g., “Central Park”)
• limit - Maximum number of results (max 50)

Example

let places = client.search("Times Square", 5).await?;

Trait Implementations

impl Default for NominatimClient

fn default() -> Self

Returns the “default value” for a type.