Struct Attribution 

pub struct Attribution {
    pub provider: String,
    pub provider_uri: Option<Url>,
}

Information about data providers of this place.

Attribution provides credit and source information for place data, ensuring proper recognition of data contributors and compliance with data usage requirements.

This information should be displayed when showing place data to users, helping maintain transparency about data sources and provider relationships.

Fields

provider: String

Name of the place’s data provider.

The display name or organization name of the entity that provided this place data. This should be shown to users to give proper credit to data sources and maintain transparency about information origins.

provider_uri: Option<Url>

URI to the place’s data provider.

Optional link to the data provider’s website, profile, or more information about the source. This can be used to create clickable attribution links that direct users to learn more about the data provider.

Implementations

impl Attribution

pub fn provider(&self) -> &String

Name of the place’s data provider.

The display name or organization name of the entity that provided this place data. This should be shown to users to give proper credit to data sources and maintain transparency about information origins.

pub fn provider_uri(&self) -> &Option<Url>

URI to the place’s data provider.

Optional link to the data provider’s website, profile, or more information about the source. This can be used to create clickable attribution links that direct users to learn more about the data provider.

impl Attribution

pub fn new(provider: impl Into<String>) -> Self

Creates a new Attribution with the specified provider name.

Used to construct attribution information with just the provider name. The provider URI can be added separately if available.

pub fn with_uri( provider: impl Into<String>, provider_uri: &str, ) -> Result<Self, Error>

Creates a new Attribution with both provider name and URI.

Used when complete attribution information is available, including a link to the data provider’s website or profile page.

pub const fn has_link(&self) -> bool

Returns whether this attribution has a clickable link.

Used to determine if the attribution should be displayed as a link or plain text, enabling appropriate UI rendering for attribution credits.

pub fn is_valid(&self) -> bool

Returns whether this attribution has valid provider information.

Used to validate attribution data before displaying it to users, ensuring that meaningful attribution information is available.

pub fn display_text(&self) -> String

Gets a display-friendly attribution text.

Provides formatted attribution text suitable for displaying in user interfaces, typically in the format “Data provided by [Provider]”.

pub fn short_display_text(&self) -> String

Gets a short attribution text for compact displays.

Provides brief attribution text suitable for space-constrained interfaces like mobile apps, map overlays, or footer areas.

pub fn to_html(&self) -> String

Generates HTML markup for the attribution.

Creates appropriate HTML markup with proper links if a provider URI is available, suitable for web applications and HTML-based displays.

pub fn to_markdown(&self) -> String

Generates markdown markup for the attribution.

Creates markdown-formatted attribution text with links where appropriate, useful for documentation, README files, or markdown-based content.

pub fn should_display_prominently(&self) -> bool

Returns whether this attribution should be prominently displayed.

Used to determine attribution display priority, with certain providers or data types requiring more prominent attribution display.

pub fn provider_domain(&self) -> Option<&str>

Gets the domain from the provider URI if available.

Extracts the domain portion of the provider URI for display purposes or security checks, useful for showing compact attribution information.

pub fn link_description(&self) -> Option<String>

Creates a user-friendly link description.

Generates descriptive text for links that provides context about where the link leads, useful for accessibility and user experience.

Trait Implementations

impl Clone for Attribution

fn clone(&self) -> Attribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attribution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Attribution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Attribution

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 PartialEq for Attribution

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Attribution

impl StructuralPartialEq for Attribution