From 63da40528eb7d0b1f2ad10038f9d8c1ef292a5b5 Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Tue, 19 May 2026 15:33:44 +0200 Subject: [PATCH 1/8] add tele-operation service level --- code/API_definitions/predictive-connectivity-data.yaml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 25541db..f5d9279 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -433,11 +433,13 @@ components: service levels are as follows: - C2: Command and Control. Consists in connecting an unmanned aerial vehicle with its remote controller. This link allows data transmission in both directions, facilitating real-time operation and feedback. - STREAM_4K: Streaming in 4K quality. + - TELE_OPERATION: Intended for vehicle tele-operation in the automotive sector. Combination of low-latency actuation and low-latency, high-throughput sensor feedback (e.g. camera feeds). - BEST_EFFORT: This service level provides a qualitative estimation of coverage based on each operator's own prediction models or public coverage maps. It does not imply any guarantee of network performance or service availability. The values of GC, MC, NC, and ND should be interpreted as approximate indicators of expected connectivity quality, not as results derived from standardised thresholds. type: string enum: - C2 - STREAM_4K + - TELE_OPERATION - BEST_EFFORT NetworkType: description: >- From d75e92b5692ac94f424e3c6cc6b80af21dd353bb Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Mon, 28 Sep 2026 09:32:03 +0200 Subject: [PATCH 2/8] incorporate Jun 22 comments --- .../predictive-connectivity-data.yaml | 36 +++++++++++++++---- .../predictive-connectivity-data.feature | 9 +++++ 2 files changed, 39 insertions(+), 6 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index f5d9279..f3ee232 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -428,13 +428,35 @@ components: maximum: 180 ServiceLevel: description: >- - Describes the requested communication service level. Although more - categories may be added in the future, for the time being, the possible - service levels are as follows: - - C2: Command and Control. Consists in connecting an unmanned aerial vehicle with its remote controller. This link allows data transmission in both directions, facilitating real-time operation and feedback. + Describes the requested communication service level. + Service levels represent predefined communication requirement + categories used by the API provider's prediction model to classify + expected connectivity. Unless explicitly stated otherwise, the detailed + technical criteria associated with each service level are + provider-defined and implementation-specific. Service levels do not + represent standardised QoS profiles, network performance guarantees, + service availability commitments, or operational safety approvals. + Although more categories may be added in the future, for the time + being, the possible service levels are as follows: + - C2: Command and Control. Consists in connecting an unmanned aerial + vehicle with its remote controller. This link allows data + transmission in both directions, facilitating real-time operation + and feedback. - STREAM_4K: Streaming in 4K quality. - - TELE_OPERATION: Intended for vehicle tele-operation in the automotive sector. Combination of low-latency actuation and low-latency, high-throughput sensor feedback (e.g. camera feeds). - - BEST_EFFORT: This service level provides a qualitative estimation of coverage based on each operator's own prediction models or public coverage maps. It does not imply any guarantee of network performance or service availability. The values of GC, MC, NC, and ND should be interpreted as approximate indicators of expected connectivity quality, not as results derived from standardised thresholds. + - TELE_OPERATION: Implementation-specific service level intended for + remote operation of vehicles, robots or machines requiring + bidirectional low-latency control and high-throughput sensor or + video feedback. The connectivity values indicate whether the + provider's prediction model expects the requested area, time, + height and network type to satisfy the criteria associated with + this service level. + - BEST_EFFORT: This service level provides a qualitative estimation + of coverage based on each operator's own prediction models or + public coverage maps. It does not imply any guarantee of network + performance or service availability. The values of GC, MC, NC, and + ND should be interpreted as approximate indicators of expected + connectivity quality, not as results derived from standardised + thresholds. type: string enum: - C2 @@ -841,6 +863,7 @@ components: - Indicated request is too big for both synchronous and asynchronous processing ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_REQUEST", "message": "The indicated request is too big for both synchronous and asynchronous processing") - Indicated cell precision (Geohash level) is not supported ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_PRECISION", "message": "Indicated cell precision (Geohash level) is not supported") - Indicated request is too big for synchronous processing and asynchronous processing is not enabled ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SYNC_RESPONSE", "message": "The indicated request is too big for synchronous processing and asynchronous processing is not enabled") + - Indicated request contains a service level that is not supported by the provider ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL", "message": "The indicated request contains a service level that is not supported by the provider") headers: x-correlator: $ref: '#/components/headers/x-correlator' @@ -859,6 +882,7 @@ components: - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_REQUEST - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_PRECISION - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SYNC_RESPONSE + - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL examples: PREDICTIVE_CONNECTIVITY_DATA_422_UNSUPPORTED_REQUEST: value: diff --git a/code/Test_definitions/predictive-connectivity-data.feature b/code/Test_definitions/predictive-connectivity-data.feature index 2c99a5c..8ce53a0 100644 --- a/code/Test_definitions/predictive-connectivity-data.feature +++ b/code/Test_definitions/predictive-connectivity-data.feature @@ -448,6 +448,15 @@ Feature: CAMARA Predictive Connectivity Data API, vwip And the response property "$.code" is "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_REQUEST" And the response property "$.message" contains a user friendly text + @predictive_connectivity_data_422.04_unsupported_service_level + Scenario: Error 422 when the requested service level is not supported by this provider + Given the request body property "$.serviceLevel" is set to a valid but not supported value + Then the response status code is 422 + And the response header "Content-Type" is "application/json" + And the response property "$.status" is 422 + And the response property "$.code" is "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL" + And the response property "$.message" contains a user friendly text + # Error 429 scenarios @predictive_connectivity_data_429.01_too_Many_Requests From 5e0252fb719175e0a48d19a4cf9071cf59ca870f Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Mon, 28 Sep 2026 09:41:46 +0200 Subject: [PATCH 3/8] remove trailing spaces, remove unneeded ordering change --- code/API_definitions/predictive-connectivity-data.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 7408343..d6a13a6 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -432,7 +432,7 @@ components: example: ezdmemd ServiceLevel: description: >- - Describes the requested communication service level. + Describes the requested communication service level. Service levels represent predefined communication requirement categories used by the API provider's prediction model to classify expected connectivity. Unless explicitly stated otherwise, the detailed @@ -445,7 +445,7 @@ components: - C2: Command and Control. Consists in connecting an unmanned aerial vehicle with its remote controller. This link allows data transmission in both directions, facilitating real-time operation - and feedback. + and feedback. - STREAM_4K: Streaming in 4K quality. - TELE_OPERATION: Implementation-specific service level intended for remote operation of vehicles, robots or machines requiring @@ -453,7 +453,7 @@ components: video feedback. The connectivity values indicate whether the provider's prediction model expects the requested area, time, height and network type to satisfy the criteria associated with - this service level. + this service level. - BEST_EFFORT: This service level provides a qualitative estimation of coverage based on each operator's own prediction models or public coverage maps. It does not imply any guarantee of network @@ -789,8 +789,8 @@ components: - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_REQUEST - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_PRECISION - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SYNC_RESPONSE - - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_AREA_TYPE + - PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL - PRIVATE_KEY_JWT_NOT_CONFIGURED examples: PREDICTIVE_CONNECTIVITY_DATA_422_UNSUPPORTED_REQUEST: From 8d33431d9e119591b061231a76222fbec61b44a0 Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Mon, 28 Sep 2026 09:42:36 +0200 Subject: [PATCH 4/8] remove duplicate description --- code/API_definitions/predictive-connectivity-data.yaml | 1 - 1 file changed, 1 deletion(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index d6a13a6..f685758 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -767,7 +767,6 @@ components: - Indicated request is too big for both synchronous and asynchronous processing ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_REQUEST", "message": "The indicated request is too big for both synchronous and asynchronous processing") - Indicated cell precision (Geohash level) is not supported ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_PRECISION", "message": "Indicated cell precision (Geohash level) is not supported") - Indicated request is too big for synchronous processing and asynchronous processing is not enabled ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SYNC_RESPONSE", "message": "The indicated request is too big for synchronous processing and asynchronous processing is not enabled") - - Indicated request contains a service level that is not supported by the provider ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL", "message": "The indicated request contains a service level that is not supported by the provider") - The requested `areaType` is not supported by the MNO ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_AREA_TYPE", "message": "The requested areaType is not supported by the MNO") - Indicated service level is not supported ("code": "PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL", "message": "The service level provided is not supported") - `sinkCredential.credentialType` is set to `PRIVATE_KEY_JWT` but no JWK Set is configured for the API consumer ("code": "PRIVATE_KEY_JWT_NOT_CONFIGURED", "message": "No JWK Set configured for PRIVATE_KEY_JWT authentication.") From aa068531c852e43682a47867d5d62a8b7769179e Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Tue, 29 Sep 2026 10:04:59 +0200 Subject: [PATCH 5/8] restore accidentally deleted paragraph --- code/API_definitions/predictive-connectivity-data.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index f685758..271048e 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -461,7 +461,11 @@ components: ND should be interpreted as approximate indicators of expected connectivity quality, not as results derived from standardised thresholds. - type: string + An MNO may not support every service level listed in this enum. If the + requested service level is not supported by the MNO, the API returns + the error response + `PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL`. + type: string enum: - C2 - STREAM_4K From bfa627c412e0952fb01d201579e5f107a0a71dbc Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Tue, 29 Sep 2026 10:06:17 +0200 Subject: [PATCH 6/8] Remove confusing double mention of implementation-specific --- .../predictive-connectivity-data.yaml | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 271048e..ed3479c 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -447,13 +447,12 @@ components: transmission in both directions, facilitating real-time operation and feedback. - STREAM_4K: Streaming in 4K quality. - - TELE_OPERATION: Implementation-specific service level intended for - remote operation of vehicles, robots or machines requiring - bidirectional low-latency control and high-throughput sensor or - video feedback. The connectivity values indicate whether the - provider's prediction model expects the requested area, time, - height and network type to satisfy the criteria associated with - this service level. + - TELE_OPERATION: Service level intended for remote operation of + vehicles, robots or machines requiring bidirectional low-latency + control and high-throughput sensor or video feedback. The + connectivity values indicate whether the provider's prediction + model expects the requested area, time, height and network type to + satisfy the criteria associated with this service level. - BEST_EFFORT: This service level provides a qualitative estimation of coverage based on each operator's own prediction models or public coverage maps. It does not imply any guarantee of network From 0cde853c767ecb9ed6840381d8d6f0963ba4f0bd Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Tue, 29 Sep 2026 10:10:29 +0200 Subject: [PATCH 7/8] add example in retrieveConnectivity operation --- .../predictive-connectivity-data.yaml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index ed3479c..60fdd7a 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -223,6 +223,23 @@ paths: longitude: 7.12 startTime: "2024-01-03T11:00:00Z" endTime: "2024-01-03T12:00:00Z" + RetrieveConnectivityRequestTeleOperation: + summary: Request with tele-operation service level + value: + serviceLevel: TELE_OPERATION + area: + areaType: POLYGON + boundary: + - latitude: 50.735851 + longitude: 7.10066 + - latitude: 50.74 + longitude: 7.11 + - latitude: 50.73 + longitude: 7.12 + startTime: "2024-01-03T11:00:00Z" + endTime: "2024-01-03T12:00:00Z" + networkType: 5G + precision: 7 required: true responses: '200': From 6cd1da7a31f6c5cb52b9a4b2fb5e5ff8bce34bbe Mon Sep 17 00:00:00 2001 From: "rintse.vandevlasakker-tno" Date: Tue, 29 Sep 2026 10:47:24 +0200 Subject: [PATCH 8/8] fix formatting issue --- code/API_definitions/predictive-connectivity-data.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 60fdd7a..2f62d49 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -481,7 +481,7 @@ components: requested service level is not supported by the MNO, the API returns the error response `PREDICTIVE_CONNECTIVITY_DATA.UNSUPPORTED_SERVICE_LEVEL`. - type: string + type: string enum: - C2 - STREAM_4K