The tools on this page are no longer supported.

Getting started

MPS offers developers access to a free Software Development Kit (SDK) that makes it possible to create server-side positioning applications with minimum effort. The SDK helps you with protocols, parsing, and testing - making development faster and easier.

Developers do not require a live positioning server to develop, demonstrate and test a new positioning application. The MPS SDK contains all the tools you need to get going.

1. Developing positioning applications
2. What is included in the MPS SDK?
3. Step-by-step instructions

MPS SDK 6.0.1

MPS SDK 6.0.1 supports both the Ericsson proprietary Mobile Positioning Protocol (MPP) and the Mobile Location Protocol (MLP). MLP is the standardized interface between a Location Based Service application and the Mobile Positioning System. MLP will be introduced in the release of Ericsson MPS-G 6.0 (GSM) product.

This development kit contains all the tools you need to build, test and demonstrate new applications based on mobile positioning. You do not have to know MPP or MLP to use the MPS SDK.

Ericsson's Mobile Positioning System (MPS) gives you a unique opportunity to create location-based solutions for both mass and vertical markets. Since mobile positioning is a relatively new area with large potentials, your possibilities to create new profitable services are only limited by your imagination.

New features:

• The JML API replaces the JMPP API.                                  
• Support for MPP 3.0, 4.0, 5.0 and MLP 3.0.0 in MPS Emulator and in JML API.                                                                     
• Phone call interface for simulation of Call Related MT-LR.                                     

Improvements:

• New method "getArcWidth" will replace method "getOuterRadius" in JML API.                     
• The MPS Emulator configuration files (Celldata.txt, emulator.properties, lbsdata.xml and Routfile.txt) are moved from the
  [MPS SDK Directory]/emulator/data directory to the
  [MPS SDK Directory]/emulator/webapps/ROOT/WEB-INF/data directory.                           
• Web based Graphical User Interface (GUI) for the MPS Emulator - "MPS Emulator Administration". In the MPS Emulator Administration GUI it is, for example, possible to:
  - add, modify and delete LBS client information.
  - add Mobile Stations (MS) that shall be possible to position.
  - view the Emulator Log.                                                                     
• MPS Emulator 6.0 does not use Authfile.txt, Confdata.txt and Lbsdata.txt. Data from these data files are instead included in the new configuration data files called: emulator.properties and lbsdata.xml.                                                                        
• The MPS Emulator runs on Tomcat from Apache, which is included in the MPS SDK package. The EServer is removed from the MPS SDK package.                                                                        
• Example Application (previously called demo) are extended with a Call Related MT-LR example and an example showing how the JML API can be configured in runtime.                                                                        
• Improved and extended User's Guide for MPS Emulator.                                                                        
• Two new documents:
  - Programmer's Guide JML API 1.0
  - Programmer's Guide Example Application based on JML API 1.0

Backwards compatibility
The JML API and the MPS Emulator supports MPP 3.0, MPP 4.0, MPP 5.0 and MLP 3.0.0 requests and responses.

Relation between MPP/MLP versions and products:

Relation between MPS products and MPS SDK releases:

System Requirements
MPS SDK is made up of parts with different system requirements.

JML API
The JML API is designed to give the location of a mobile phone as fast and easy as possible. All data parsing, and requests sent and received over the Internet will be done for you. By the use of the JML API you will be able to develop positioning applications with little or no knowledge about the protocols involved. If the JML API 1.0 is used in a Java 2 Standard Edition (J2SE) 1.3 environment, Sun's JSSE API (JSSE 1.0.3) is required for SSL connectivity and JAXP from Sun (JAXP 1.2) is required for the XML parsing. If the JML API 1.0 is used in a J2SE 1.4 environment no extra APIs are required.

An Internet connection is not needed prior to testing the application, in the emulated environment, but is required for real world testing.

Example Application
An Example Application with four examples, based on the JML API, are included in the MPS SDK package. The examples will help you jump start the development of your own applications by showing how basic tasks are performed. The source code from those examples can be freely used in your own application.

Click on the startup file in the [MPS SDK directory]/api/examples/bin directory to start the Example Application. Example 1 illustrates a web application based on the Mobile Terminated Location Request (MT-LR) concept in mobile positioning. Example 2 illustrates a Mobile Originated Location Request (MO-LR) based application that collects pushed location results from MPS. Example 3 illustrates the Call-Related MT-LR concept in mobile positioning and the Administration Example shows how the JML API can be configured in runtime.

MPS Emulator
The communication between an application and GMPC relies on the Mobile Positioning Protocol (MPP) or the Mobile Location Protocol (MLP). With the MPS Emulator you are able to setup your own local positioning system. The MPS Emulator runs on a server and is a valuable tool to test your application.

The MPS Emulator is built with servlet technology and should run on a servlet-enabled server. Tomcat from Apache complies with the needs of the MPS Emulator and is therefore included in the MPS SDK package. When loaded with a mobile network you can create with Ericsson MPC MapTool, MPS Emulator will give you an emulated positioning answer from an area of your choice. A default set of configuration files with three moving phones in the capital of Austria is supplied with the MPS Emulator.

The MPS Emulator 6.0 supports MPP 3.0, MPP 4.0, MPP 5.0 and MLP 3.0.0.

MPC MapTool 
MPC MapTool is a Windows application. For non-Window developers, default network files for other platforms are supplied with the emulator. A Pentium with at least 32 Mb RAM and Windows 95, 98, NT or 2000 is required. Internet Explorer v4 or higher is also recommended to run MPC MapTool. Since the application only benefits Windows users we have made a separate package. MPC MapTool has no value without the MPS Emulator.

For more information, please look into the webcast that will guide you through the different parts of the MPS SDK 6.0.

Please note that by downloading the MPS SDK, and the MPC MapTool, you accept the terms and conditions of the MPS SDK License Agreement, and the MPC MapTool License Agreement.

The Mobile Positioning video guides you through the SDK
1. Mobile Positioning SDK Overview
This is an overview of the different parts that are included in the MPS SDK.
2. Mobile Positioning SDK Technical Walkthrough
This presentation covers different ways to access MPS. We will go through the query content when interacting with the MPS and the location answer sent back from the MPS.
3. Mobile Positioning SDK, JML API Tutorial
This presentation gives detailed information about the Java-based API (JML API).
4. Mobile Positioning SDK, Test Environment
In this presentation we describe how the MPS Emulator works and how it can be configured. This part also gives information about the MPC Map Tool.

Please note that by downloading the MPS SDK you accept the terms and conditions of the MPS SDK License Agreement.

MPS SDK 6.0.1 (ZIP) 
Size: 7,25 MB
March 12, 2004


MPC MapTool 3.0.1 (ZIP)
Size: 6 MB
June 27, 2003

MPS SDK 5.0.1

MPS SDK 5.0.1 supports the Mobile Positioning Protocol (MPP) 5.0 that was introduced in Ericsson MPS-G 5.0 (GSM) product and MPS-U 1.0 (UMTS) product. 

The MPS SDK 5.0 contains:

• Java Mobile Positioning Protocol Application Program Interface (JMPP API) to easily send and receive positioning requests.                         
• Java Example Programs that uses the JMPP API.                         
• MPC Emulator used to test your application with realistic answers from your own geographical area.                         
• EServer, a servlet enabled server especially design for the MPS SDK.                         
• Documentation 

Please note that by downloading the MPS SDK you accept the terms and conditions of the MPS SDK License Agreement.

MPS SDK 5.0.1 (ZIP)
Size: 3,81 MB