18 on two plug-ins: the SUPL Proxy Protocol module and the SUPL Positioning Message |
18 on two plug-ins: the SUPL Proxy Protocol module and the SUPL Positioning Message |
19 interface. The relationship between the Location subsystem and SUPL is illustrated |
19 interface. The relationship between the Location subsystem and SUPL is illustrated |
20 below. The plug-ins enable information to pass from the network directly to |
20 below. The plug-ins enable information to pass from the network directly to |
21 the GPS hardware.</p><fig id="GUID-7F00AED7-1CF7-456E-A24E-A494E4C43ED9"> |
21 the GPS hardware.</p><fig id="GUID-7F00AED7-1CF7-456E-A24E-A494E4C43ED9"> |
22 <title>Location subsystem and SUPL extension</title> |
22 <title>Location subsystem and SUPL extension</title> |
23 <image href="GUID-1D58231A-7DDF-46DB-B5A6-7A326BD954F3_d0e455588_href.png" placement="inline"/> |
23 <image href="GUID-1D58231A-7DDF-46DB-B5A6-7A326BD954F3_d0e461433_href.png" placement="inline"/> |
24 </fig> <p>If a client application wants to obtain a position without waiting |
24 </fig> <p>If a client application wants to obtain a position without waiting |
25 for a GPS service a mobile network can provide a cell-based position, using |
25 for a GPS service a mobile network can provide a cell-based position, using |
26 SUPL. </p> <p>A cell-based positioning request using SUPL is shown in the |
26 SUPL. </p> <p>A cell-based positioning request using SUPL is shown in the |
27 following steps.</p> </context> |
27 following steps.</p> </context> |
28 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-18-1-1-9-1-6-1-10-1-3-2"> |
28 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-19-1-1-9-1-6-1-10-1-3-2"> |
29 <step id="GUID-E0BA1F47-0751-479D-B341-06C4FAB15A03"><cmd>The client must |
29 <step id="GUID-E0BA1F47-0751-479D-B341-06C4FAB15A03"><cmd>The client must |
30 open RPositionServer and 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 open RPositionServer and 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> |
31 </step> |
31 </step> |
32 <step id="GUID-B3CB8376-2620-4A86-9FD6-92E611146629"><cmd>The client must |
32 <step id="GUID-B3CB8376-2620-4A86-9FD6-92E611146629"><cmd>The client must |
33 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 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 |
34 specify the UID of the Network Proxy PSY.</cmd> |
34 specify the UID of the Network Proxy PSY.</cmd> |
35 </step> |
35 </step> |
36 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-18-1-1-9-1-6-1-10-1-3-2-3"><cmd>The client application |
36 <step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-19-1-1-9-1-6-1-10-1-3-2-3"><cmd>The client application |
37 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 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> |
38 </step> |
38 </step> |
39 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-18-1-1-9-1-6-1-10-1-3-2-4"><cmd>The Location subsystem |
39 <step id="GUID-FD076E9C-8A18-4692-920E-D3CAFD64A262-GENID-1-12-1-19-1-1-9-1-6-1-10-1-3-2-4"><cmd>The Location subsystem |
40 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 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>. |
41 (In the default configuration SUPL is used for cell-based positioning).</cmd> |
41 (In the default configuration SUPL is used for cell-based positioning).</cmd> |
42 </step> |
42 </step> |
43 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-18-1-1-9-1-6-1-10-1-3-2-5"><cmd>The SUPL protocol |
43 <step id="GUID-C91844EA-4E31-4EAD-981F-6C83EBDD3D67-GENID-1-12-1-19-1-1-9-1-6-1-10-1-3-2-5"><cmd>The SUPL protocol |
44 module communicates with an external SUPL server and obtains a cell-based |
44 module communicates with an external SUPL server and obtains a cell-based |
45 location. </cmd> |
45 location. </cmd> |
46 </step> |
46 </step> |
47 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-18-1-1-9-1-6-1-10-1-3-2-6"><cmd>The SUPL Protocol |
47 <step id="GUID-C38775F8-AF05-48A0-99A5-AA0AD63055AB-GENID-1-12-1-19-1-1-9-1-6-1-10-1-3-2-6"><cmd>The SUPL Protocol |
48 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> |
48 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> |
49 </step> |
49 </step> |
50 <step id="GUID-EB292F2E-BA44-4701-A0A7-2E9A5C258568"><cmd>The Location subsystem |
50 <step id="GUID-EB292F2E-BA44-4701-A0A7-2E9A5C258568"><cmd>The Location subsystem |
51 completes the client request.</cmd> |
51 completes the client request.</cmd> |
52 </step> |
52 </step> |