From Navit's Wiki
Revision as of 16:05, 2 December 2011 by Ruedi (talk | contribs) (Including in Navit)
Jump to: navigation, search

Navit includes a map driver which supports csv files. Note that this feature is only available in the latest versions of Navit (i.e. those built from daily updates).

Including in Navit

In order for the points in the csv file to show up in Navit, the map must be added to navit.xml. This can be accomplished by adding the following line into the enabled and active mapset.

<map type="csv" enabled="yes" data="poi.csv" item_type="poi_hotel" attr_types="id,position_longitude,position_latitude,label" />

NOTE: This only works if you complie navit with the option --enable-map-csv . If you use navit from a deb package, it won't work!

Features to note from the previous example:

  • item_type
    • The type of item in each csv file is defined in the item_type attribute of the above line, and can be anything from item_def.h
    • This of course means that each csv file (or map) can hold only one type of item. For example, a list of hotels (item_type="poi_hotel") or fuel stations (item_type="poi_fuel"). You cannot mix different items within the same csv file.
  • attr_types
    • The corresponding attribute types for the columns of the csv file should be specified by the attr_types attribute inside the map tag. The value of that attribute should be a comma separated list of navit attributes in the order they appear in the csv file.
    • You can define any attribute from attr_def.h
    • The csv map definition should have position_longitude and position_latitude attributes in the attr_types list definition otherwise the csv file will not be loaded.

Adding map items by osd commands

One can add new items which are saved on exit to a csv map runtime by OSD commands. Please see map_add_curr_pos command in the OSD commands description section for an example.

Special Case: IGO8 (speed camera) files

The speed_cam OSD item can use speed camera data from IGO8 files, which are a type of csv file.

If your IGO8 file comes from http://speedcamerapoi.com/download.php, the following line should be used:

<map type="csv" enabled="yes" data="/path/to/igo8/file/speedcam.txt" item_type="tec_common" attr_types="position_longitude,position_latitude,tec_type,maxspeed,tec_dirtype,tec_direction" />

Sometimes, an IGO8 file has an ID column as its first column. Then the following should be used:

<map type="csv" enabled="yes" data="/path/to/igo8/file/speedcam.txt" item_type="tec_common" attr_types="id,position_longitude,position_latitude,tec_type,maxspeed,tec_dirtype,tec_direction" />

The csv File

Contents of an example csv file is shown below, and corresponds to the example line for navit.xml shown above.

01,23.657,-46.7678,The Sunny Hotel
02,23.457,-46.7878,Spa Hotel
03,23.437,-46.2378,The Railway Hotel


  • No trailing comma
  • Each item is defined on a new line
  • Each column corresponds to the attr_types attribute in the <map ...> line in the example above.

Android Issues

Currently, the Android builds do not include the required plugin line in navit.xml, although the csv map driver itself is built. To enable csv maps on Android, add the following line into the plugins section of your navit.xml:

<plugin path="$NAVIT_PREFIX/lib/libmap_csv.so" ondemand="no"/>

For more information, see #781.

WinCE Issues

You will need to use the full path to the CSV file, and not $NAVIT_SHAREDIR

<map type="csv" enabled="yes" data="\SDMMC\navit/maps/speedcam.txt" item_type="tec_common" attr_types="position_longitude,position_latitude,tec_type,maxspeed,tec_dirtype,tec_direction" />