Struct Geoname

pub struct Geoname {
    pub geoname_id: i64,
    pub name: String,
    pub latitude: f64,
    pub longitude: f64,
    pub country_code: String,
    pub admin1_code: String,
    pub population: u64,
}

A single geographic place.

This corresponds to a single row in the main “geoname” table described in the GeoNames documentation 1. We exclude fields we don’t need.

Fields

geoname_id: i64

The geonameid straight from the geoname table.

name: String

This is pretty much the place’s canonical name. Usually there will be a row in the alternates table with the same name, but not always. When there is such a row, it doesn’t always have is_preferred_name set, and in fact fact there may be another row with a different name with is_preferred_name set.

latitude: f64

Latitude in decimal degrees.

longitude: f64

Longitude in decimal degrees.

country_code: String

ISO-3166 two-letter uppercase country code, e.g., “US”.

admin1_code: String

The top-level administrative region for the place within its country, like a state or province. For the U.S., the two-letter uppercase state abbreviation.

population: u64

Population size.

Implementations

impl Geoname

pub fn has_same_region(&self, other: &Self) -> bool

Whether self and other have the same region and country. If one is a city and the other is a region, this will return true if the city is located in the region.

Trait Implementations

impl Clone for Geoname

fn clone(&self) -> Geoname

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for Geoname

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for Geoname

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

Formats the value using the given formatter.

impl<UT> FfiConverter<UT> for Geoname

const TYPE_ID_META: MetadataBuffer = _

Type ID metadata, serialized into a [MetadataBuffer].

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl Hash for Geoname

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<UT> Lift<UT> for Geoname

type FfiType = <Geoname as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for Geoname

type LiftType = Geoname

impl<UT> LiftReturn<UT> for Geoname

type ReturnType = <Geoname as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for Geoname

type FfiType = <Geoname as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for Geoname

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for Geoname

type ReturnType = <Geoname as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for Geoname

fn eq(&self, other: &Geoname) -> 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<UT> TypeId<UT> for Geoname

const TYPE_ID_META: MetadataBuffer = _

impl Eq for Geoname