Tech-
invite
3GPP
space
IETF
RFCs
SIP
Quick
21
22
23
24
25
26
27
28
29
31
32
33
34
35
36
37
38
4‑5x
Content for
TS 29.572
Word version: 17.6.0
1…
5…
5
Services Offered by the LMF
5.1
Introduction
5.2
Nlmf_Location Service
5.3
Nlmf_Broadcast Service
6
API Definitions
6.1
Nlmf_Location Service API
6.2
Nlmf_Broadcast Service API
A
OpenAPI specification
$
Change history
5
Services Offered by the LMF
p. 10
5.1
Introduction
p. 10
5.2
Nlmf_Location Service
p. 10
5.2.1
Service Description
p. 10
5.2.2
Service Operations
p. 11
5.2.2.1
Introduction
p. 11
5.2.2.2
DetermineLocation
p. 11
5.2.2.2.1
General
p. 11
5.2.2.2.2
Retrieve UE Location
p. 11
5.2.2.2.3
Retrieve UE Location for 5G-MO-LR
|R16|
p. 12
5.2.2.3
EventNotify
|R16|
p. 12
5.2.2.3.1
General
p. 12
5.2.2.3.2
Periodic or Triggered Event Notification
p. 12
5.2.2.4
CancelLocation
|R16|
p. 13
5.2.2.4.1
General
p. 13
5.2.2.4.2
Cancel Periodic or Triggered Location
p. 13
5.2.2.5
LocationContextTransfer
|R16|
p. 14
5.2.2.5.1
General
p. 14
5.2.2.5.2
Transfer Location Context
p. 14
5.3
Nlmf_Broadcast Service
|R16|
p. 15
5.3.1
Service Description
p. 15
5.3.2
Service Operations
p. 15
5.3.2.1
Introduction
p. 15
5.3.2.2
CipheringKeyData
p. 15
5.3.2.2.1
General
p. 15
5.3.2.2.2
Request Ciphering Key Information
p. 15
5.3.2.2.3
Provide Ciphering Key Information
p. 16
6
API Definitions
p. 16
6.1
Nlmf_Location Service API
p. 16
6.1.1
API URI
p. 16
6.1.2
Usage of HTTP
p. 17
6.1.2.1
General
p. 17
6.1.2.2
HTTP Standard Headers
p. 17
6.1.2.2.1
General
p. 17
6.1.2.2.2
Content type
p. 17
6.1.2.3
HTTP custom headers
p. 17
6.1.2.3.1
General
p. 17
6.1.2.4
HTTP multipart messages
|R16|
p. 18
6.1.3
Resources
p. 18
6.1.3.1
Overview
p. 18
6.1.4
Custom Operations without associated resources
p. 19
6.1.4.1
Overview
p. 19
6.1.4.2
Operation: determine-location
p. 19
6.1.4.2.1
Description
p. 19
6.1.4.2.2
Operation Definition
p. 19
6.1.4.3
Operation: cancel-location
|R16|
p. 21
6.1.4.3.1
Description
p. 21
6.1.4.3.2
Operation Definition
p. 21
6.1.4.4
Operation: location-context-transfer
|R16|
p. 22
6.1.4.4.1
Description
p. 22
6.1.4.4.2
Operation Definition
p. 22
6.1.5
Notifications
p. 23
6.1.5.1
EventNotify
|R16|
p. 24
6.1.5.1.1
Description
p. 24
6.1.5.1.2
Notification Definition
p. 24
6.1.5.1.3
Notification Standard Methods
p. 24
6.1.6
Data Model
p. 25
6.1.6.1
General
p. 25
6.1.6.2
Structured data types
p. 28
6.1.6.2.1
Introduction
p. 28
6.1.6.2.2
Type: InputData
p. 29
6.1.6.2.3
Type: LocationData
p. 31
6.1.6.2.4
Type: GeographicalCoordinates
p. 32
6.1.6.2.5
Type: GeographicArea
p. 33
6.1.6.2.6
Type: Point
p. 33
6.1.6.2.7
Type: PointUncertaintyCircle
p. 33
6.1.6.2.8
Type: PointUncertaintyEllipse
p. 34
6.1.6.2.9
Type: Polygon
p. 34
6.1.6.2.10
Type: PointAltitude
p. 34
6.1.6.2.11
Type: PointAltitudeUncertainty
p. 34
6.1.6.2.12
Type: EllipsoidArc
p. 35
6.1.6.2.13
Type: LocationQoS
p. 35
6.1.6.2.14
Type: CivicAddress
p. 36
6.1.6.2.15
Type: PositioningMethodAndUsage
p. 37
6.1.6.2.16
Type: GnssPositioningMethodAndUsage
p. 38
6.1.6.2.17
Type: VelocityEstimate
p. 38
6.1.6.2.18
Type: HorizontalVelocity
p. 38
6.1.6.2.19
Type: HorizontalWithVerticalVelocity
p. 38
6.1.6.2.20
Type: HorizontalVelocityWithUncertainty
p. 39
6.1.6.2.21
Type: HorizontalWithVerticalVelocityAndUncertainty
p. 39
6.1.6.2.22
Type: UncertaintyEllipse
p. 39
6.1.6.2.23
Type: UeLcsCapability
p. 39
6.1.6.2.24
Type: PeriodicEventInfo
|R16|
p. 40
6.1.6.2.25
Type: AreaEventInfo
|R16|
p. 40
6.1.6.2.26
Type: ReportingArea
|R16|
p. 40
6.1.6.2.27
Type: MotionEventInfo
|R16|
p. 41
6.1.6.2.28
Void
6.1.6.2.29
Type: CancelLocData
|R16|
p. 41
6.1.6.2.30
Type: LocContextData
|R16|
p. 42
6.1.6.2.31
Type: EventReportMessage
|R16|
p. 42
6.1.6.2.32
Type: EventReportingStatus
|R16|
p. 43
6.1.6.2.33
Type: UELocationInfo
|R16|
p. 43
6.1.6.2.34
Type: EventNotifyData
|R16|
p. 44
6.1.6.2.35
Type: UeConnectivityState
|R16|
p. 45
6.1.6.2.36
Type: LocalOrigin
|R17|
p. 45
6.1.6.2.37
Type: RelativeCartesianLocation
|R17|
p. 45
6.1.6.2.38
Type: Local2dPointUncertaintyEllipse
|R17|
p. 46
6.1.6.2.39
Type: Local3dPointUncertaintyEllipsoid
|R17|
p. 46
6.1.6.2.40
Type: UncertaintyEllipsoid
|R17|
p. 46
6.1.6.2.41
Type: LocalArea
|R17|
p. 47
6.1.6.2.42
Type: UeAreaIndication
|R17|
p. 47
6.1.6.2.43
Type: MinorLocationQoS
|R17|
p. 47
6.1.6.3
Simple data types and enumerations
p. 47
6.1.6.3.1
Introduction
p. 47
6.1.6.3.2
Simple data types
p. 47
6.1.6.3.3
Enumeration: ExternalClientType
p. 49
6.1.6.3.4
Enumeration: SupportedGADShapes
p. 49
6.1.6.3.5
Enumeration: ResponseTime
p. 49
6.1.6.3.6
Enumeration: PositioningMethod
p. 50
6.1.6.3.7
Enumeration: PositioningMode
p. 50
6.1.6.3.8
Enumeration: GnssId
p. 51
6.1.6.3.9
Enumeration: Usage
p. 51
6.1.6.3.10
Enumeration: LcsPriority
p. 51
6.1.6.3.11
Enumeration: VelocityRequested
p. 51
6.1.6.3.12
Enumeration: AccuracyFulfilmentIndicator
p. 52
6.1.6.3.13
Enumeration: VerticalDirection
p. 52
6.1.6.3.14
Enumeration: LdrType
|R16|
p. 52
6.1.6.3.15
Enumeration: ReportingAreaType
|R16|
p. 52
6.1.6.3.16
Enumeration: OccurrenceInfo
|R16|
p. 52
6.1.6.3.17
Enumeration: ReportingAccessType
|R16|
p. 53
6.1.6.3.18
Enumeration: EventClass
|R16|
p. 53
6.1.6.3.19
Enumeration: ReportedEventType
|R16|
p. 53
6.1.6.3.20
Enumeration: TerminationCause
|R16|
p. 53
6.1.6.3.21
Enumeration: LcsQosClass
|R16|
p. 54
6.1.6.3.22
Enumeration: UeLocationServiceInd
|R16|
p. 54
6.1.6.4
Binary data
|R16|
p. 54
6.1.6.4.1
Introduction
p. 54
6.1.6.4.2
LPP Message
p. 54
6.1.7
Error Handling
p. 54
6.1.7.1
General
p. 54
6.1.7.2
Protocol Errors
p. 54
6.1.7.3
Application Errors
p. 54
6.1.8
Security
p. 55
6.1.9
Feature Negotiation
|R16|
p. 55
6.1.10
HTTP redirection
|R16|
p. 56
6.2
Nlmf_Broadcast Service API
|R16|
p. 56
6.2.1
API URI
p. 56
6.2.2
Usage of HTTP
p. 56
6.2.2.1
General
p. 56
6.2.2.2
HTTP Standard Headers
p. 56
6.2.2.2.1
General
p. 56
6.2.2.2.2
Content type
p. 56
6.2.2.3
HTTP custom headers
p. 57
6.2.2.3.1
General
p. 57
6.2.3
Resources
p. 57
6.2.3.1
Overview
p. 57
6.2.4
Custom Operations without associated resources
p. 57
6.2.4.1
Overview
p. 57
6.2.4.4
Operation: cipher-key-data
p. 57
6.2.4.4.1
Description
p. 57
6.2.4.4.2
Operation Definition
p. 57
6.2.5
Notifications
p. 59
6.2.5.1
CipheringKeyData
p. 59
6.2.5.1.1
Description
p. 59
6.2.5.1.2
Notification Definition
p. 59
6.2.5.1.3
Notification Standard Methods
p. 59
6.2.6
Data Model
p. 60
6.2.6.1
General
p. 60
6.2.6.2
Structured data types
p. 61
6.2.6.2.1
Introduction
p. 61
6.2.6.2.2
Type: CipheringKeyInfo
p. 61
6.2.6.2.3
Type: CipheringKeyResponse
p. 62
6.2.6.2.4
Type: CipheringDataSet
p. 63
6.2.6.2.5
Type: CipheringSetReport
p. 66
6.2.6.2.6
Type: CipherRequestData
p. 66
6.2.6.2.7
Type: CipherResponseData
p. 66
6.2.6.3
Simple data types and enumerations
p. 66
6.2.6.3.1
Introduction
p. 66
6.2.6.3.2
Simple data types
p. 66
6.2.6.3.3
Enumeration: StorageOutcome
p. 67
6.2.6.3.4
Enumeration: DataAvailability
p. 67
6.2.7
Error Handling
p. 67
6.2.7.1
General
p. 67
6.2.7.2
Protocol Errors
p. 67
6.2.7.3
Application Errors
p. 67
6.2.8
Security
p. 68
6.2.9
Feature Negotiation
p. 68
6.2.10
HTTP redirection
p. 68
A
(Normative) OpenAPI specification
p. 69
A.1
General
p. 69
A.2
Nlmf_Location API
p. 69
A.3
Nlmf_Broadcast API
|R16|
p. 89
$
Change history
p. 93