SUPL Network Initiation APIChanges in SUPL Network Initiation API
Changes in SUPL Network Initiation API PurposeSecure User Plane Location (SUPL) defines how the location related information is transferred and how already existing control plane positioning protocols can be tunneled over the user plane between terminal and network server. The network sends SUPL initiation message to the terminal to start the SUPL Session either as SMS or as WAP push message. The purpose of SUPL Network Initiation API is to enable client running in the terminal to forward these SUPL initiation messages received from the network to the SUPL server. API descriptionThe client uses SUPL Network Initiation API to forward the SUPL initiation messages received from the network. SUPL Network Initiation API is a Virtual Machine API abstracting the client-server communication from the client. SUPL Network Initiation API belongs to domain API category. The only class of SUPL Network Initiation API is server class. The server class is used by client applications for connecting to SUPL server, to forward message to SUPL server and to close connection to SUPL server. Use casesThe main use case of SUPL Network Initiation API is as follows:
All methods in SUPL Network Initiation API are synchronous calls. API class structureThe only class of SUPL Network Initiation API is
Following diagram presents the class hierarchy and methods in
Related APIs
Using SUPL Network Initiation APIClient application using SUPL Network Initiation API must have CommDD capability to use all methods. Using SUPL Network Initiation API always contains the following steps:
It is recommended that the client should close the connection to SUPL Server when it is no longer required. Forwarding SUPL initiation message to SUPL ServerSUPL Network Initiation client establishes a connection to SUPL Server before forwarding SUPL initiation message. After forwarding message is completed, the client can close the connection to SUPL Server. The following diagram illustrates the steps involved in forwarding a message using SUPL Network Initiation API.
The following code snippets illustrates how to forward the message to SUPL Server. Error handlingSUPL Network Initiation API uses the standard error reporting mechanism. In case of an irrecoverable error, panics are used. Otherwise, functions return error codes as their return values. SUPL Network Initiation API uses standard system error codes and certain panic codes defined in SUPL Network Initiation API. These can be found in the epos_suplnetworkerrors.h file. Memory overheadWhen using SUPL Network Initiation API, the memory overhead is dependent on the amount of instantiated classes but there are also some cases when extra memory usage can be involved. Nevertheless, the memory usage is always controlled by the client application and there are never any uncontrolled allocations of large amounts of memory that the client cannot prevent or avoid. In all cases the amount of memory is defined by the client and thus cannot be exactly predicted. The number of simultaneous connections also has an impact on the overall memory usage. For this reason, unnecessary connections should be avoided.
Related APIs
GlossaryAbbreviationsAbbreviations
DefinitionsDefinitions
ReferencesReferences
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. License: EPL
|