Struct Openstreetmap

pub struct Openstreetmap { /* private fields */ }

An instance of the Openstreetmap geocoding service

Implementations

impl Openstreetmap

pub fn new() -> Self

Create a new Openstreetmap geocoding instance using the default endpoint

pub fn new_with_endpoint(endpoint: String) -> Self

Create a new Openstreetmap geocoding instance with a custom endpoint.

Endpoint should include a trailing slash (i.e. “https://nominatim.openstreetmap.org/”)

pub async fn forward_full<T>( &self, params: &OpenstreetmapParams<'_, T>, ) -> Result<OpenstreetmapResponse<T>, GeocodingError>

where for<'de> T: Float + Debug + Deserialize<'de>,

A forward-geocoding lookup of an address, returning a full detailed response

Accepts an OpenstreetmapParams struct for specifying options, including whether to include address details in the response and whether to filter by a bounding box.

Please see the documentation for details.

This method passes the format parameter to the API.

Examples

use geocoding_async::{Openstreetmap, InputBounds, Point};
use geocoding_async::openstreetmap::{OpenstreetmapParams, OpenstreetmapResponse};

let osm = Openstreetmap::new();
let viewbox = InputBounds::new(
    (-0.13806939125061035, 51.51989264641164),
    (-0.13427138328552246, 51.52319711775629),
);
let params = OpenstreetmapParams::new(&"UCL Centre for Advanced Spatial Analysis")
    .with_addressdetails(true)
    .with_viewbox(&viewbox)
    .build();
let res: OpenstreetmapResponse<f64> = osm.forward_full(&params).await.unwrap();
let result = res.features[0].properties.clone();
assert!(result.display_name.contains("Tottenham Court Road"));

Trait Implementations

impl Default for Openstreetmap

fn default() -> Self

Returns the “default value” for a type.

impl<T> Forward<T> for Openstreetmap

where for<'de> T: Float + Debug + Deserialize<'de>,

async fn forward(&self, place: &str) -> Result<Vec<Point<T>>, GeocodingError>

A forward-geocoding lookup of an address. Please see the documentation for details.

This method passes the format parameter to the API.

impl<T> Reverse<T> for Openstreetmap

where for<'de> T: Float + Debug + Deserialize<'de>,

async fn reverse( &self, point: &Point<T>, ) -> Result<Option<String>, GeocodingError>

A reverse lookup of a point. More detail on the format of the returned String can be found here

This method passes the format parameter to the API.