Default Positioning Module Overview

Purpose

The Default Positioning Module is used by the Location Server when a Location Acquisition API client calls RPositioner::Open() without specifying a PSY ID.

The Default Positioning Module is used internally by LBS and has no published APIs.

Required background

Read LBS Architecture Overview to understand how PSYs fit into the LBS subsystem.

Key concepts and terms

Location Server

The Location Server manages location requests makes using the Location Acquisition API. Location requests from the Location Server eposserver.exe can be sent via the Default Positioning Module.

Positioning Plug-in (PSY)

An ECom plug-in that provides position data to the LBS subsystem. The Default Positioning Module is a Proxy PSY because it forwards requests for position data to another PSY, such as the Bluetooth Positioning Module or Simulation Positioning Module.

Architecture

When a Location Acquisition Request is made, if no PSY is specified, then the Default Position Module handles the request.

The Default Positioning module receives a location request and acts as a proxy to a selected PSY.

The Default Positioning Module includes functions to inspect the prioritised list of Positioning Modules and return the top of the list, and to receive notification when the prioritised list of Positioning Modules is updated by the Location Settings API.

APIs

The Default Positioning Module has no published APIs.