Fork me on GitHub

52n SPS version 2.x

The 52°North SPS v2.x supports OGC SPS specification v2.0.0. If you need support for OGC SPS specification v1.0.0 than take a look at 52°North SPS v1.x.

Service Documentation

The 52°North Sensor Planning Service (SPS) serves as runtime environment for sensor tasking assets. This site documents the 52°SPS project implementation of the OGC SPS 2.0.0 specification. During the CITE programme of the OGC OWS phase 9, the 52°SPS version 2.0.1 served as the reference implementation of the OGC SPS specification and successfully passed the CITE compliance tests in mid 2013.

Quick Access



Getting to a running SPS server following two ways are possible:
  • Build the 52°North SPS from source (makes pre-configuration possible) plus deployment into a servlet container (e.g. Apache Tomcat)
  • Deploy a pre-build version into a servlet container (e.g. Apache Tomcat)

Build from source

  • Clone the source code from (note that main development line can be found on the develop branch)
  • Copy the to your ${user.home}/ (note renaming to and make changes to the configuration
  • Open a terminal and build with Apache Maven: mvn clean install -env-dev (requires to have Apache Maven already installed and to be available on system's path)

Deploy to a servlet container

  • Download latest version from SPS Download section (skip if you build from source)
  • Make sure a servlet container is running
  • Copy/paste the SPS .war file into the webapps directory of the servlet container or upload the .war file via Management application (see servlet container's documentation)
  • Make sure a sensor plugin implementation exist and is available on the SPS web application's classpath (WEB-INF/lib is recommended)
  • Register an instance of the sensor plugin to the SPS using InsertSensorOffering operation.


Service interface

The OGC SPS specification lists a core interface and several extensions. 52°North SPS 2.x implements the core profile of the SPS standard.

52n SPS interface

The 52n SPS implementation complements the official OGC interface with further endpoints and functions. The following sections describe each in detail.

Insert new SensorOfferings

The SPS standard specifies how to task sensor assets which are already available, i.e. it does not specify an operation how to add new those sensor assets to a running SPS instance. Therefore the 52°North SPS 2.x implementation defines an InsertSensorOffering request to insert a new sensor offering. The SPS administrator creates an InsertSensorOffering request and sends it via HTTP POST to the SPS admin interface

There is an XML schema available in the 52n-sps-api-xml module which describes the document structure of an InsertSensorOffering request. Use the InsertSensorOffering.xml example to add a new instance of the testplugin tasking asset. For a quick reference have a look at the overview of the document structure. The response is very simple:


Per default the SPS requires the user to authenticate with servlet container's admin role (you can customize this in the web.xml file).

List all tasks for a procedure

A simple HTTP GET will return a list of taskIds which belong to a given sensor (procedure). Just call


Release Notes




Checkout the sources directly from our subversion repository:
  git clone 52n-sps
  cd 52n-sps
  git checkout -b 52n-sps-2.0.1

  svn co 

or checkout the latest code from the main development line:
  git clone 52n-sps


Creative Commons Licence
This work is licensed under a Creative Commons Attribution 3.0 Unported License.


File Description
InsertSensorOffering.xml example request to add new sensor assets
I Attachment Action Size Date Who Comment
InsertSensorOffering.xmlxml InsertSensorOffering.xml manage 5 K 04 Jan 2013 - 08:24 HenningBredel example request to add new sensor assets
insert_sensor_offering._response.pngpng insert_sensor_offering._response.png manage 3 K 20 Sep 2013 - 07:57 HenningBredel  
insert_sensor_offering.pngpng insert_sensor_offering.png manage 96 K 20 Sep 2013 - 07:53 HenningBredel  
Topic revision: r12 - 22 Apr 2015, EikeJuerrens
Legal Notice | Privacy Statement

This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki? Send feedback