Content for TS 23.437 Word version: 20.1.0
8.4 Spatial anchor usage information
8.4.1 General
8.4.2 Spatial anchor usage information (Sub-Notify)
8.4.3 Spatial anchor usage information (Request-Response)
8.4.4 Spatial anchor usage reporting
...
...
8.4 Spatial anchor usage information p. 44
8.4.1 General p. 44
The spatial anchor usage information procedure allows consumer (i.e. VAL server) to get usage information about the spatial anchor. The spatial anchor usage information procedure enables the VAL server to request or subscribe with the SAn server to receive spatial anchor usage information.
8.4.2 Spatial anchor usage information (Sub-Notify) p. 44
8.4.2.1 General p. 44
This clause enables VAL server to subscribe spatial anchor usage information from the SEAL SAn server.
8.4.2.2 Procedure p. 44
Figure 8.4.2.2-1 depicts the procedure for subscribing to receive information related to spatial anchor usage for metaverse applications. The service is provided by SAn server.
Step 1.
A consumer (e.g. VAL server) sends a spatial anchor usage information subscription request to the SAn server). The request can include the VAL server identifier, security credentials, a notification endpoint (e.g., IP address, FQDN, URI), and spatial anchor filters like spatial anchor identifiers, spatial anchor location information, position of the user, proximity distance, and application service identifier. It may also include the periodicity for reporting notification and sampling interval.
Step 2.
Upon receiving the request, the SAn server authorizes the VAL server subscription request and sends a spatial anchor usage subscription response to the consumer.
Step 3.
The SAn server samples the information related to spatial anchor usage based on the obtained data and the stored spatial anchor data as per the sampling interval. It provides notification to the consumer as per the reporting interval. The notification message includes spatial anchor ID, number of times spatial anchor discovered and accessed, spatial anchor density per location, user density per spatial anchor, spatial anchor services accessed information.
8.4.2.3 Information flows p. 45
8.4.2.3.1 Spatial anchor usage information subscription request p. 45
Table 8.4.2.3.1-1 describes information elements for the spatial anchor usage information subscription request from the consumer to the SAn server.
| Information element | Status | Description |
|---|---|---|
| Requestor identifier | M | The identifier of the requestor (e.g., VAL server). |
| Security credentials | M | The security credentials of the requestor. |
| Spatial anchor filters | M | Indicates the spatial anchor filter for the information |
| > Spatial anchor identifiers | O | Indicates the spatial anchor identities. |
| > Spatial anchor location information | O | Indicates the spatial anchor location information. |
| > Area information | O | Indicates the area information (e.g., location information). |
| > Application service information | O | Indicates the application service information(e.g., application identifier). |
| Sampling interval | O | Indicates the interval to sample the spatial anchor(s) related information. |
| Reporting interval | O | Indicates the periodic reporting interval of information. |
| Notification endpoint | O | Indicates the endpoint(e.g., IP address, FQDN, URI) to send the information notification. |
|
NOTE:
Spatial anchor filters IE must include at least one optional IE.
|
||
8.4.2.3.2 Spatial anchor usage information subscription response p. 45
Table 8.4.2.3.2-1 describes information elements for the spatial anchor usage information subscription response from the SAn server to the consumer.
| Information element | Status | Description |
|---|---|---|
| Successful response | O | Indicates that the subscription request was successful. |
| > Spatial anchor usage information subscription ID | M | Identity for the spatial anchor usage information subscription. |
| Failure response | O | Indicates that the subscription request has failed. |
| > Cause | O | The cause for the request failure. |
8.4.2.3.3 Spatial anchor usage information notification p. 45
Table 8.4.2.3.3-1 describes information elements for the spatial anchor usage information notification from the SAn server to the consumer.
| Information element | Status | Description |
|---|---|---|
| Spatial anchor usage information subscription ID | M | Identity for the spatial anchor usage information subscription. |
| Spatial anchor identifiers | M | Indicates the spatial anchor identities. |
| > Spatial anchor usage information | M | Indicates spatial anchor usage information. It includes number of times spatial anchor discovered and accessed, spatial anchor services accessed information. |
| > Spatial anchor density per location | M | Indicates the density of the spatial anchor in the given area. |
| > User density per spatial anchor | M | Indicates the density of users within proximity to a specific spatial anchor. |
8.4.3 Spatial anchor usage information (Request-Response) p. 46
8.4.3.1 General p. 46
This clause enables VAL server to request spatial anchor usage information from the SEAL SAn server.
8.4.3.2 Procedure p. 46
Figure 8.4.3.2-1 depicts the procedure to receive information related to spatial anchor usage for metaverse applications. The service is provided by SAn server.
Step 1.
The consumer (e.g. VAL server) sends a request message to the SAn server to get the spatial anchor usage information as per Table 8.4.3.3.1-1.
Step 2.
The SAn server authorizes the consumer. If the requestor is authorized, then the SAn server provides the spatial anchor usage information. The response message includes spatial anchor ID, number of times spatial anchor discovered and accessed, spatial anchor density per location, user density per spatial anchor, spatial anchor services accessed information.
8.4.3.3 Information flows p. 46
8.4.3.3.1 Spatial anchor usage information request p. 46
Table 8.4.3.3.1-1 describes information elements for the spatial anchor usage information request from the consumer to the SAn server.
| Information element | Status | Description |
|---|---|---|
| Requestor identifier | M | The identifier of the requestor (e.g., VAL server). |
| Security credentials | M | The security credentials of the requestor. |
| Spatial anchor filters | M | Indicates the spatial anchor filter for the information. |
| > Spatial anchor identifiers | O | Indicates the spatial anchor identities. |
| > Spatial anchor location information | O | Indicates the spatial anchor location information. |
| > Area information | O | Indicates the area information (e.g., location information). |
| > Application service information | O | Indicates the application service information(e.g., application identifier). |
|
NOTE:
Spatial anchor filters IE must include at least one optional IE.
|
||
8.4.3.3.2 Spatial anchor usage information response p. 47
Table 8.4.3.3.2-1 describes information elements for the spatial anchor usage information response from the SAn server to the consumer.
| Information element | Status | Description |
|---|---|---|
| Successful response | O | Indicates that the request was successful. |
| > Spatial anchor identifiers | M | Indicates the spatial anchor identities. |
| > Spatial anchor usage information | M | Indicates spatial anchor usage information. It includes number of times spatial anchor discovered and accessed, spatial anchor services accessed information. |
| > Spatial anchor density per location | M | Indicates the density of the spatial anchor in the given area. |
| > User density per spatial anchor | M | Indicates the density of users within proximity to a specific spatial anchor. |
| Failure response | O | Indicates that the request has failed. |
| > Cause | O | The cause for the request failure. |
8.4.4 Spatial anchor usage reporting p. 47
8.4.4.1 General p. 47
Spatial anchor usage reporting enables a spatial anchor consumer (e.g., SAn client or VAL server) to report spatial anchor usage to the SAn server.
8.4.4.2 Procedure p. 47
Figure 8.4.4.2-1 illustrates the spatial anchor usage reporting procedure.
Pre-conditions:
- The SAn client or VAL server has received information (e.g. URI, IP address) related to the SAn server;
- The SAn client or VAL server has received security credentials authorizing it to communicate with the SAn server.
Step 1.
The requestor (e.g., SAn client or VAL server) sends a spatial anchor usage report request to the SAn server. The request includes a requestor identifier, security credentials, and spatial anchor usage information as described in clause 8.4.4.3.1.
Step 2.
Upon receiving the request, the SAn server validates if the requestor is authorized for the request. If the requestor is authorized, the SAn server updates the spatial anchor usage information. The SAn server uses the spatial anchor usage information when notifying subscribers(s) as specified in clause 8.4.2.2.
Step 3.
The SAn server sends a spatial anchor usage report response to the requestor. If the SAn server successfully stored the spatial anchor usage information, the response includes an indication of success. Otherwise, the response includes an indication of failure and can include a reason for failure.
8.4.4.3 Information flows p. 48
8.4.4.3.1 Spatial anchor usage report request p. 48
Table 8.4.4.3.1-1 describes information elements for the spatial anchor usage report request from the SAn client or VAL server to the SAn server.
| Information element | Status | Description |
|---|---|---|
| Requestor identifier | M | The identifier of the requestor (e.g., VAL server or VAL UE and VAL user). |
| Security credentials | M | The security credentials of the requestor. |
| List of spatial anchor usage information | M | List of usage information for spatial anchors. |
| > Spatial anchor ID | M | Identifier of the spatial anchor. |
| > Number of access | M | The number of times the spatial anchor was accessed. |
| > Report period | O | The time period for which the number of access applies. If omitted, the number of access is the number of access since the last spatial anchor usage report request. |
8.4.4.3.2 Spatial anchor usage report response p. 48
Table 8.4.4.3.2-1 describes information elements for the spatial anchor usage report response from the SAn server to the SAn client or VAL server.
| Information element | Status | Description |
|---|---|---|
| Successful response | O | Indicates that the spatial anchor usage report request was successful. |
| Failure response | O | Indicates that the spatial anchor usage report request has failed. |
| > Cause | O | The cause for the request failure. |
