PyPOIAlert

Download: PyPOIAlert 0.5.2 (01.06.2008)

Readme

PyPOIAlert 0.5.2 (for S60 3rd)


Installation notes:

Install all sis-files on c:

Using PyPOIAlert:

  • Start PyPOIAlert from your programs folder.
  • The first time PyPOIAlert starts you'll be notified about missing files, which will be created automatically. To make sure everything has worked properly, quit PyPOIAlert and restart it. If everything went well, there shouldn't be any more pop-ups.
  • Place your POI-files (*.asc or *.txt) in E:\data\others\PyPOIAlert\pois\

Make sure the files ONLY contain lines in THIS format:

Longitude,Latitude,Text


Make sure, that there's no first line like "LON,LAT,DESCRITION"! Furthermore check, that each column is seperated by a , and nothing else! And finally check, that the latitudes/longitudes use dots ( . ) as a decimal seperator!
Each line should look like this: #.######,##.######,my poi
As far as I know, the usual POI-files distributet in *.asc-format (like speedcams for Navigon) work out of the box. But still, check it!

  • To import your POIs, press "Options" -> "POIs" -> "Import POIs". Depending on how many POIs you've put into the pois-folder, this can take quite some time. ~250kb take about half a minute. So DON'T place too many POIs in the pois-folder, since performance will become really bad!
  • You now have to set you home-coordinates. Use something like Google-Earth to get the values, then press "Options" -> "Home" -> "LAT/LON (0.00/0.00)". First enter the LAT, then LON. Beware, that you HAVE TO use dots ( . ) as the decimal seperator!

If you wish, you can change the default-radius (100 kilometers) of the POIs around your home by pressing "Options" -> "Home" -> "Home Radius (is 100km)". Bigger values than 100 are NOT advised! The smaller the value, the faster the program will run. So if you never drive further away from home than e.g. 50 kilometers, set this value accordingly!

  • Once you have imported your POIs and set your home-coordinates, you have to calculate the local pois (by default within a radius of 100 kilometers). To do this press "Options" -> "POIs" -> "Calculate local POIs". For ~250kb this will take about 5 to 15 seconds.
    If you haven't set your "Home" and a real GPS-Device already is active, the current position will be used as the home location.
  • Select, which GPS-device should be used by default by pressing "Options" -> "GPS-Device" and then whatever device you want to use. By default, the internal device will be used.
  • Save your settings by pressing "Options" -> "Settings" -> "Save". Pressing "Load" will load the last saved configuration since program-start.
  • Switch the active tab by pressing the right or left navigation-key.
  • To start POI-alerting, switch to Radar-tab and press "Options" -> "Start GPS". You can check the GPS-status in the GPS-tab. As soon as the GPS-signal is available, you're ready to go.
  • Always switch to the Radar-tab to keep near POIs being updated!
  • POIs within a radius of 900 meters are displayed as red dots. POIs within a radius of 3 kilometers are displayed as orange dots. POIs further away will be displayed as yellow dots.
  • Within the white headline the text if the closest POI will be displayed
  • On the right, below the text, the distance to the nearest POI will be displayed, and on the left, the angle to the nearest POI.
  • The number of POIs displayed depends on current driving-speed. Therefore no POIs will be displayed while not in movement!
  • You will be notified about POIs ~60 seconds, ~30 seconds and ~10 seconds befor arrival at the nearest POI by a popup or (if activated) by (synthesized) voice. You'll even get notified (by Popup or voice or both) if PyPOIAlert is hidden (which you can do by pressing the red key)!
  • If you drive further than 100 kilometers, you will have to recalculate the local POIs. Do so by pressing "Options" -> "POIs" -> "Calculate Local POIs". Keep in mind, that during recalculation you won't be notified of near POIs!
  • To close PyPOIAlert when minimized, hold down the menu-key and select PyPOIAlert from the tasklist, or navigate to the icon in your programs-folder. Then, within the programm, press "Exit" (the right soft-key) and confirm.

You'll be notified if envy is missing.

AT ALL TIME keep your focus on driving SAFE and NOT on PyPOIAlert!!!

Changelog (0.5.2):

  • added voice
  • (most of) the current settings are shown next to their menu-entries (like home-radius or if voice is on or off)

To do:

  • Userdefinable notification times and total number of notifications

Known Bugs:

  • You may get notified about a POI more than once
  • Program might crash if GPS-connection is lost

FAQ:
Q: Why does pressing the red key quit PyPOIAlert?
A: There's something wrong with envy. Try installing again.

Q: Which phones are supported?
A: I don't know. I guess it will run on almost any other S60 3rd phone. But since I don't really know, I'm not responsible for any damages.

Seems to run on:

  • Nokia N95 8GB (20 Firmware)

If you experience any difficulties using PyPOIAlert, you can send me an e-mail with an explanation of the malfunction. But most likely, there's nothing you can do about it. I'm just programming with python for a month now and don't know anything about bugfixing or improving compatibility. But maybe i'll give it a try.


All needed files are included in the zip-file.
The latest versions can be found here:
Python for S60: http://sourceforge.net/project/showfiles.php?group_id=154155
LocationRequestor: http://www.iyouit.eu/portal/Software.aspx
envy: http://sourceforge.net/project/showfiles.php?group_id=132176


License:

Since I don't know anything about licensing, PyPOIAlert is (and will always be) free for everybody. Host it, post it, share it, do what ever you like with it.