My favorites | Sign in
Project Logo
                
Search
for
Updated Jan 27, 2009 by gdjones
Labels: Phase-Support
UserGuide  
User Guide for Mobile Trail Explorer

1. Introduction

This is a small user guide for Mobile Trail Explorer application.

2. Requirements

Mobile Trail Explorer requires the following to work:

You can check that you have all of the above APIs using the JavaME API Checker

3. Installation

3.1 Installing over the air

You can install the latest release over-the-air to your phone by downloading the application file from http://www.substanceofcode.com/software/mobile-trail-explorer. Point your phone browser to JAR file using the following URL address: http://www.substanceofcode.com/downloads/midlets/TrailExplorer.jar

3.2 Installing locally from JAR file

Another way to install the application is to download the JAR and JAD files to your local disk and use the phone manufacturer software to upload and install the files to your phone. You can download the latest release here.

4. Setup GPS

4.1 External Bluetooth GPS

After you have installed the software to your phone you can configure the GPS unit like this:

4.2 Internal GPS (via Jsr179)

If your phone has an internal gps unit, and the java Location API (jsr179), MTE can use that as well. To enable the internal GPS:

5. Record your first trail

Now that you have configured the GPS device you are ready to record your first trail.

How to start

How to stop

6. Key-Pad shorcuts

Function Primary Key Secondary Key
Zoom In 1
Zoom Out 3
Pan View Left Left Key 4
Pan View Right Right Key 6
Pan View Up Up Key 2
Pan View Down Down Key 8
Centre View Fire Key 5
Change View 0

7. Settings

You can change application settings by selecting a "Settings" menu item from the main screen.

7.1 Settings / GPS

7.2 Settings / Export folder

Export folder is used when trail is exported to a file. Export folder can be located in the phone's memory card or in the internal memory. Some phones allow only specific folders to be used with Java applications.

7.3 Settings / Recording

Recording settings are used for defining what sort of location data is recorded to your trail. There are following options:

7.4 Settings / Web Recording

Web recording can be used to send current location to a web server. Options are:

Tag Description
@LAT@ Latitude
@LON@ Longitude
@ALT@ Altitude
@TRAILID@ Trail identifier (date stamp)
@HEA@ Heading
@SPD@ Speed

E.g. Following URL 'http://server/record.php?lat=@LAT@&lon=@LON@&alt=@ALT@&id=@TRAILID@&hea=@HEA@&spd=@SPD@'

Would be converted to this: 'http://server/record.php?lat=43.1432&lon=20.124&alt=89&id=200805062130&hea=120&spd=8.12'


Comment by bigbug21, Mar 17, 2008

How can one set a waypoint?

Comment by ManlyJack, Mar 29, 2008

Select Waypoints from the menu, then Add new waypoint and it will already have the coords in for the current viewing position

Comment by bhanu2951983, Apr 22, 2008

can raster image of map is used in place of osm.

Comment by diegorodriguezperegrin, May 14, 2008

Hello. I must be idiot, but I can't find the JAR file anywhere on this site. The link supposedly there to link it sends you to a zip file containing lots of source files I don't know how to handle. Thanks for your help.

Comment by diegorodriguezperegrin, May 14, 2008

Hello again. I found the idiot here. It wasn't me, fortunately. Microsoft Explorer itself changes jar extensions into zip. I may change it back manually, because how to 'force' IE to respect the extension is something you can do in several ways. For today, I simply dropped IE and used Firefox instead. Everything fixed!

Comment by diegorodriguezperegrin, May 14, 2008

Ok, now I could start the application. I granted it full data access, first.

Trying to save the trail into my microSD card, I always get a message asking permission to add and edit data into the memory card. When I say YES, it throws an ugly java/lang/OutOfMemoryError? message. The memory card has 2GB free space... what can it be?

Comment by Saydujjaman, May 18, 2008

how to get source code for download for this nice application and how to get be part of this team if i want be. there is option for SVN but i donlt have svn tools

Comment by ragamaier, Aug 27, 2008

Hi! I would like to use this nice midlet with my xda orbit II (=HTC Prophet) with wm6 and Esmertec Java. After install and start there is unfortunatelly no menu at the bottom, the midlet is displayed full screen. So I can't make any settings and therefore not use the program. Have you advice? Thanks Goetz

Comment by manuel.g...@fh-hagenberg.at, Aug 28, 2008

Hello

i want to send the current speed with the webupload-service. Is it possible ?

Comment by tho...@lazy8.nu, Sep 26, 2008

Hi, I would like the timestamp sent to web-recording also. Taking the time that it arrives at the server is really a poor substitute. By the way, I have written a server to recieve and show the web-recording data!!! Try it at http://followmytrail.lazy8.nu

Comment by tho...@lazy8.nu, Sep 26, 2008

Could you update the GPS setup section. I have a GPS that is built into my nokia 95 telephone and your setup description does not mention that you must enable "jsr 179" in some other sub menu. I was very near to give up installation when I found this by pure luck.

Comment by alvonsius.albert, Oct 21, 2008

hi there, I just use this application with my research. And I actually want to send the data via URL with format like this: http://my_server/index.php/report/some_id_of_sender/@LAT@/@LON@/@SPD@/@TRAILID@

and somehow it doesn't even sent to the server. Anybody could give me a hint does my format right or wrong (I use codeIgniter framework as the backend on the server) ... does the parameters only works for URL with query string like "lat=@LAT@" only?

Thanks ...

Comment by alvonsius.albert, Oct 22, 2008

Sorry to double post. Maybe I found where is the bug is ... It seems that the web upload won't work whenever the speed is '0' and we want to sent it with @SPD@ ... cmiiw ...

Comment by danny.decock, Dec 06, 2008

hi, this is a very cool application! I noticed that

- the use of a web recording to an ssl/tls server through https://server/... keeps reporting that the server's certificate is untrusted, even though the server's certificate and each of the certificates in its certificate chain is included in the store with trusted certificates... would it be possible to store/flag this certificate in the application's local configuration as trusted? - default access point: would it be possible to specify the default access point that the application can use for its web recording? :)

I would be very happy contributing to it...

Comment by brian.schimmel, Jan 08, 2009

I totally like the ability to import a GPX file, and I'm glad TrailExplorer? can do it. But it is not documented at all, so at first I thought it could not import. Anyway, I tried. I almost thought I'd have to buy one of there Garmin thingies to be able to follow a trail that I had downloaded somewhere. I think you should point this out more clearly as it is one of it's most important features. By the way, there are many J2ME-Applications that can record to GPX, but as far as I know, none of them can actually read GPX files.

Comment by hskiran1972, Apr 09, 2009

I have installed this app on my MOTO ROKR E6 phone and have an external GPS receiver also in the vicinity and switched on. When I start the application, it shows the splash screen and then another screen where it says "STATUS: NOT CONNECTED (0)". There are no menus displayed either. How do I get this app running?


Sign in to add a comment
Hosted by Google Code