Network Request Handler Overview

The Network Request Handler (NRH) is responsible for processing and responding to privacy and location requests received from the network (MT-LR, Emergency MT-LR and NI-LR). It also provides an interface for installed applications to send the handset’s current location to remote third parties (MO-LR transmit to third party).

Purpose

The Network Request Handler (NRH) is responsible for processing and responding to privacy and location requests received from the network (MT-LR, Emergency MT-LR and NI-LR). Privacy requests are forwarded to a privacy handler for processing, which may be Privacy Notifier or Privacy Controller.

The NRH also provides an interface to local client applications that need to send the handset’s current location to remote third parties (MO-LR transmit to third party, also known as X3P in Symbian platform LBS documentation).

Required background

Knowledge of LBS architecture is required.

Key concepts and terms

Network Request Handler Server

The Symbian platform server responsible for handling location requests from the network.

MT-LR

Mobile Terminated Location Request. A request from the network for the device location. It consists of two parts, a privacy request and a location request. The NRH processes MT-LRs.

NI-LR

Network Initiated Location Request. A request from the network for the device location. It consists of only a location request without a privacy request. The NRH processes NI-LRs.

Privacy request

The part of an MT-LR that requires a privacy response from a privacy handler. See Privacy Requests for more information.

Architecture

See LBS Architecture Overview for more information.

APIs

This section provides links to the APIs provided by the NRH.

API Description

Transmit to Third Party API (X3P API)

Allows installed applications to send the current location to a contact or service.

Privacy Controller API

Allows device creators to develop a Privacy Controller application to automatically handle MT-LR privacy requests.

Privacy Notifier API

Allows device creators to develop notifiers to query the user when MT-LR privacy requests are received.

Privacy Q&N Notifier API

A deprecated API for creating notifiers. Use of the Privacy Notifier API is recommended.