Tech-invite3GPPspaceIETF RFCsSIP
Quick21222324252627282931323334353637384‑5x

Content for  TS 23.558  Word version:  17.4.0

Top   Top   Up   Prev   Next
0…   5…   6…   7…   8…   8.4…   8.5…   8.6…   8.6.3…   8.6.6…   8.7…   8.8…   8.8.3…   8.8.4…   8.9…   A…   B…   C…   D…

 

8.6  EES capability exposure to EASWord‑p. 80

8.6.1  GeneralWord‑p. 80

This clause describes service capability APIs exposed by the EES to the EAS(s). The service capability APIs exposed include EES capabilities and exposed 3GPP Core Network capabilities. The 3GPP Core Network capabilities may be exposed from EES to the EAS(s).
The 3GPP Core Network capabilities APIs which are enhanced for exposure are also specified in this clause.

8.6.2  UE location APIWord‑p. 80

8.6.2.1  GeneralWord‑p. 80

The EES exposes the UE location API to the EAS in order to support tracking or checking the valid location of the UE. The UE location API exposed by the EES relies on the 3GPP core network capabilities as specified in clause 8.10.3.
The EAS can request UE location API for one-time reporting to check current UE location and for continuous reporting to track UE's location.
The UE location API supports both request-response for one-time queries (in order to check UE's current location) as well as subscribe-notify models for providing UE's location to EAS on a continuous basis and enabling the EAS to track UE's location (as UE location changes).
Up

8.6.2.2  ProceduresWord‑p. 80

8.6.2.2.1  GeneralWord‑p. 80
Void
8.6.2.2.2  Request-response modelWord‑p. 80
Figure 8.6.2.2.2-1 illustrates the interactions between the EES and the EAS for one-time location report.
Pre-conditions:
  1. The EAS is authorized to discover and to use UE location API provided by the EES.
  2. The EES is authorized to use Nnef Event Exposure API for UE location, based on service level agreement with MNO.
  3. UE Identifier between EAS and the EES is authorized for the UE location API (e.g. appropriate access token is received by EAS based on user's consent).
Copy of original 3GPP image for 3GPP TS 23.558, Fig. 8.6.2.2.2-1: UE location API request-response model
Up
Step 1.
The EAS sends UE location request to the EES. The UE location request shall include the UE Identifier. It may also include location granularity to indicate requested format of the location e.g. GPS Coordinates, Cell ID, Tracking Area ID, or civic addresses (e.g. streets, districts, etc.), which can be understood by the EAS and location QoS.
Step 2.
The EES checks the UE location:
  1. If the UE location request from the EAS includes the location granularity, the EES considers the location granularity parameter for checking the location of the UE.
  2. If the EES has a valid locally cached location of the UE, the EES may use this cached UE location to respond to the EAS. Otherwise, the EES utilizes the capabilities of the 3GPP core network as specified in clause 8.10.3.
  3. The EES may modify the format of the UE location to fit to the location granularity requested from the EAS in the step 1, if supported. For example, if the EES receives the UE location in a format of tracking area ID or cell ID, the EES can modify the representation of the location information to the GPS Coordinates, or civic addresses (e.g. streets, districts, etc.) as requested by the EAS.
Step 3.
If successful, the EES responds to the EAS with the location of the UE, and optionally the timestamp of the location.
Up
8.6.2.2.3  Subscribe-notify modelWord‑p. 81
8.6.2.2.3.1  GeneralWord‑p. 81
Void
8.6.2.2.3.2  SubscribeWord‑p. 81
Figure 8.6.2.2.3.2-1 illustrates the subscribe operation between the EAS and the EES for continuous UE location reporting.
Pre-conditions:
  1. The EAS is authorized to discover and to use UE location API provided by the EES;
  2. The EES is authorized to use 3GPP network exposure capability (e.g. Nnef Event Exposure API) for UE location, based on service level agreement with MNO; and
  3. UE Identifier between EAS and the EES is authorized for the UE location API (e.g. appropriate access token is received by EAS based on user's consent).
Copy of original 3GPP image for 3GPP TS 23.558, Fig. 8.6.2.2.3.2-1: UE location API: Subscribe operation
Up
Step 1.
The EAS sends UE location subscribe request to the EES for tracking a UE's location continuously. The UE location subscribe request shall include the UE Identifier or UE group Identifier and may include proposed expiration time. It may also include location granularity to indicate requested format of the location e.g. GPS Coordinates, Cell ID, Tracking Area ID, or civic addresses (e.g. streets, districts, etc.), which can be understood by the EAS and location QoS.
Step 2.
The EES checks if the request from the EAS is authorized. If authorized, the EES sends success response to the EAS and utilizes the UE location exposure capability of the 3GPP core network as specified in clause 8.10.3. The EES requests continuous location reporting from the 3GPP system to have up to date location information of the UE.
Step 3.
The EES may subscribe to UE expected behaviour analytics (UE mobility) as described in TS 23.288.
Step 4.
The response includes the subscription identifier and may include the expiration time, indicating when the subscription will automatically expire. To maintain the subscription, the EAS shall send a UE location subscription update request prior to the expiration time. If a UE location subscription update request is not received prior to the expiration time, the EES shall treat the EAS as implicitly unsubscribed. If it is not authorized, the EES sends failure response with rejection cause.
Up
8.6.2.2.3.3  NotifyWord‑p. 82
Figure 8.6.2.2.3.3-1 illustrates the notify operation between the EES and the EAS for continuous location.
Pre-conditions:
  1. The EAS has subscribed to UE location API provided by the EES.
Copy of original 3GPP image for 3GPP TS 23.558, Fig. 8.6.2.2.3.3-1: UE location API: Notify operation
Up
Step 1.
The EES detects the location of the UE e.g., receiving location of the UE from the 3GPP system. The EES may cache the detected location information locally with timestamp as the latest location information of the UE(s) and start the notification aggregation for a group of UEs. The EES decides whether to aggregate and the aggregation period based on the analytics result received from the 3GPP Core Network, local policy and UE location subscription information received from the EAS. The EES determines to notify the location information of the UE to the EAS which has subscribed for UE's location.
Step 2.
The EES sends UE location notification to the EAS. The EES includes the location of the UE(s). Each UE location includes UE ID and location type and may include the location accuracy and the timestamp of the location.
The EES may modify the format of location information to fit to the location granularity requested from the EAS during the subscribe operation, if supported. For example, if the EES receives the UE location in a format of tracking area ID or cell ID, the EES can modify the representation of the location information to the GPS Coordinates, or civic addresses (e.g. streets, districts, etc.) as requested from the EAS.
Up
8.6.2.2.3.4  Subscription updateWord‑p. 83
Figure 8.6.2.2.3.4-1 illustrates the subscription update operation between the EAS and the EES.
Pre-conditions:
  1. The EAS has subscribed to UE location API provided by the EES.
Copy of original 3GPP image for 3GPP TS 23.558, Fig. 8.6.2.2.3.4-1: UE location API: Subscription update operation
Up
Step 1.
The EAS sends UE location subscription update request to the EES. The request includes the subscription identifier of the subscription to be. The UE location subscription update request may also include proposed expiration time for the updated subscription, updated Location granularity and Location QoS.
Step 2.
The EES checks if the request from the EAS is authorized. If authorized, the EES updates the subscription request and may update the UE location subscription in the 3GPP Core Network.
Step 3.
The EES may update the subscription to the UE expected behaviour analytics.
Step 4.
The EES sends the UE location subscription update response to the EAS.
Up
8.6.2.2.3.5  UnsubscribeWord‑p. 84
Figure 8.6.2.2.3.5-1 illustrates the unsubscribe operation between the EAS and the EES to stop the UE location notifications.
Pre-conditions:
  1. The EAS has subscribed to UE location API provided by the EES.
Copy of original 3GPP image for 3GPP TS 23.558, Fig. 8.6.2.2.3.5-1: UE location API: unsubscribe operation
Up
Step 1.
The EAS sends the UE location unsubscribe request to the EES.
Step 2.
The EES checks if the EAS is authorized or not. If authorized, the EES terminates the subscription of the EAS and unsubscribes the UE location from the 3GPP Core Network.
Step 3.
The EES unsubscribes from the UE expected behaviour analytics, if applicable.
Step 4.
The EES responds to the EAS.

8.6.2.3  Information flowsWord‑p. 84

8.6.2.3.1  GeneralWord‑p. 84
The following information flows are specified for UE location API:
  • UE location request and response; and
  • UE location subscription, notification, subscription update and unsubscribe.
8.6.2.3.2  UE location requestWord‑p. 85
Information element Status Description
UE IDMIdentifies the UE for which location will be reported (e.g. GPSI, or an access token which not only identifies the UE, but also provides the end user's consent for reporting UE's location to a given EAS)
Security credentialsMSecurity credentials of the EAS
Location granularityOindicates format of location e.g. GPS Coordinates, Cell ID, Tracking Area ID, or civic addresses (e.g. streets, districts, etc.) that can be understood by the EAS
Location QoSOIndicate the location quality of service as described in clause 4.1b of TS 23.273.
Up
8.6.2.3.3  UE location responseWord‑p. 85
Information element Status Description
Successful responseOIndicates that the UE location request was successful
> UE locationMLocation of the UE
> TimestampOIndicates the age of the UE's location information
> Location accuracyOIndicates accuracy of the location information
Failure responseOIndicates that the subscription request failed
> CauseOIndicates the cause of request failure
Up
8.6.2.3.4  UE location subscribe requestWord‑p. 85
Information element Status Description
EASIDMThe identifier of the EAS
UE ID (NOTE)OIdentifies the UE for which location will be reported (i.e GPSI, or an access token which not only identifies the UE, but also provides the end user's consent for reporting UE's location to a given EAS)
UE Group ID (NOTE)OIdentifies a group of UEs (i.e. internal group ID or external group ID)
Security credentialsMSecurity credentials of the EAS
Notification Target AddressMNotification Target Address of the EAS where the notification is to be sent by the EES
Event reporting informationO Event Reporting Information as specified in Table 4.15.1-1 of TS 23.502, e.g. event reporting mode.
Proposed expiration timeOProposed expiration time for the subscription
Location GranularityOindicates format of location e.g. GPS Coordinates, Cell ID, Tracking Area ID, or civic addresses (e.g. streets, districts, etc.) that can be understood by the EAS
Location QoSOIndicate the location quality of service as described in clause 4.1b of TS 23.273.
NOTE:
Either UE ID or UE Group ID shall be provided.
Up
8.6.2.3.5  UE location subscribe responseWord‑p. 86
Information element Status Description
Successful responseOIndicates that the subscription request was successful.
> Subscription IDMSubscription identifier corresponding to the subscription.
> Expiration timeOIndicates the expiration time of the subscription. To maintain an active subscription, a subscription update is required before the expiration time.
Failure responseOIndicates that the subscription request failed.
> CauseOIndicates the cause of subscription request failure
Up
8.6.2.3.6  UE location notificationWord‑p. 86
Information element Status Description
Subscription IDMSubscription identifier corresponding to the subscription stored in the EES for the request
List of event notificationsMA list of event notifications for one or more UEs.
> UE IDMThe identifier of each UE (i.e. GPSI or identity token)
> UE locationMLocation of the UE
> TimestampOIndicates the age of the location information
> Location accuracyOIndicates accuracy of the location information
> Location typeMIndicates whether it is a predictive or actual UE location change.
Up
8.6.2.3.7  UE location subscription update requestWord‑p. 86
Information element Status Description
Subscription IDMSubscription identifier corresponding to the subscription to be updated
Security credentialsMSecurity credentials of the EAS
Event reporting information (NOTE)O Event Reporting Information as specified in Table 4.15.1-1 of TS 23.502, e.g. event reporting mode.
Proposed expiration time (NOTE)OProposed expiration time for the subscription
Notification Target Address (NOTE)ONotification Target Address of the EAS where the notification is to be sent by the EES
Location Granularity (NOTE)Oindicates format of location e.g. GPS Coordinates, Cell ID, Tracking Area ID, or civic addresses (e.g. streets, districts, etc.) that can be understood by the EAS
Location QoS (NOTE)OIndicate the location quality of service as described in clause 4.1b of TS 23.273.
NOTE:
At least one of these IEs is present.
Up
8.6.2.3.8  UE location subscription update responseWord‑p. 86
Information element Status Description
Successful responseOIndicates that the subscription request was successful.
> Expiration timeOIndicates the expiration time of the subscription. To maintain an active subscription, a subscription update is required before the expiration time.
Failure responseOIndicates that the subscription request failed.
> CauseOIndicates the cause of subscription request failure
Up
8.6.2.3.9  UE location unsubscribe requestWord‑p. 87
Information element Status Description
Subscription IDMSubscription identifier corresponding to the subscription stored in the EES for the request
Security credentialsMSecurity credentials of the EAS
Up
8.6.2.3.10  UE location unsubscribe responseWord‑p. 87
Information element Status Description
Successful responseOIndicates that the unsubscribe request was successful.
Failure responseOIndicates that the unsubscribe request failed.
> CauseOIndicates the cause of unsubscribe request failure
Up

8.6.2.4  APIsWord‑p. 87

8.6.2.4.1  GeneralWord‑p. 87
Table 8.6.2.4.1-1 illustrates the API for UE location.
API Name API Operations Operation Semantics Consumer(s)
Eees_UELocationGetRequest/ResponseEAS
SubscribeSubscribe/NotifyEAS
Notify
UpdateSubscription
Unsubscribe
Up
8.6.2.4.2  Eees_UELocation_Get operationWord‑p. 87
API operation name:
Eees_UELocation_Get
Description:
The consumer requests one time report of a UE's location.
Inputs:
Outputs:
See clause 8.6.2.2.2 for details of usage of this operation.
8.6.2.4.3  Eees_UELocation_Subscribe operationWord‑p. 87
API operation name:
Eees_UELocation_Subscribe
Description:
The consumer subscribes for continuous reporting of a UE's location.
Inputs:
Outputs:
See clause 8.6.2.2.3.2 for details of usage of this operation.
8.6.2.4.4  Eees_UELocation_Notify operationWord‑p. 88
API operation name:
Eees_UELocation_Notify
Description:
The consumer is notified with report of the UE's location.
Inputs:
Outputs:
None.
See clause 8.6.2.2.3.3 for details of usage of this operation.
8.6.2.4.5  Eees_UELocation_UpdateSubscription operationWord‑p. 88
API operation name:
Eees_UELocation_UpdateSubscription
Description:
The consumer updates an existing subscription for continuous reporting of a UE's location.
Inputs:
Outputs:
See clause 8.6.2.2.3.4 for details of usage of this operation.
8.6.2.4.6  Eees_UELocation_Unsubscribe operationWord‑p. 88
API operation name:
Eees_UELocation_Unsubscribe
Description:
The consumer cancels an existing subscription for continuous reporting of a UE's location.
Inputs:
Outputs:
See clause 8.6.2.2.3.5 for details of usage of this operation.

Up   Top   ToC