Data Source Modules Overview

Purpose

The LBS subsystem requires a source of position data. The components in the Data Source Modules collection deliver position data to the LBS subsystem.

Architecture

Figure 1 shows this collection within the context of the LBS system model.

Figure 1. Figure 1. Data Source Modules collection in the LBS system model.

Description

The Data Source Modules collection contains a set of components that provide position data to the LBS subsystem.

Data Source Modules and the Location Server

A device creator's LBS subsystem must be built to include the Location Server executable: eposserver.exe. The components in the Data Source Modules collection are Positioning Plug-ins (PSYs) and can only be used with eposserver.exe. A PSY implements the Positioning Plug-in (PSY) API which can be used to develop PSYs that use any positioning technology.

Components

The Data Source Modules collection contains the following Positioning Modules:

• Simulation Positioning Module

  The Simulation Positioning Module returns simulated position fixes that are read from a data file.

  This component is useful for application developers who want to test location aware applications in an emulator. It can also be used on hardware.

• Bluetooth GPS Positioning Module

  The Bluetooth GPS Positioning Module enables the LBS subsystem to use Bluetooth GPS hardware that is external to the mobile device.

• Default Positioning Module

  The Default Positioning Module is used by the Location Server variant executable eposserver.exe to choose a Positioning Module to use when the a client application that uses the LBS Location Acquisition API does not specify a preference.

• GPS/A-GPS PSY

  The A-GPS PSY connects the Location Server to the A-GPS Location Manager. It allows the Location Server to use an A-GPS Integration Module to obtain a GPS position fix. See A-GPS Location Data Source API for information about the API that device creators use to develop an A-GPS Integration Module.

• Network PSY

  The Network PSY connects the Location Server to the Network Location Manager. It allows the Location Server to use a Network Protocol Module to obtain a cell-based position fix. See Network Protocol Module API for information about the API that device creators use to develop a Network Protocol Module.

Using the Data Source Modules collection

A Positioning Module is selected by the Location Server when a client application makes a location request.

Each Positioning Module has a UID that can be chosen when an LBS application client application opens a session using the Location Acquisition API.

For more information about using each of the components in this collection, follow the links below to the documentation for that component.