REST API

Introduction

The Seismic Server REST API provides a programmatic interface to  services provided by the Subsurface Portal for ArcGIS using the HTTP protocol. The Seismic Server extends an ArcGIS map service, meaning no feature service or image service is required to use it. In addition to serving seismic data the Seismic Server also serves rasters included in the map.

Using the REST API you can:

• Get metadata for Seismic 2D and 3D surveys and rasters
• Extract sub sections of seismic surveys. Once retrieved the data can be processed or displayed in a web client using the Geocap Javascript API.
• Read raster data for a given extent and resolution. The raster data can then be displayed using in the web client.

The REST API is used by the Geocap Javascript API as depicted in the following diagram.

Server information

version

Report seismic server version number and license expiry date.

example : http://osl-ts-07.oslo.geodata.no/arcgis/rest/services/Australia2D/MapServer/exts/SeismicServer/version?f=pjson

2D Seismics

This section describes how to get data and metadata for seismic 2D lines. A seismic survey comprising several navigation lines will be stored in a single feature layer. Each feature  represents one survey line. Each survey line has an associated one-band floating point raster containing the amplitude values. The dimensions of this raster and associated metadata can be read using the info REST call.  The raster data itself can be retrieved using the data request documented in this section.

The URL resource scheme to address a single seismic line will refer to the feature layer containing the surveys and the feature representing a single seismic line:

http:// <seismic server>  /layer/<layer id>/line/<line id>

info

Report meta data about all seismic 2D lines contained in the given feature layer.

example : http://osl-ts-07.oslo.geodata.no/arcgis/rest/services/Australia2D/MapServer/exts/SeismicServer/layer/0/line/info?f=pjson

Report meta data about the seismics 2D lines contained in the given feature layer with feature id <line oid>.

example : http://osl-ts-07.oslo.geodata.no/arcgis/rest/services/Australia2D/MapServer/exts/SeismicServer/layer/0/line/1/info?f=pjson

data

Return amplitude data for a given seismic line. The request will return a one band floating point raster in the form of a float32 array. The desired dimensions of the output raster is set by the caller using the width and height arguments. Use the info request to read the original dimensions of the raster. If the output dimensions differ form the raster's original dimensions the raster will be resampled.

If making the data call from Javascript using an XMLHttpRequest the response data type should be set to arraybuffer. You may then convert this to a Float32Array for further processing.

var xhr_response = data; // of type arraybuffer
var myfloatarray  = new Float32Array (xhr_response );

example : http://osl-ts-07.oslo.geodata.no/arcgis/rest/services/Australia2D/MapServer/exts/SeismicServer/layer/0/line/1/data?f=application/octet-stream