8 Network Function Services
23.2733GPP5G System (5GS) Location Services (LCS)Release 18Stage 2TS
8.1 AMF Services
AMF services related to location service are defined in clause 5.2.2 of TS 23.502 [19].
8.2 UDM Services
UDM services related to location service are defined in clause 5.2.3 of TS 23.502 [19].
8.3 LMF Services
8.3.1 General
The following table shows the LMF Services and LMF Service Operations.
Table 8.3.1-1: List of LMF Services
|
Service Name |
Service Operations |
Operation Semantics |
Example Consumer(s) |
|
Nlmf_Location |
DetermineLocation |
Request/Response |
AMF |
|
EventNotify |
Notify |
GMLC |
|
|
CancelLocation |
Request/Response |
AMF |
|
|
LocationContextTransfer |
Request/Response |
LMF |
|
|
Nlmf_Broadcast |
CipheringKeyData |
Notify |
AMF |
8.3.2 Nlmf_Location service
8.3.2.1 General
Service description: This service enables an NF to request location determination for a target UE. The following are the key functionalities of this NF service.
– Allow the consumer NF to request the current geodetic and optionally local and/or civic location of a target UE.
– Allow the consumer NF to subscribe/unsubscribe the geodetic and optionally local and/or civic location of a target UE for some certain events.
– Allow the consumer NF to get notified about the geodetic and optionally local and/or civic location of a target UE when some certain events are detected.
– Allows the consumer NF to cancel location event reporting for a target UE.
– Allows the consumer NF to transfer location context information for location event reporting for a target UE.
The events to trigger location estimation notification are defined in clause 4.1a.5.1
8.3.2.2 Nlmf_Location_DetermineLocation service operation
Service operation name: Nlmf_Location_DetermineLocation
Description: Provides UE location information to the consumer NF.
NOTE: For deferred location request, this service operation is used to implicitly subscribe to the notification of the UE location information.
Input, Required: Client Type, LCS Correlation Identifier.
Input, Optional: Serving cell identifierof the Primary Cell in the Master RAN node and the Primary Cell in the Secondary RAN node when available based on Dual Connectivity scenarios if the UE is using 3GPP access, required Location QoS instance(s), Supported GAD shapes, service type, indication of requiring reliable UE location information, AMF identity if a UE associated Namf_Communication service is to be invoked by LMF, Type of request for a 5GC-MO-LR, Embedded LPP message(s) for a 5GC-MO-LR (1-3 messages), subscribed assistance data for a 5GC-MO-LR, Deferred location type, Deferred location parameters, indication if UE supports LPP or not, UE connectivity state per access type, Notification Target Address, Notification Correlation ID, indication of UE geographical area determination for PLMN selection verification, UE Positioning Capability, TNAPId (see TS 29.571 [33]), TWAPId (see TS 29.571 [33]), Scheduled Location Time, request for user plane reporting to an LCS Client or AF, user plane address of an LCS Client or AF, user plane security information for an LCS Client or AF, cumulative event report timer, maximum number of user plane event reports to an LCS Client or AF.
Output, Required: Success/Failure indication
Output, Optional: Geodetic Location, Local Location including Coordinate ID, Civic Location, Position Methods Used (in the case of success indication provided), Serving LMF identification, Failure Cause (in the case of failure indication provided), achieved Location QoS Accuracy, UE geographical area where a PLMN is or is not allowed to operate, UE Positioning Capability, the timestamp of the Location.
See clause 6.1, clause 6.2. clause 6.3.1 and clause 6.9.1 for examples of usage of this service operation.
8.3.2.3 Nlmf_Location_EventNotify service operation
Service operation name: Nlmf_Location_EventNotify.
Service operation description: Allow the consumer NF to get notified about the geodetic and optionally local and/or civic location of a target UE when some certain events are detected, either the events implicitly subscribed by the AMF using Nlmf_Location_DetermineLocation service operation or the cancellation of reporting of periodic or triggered location events.
Input, Required: Notification Correlation ID, UE (SUPI and if available GPSI), Type of event.
Input, Optional: Geodetic Location, Local Location including Coordinate ID, Civic Location, Position Methods Used (in the case of success indication provided), Notification Target address, Serving LMF identification, Failure Cause (in the case of failure indication provided), achieved Location QoS Accuracy, the timestamp of the Location.
Output, Required: None.
Output, Optional: Success/Failure indication.
See clause 6.3.1 and clause 6.3.2 for examples of usage of this service operation.
8.3.2.4 Nlmf_Location_CancelLocation service operation
Service operation name: Nlmf_Location_CancelLocation
Description: The consumer NF cancels a deferred 5GC-MT-LR procedure for periodic or triggered location request.
Input, Required: Notification Target Address, Notification Correlation ID.
Input, Optional: None.
Output, Required: Success/Failure indication
Output, Optional: None.
See clause 6.3.3 for an example of usage of this service operation.
8.3.2.5 Nlmf_Location_LocationContextTransfer service operation
Service operation name: Nlmf_Location_LocationContextTransfer
Description: Transfers location context information for location event reporting for a target UE from the consumer NF.
Input, Required: AMF identity, Location QoS, Supported GAD shapes, Deferred location type, Deferred location parameters, Notification Target Address, Notification Correlation ID, Embedded event report message.
Input, Optional: Event reporting status, UE location information, UE Positioning Capabilities, Scheduled Location Time, the timestamp of the Location, request for user plane reporting to an LCS Client or AF, cumulative event report timer, maximum number of user plane event reports to an LCS Client or AF.
Output, Required: Success/Failure indication
Output, Optional: None.
See clause 6.4 for an example of usage of this service operation.
8.3.3 Nlmf_Broadcast service
8.3.3.1 General
Service description: This service enables an NF to receive information related to broadcast of location assistance by an LMF. The following are the key functionalities of this NF service.
– Allow the consumer NF to be notified about ciphering keys used to cipher broadcast assistance data.
The events to trigger ciphering key notification are defined in clause 6.14.2.
8.3.3.2 Nlmf_Broadcast_CipheringKeyData service operation
Service operation name: Nlmf_Broadcast_CipheringKeyData
Description: Provides ciphering key data to the consumer NF.
Input, Required: For each ciphering key: ciphering key value, ciphering key identifier, validity period, set of applicable types of broadcast assistance data.
Input, Optional: For each ciphering key: set of applicable tracking areas.
Output, Required: For each ciphering key: ciphering key identifier, success/failure indication.
Output, Optional: none.
See clause 6.14.2 for an example of usage of this service operation.
8.4 GMLC Services
8.4.1 General
The following table shows the GMLC Services and GMLC Service Operations.
Table 8.4.1-1: List of GMLC Services
|
Service Name |
Service Operations |
Operation Semantics |
Example Consumer(s) |
|
Ngmlc_Location |
ProvideLocation |
Request / Response |
GMLC, NEF |
|
LocationUpdate |
Request / Response |
AMF, GMLC |
|
|
LocationUpdateNotify |
Notify |
NEF |
|
|
CancellLocation |
Request / Response |
GMLC, NEF |
|
|
EventNotify |
Notify |
GMLC, NEF |
8.4.2 Ngmlc_Location service
8.4.2.1 General
Service description: This service enables an NF to request location determination for a target UE. The following are the key functionalities of this NF service.
– Allow the consumer NF to request the current geodetic and optionally local and/or civic location of a target UE.
– Allow the consumer NF to subscribe/unsubscribe the geodetic and optionally local and/or civic location of a target UE for some certain events.
– Allow the consumer NF to cancel an on-going periodic or triggered location request of a target UE.
– Allow the consumer NF to get notified about the geodetic and optionally local and/or civic location of a target UE when some certain events are detected.
8.4.2.2 Ngmlc_Location_ProvideLocation service operation
Service operation name: Ngmlc_Location_ProvideLocation
Description: Provides UE location information to the consumer NF.
NOTE 1: For deferred location request, this service operation is used to implicitly subscribe to the notification of the UE location information.
NOTE 2: For bulk LCS service request from NEF to GMLC, this service operation is used to implicitly subscribe to the notification of UE location information
Input, Required: UE identifier (GPSI, SUPI, Internal Group Identifier or External Group Identifier), Client Type.
Input, Optional: Required QoS instance(s), Supported GAD shapes, UE privacy requirements, LCS Client Identification, Service type, indication of requiring reliable UE location information, Notification Target Address, Notification Correlation ID, Event Type (defined in clause 4.1a.5.1), Scheduled Location Time, request for user plane reporting to an LCS Client or AF, user plane address of an LCS Client or AF, user plane security information for an LCS Client or AF, cumulative event report timer, maximum number of user plane event reports to an LCS Client or AF and:
– For periodic event type, optional input further includes the time interval between successive location reports, the total number of reports, location QoS.
– For area event type, optional input further includes target geographical area(s) with optionally associated required QoS instance, whether the event to be reported is the UE being inside, entering into or leaving the target area, the duration of event reporting, the minimum and maximum time intervals between successive event reports, the maximum event sampling interval, whether location estimates and associated location QoS shall be included in event reports, and whether only one location report is required or more than one.
– For motion event type, optional input further includes the threshold linear distance, the duration of event reporting, the minimum and maximum time intervals between successive event reports, the maximum event sampling interval, whether location estimates and associated location QoS shall be included in event reports, and whether only one location report is required or more than one.
Output, Required: Success/Failure indication
Output, Optional: Geodetic location, Local Location including Coordinate ID, civic location, age of location, position methods used (in the case of success indication provided), failure cause (in the case of failure indication provided), achieved Location QoS Accuracy, the timestamp of the Location.
See clauses 6.3.1 and 6.8 for examples of usage of this service operation.
8.4.2.3 Ngmlc_Location_LocationUpdate service operation
Service operation name: Ngmlc_Location_LocationUpdate
Description: Consumer NF provides UE location information to the GMLC.
Input, Required: UE identifier (GPSI or SUPI), event causing the location estimate (5GC-MO-LR), location estimate, age of location estimate, accuracy indication, LCS QoS class.
Input, Optional: pseudonym indicator, identity of the LCS client, identity of the AF, GMLC address, service type specified by UE, the timestamp of the location estimate.
Output, Required: Success/Failure indication
Output, Optional: Failure Cause (in the case of failure indication provided).
See clause 6.2 for example of usage of this service operation.
8.4.2.4 Ngmlc_Location_EventNotify service operation
Service operation name: Ngmlc_Location_EventNotify
Description: Allow the consumer NF to get notified about the geodetic and optionally local and/or civic location of one or more target UEs when some certain events, either the events implicitly subscribed by the AMF using Ngmlc_Location_ProvideLocation service operation, or the cancellation of reporting of periodic or triggered location events, are detected or at bulk reporting of location.
Input, Required: Notification Correlation ID, UE (SUPI and if available GPSI), Type of location related event (e.g. deferred location for the UE available event, activation of location for periodic or triggered location, mobility of a target UE to a new AMF or MME for a deferred location).
Input, Optional: Geodetic Location, Local Location including Coordinate ID, Civic Location, Position Methods Used (in the case of success indication provided), Failure Cause (in the case of failure indication provided), address of a new AMF or MME, achieved Location QoS Accuracy, the timestamp of the Location.
Output, Required: None.
Output, Optional: None.
See clauses 6.3 and 6.8 for examples of usage of this service operation.
8.4.2.5 Ngmlc_Location_CancelLocation service operation
Service operation name: Ngmlc_Location_CancelLocation
Description: The consumer NF uses this service operation to cancel a deferred 5GC-MT-LR procedure for periodic or triggered location.
Input, Required: UE Identification (SUPI), Notification Target address, Notification Correlation ID.
Input, Optional: None.
Output, Required: None.
Output, Optional: None.
See clause 6.3.3 for example of usage of this service operation.
8.4.2.6 Ngmlc_Location_LocationUpdateNotify service operation
Service operation name: Ngmlc_Location_LocationUpdateNotify
Description: Provides UE location information to the consumer NF.
Input, Required: UE identifier (GPSI or SUPI), identity of the AF, event causing the location estimate (5GC-MO-LR), location estimate, age of location estimate, accuracy indication, LCS QoS class.
Input, Optional: Service identity (mapped from service type by HGMLC), the timestamp of the location estimate.
Output, Required: Success/Failure indication.
Output, Optional: Failure Cause (in the case of failure indication provided).
See clause 6.2 for example of usage of this service operation.
8.5 NEF Services
For 5GC-MT-LR procedures, location reporting is one of the monitoring events, as defined in clause 4.15.3.1 of TS 23.502 [19], supported by Nnef_EventExposure service.
Nnef_EventExposure service operations are defined in clause 5.2.6.2 of TS 23.502 [19].
The attributes that may be included in the location service request and response are listed in clause 5.5.
For 5GC-MO-LR procedure, if UE requests to report its location to AF, the location reporting is supported by Nnef_Location_LocationUpdateNotify service operation defined in clause 5.2.6.21 of TS 23.502 [19].
8.6 UDR Services
UDR services related to location service are defined in clause 5.2.3 of TS 23.502 [19].
Annex A (informative):
Differences with TS 23.271 [4]