1. 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)

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

3. 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

5.   

6. 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

7. 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
… .    

8. 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

9. 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

10. 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

11. 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

12.   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  

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

14. 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

15. Thank you !

16. 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