Binding

実際の通信方式（HTTPS、ファイル転送、WebSocket等）に当てはめたときの定義を記述する。 以下に記述する内容は全てNon-normative（例示）である。

Concrete Specification（実装例）

Prerequisites（前提条件）

• 通信プロトコル: HTTPS (TLS1.2以上)

• メッセージ形式: JSON-LD

• エンコーディング: UTF-8

• サービス定義方法: SAMM(Semantic Aspect Metamodel)

• <base> はコネクタベースURLを示す

---

Field Definitions（フィールド定義）

本プロトコルで使用される各フィールドの定義を記す。

SPARQLクエリ発行

Method	Endpoint	説明
POST	/v1/api/query	SPARQLクエリ発行

リクエストボディは、以下である。

パラメータ	必須	型	説明
query	○	string	SPARQLクエリ文字列
target	-	string	発行先URL。省略時はキャッシュに発行
options	-	object	オプションパラメータ

サンプルは、以下となる

{
  "query": "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10",
  "target": "https://domain-app.example.com/sparql",
  "options": {}
}

リソースメタデータ

航空業界のドローン航路におけるメタデータの例を挙げる。

機体 (Aircraft)

エンティティ概要

項目	内容
RDF型	Aircraft
語彙	http://example.com/aircraft#

ID形式(例)

http://localhost:8080/resource/aircraft/DDDD2222-0000-0000-4444-000000000004

主なプロパティ

プロパティ	型	説明	サンプル
aircraftId	string	機体ID	DDDD2222-...0004
aircraftName	string	機体名称	B2ドローン
modelName	string	型式名	B2 Nimbus Pro V4
modelNumber	string	型式番号	B2-MD12348V1
manufacturer	string	製造者	株式会社STU-B2
bodyWeight	double	機体重量	9.0
maxTakeoffWeight	double	最大離陸重量	18.0
maxFlightSpeed	double	最大速度	65.0
maxFlightTime	double	最大飛行時間	160.0
certification	boolean	認証有無	true
publicFlag	boolean	公開可否	true

ジオメトリ

{
  "@type": "sf:Point",
  "geo:asWKT": {
    "@value": "POINT (130.408585 33.588344)",
    "@type": "geo:wktLiteral"
  }
}

サンプルデータ

