Wave Pattern Background

Developer Resources & Documentation

Comprehensive technical documentation for developers and data providers working with the BlueDataSpace platform.

Technical Foundation

BlueDataSpace is built on open standards and interoperable technologies to ensure seamless data exchange and integration across marine and ocean data ecosystems. Our platform leverages semantic web technologies, geospatial standards, and the Web of Things (WoT) to create a unified framework for ocean data.

Open Standards

Built on established standards like RDF, OWL, GeoSPARQL, and EMODnet data models to ensure interoperability.

Federated Architecture

Distributed data storage with centralized discovery and access, preserving data sovereignty while enabling collaboration.

API-First Design

RESTful and GraphQL APIs with comprehensive documentation and client libraries for multiple programming languages.

API Documentation

BlueDataSpace offers multiple API endpoints for accessing ocean data, metadata, and platform services. Our APIs follow RESTful principles and support JSON, JSON-LD, and other standard formats.

REST API
RESTful endpoints for accessing ocean data and platform services

Base URL

https://api.bluedataspace.org/v1

Authentication

All API requests require authentication using an API key or OAuth 2.0.

Authorization: Bearer {your_api_key}

Example Request

curl -X GET "https://api.bluedataspace.org/v1/datasets" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"

Available Endpoints

  • /datasets - List available datasets
  • /datasets/{id} - Get dataset details
  • /observations - Query observational data
  • /geospatial - Access geospatial features
  • /timeseries - Retrieve time series data

Schema & Data Models

BlueDataSpace uses standardized data models and schemas to ensure interoperability and semantic consistency across different data sources and applications.

Ocean Ontology
Semantic data model for ocean observations and features

The BlueDataSpace Ocean Ontology extends existing standards like SOSA/SSN, GeoSPARQL, and EMODnet data models to create a comprehensive semantic framework for ocean data.

Key Concepts

  • Ocean Observations & Measurements
  • Marine Features & Properties
  • Spatial & Temporal Contexts
  • Sensors & Platforms
  • Ocean Processes & Events

Namespace

http://bluedataspace.org/ontology/
Data Exchange Formats
Standardized formats for data exchange and integration

BlueDataSpace supports multiple standardized data exchange formats to facilitate interoperability with existing systems and tools.

JSON-LD

Linked Data in JSON format with semantic context

GeoJSON

Geospatial data encoding in JSON format

NetCDF

Scientific array-oriented data format

CSV/TSV

Tabular data with metadata headers

EMODnet Compatibility
Alignment with European Marine Observation and Data Network standards

BlueDataSpace is designed to be compatible with EMODnet data standards and models, enabling seamless integration with European marine data infrastructure.

Data Harmonization

Standardized parameters, units, and quality flags aligned with EMODnet conventions

Metadata Standards

INSPIRE-compliant metadata with extended marine-specific elements

Service Interfaces

OGC-compatible web services for data discovery, viewing, and download

Tutorials

Learn how to use BlueDataSpace APIs, query data, and integrate with the platform through our step-by-step tutorials.

Getting Started with the REST API
Beginner
Learn how to authenticate and make your first API requests

This tutorial walks you through the process of setting up authentication, making basic API requests, and handling responses.

Languages:
Python
JavaScript
R
Time:15 minutes
Querying with SPARQL
Intermediate
Learn how to write SPARQL queries for the knowledge graph

This tutorial covers the basics of SPARQL query language and how to use it to extract meaningful information from the BlueDataSpace knowledge graph.

Prerequisites:
Basic RDF knowledge
Time:30 minutes
Geospatial Queries with GeoSPARQL
Spatial filtering and analysis

Learn to use GeoSPARQL for spatial queries.

Advanced
Working with Time Series Data
Retrieving and analyzing temporal data

Techniques for working with temporal ocean data.

Intermediate
Data Provider Integration
Publishing your data to BlueDataSpace

Guide for data providers to integrate with the platform.

Advanced

Code Repositories

Access our open-source libraries, client SDKs, and example code to accelerate your development with BlueDataSpace.

Client Libraries
Official client libraries for multiple programming languages

bluedataspace-python

Python client library with pandas integration

bluedataspace-js

JavaScript/TypeScript client for browser and Node.js

bluedataspace-r

R package for data scientists and researchers

Example Applications
Reference implementations and example projects

ocean-dashboard

Interactive dashboard for visualizing ocean data

marine-data-connector

Tool for connecting local data to BlueDataSpace

ocean-data-explorer

Web-based application for exploring ocean datasets

Ready to Start Building?

Join our developer community and start building applications with ocean data.