Introduction

Pinkr is a RESTful client for a GPS tracking system designed to work on a mobile device that supports J2ME.

GPS data are collected from a bluetooth-connected or a built-in device and pushed to a RESTful web serivice over HTTP protocol.

Here's a bluetooth version:

+--------+             +------------+               +-------------+
| GPS    |  Bluetooth  | Cell phone |    HTTP       | Web service |
| device | <---------> |            | <-----------> | REST        |
+--------+             +------------+               +-------------+

Currently, it only has a NMEA simple parser implemented but you might find other data format parsers in the future.

Parsed NMEA data are sent over HTTP in the following way:

  POST <url_path>
  lat=<latitude>&lng=<longitude>

Installation

Use WTK (works well with v. 2.5.2), NetBeans (currently used for the development) or Eclipse to compile, with these options:

CLDC-1.1 Device Configuration
MIDP-2.0 Device Profile

Consult your mobile device manual on how to install the resulting package (usually named Pinkr.jar). 99% of the cases it is simple drag & drop or "Send via Bluetooth" from your PC to the mobile device.

How to compile

TODO