Symbian3/PDK/Source/GUID-3E7FBDE5-B580-4C2D-9815-83E04B7D71E1.dita
changeset 12 80ef3a206772
parent 9 59758314f811
equal deleted inserted replaced
11:5072524fcc79 12:80ef3a206772
    22 cell-based positioning and AGPS terminal-assisted positioning, the SUPL Network
    22 cell-based positioning and AGPS terminal-assisted positioning, the SUPL Network
    23 Server may optionally use AGPS terminal-assisted positioning, though this
    23 Server may optionally use AGPS terminal-assisted positioning, though this
    24 is not usually advised.<p>With AGPS terminal-assisted positioning the client
    24 is not usually advised.<p>With AGPS terminal-assisted positioning the client
    25 application therefore requests a position from the network using an AGPS Terminal.
    25 application therefore requests a position from the network using an AGPS Terminal.
    26 The steps below describe the process.</p>     </context>
    26 The steps below describe the process.</p>     </context>
    27 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2">
    27 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2">
    28 <step id="GUID-B53B2F90-233B-42D8-A083-57DC29B6251C"><cmd>The client must
    28 <step id="GUID-B53B2F90-233B-42D8-A083-57DC29B6251C"><cmd>The client must
    29 open a connection to the server by calling <xref href="GUID-0ADC4654-7F7B-3B53-A2F9-7035670F501B.dita#GUID-0ADC4654-7F7B-3B53-A2F9-7035670F501B/GUID-23285930-A1D5-3A97-AED4-E979BFA96FDD"><apiname>RPositionServer::Connect()</apiname></xref>.</cmd>
    29 open a connection to the server by calling <xref href="GUID-0ADC4654-7F7B-3B53-A2F9-7035670F501B.dita#GUID-0ADC4654-7F7B-3B53-A2F9-7035670F501B/GUID-23285930-A1D5-3A97-AED4-E979BFA96FDD"><apiname>RPositionServer::Connect()</apiname></xref>.</cmd>
    30 </step>
    30 </step>
    31 <step id="GUID-A66E2C33-E992-4832-93BC-58ACE995A734"><cmd>The client must
    31 <step id="GUID-A66E2C33-E992-4832-93BC-58ACE995A734"><cmd>The client must
    32 then open RPositioner by calling <xref href="GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575.dita#GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575/GUID-AF3D9B5F-8025-3AFF-A101-82025520EBD6"><apiname>RPositioner::Open()</apiname></xref> and
    32 then open RPositioner by calling <xref href="GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575.dita#GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575/GUID-AF3D9B5F-8025-3AFF-A101-82025520EBD6"><apiname>RPositioner::Open()</apiname></xref> and
    33 specify the UID of the Network Proxy PSY.</cmd>
    33 specify the UID of the Network Proxy PSY.</cmd>
    34 </step>
    34 </step>
    35 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2-3"><cmd>The client application
    35 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2-3"><cmd>The client application
    36 sends a location request to the Location subsystem by calling <xref href="GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575.dita#GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575/GUID-321F6046-3551-3ACE-B0A3-26D51FAEB477"><apiname>RPositioner::NotifyPositionUpdate()</apiname></xref>.</cmd>
    36 sends a location request to the Location subsystem by calling <xref href="GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575.dita#GUID-1EAEB7EF-0AC7-37C7-B35F-C9B780FFC575/GUID-321F6046-3551-3ACE-B0A3-26D51FAEB477"><apiname>RPositioner::NotifyPositionUpdate()</apiname></xref>.</cmd>
    37 </step>
    37 </step>
    38 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2-4"><cmd>The Location subsystem
    38 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2-4"><cmd>The Location subsystem
    39 forwards the location request to the SUPL Protocol module by calling <xref href="GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5.dita#GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5/GUID-E52AC2F2-6E42-370B-93EB-48389E062E33"><apiname>CLbsNetworkProtocolBase::RequestNetworkLocation()</apiname></xref>.
    39 forwards the location request to the SUPL Protocol module by calling <xref href="GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5.dita#GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5/GUID-E52AC2F2-6E42-370B-93EB-48389E062E33"><apiname>CLbsNetworkProtocolBase::RequestNetworkLocation()</apiname></xref>.
    40 (In the default configuration SUPL is used for cell-based positioning).</cmd>
    40 (In the default configuration SUPL is used for cell-based positioning).</cmd>
    41 </step>
    41 </step>
    42 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2-5"><cmd>The SUPL protocol
    42 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2-5"><cmd>The SUPL protocol
    43 module communicates with an external SUPL server, which decides to use terminal-assisted
    43 module communicates with an external SUPL server, which decides to use terminal-assisted
    44 GPS positioning instead of cell-based positioning. </cmd>
    44 GPS positioning instead of cell-based positioning. </cmd>
    45 </step>
    45 </step>
    46 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2-6"><cmd>The SUPL Protocol
    46 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2-6"><cmd>The SUPL Protocol
    47 Module requests a measurement update from the Location subsystem by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-676C6200-0A3A-331D-9776-17CA53E8A1D7"><apiname>MLbsNetworkProtocolObserver::ProcessLocationRequest()</apiname></xref>.</cmd>
    47 Module requests a measurement update from the Location subsystem by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-676C6200-0A3A-331D-9776-17CA53E8A1D7"><apiname>MLbsNetworkProtocolObserver::ProcessLocationRequest()</apiname></xref>.</cmd>
    48 </step>
    48 </step>
    49 <step id="GUID-675B9902-D5B8-4292-8F61-6599E7E128FA"><cmd>The Location subsystem
    49 <step id="GUID-675B9902-D5B8-4292-8F61-6599E7E128FA"><cmd>The Location subsystem
    50 requests a measurement update from the AGPS module by calling <xref href="GUID-A458AA58-8BD6-303B-89E5-C99000376615.dita#GUID-A458AA58-8BD6-303B-89E5-C99000376615/GUID-C5784C56-C6BA-3D11-AFEB-D08CA8E3E083"><apiname>CLbsLocationSourceGpsBase::RequestLocationUpdate()</apiname></xref>.</cmd>
    50 requests a measurement update from the AGPS module by calling <xref href="GUID-A458AA58-8BD6-303B-89E5-C99000376615.dita#GUID-A458AA58-8BD6-303B-89E5-C99000376615/GUID-C5784C56-C6BA-3D11-AFEB-D08CA8E3E083"><apiname>CLbsLocationSourceGpsBase::RequestLocationUpdate()</apiname></xref>.</cmd>
    51 </step>
    51 </step>
    56 forwards the measurement update to the network by calling <xref href="GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5.dita#GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5/GUID-A4F669B3-52D7-32B7-A2B6-76F5C9B954E2"><apiname>CLbsNetworkProtocolBase::ProcessLocationUpdate()</apiname></xref>.</cmd>
    56 forwards the measurement update to the network by calling <xref href="GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5.dita#GUID-479C43CF-8787-3596-93ED-F03A8E5CA2F5/GUID-A4F669B3-52D7-32B7-A2B6-76F5C9B954E2"><apiname>CLbsNetworkProtocolBase::ProcessLocationUpdate()</apiname></xref>.</cmd>
    57 </step>
    57 </step>
    58 <step id="GUID-5B71C7FE-FB91-4096-9DCD-3C8053862213"><cmd>The measurement
    58 <step id="GUID-5B71C7FE-FB91-4096-9DCD-3C8053862213"><cmd>The measurement
    59 is sent to the SUPL server, which calculates and returns the position.</cmd>
    59 is sent to the SUPL server, which calculates and returns the position.</cmd>
    60 </step>
    60 </step>
    61 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-18-1-1-9-1-6-1-12-1-3-2-11"><cmd>The SUPL Protocol
    61 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-19-1-1-9-1-6-1-12-1-3-2-11"><cmd>The SUPL Protocol
    62 module returns the cell-based position by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-CAB9645E-91AD-326B-8803-45F28505CCCC"><apiname>MLbsNetworkProtocolObserver::ProcessLocationUpdate()</apiname></xref>.</cmd>
    62 module returns the cell-based position by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-CAB9645E-91AD-326B-8803-45F28505CCCC"><apiname>MLbsNetworkProtocolObserver::ProcessLocationUpdate()</apiname></xref>.</cmd>
    63 </step>
    63 </step>
    64 <step id="GUID-A0638E54-9F51-468E-9DD3-B43A0C0AAAAA"><cmd>The Location subsystem
    64 <step id="GUID-A0638E54-9F51-468E-9DD3-B43A0C0AAAAA"><cmd>The Location subsystem
    65 completes the client request.</cmd>
    65 completes the client request.</cmd>
    66 </step>
    66 </step>