18 The client application is configured to use the Network Proxy PSY. However, |
18 The client application is configured to use the Network Proxy PSY. However, |
19 when a request is made the network is unable to produce the position. Instead |
19 when a request is made the network is unable to produce the position. Instead |
20 of the attempt failing completely the Location subsystem produces a fallback |
20 of the attempt failing completely the Location subsystem produces a fallback |
21 cell-based position.</p> <p>The process is described in the steps below.</p> |
21 cell-based position.</p> <p>The process is described in the steps below.</p> |
22 </context> |
22 </context> |
23 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2"> |
23 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2"> |
24 <step id="GUID-AEDA448D-E436-4B3F-BEF1-BAC739E389AC"><cmd>The client must |
24 <step id="GUID-AEDA448D-E436-4B3F-BEF1-BAC739E389AC"><cmd>The client must |
25 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> |
25 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> |
26 </step> |
26 </step> |
27 <step id="GUID-7E093F3A-3F22-4D9C-9218-1643900D99A5"><cmd>The client must |
27 <step id="GUID-7E093F3A-3F22-4D9C-9218-1643900D99A5"><cmd>The client must |
28 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 |
28 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 |
29 specify the UID of the Network Proxy PSY.</cmd> |
29 specify the UID of the Network Proxy PSY.</cmd> |
30 </step> |
30 </step> |
31 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-3"><cmd>The client application |
31 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-3"><cmd>The client application |
32 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> |
32 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> |
33 </step> |
33 </step> |
34 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-4"><cmd>The Location subsystem |
34 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-4"><cmd>The Location subsystem |
35 forwards the location request to the Control Plane 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> (if Control Plane is the default in the default configuration).</cmd> |
35 forwards the location request to the Control Plane 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> (if Control Plane is the default in the default configuration).</cmd> |
36 </step> |
36 </step> |
37 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-5"><cmd>The Control Plane |
37 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-5"><cmd>The Control Plane |
38 protocol module communicates with the cellular network but the network is |
38 protocol module communicates with the cellular network but the network is |
39 unable to provide a cell-based location. </cmd> |
39 unable to provide a cell-based location. </cmd> |
40 </step> |
40 </step> |
41 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-6"><cmd>The Control Protocol |
41 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-6"><cmd>The Control Protocol |
42 Module completes the session by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-ACBFB09B-D4D1-36A0-A9D6-FD3207E93E30"><apiname>MLbsNetworkProtocolObserver::ProcessSessionComplete()</apiname></xref>.</cmd> |
42 Module completes the session by calling <xref href="GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4.dita#GUID-A97ABAA7-46B0-3E26-97C6-123C92CCEEE4/GUID-ACBFB09B-D4D1-36A0-A9D6-FD3207E93E30"><apiname>MLbsNetworkProtocolObserver::ProcessSessionComplete()</apiname></xref>.</cmd> |
43 </step> |
43 </step> |
44 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-7"><cmd>The Location subsystem |
44 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-7"><cmd>The Location subsystem |
45 fallbacks to SUPL positioning and forwards the request to the SUPL Protocol |
45 fallbacks to SUPL positioning and forwards the request to the SUPL Protocol |
46 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>. |
46 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>. |
47 (In the default configuration SUPL is used for cell-based positioning).</cmd> |
47 (In the default configuration SUPL is used for cell-based positioning).</cmd> |
48 </step> |
48 </step> |
49 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-8"><cmd>The SUPL Protocol |
49 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-8"><cmd>The SUPL Protocol |
50 module communicates with an external SUPL server and obtains a cell-based |
50 module communicates with an external SUPL server and obtains a cell-based |
51 location. </cmd> |
51 location. </cmd> |
52 </step> |
52 </step> |
53 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-18-1-1-9-1-6-1-11-1-3-2-9"><cmd>The SUPL Protocol |
53 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-19-1-1-9-1-6-1-11-1-3-2-9"><cmd>The SUPL Protocol |
54 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> |
54 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> |
55 </step> |
55 </step> |
56 <step id="GUID-D17075FA-847E-4489-84CB-7EB94554B051"><cmd>The Location subsystem |
56 <step id="GUID-D17075FA-847E-4489-84CB-7EB94554B051"><cmd>The Location subsystem |
57 completes the client request.</cmd> |
57 completes the client request.</cmd> |
58 </step> |
58 </step> |