Binding

This section describes definitions when mapped to an actual communication method (e.g., HTTPS, file transfer, WebSocket). All content described below is non-normative (examples).

Concrete Specification (Implementation Example)

Prerequisites

• Communication protocol: HTTPS (TLS 1.2 or higher)

• Message format: JSON-LD

• Encoding: UTF-8

• Service definition method: SAMM (Semantic Aspect Metamodel)

• <base> indicates the connector base URL

---

Field Definitions

For each field used in this binding, the following information is provided:

Issuing a SPARQL Query

Method	Endpoint	Description
POST	/v1/api/query	Issue a SPARQL query

The request body is as follows.

Parameter	Required	Type	Description
query	✔	string	SPARQL query string
target	-	string	Destination URL. If omitted, issue to the cache
options	-	object	Optional parameters

A sample is as follows.

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

Resource Metadata

An example of metadata in a drone route domain is shown below.

Aircraft

Entity Overview

Item	Content
RDF Type	Aircraft
Vocabulary	http://example.com/aircraft#

ID Format (Example)

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

Main Properties

Property	Type	Description	Example
aircraftId	string	Aircraft ID	DDDD2222-...0004
aircraftName	string	Aircraft name	B2 drone
modelName	string	Model name	B2 Nimbus Pro V4
modelNumber	string	Model number	B2-MD12348V1
manufacturer	string	Manufacturer	STU-B2, Inc.
bodyWeight	double	Aircraft weight	9.0
maxTakeoffWeight	double	Maximum takeoff weight	18.0
maxFlightSpeed	double	Maximum speed	65.0
maxFlightTime	double	Maximum flight time	160.0
certification	boolean	Whether certified	true
publicFlag	boolean	Whether publicly available	true

Geometry

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

Sample Data

Show sample data

    "@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 drone",
            "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, Inc.",
            "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#"
    }

---

Drone Port (DronePort)

Entity Overview

Item	Content
RDF Type	DronePort
Vocabulary	http://example.com/drone-port#

Main Properties

Property	Type	Description	Example Value
dronePortId	string	Port ID	DDDD2222-...0004
dronePortName	string	Port name	B2 Fukuoka Landing Port
address	string	Address	B2, Fukuoka, Japan
altitude	double	Altitude	8.0
latitude	double	Latitude	33.5986554
longitude	double	Longitude	130.4218919
supportDroneType	string	Supported aircraft type	Medium-sized drone
activeStatus	integer	Operational status	2
publicFlag	boolean	Whether publicly available	true
storesAircraft	IRI	Stored aircraft	Reference to Aircraft

Sample Data

Show sample data

    "@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": "Medium-sized drone",
            "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, Fukuoka, Japan",
            "altitude": {
                "@value": "8.0e0",
                "@type": "http://www.w3.org/2001/XMLSchema#double"
            },
            "dronePortId": "DDDD2222-0000-0000-3333-000000000004",
            "dronePortName": "B2 Fukuoka Landing Port",
            "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, Inc.",
            "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#"
    }

---

Route (UASL)

Entity Overview

Item	Content
RDF Type	Uasl
Vocabulary	http://example.com/uasl#

Route Entity

Property	Type	Description
uaslId	string	Route ID
uaslName	string	Route name
flightPurpose	string	Flight purpose
createdAt	dateTime	Created at
updatedAt	dateTime	Updated at

Sample Data

Show sample data

    "@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": "Route 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": "Flight purpose-Route 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 Notification

RDF Patch update notifications from a domain application are received via AMQP.

Delivery Semantics

• At-least-once delivery

• Arrival order is not guaranteed (ordering is controlled on the distributed catalog side)

Message Format

Field	Description
id	Update sequence identifier (version ID)
prev	ID of the previous patch (used for ordering control)
RDF Patch body	Patch in Apache Jena/Fuseki format

AMQP Headers (Optional)

Header Name	Description
domain_app_id	Domain application identifier (a default value is used if not specified)

RDF Patch Format (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

Element	Description
H	Header (id, prev, etc.)
TX / TC / TA	Transaction boundaries
PA / PD	Add/remove prefixes
A / D	Add/remove triples

Functional Description

For concrete implementations such as Sent by, Resulting state(s), Request, Response, Examples, Error lists, and API-specific field definitions, refer to the API specification.

Function Category	Summary	Description
Metadata Publish	Publish RDF	Register RDF
Patch Notify	Differential notification	Send RDF Patch
SPARQL Query	Retrieve RDF	SPARQL search

Sequence Diagram

Issuing a SPARQL Query