サンプルデータ表示

    "@graph": [
        {
            "@id": "http://localhost:8080/resource/aircraft/DDDD2222-0000-0000-4444-000000000004",
            "geo:hasGeometry": {
                "@id": "http://localhost:8080/resource/aircraft/DDDD2222-0000-0000-4444-000000000004/geometry"
            },
            "publicFlag": {
                "@value": "true",
                "@type": "http://www.w3.org/2001/XMLSchema#boolean"
            },
            "ownerType": {
                "@value": "1",
                "@type": "http://www.w3.org/2001/XMLSchema#int"
            },
            "ownerId": "550e8400-e29b-41d4-a716-446655440018",
            "operatorId": "DDDD2222-0000-0000-0000-0000",
            "modelNumber": "B2-MD12348V1",
            "modelName": "B2 Nimbus Pro V4",
            "@type": "Aircraft",
            "aircraftId": "DDDD2222-0000-0000-4444-000000000004",
            "aircraftName": "B2ドローン",
            "aircraftType": {
                "@value": "3",
                "@type": "http://www.w3.org/2001/XMLSchema#int"
            },
            "bodyWeight": {
                "@value": "9.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "certification": {
                "@value": "true",
                "@type": "http://www.w3.org/2001/XMLSchema#boolean"
            },
            "dipsRegistrationCode": "B2-DIPS126",
            "hasAircraftType": {
                "@id": "http://example.com/aircraft#MultiRotor"
            },
            "hasOwnerType": {
                "@id": "http://example.com/aircraft#OperatorOwned"
            },
            "latitude": {
                "@value": "33.588344e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "longitude": {
                "@value": "130.408585e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "manufacturer": "株式会社STU-B2",
            "manufacturingNumber": "B2-MN456792",
            "maxFlightSpeed": {
                "@value": "65.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "maxFlightTime": {
                "@value": "160.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "maxTakeoffWeight": {
                "@value": "18.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            }
        },
        {
            "@id": "http://localhost:8080/resource/aircraft/DDDD2222-0000-0000-4444-000000000004/geometry",
            "geo:asWKT": {
                "@value": "POINT (130.408585 33.588344 )",
                "@type": "geo:wktLiteral"
            },
            "@type": "http://www.opengis.net/ont/sf#Point"
        }
    ],
    "@context": {
        "geo": "http://www.opengis.net/ont/geosparql#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "@vocab": "http://example.com/aircraft#"
    }

---

ドローンポート(DronePort)

エンティティ概要

項目	内容
RDF型	DronePort
語彙	http://example.com/drone-port#

(2) 主なプロパティ

プロパティ	型	説明	値の例
dronePortId	string	ポートID	DDDD2222-...0004
dronePortName	string	ポート名	B2福岡離着陸場
address	string	住所	福岡県福岡市B2
altitude	double	標高	8.0
latitude	double	緯度	33.5986554
longitude	double	経度	130.4218919
supportDroneType	string	対応機体	中型ドローン
activeStatus	integer	稼働状態	2
publicFlag	boolean	公開可否	true
storesAircraft	IRI	格納機体	Aircraft参照

サンプルデータ

サンプルデータ表示

    "@graph": [
        {
            "@id": "http://localhost:8080/resource/dronePort/DDDD2222-0000-0000-3333-000000000004",
            "geo:hasGeometry": {
                "@id": "http://localhost:8080/resource/dronePort/DDDD2222-0000-0000-3333-000000000004/geometry"
            },
            "visDronePortCompanyId": "B2-VIS126",
            "updateTime": {
                "@value": "2025-10-03T09:00:00Z",
                "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
            },
            "supportDroneType": "中型ドローン",
            "storesAircraft": {
                "@id": "http://localhost:8080/resource/aircraft/DDDD2222-0000-0000-4444-000000000004"
            },
            "@type": "DronePort",
            "activeStatus": {
                "@value": "2",
                "@type": "http://www.w3.org/2001/XMLSchema#integer"
            },
            "address": "福岡県福岡市B2",
            "altitude": {
                "@value": "8.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "dronePortId": "DDDD2222-0000-0000-3333-000000000004",
            "dronePortName": "B2福岡離着陸場",
            "hasActiveStatus": {
                "@id": "http://example.com/drone-port#AvailableStatus"
            },
            "hasPortType": {
                "@id": "http://example.com/drone-port#UnmannedDronePort"
            },
            "latitude": {
                "@value": "33.5986554e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "longitude": {
                "@value": "130.4218919e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "manufacturer": "株式会社MNO-B2",
            "operatorId": "DDDD2222-0000-0000-0000-0000",
            "portType": {
                "@value": "1",
                "@type": "http://www.w3.org/2001/XMLSchema#integer"
            },
            "publicFlag": {
                "@value": "true",
                "@type": "http://www.w3.org/2001/XMLSchema#boolean"
            },
            "serialNumber": "B2-SN789015",
            "storedAircraftId": "DDDD2222-0000-0000-4444-000000000004"
        },
        {
            "@id": "http://localhost:8080/resource/dronePort/DDDD2222-0000-0000-3333-000000000004/geometry",
            "geo:asWKT": {
                "@value": "POINT Z (130.4218919 33.5986554 8.0)",
                "@type": "geo:wktLiteral"
            },
            "@type": "http://www.opengis.net/ont/sf#Point"
        }
    ],
    "@context": {
        "geo": "http://www.opengis.net/ont/geosparql#",
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "@vocab": "http://example.com/drone-port#"
    }

---

航路(UASL)

エンティティ概要

項目	内容
RDF型	Uasl
語彙	http://example.com/uasl#

航路エンティティ

プロパティ	型	説明
uaslId	string	航路ID
uaslName	string	航路名称
flightPurpose	string	飛行目的
createdAt	dateTime	作成日時
updatedAt	dateTime	更新日時

サンプルデータ

サンプルデータ表示

    "@graph": [
        {
            "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000",
            "updatedAt": {
                "@value": "2025-01-24T05:36:26.021Z",
                "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
            },
            "uaslName": "航路E",
            "uaslId": "22222222-EEEE-0000-0000-446655440000",
            "@type": "Uasl",
            "belongsToUaslAdministrator": {
                "@id": "http://localhost:8080/resource/uaslAdministrator/22222222-678643e0-b4d4-4d0f-866c-c441a4659be4"
            },
            "createdAt": {
                "@value": "2025-01-24T05:36:26.021Z",
                "@type": "http://www.w3.org/2001/XMLSchema#dateTime"
            },
            "droneId": [
                {
                    "@value": "1",
                    "@type": "http://www.w3.org/2001/XMLSchema#integer"
                },
                {
                    "@value": "2",
                    "@type": "http://www.w3.org/2001/XMLSchema#integer"
                }
            ],
            "flightPurpose": "飛行目的-航路E",
            "hasRepresentativePoint": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000/representativePoint"
            },
            "hasUaslPoint": [
                {
                    "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002"
                }
            ],
            "hasUaslSection": [
                {
                    "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000002"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000004"
                }
            ]
        },
        {
            "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000/representativePoint",
            "longitude": {
                "@value": "130.42092",
                "@type": "http://www.w3.org/2001/XMLSchema#decimal"
            },
            "latitude": {
                "@value": "33.597",
                "@type": "http://www.w3.org/2001/XMLSchema#decimal"
            },
            "@type": "UaslRepresentativePoint"
        },
        {
            "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003",
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslPoint"
        },
        {
            "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004",
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslPoint"
        },
        {
            "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001",
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslPoint"
        },
        {
            "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003",
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslPoint"
        },
        {
            "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002",
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslPoint"
        },
        {
            "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000003",
            "connectsUaslPoint": [
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004"
                },
                {
                    "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003"
                }
            ],
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslSection"
        },
        {
            "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000002",
            "connectsUaslPoint": [
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004"
                },
                {
                    "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003"
                }
            ],
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslSection"
        },
        {
            "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000001",
            "connectsUaslPoint": [
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004"
                },
                {
                    "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003"
                }
            ],
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslSection"
        },
        {
            "@id": "http://localhost:8080/resource/uaslSection/22222222-EEEE-0000-2222-000000000004",
            "connectsUaslPoint": [
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000003"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000002"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000001"
                },
                {
                    "@id": "http://localhost:8080/resource/uaslPoint/22222222-EEEE-0000-1111-000000000004"
                },
                {
                    "@id": "http://uasl-system-a.revitie.org/resource/uaslPoint/11111111-DDDD-0000-1111-000000000003"
                }
            ],
            "belongsToUasl": {
                "@id": "http://localhost:8080/resource/uasl/22222222-EEEE-0000-0000-446655440000"
            },
            "@type": "UaslSection"
        }
    ],
    "@context": {
        "geo": "http://www.opengis.net/ont/geosparql#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "@vocab": "http://example.com/uasl#"
    }

