pub struct GbifAdapter {
pub id: &'static str,
pub occurrence_endpoint: String,
}Expand description
Adapter for GBIF occurrence API bbox queries.
Fields§
§id: &'static str§occurrence_endpoint: StringImplementations§
Source§impl GbifAdapter
impl GbifAdapter
Source§impl GbifAdapter
impl GbifAdapter
Sourcepub fn adapter_id(&self) -> &'static str
pub fn adapter_id(&self) -> &'static str
Stable adapter identifier.
Sourcepub fn build_fetch_request(
&self,
bbox: (f64, f64, f64, f64),
time_range: (u64, u64),
registry: &NetworkDisclosureRegistry,
) -> Result<AdapterHttpRequest, String>
pub fn build_fetch_request( &self, bbox: (f64, f64, f64, f64), time_range: (u64, u64), registry: &NetworkDisclosureRegistry, ) -> Result<AdapterHttpRequest, String>
Builds a GBIF occurrence fetch request for a region.
Sourcepub fn parse_features(&self, body: &str) -> Result<Vec<NQuin>, String>
pub fn parse_features(&self, body: &str) -> Result<Vec<NQuin>, String>
Parse a GBIF occurrence-search JSON response body into provenance NQuins.
The results array (each element an occurrence record) is mapped to a set of
Dublin Core / WGS84 provenance quins per record, using generate_60bit_token
for IRI/literal hashing so the emitted data is queryable by the SPARQL layer
(which hashes IRIs the same way). If results is absent an empty Vec is
returned. Only invalid JSON yields an Err.
Trait Implementations§
Source§impl DataAdapter for GbifAdapter
impl DataAdapter for GbifAdapter
Source§fn adapter_id(&self) -> &'static str
fn adapter_id(&self) -> &'static str
"gbif_adapter".
Source§fn build_fetch_request(
&self,
bbox: (f64, f64, f64, f64),
time_range: (u64, u64),
registry: &NetworkDisclosureRegistry,
) -> Result<AdapterHttpRequest, String>
fn build_fetch_request( &self, bbox: (f64, f64, f64, f64), time_range: (u64, u64), registry: &NetworkDisclosureRegistry, ) -> Result<AdapterHttpRequest, String>
Build the GBIF occurrence request via the inherent helper.
Source§fn primary_endpoint(&self) -> &str
fn primary_endpoint(&self) -> &str
The GBIF occurrence-search endpoint.
Source§fn estimate_tile_count(&self, bbox: (f64, f64, f64, f64)) -> u32
fn estimate_tile_count(&self, bbox: (f64, f64, f64, f64)) -> u32
Page estimate: ~10 records/deg² at 300/page, minimum 1.
Source§fn fetch_region(
&self,
bbox: (f64, f64, f64, f64),
time_range: (u64, u64),
registry: &NetworkDisclosureRegistry,
) -> Result<(), String>
fn fetch_region( &self, bbox: (f64, f64, f64, f64), time_range: (u64, u64), registry: &NetworkDisclosureRegistry, ) -> Result<(), String>
Initiate fetching through the native blocking transport. Browser WASM
cannot legally block on network I/O, so wasm callers use
fetch_region_async.Source§fn needs_fetch_body(&self) -> bool
fn needs_fetch_body(&self) -> bool
Whether the adapter consumes the response body instead of only checking
that the endpoint accepted the request.
Source§fn requires_specialized_fetch_path(&self) -> bool
fn requires_specialized_fetch_path(&self) -> bool
Whether this adapter needs its typed fetch method for correct handling.
This prevents generic text transports from truncating tiled or binary data.
Source§fn handle_fetch_body(&self, _body: &str) -> Result<(), String>
fn handle_fetch_body(&self, _body: &str) -> Result<(), String>
Parse or enqueue the fetched body. Most adapters currently only verify
access; CKAN consumes JSON discovery results here.
Source§fn parse_response(&self, _body: &str) -> Result<Vec<NQuin>, String>
fn parse_response(&self, _body: &str) -> Result<Vec<NQuin>, String>
Parse a fetched response body into provenance
NQuins (title / license /
created / source / lat / long, hashed with the same generate_60bit_token
the SPARQL layer uses, so the results are queryable). Adapters that can
interpret their response format override this — GBIF, OSM/Overpass, STAC,
OGC 3D Tiles and SPARQL-results do — and the default yields none. This is
how a fetched response becomes graph data rather than being discarded.Source§fn fetch_region_features(
&self,
bbox: (f64, f64, f64, f64),
time_range: (u64, u64),
registry: &NetworkDisclosureRegistry,
) -> Result<Vec<NQuin>, String>
fn fetch_region_features( &self, bbox: (f64, f64, f64, f64), time_range: (u64, u64), registry: &NetworkDisclosureRegistry, ) -> Result<Vec<NQuin>, String>
Native fetch that returns the parsed provenance
NQuins: build the
consent-gated request, execute it, and run parse_response on the body.
A caller can then route the quins into the graph. (WASM callers fetch via
fetch_region_async and call parse_response on the returned body.)Auto Trait Implementations§
impl Freeze for GbifAdapter
impl RefUnwindSafe for GbifAdapter
impl Send for GbifAdapter
impl Sync for GbifAdapter
impl Unpin for GbifAdapter
impl UnsafeUnpin for GbifAdapter
impl UnwindSafe for GbifAdapter
Blanket Implementations§
§impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
Aggregate shares in an MPC protocol.
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more