Interactive help

From Navit's Wiki

Jump to: navigation, search

Your journey starts here

Hi. Welcome to NavIt's interactive help. Think of it as those books where you are the hero. From now, you will follow a given number of steps, which depends of what you expect from this help. After each question, choose the answer that matches best your needs, and you will jump to the next step. This guide will cover from code downloading to the problems you might encounter when using NavIt, and the solutions which could be useful.

Do you want to learn more about Navit?




Fetch a release

Ok. You can get the latest official release from here : http://sourceforge.net/project/platformdownload.php?group_id=153410

Download the file, and extract it.



Learn more

Navit is a car navigation system with routing engine.

It's modular design is capable of using vector maps of various formats for routing and rendering of the displayed map. It's even possible to use multiple maps at a time.

The GTK+ or SDL user interfaces are designed to work well with touch screen displays. Points of Interest of various formats are displayed on the map.

The current vehicle position is either read from gpsd or directly from NMEA GPS sensors.

The routing engine not only calculates an optimal route to your destination, but also generates directions and even speaks to you using speechd.

Navit currently speaks 18 languages :

  • Brazilian Portuguese
  • Czech
  • Danish
  • Dutch
  • English
  • Finnish
  • French
  • German
  • Hebrew
  • Italian
  • Norwegian Bokmal
  • Polish
  • Romanian
  • Russian
  • Slovak
  • Slovenian
  • Spanish
  • Swedish

For more informations about translations, you can have a look here

Do you want to start using navit now?


.

Maps : Garmin

Warning : this driver is still experimental.

The following link should tell you everything you need to know about Garmin maps : Garmin_maps


.

Fetch from SVN

Obtaining the code via svn. 

svn co https://navit.svn.sourceforge.net/svnroot/navit/trunk/navit


.

Fetch : Archlinux

http://aur.archlinux.org/packages/navit/navit/



Configure NavIt

NavIt needs to know some little things before it can be useful for you. First, you need maps.

If you don't know, the best choice is probably OSM.

If you just want to use the default demo map of München, you can continue :


.

Let's start

Please, please, be sure to check the prerequisites. If you miss one of them, NavIt may build, but you may have no gui.

Before continuing, ensure that you have the following installed.

See the list detailed per distro :

If your distro is not listed, feel free to add a dedicated page like above. Otherwise, here is what you will need :

Compilation tools :

  • gcc
  • libtool
  • automake
  • autoconf

You will need the following libraries. If you're using Gentoo, install simply the package. If you use a rpm-based distro, also install the <package>-devel.

  • gettext
  • glib2
  • libxt-dev


Now, about the GUIs:

If you want to use the GTK gui (great on low-power devices) :

  • gtk2
  • libgtk2-dev


If you want to use the SDL gui (best looking, but eat more ressources and not as complete as the GTK gui) :



GPS receiver: If you want to be able to connect to a gps receiver, you will need :


Fonts: NavIt will use the first font found in this list to draw the road names :


Ok, we're ready to start.

What code do you want to use?

If you don't know what to choose, SVN is currently recommended.


.

Configure your receiver

Using a gps receiver isn't mandatory, but.. without it, you won't go far :)

Please see the following link : http://wiki.navit-project.org/index.php/Configuring_NavIt#The_vehicles_definitions

When done, you can go back here to continue your journey.

If you have a recent Garmin GPS you could use it for testing navit with gpsd in the following way (works for me on a E-Trex Vista) 

- power on Garmin
- connect it via USB or Serial cable to your PC
- disable GPS at the Garmin
- Select Find a Waypoint, Select demonstration mode and follow road (even on a basemap)
- start gpsd at the PC (e.g. gpsd -N -D 3 /dev/ttyUSB0 for USB-cable - check tty device for garmin)

Your Garmin should now simulate a vehicle and give the simulated data to the usb or serial interface.

Probably you want to check your GPS manual if the device has a Simulation mode.

Hints are welcome for other devices.


Fetch : Gentoo

An ebuild is available for Gentoo in the overlay sunrise. This ebuild is based on the svn version of navit to have an up to date version.

Once you install navit using this ebuild, you can follow the rest of this help. The only difference is that you will find the default navit.xml file in /usr/share/navit.

You should copy it to the ~/.navit/ directory (create it if it doesn't exists) or to your home directory. NavIt will look in both these places.

You can now jump to Configure NavIt


Debian

Packages for Debian are available for the following versions:

Those packages are based on the svn and are regularly updated.

Ubuntu

Packages for Ubuntu are available for the following versions:

Those packages are based on the svn and are regularly updated.

Ubuntu 7.10 Glues

Testing with Ubuntu 7.10 showed up the following (may vary depending on what is installed or what not)

  • the X-libraries are not complete for navit, install libxmu-dev additionally from repository
  • prebuild package quesoglc did not work because it has a dependency to /usr/lib/libGL.la which is not present (also after installing libmesa*)
  • so build package quesoglc from tarball with --prefix=/usr
  • repository package libcegui* did not work because using XERCES as xml-parser

REMARK the XERCES problem should be fixed in svn as of April 2008. Please give feedback so building from tarball with disabling nearly all but TGA and TinyXML and --prefix=/usr

  • therefore additional libraries like libpcre3-dev are needed
  • installed libgarmin from subversion because not found in repository
  • installed libspeechd-dev from repository
  • installed libtiff-dev from repository
  • installed libdevil-dev from repository (unresolved external libILU..)
  • installed gpsd (should provide libgps-dev)

.

Windows

We are sorry, we don't have pre-built binaries for Windows for now. Please see this page : NavIt on Windows

If you need help about this, please contact us.



MacOS

We are sorry, we don't have pre-built binaries for MacOS for now. Please see this page : NavIt on MacOS


If you need help about this, please contact us.



Building NavIt

This should be pretty easy.

go in to the navit directory : 

cd navit

Now, launch the compilation : 

./autogen.sh && ./configure

Now, you sould have a summary like this : 

Summary of your installation :
 GTK gui     : ENABLED
 SDL gui     : ENABLED
 GPS support : ENABLED
 SPEECHD     : ENABLED
 Garmin IMG  : ENABLED
 Samplemap   : ENABLED


In some cases (for example ubuntu 7.10) there are some problems with python. Then type: 

./autogen.sh && ./configure --disable-binding-python

If you're happy with what is enabled or not, you can run 

make

This build NavIt, and will also download the demo map of München (20Mo)

If you want a feature which is disabled, please go back and check the dependencies.

Next :


.

Fetch a package

What is your distribution?



.

IRC

We are sorry that this help didn't solve your case. Everything is not lost : join us on IRC, we'll help you and enhance this help. 

irc server : irc.freenode.org
channel : #navit

















(lines left blank on purpose, please keep them so that the last entry shows up at the top of the page)

Retrieved from "http://wiki.navit-project.org/index.php/Interactive_help"
Personal tools