RDF Patch通知

ドメインアプリケーションからのRDF Patch更新通知をAMQPで受信する。

配送セマンティクス

• 少なくとも1回配送（at-least-once）

• 到着順序は保証されない（分散カタログ側で順序制御）

メッセージ形式

フィールド	説明
id	更新シーケンス識別子（バージョンID）
prev	直前パッチのID（順序制御に使用）
RDF Patch本体	Apache Jena/Fuseki形式のパッチ

AMQPヘッダー（オプション）

ヘッダー名	説明
domain_app_id	ドメインアプリ識別子（未指定時はデフォルト値を使用）

RDF Patch形式（Apache Jena/Fuseki）

H id <uuid:...>
H prev <uuid:...>
TX
PA ex: <http://example.org/>
A ex:subject ex:predicate "object" .
D ex:subject ex:oldPredicate "oldObject" .
TC

要素	説明
H	ヘッダー（id, prev等）
TX / TC / TA	トランザクション境界
PA / PD	prefix追加/削除
A / D	トリプル追加/削除

---

Functional Description（機能詳細）

Sent by・Resulting state(s)・Request・Response・Example・Error一覧・API固有のフィールド定義などの具体実装はAPI仕様書の記載を参照してください

機能分類	機能概要	説明
Metadata Publish	RDF公開	RDF登録
Patch Notify	差分通知	RDF Patch送信
SPARQL Query	RDF取得	SPARQL検索

---

Sequence Diagram（シーケンス図）

SPARQLクエリ発行