GEO DAB APIs: Introduction Data Providers side event 7 November 2016, St. Petersburg GEO DAB APIs: Introduction Stefano Nativi Mattia Santoro (CNR-IIA and ESSI-lab)

Agenda GEOSS, GCI, and GEO DAB GEOSS Downstream services and the GEO DAB APIs API types Common abstract Ontology Different Implementations Views

GEOSS Common Infrastructure GEOSS end-Users GEOSS Web Portal DOWNSTREAM GEOSS Applications GEOSS Applications GEOSS Applications GEOSS Applications GEOSS Application Developers (intermediate Users) GEOSS Common Infrastructure APIs GEOSS Community Environment MIDSTREAM Mediation modules GEOSS Supply Chain Enterprise System 1 Enterprise System 3 … . System 4 Enterprise System 2 Enterprise System 1 Enterprise System 3 … . Enterprise System 2 Enterprise System 2 System 4 Enterprise System Z System 4 Enterprise System 3 Enterprise System 1 SBA 8 … . … . Enterprise System K Enterprise System j SBA 2 UPSTREAM SBA 1 GEOSS Providers

  

GEO DAB APIs Different APIs for serving diverse Application development use cases (environments) A set of standard Web service interfaces e.g. OGC service interfaces, CKAN, OAI-PMH, FTP, etc.  Application A (services Consumer) Application B (services Provider)  Interfaces

GEO DAB APIs     A set of APIs for software developers Client side APIs: (high-level) JavaScript library … . (Python) Server side APIs: REST/JSON APIs OpenSearch APIs … .    

API conceptual model (ontology) «Broker» DAB Resource Set «Clause» Access Parameter Brokering concepts 1..* +Discovery&Access interface providesAccessTo +ResultSet +mediator virtualizes +server Resources Provision concepts «Broker» View setOfConstraints «Provider» Source +Publisher shares +AccesibleObject 1..* Resource +AccessedObject representedBy +TransferredEelement 1..* Representation

JavaScript implementation (Client-side APIs) «GI_Node» DAB + discover() :ResultSet view() :Consumer-defined View getSources() :Sources Consumer-defined View discover() :void getSources() :void Sources ResultSet Source «utility» Paginator next()() :void Page Resource download(RepresentationParameters) :ListOfLayers «Representation» Layer «Clause» Representation Parameters Utility concepts 1..* +constructor instancies +builtObject 0..* +builtResource representedBy OperatesOn navigatedBy 0..1 lists +accessibleResource

REST implementation (Server-side APIs) «Resource» Sources + GET() :ListOfDatasetDescription GET Datasets GET(DatasetID) :DatasetDescription POST(FilterClauses) :ListofDatasetDescription POST(ViewID, FilterClauses) :ListofDatasetDescription POST Dataset Content GET(DatasetID) :Dataset Content Parameters GET(DatasetContentParameters, DatasetID) :DatasetContent Get the list of brokered Sources brokered Datasets Get the metadata of a given Dataset brokered «dataType» Dataset Content Parameters - contentCRS :CRS Envelope :BBOX envelopeCRS :CRS format :MIME spatialResolutions :SpatialResolutions timePeriod :Interval Get the list of parameters for accessing Dataset content Get a Dataset content DatasetDescription id :ID title :Title abstract :Abstract .... :.... Provider-defined Views GET(UserID) :ListOfViews POST(UserID, ViewParameters) :View DELETE(UserID, ViewID) :void DELETE Get the list of Views defined by a Provider Create a View Delete a View

OGC WxS (Web Service Interfaces) «Web Serice Interface» Access Service + getCapabilities() :void describeResource() :void getResource() :void Resource - metadata :ContentMetadata Representation format :MIMEType crs :CRSType envelope :BBOXType ResultSet AccessParameters +accessAgent +downloadedRepresentation 1..* returns contains representedBy

  GEOSS View(s) Definition: Subset of the whole GEOSS resources defined by applying, via the DAB, a set of clauses Discovery clauses (e.g. spatial envelope, keywords, sources, etc.) Access clauses (e.g. data format, access protocol, CRS, etc.) Provider-defined View –i.e. Server-side APIs Consumer-defined View –i.e. Client-side APIs  

A simple web-based tool to define and manage GEOSS Views

Virtual Workshop A virtual workshop was organized to demonstrate how to use GEO DAB APIs Two sessions: Description of APIs: which service interfaces are supported, which extension parameters, etc. Hands-on: how to define views and use APIs in client applications

Thank you !

OGC WCS (Web Service Interfaces) «Web Serice Interface» Discovery Service + getCapabilities() :CapabilitiesType getRecords(QueryClausesType) :ResultSetType getRecordbyID(IDType) :RecordType ResultSet Resource - metadata :RecordMetadataType DiscoveryParameters 1..* contains 1 discovers