センサーAPI(Senser Obserbation Servide)
仕様書

Ver. 1.0.0
2015/9/1

国立研究開発法人 防災科学技術研究所

変更履歴
Version

変更日付

1.0

2015/09/1

変更内容
初版作成

目次
1

概要 ....................................................................................................................................... 1

2API 仕様 ............................................................................................................................... 1
2.1 Sensor Observation Service ............................................................................................. 1
2.1.1

GetCapabilities.......................................................................................................... 1

2.1.2

DescribeSensor .......................................................................................................... 2

2.1.3

GetObservation ......................................................................................................... 3

1

概要
本書は、防災科学技術研究所が開発したセンサ情報相互運用配信システムで配信可能なセンサーAPI(Sensor Observation Service)仕様を明らかにするものである。

2 API 仕様
2.1

Sensor Observation Service

Sensor Observation Service（SOS、以下 SOS と表記）は、Open Geospatial Consortium,Inc.（OGC）によって策定された標準仕様に基づく HTTP プロトコルによるセンサーデー
タサービスインタフェースであり、センサーデータの取得を主とするサービスである。
ここでは SOS バージョン 1.0.0 について説明する。
利用可能なリクエストは以下の通り。
リクエスト

説明

GetCapabilities

SOS を利用するために必要な各種情報を取得する。

DescribeSensor

詳細なセンサーメタデータを取得する。

GetObservation

観測データを取得する。

全てのリクエストは HTTP GET または POST（applicationi/x-www-form-urlencoded）
によってパラメータを送信して利用する。
SOS の正式な仕様は以下の URL から入手できる。
http://www.opengeospatial.org/standards/sos
2.1.1

GetCapabilities 1

SOS を利用するために必要な各種情報を取得する。
リクエストの応答は SOS を利用するための各種情報が記述された XML テキストである。
リクエストパラメータは以下の通り（*は必須パラメータ）。
パラメータ名値

説明

SERVICE*

SOSサービス種別。SOS 固定。

VERSION*

1.0.0

SOS のバージョン、1.0.0 固定。

REQUEST*

GetCapabilities

リクエスト名。GetCapabilities 固定。

リクエストとレスポンスサンプル：
http://192.168.100.169:8080/NIED_SOS/sos?REQUEST=GetCapabilities&SERVICE=SOS

52north exploring horizons GetCapabilities
https://wiki.52north.org/bin/view/SensorWeb/GetCapabilities
1-1-2.1.2

DescribeSensor 2

詳細なセンサーメタデータ（観測対象となる物理情報、保有する観測データの期間、センサーが配置されている位置情報など）を取得する。
リクエストの応答は SOS を利用するための各種情報が記述された XML テキスト。
リクエストパラメータは以下の通り（*は必須パラメータ）。
パラメータ名値

説明SERVICE*

SOS

サービス種別。SOS 固定。

VERSION*

1.0.0

SOS のバージョン、1.0.0 固定。

REQUEST*

DescribeSensor

リクエスト名。DescribeSensor 固定。

outputFormat*

text/xml;subtype="sensorML/1.
0.1"

出力フォーマット(MIME タイプ)

procedure*

Station Example:
出力対象とするセンサーを特定する。
procedure=urn:ioos:station:NO
AA.NOS.CO-OPS:cb1301
Sensor Example:
procedure=urn:ioos:sensor:NOA
A.NOS.CO-OPS:8454000:A1

リクエストとレスポンスサンプル：
http://192.168.100.169:8080/NIED_SOS/sos?REQUEST=DescribeSensor&SERVICE=SOS&VERSION=

52north exploring horizons DescribeSensor
https://wiki.52north.org/bin/view/SensorWeb/DescribeSensor
2-2-1.0.0&PROCEDURE=urn:ogc:object:feature:Sensor:NIED:flood-10&OUTPUTFORMAT=text/xml;subty
pe="sensorML/1.0.1

時系列データの取得範囲
2/1 23:50 ~ 3/13 23:50 のデータが格納されていることを示す

2.1.3

GetObservation 3センサーによって測定された観測データを取得する。
リクエストの応答は SOS を利用するための各種情報が記述された XML テキストである。
リクエストパラメータは以下の通り（*は必須パラメータ）。
パラメータ名値

説明SERVICE*

SOS

サービス種別。SOS 固定。

VERSION*

1.0.0

SOS のバージョン、1.0.0 固定。

REQUEST*

GetObservation

リクエスト名。GetObservation 固定。

responseFormat text/csv

出力フォーマット*eventTime

2015-06-08T00:00:00Z/2015-0608T00:59:00Z

リクエストする観測データの観測時刻。ISO フォー
マット：YYYY-MM-DDTHH:mm:ss±HH を満たすこと。

featureOfInter BBOX:-177.3720,-18.1333,178.4
250,71.3601
est

リクエストする観測データが属する地物の領域。

observedProper air_temperaturety*

リクエストするセンサの種類

52north exploring horizons GetObservation
https://wiki.52north.org/bin/view/SensorWeb/GetObservation
3-3-

offering*procedure

BBOX

Single Station Example:
offering=urn:ioos:station:NOA
A.NOS.CO-OPS:8454000
Single Station Example:
procedure=urn:ioos:sensor:NOA
A.NOS.CO-OPS:cb0102:
Nortek-ADP-511:rtb
BBOX=[minlon,minlat,maxlon,maxlat(,srsURI)]

GetCapabilities レスポンスに記載された offerin
g URI
出力対象とするセンサーを特定する。

リクエストする領域、min 経度、min 緯度、max 経度、max 緯度。いずれも小数点付データ

リクエストとレスポンスサンプル：
http://192.168.100.169:8080/NIED_SOS/sos?REQUEST=GetObservation&SERVICE=SOS&VERSION=
1.0.0&OFFERING=INUNDATION&OBSERVEDPROPERTY=urn:ogc:def:phenomenon:OGC:1.0.30:inu
ndation&RESPONSEFORMAT=text/xml;subtype="om/1.0.0"

センサー群の緯度、経度範囲

センサーデータの測定時刻範囲

１つのセンサーデータの内容

観測時刻、観測値

以上-4-