Enum Granularity 

#[repr(u8)]
pub enum Granularity {
    GranularityUnspecified = 0,
    SubPremise = 1,
    Premise = 2,
    PremiseProximity = 3,
    Block = 4,
    Route = 5,
    Other = 6,
}

The various granularities that an address or a geocode can have. When used to indicate granularity for an address, these values indicate with how fine a granularity the address identifies a mailing destination. For example, an address such as “123 Main Street, Redwood City, CA, 94061” identifies a PREMISE while something like “Redwood City, CA, 94061” identifies a LOCALITY. However, if we are unable to find a geocode for “123 Main Street” in Redwood City, the geocode returned might be of LOCALITY granularity even though the address is more granular.

Address granularity refers to the level of detail used in determining the specificity of an address or geocode. Address specificity in the validationGranularity response is a key signal for whether or not an address is deliverable.

The verdict property returns these granularity signals:

• inputGranularity — Describes the level of detail captured from the address sent to the Address Validation API. The level of address detail in the request influences the level of address detail in the validation response. For example, an address with an inputGranularity below PREMISE below level does not typically result in a validationGranularity to a PREMISE level.

• validationGranularity — The granularity level that the Address Validation API can fully validate the address to. In most cases, a granularity level of PREMISE or SUB_PREMISE indicates a quality address that is likely deliverable.

• geocodeGranularity — Describes the level of detail of the geocode associated with the address. For example, Google records might indicate the existence of an apartment number, but not a precise location for that particular apartment within a large apartment complex. In that case, the validationGranularity is SUB_PREMISE but the geocodeGranularity is

Variants

GranularityUnspecified = 0

Default value. This value is unused.

SubPremise = 1

Below-building level result, such as an apartment.

Premise = 2

Building-level result.

PremiseProximity = 3

A geocode that approximates the building-level location of the address.

Block = 4

The address or geocode indicates a block. Only used in regions which have block-level addressing, such as Japan.

Route = 5

The geocode or address is granular to route, such as a street, road, or highway.

Other = 6

All other granularities, which are bucketed together since they are not deliverable.

Trait Implementations

impl AsRef<str> for Granularity

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Granularity

fn clone(&self) -> Granularity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Granularity

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

Formats the value using the given formatter.

impl Default for Granularity

fn default() -> Granularity

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Granularity

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Granularity

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

Formats the value using the given formatter.

impl FromStr for Granularity

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Granularity, <Self as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Granularity

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 IntoEnumIterator for Granularity

type Iterator = GranularityIter

fn iter() -> GranularityIter

impl Ord for Granularity

fn cmp(&self, other: &Granularity) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Granularity

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

fn partial_cmp(&self, other: &Granularity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Granularity

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for Granularity

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Granularity, <Self as TryFrom<&str>>::Error>

Performs the conversion.

impl Copy for Granularity

impl Eq for Granularity

impl StructuralPartialEq for Granularity