Struct GeoLocation 

pub struct GeoLocation {
    pub continent: Option<Continent>,
    pub country: Option<Country>,
    pub registered_country: Option<Country>,
    pub subdivisions: Vec<Subdivision>,
    pub city: Option<Box<str>>,
    pub postal_code: Option<Box<str>>,
    pub location: Option<Coordinates>,
    pub autonomous_system: Option<AsOrg>,
}

Available on crate feature net only.

Owned, 'static geolocation data for a single IP address.

Obtain one from GeoLocationRef::to_owned. Suitable for storing in rama_core::extensions and for serialisation. Every field is optional: different database editions (country / city / ASN) populate different subsets. EU membership is available via Country::is_in_eu.

Fields

continent: Option<Continent>

Continent of the IP address.

country: Option<Country>

Country of the IP address.

registered_country: Option<Country>

Country in which the IP address is registered (may differ from Self::country for e.g. satellite or anycast ranges).

subdivisions: Vec<Subdivision>

Subdivisions, ordered from largest (e.g. state) to smallest.

city: Option<Box<str>>

Localised city name in the requested language, if available.

postal_code: Option<Box<str>>

Postal / ZIP code, if available.

location: Option<Coordinates>

Approximate geographic coordinates, if available.

autonomous_system: Option<AsOrg>

Autonomous system information, if available.

Implementations

impl GeoLocation

pub fn is_empty(&self) -> bool

Returns true if no field carries any information.

pub fn fill_gaps_from(&mut self, other: &GeoLocation)

Fill any field that is empty in self with the corresponding value from other; already-populated fields are left untouched. The composite autonomous_system and location are merged field-wise, so a partial value in self (e.g. an org without an ASN) is completed from other rather than blocking the merge.

Trait Implementations

impl Clone for GeoLocation

fn clone(&self) -> GeoLocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeoLocation

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

Formats the value using the given formatter.

impl Default for GeoLocation

fn default() -> GeoLocation

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GeoLocation

fn deserialize<__D>( __deserializer: __D, ) -> Result<GeoLocation, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Extension for GeoLocation

impl NetExtension for GeoLocation

impl PartialEq for GeoLocation

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

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GeoLocation