Struct Collection 

pub struct Collection {

    pub type_: String,
    pub stac_version: String,
    pub stac_extensions: Option<Vec<String>>,
    pub id: String,
    pub title: Option<String>,
    pub description: String,
    pub keywords: Option<Vec<String>>,
    pub license: String,
    pub providers: Option<Vec<Provider>>,
    pub extent: Extent,
    pub summaries: Option<HashMap<String, Value>>,
    pub links: Vec<Link>,
    pub assets: Option<HashMap<String, Asset>>,
    pub additional_fields: HashMap<String, Value>,
}

A STAC Collection provides additional metadata about a set of Items.

Fields

type_: String

Type must be “Collection”.

stac_version: String

STAC version.

stac_extensions: Option<Vec<String>>

List of extensions used in the collection.

id: String

Unique identifier for the collection.

title: Option<String>

Title of the collection.

description: String

Description of the collection.

keywords: Option<Vec<String>>

Keywords describing the collection.

license: String

License of the collection (SPDX license identifier or URL).

providers: Option<Vec<Provider>>

Providers of the collection.

extent: Extent

Extent of the collection.

summaries: Option<HashMap<String, Value>>

Summaries of properties in the collection.

links: Vec<Link>

Links to other resources.

assets: Option<HashMap<String, Asset>>

Assets associated with this collection.

additional_fields: HashMap<String, Value>

Additional fields for extensions.

Implementations

impl Collection

pub fn new( id: impl Into<String>, description: impl Into<String>, license: impl Into<String>, ) -> Self

Creates a new STAC Collection.

Arguments

• id - Unique identifier for the collection
• description - Description of the collection
• license - License identifier or URL

Returns

A new Collection instance with default STAC version 1.0.0

pub fn with_title(self, title: impl Into<String>) -> Self

Sets the title of the collection.

Arguments

• title - Title for the collection

Returns

Self for method chaining

pub fn with_keywords(self, keywords: Vec<String>) -> Self

Sets the keywords of the collection.

Arguments

• keywords - Vector of keywords

Returns

Self for method chaining

pub fn add_provider(self, provider: Provider) -> Self

Adds a provider to the collection.

Arguments

• provider - Provider to add

Returns

Self for method chaining

pub fn with_spatial_extent(self, bbox: Vec<f64>) -> Self

Sets the spatial extent of the collection.

Arguments

• bbox - Bounding box [west, south, east, north]

Returns

Self for method chaining

pub fn with_temporal_extent( self, start: Option<DateTime<Utc>>, end: Option<DateTime<Utc>>, ) -> Self

Sets the temporal extent of the collection.

Arguments

• start - Start datetime (None for open start)
• end - End datetime (None for open end)

Returns

Self for method chaining

pub fn add_link(self, link: Link) -> Self

Adds a link to the collection.

Arguments

• link - Link to add

Returns

Self for method chaining

pub fn add_extension(self, extension: impl Into<String>) -> Self

Adds a STAC extension.

Arguments

• extension - Extension schema URI

Returns

Self for method chaining

pub fn add_summary(self, key: impl Into<String>, value: Value) -> Self

Adds a summary field.

Arguments

• key - Summary field name
• value - Summary value

Returns

Self for method chaining

pub fn find_links(&self, rel: &str) -> impl Iterator<Item = &Link>

Finds links by relationship type.

Arguments

• rel - Relationship type

Returns

Iterator over matching links

pub fn validate(&self) -> Result<()>

Validates the collection according to STAC specification.

Returns

Ok(()) if valid, otherwise an error

Trait Implementations

impl Clone for Collection

fn clone(&self) -> Collection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Collection

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Collection

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Collection

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Collection