1 <?xml version="1.0" encoding="UTF-8"?>
4 <title>Maemo Mapper</title>
6 <topictitle>Introduction</topictitle>
7 <context contextUID="help_maemomapper_intro"/>
8 <para>Welcome to Maemo Mapper.</para>
10 Maemo Mapper is a geographical mapping tool that can be used to:
14 Download map data to your device's main memory or to an external
18 View that map data on the screen.
21 Navigate that map data by panning around the screen and zooming in
25 Display your position and other GPS information from a GPS
29 Store and display Point-of-Interest (POI) data.
32 Download directions between arbitrary points on the map.
35 Save or open track data or route data.
39 Use the <ref refid="help_maemomapper_" refdoc="index"/> to peruse the
40 various sections of this help document, or go to <ref
41 refid="help_maemomapper_getstarted" refdoc="Getting Started"/> to
42 get up and running quickly.
46 <topictitle>Getting Started</topictitle>
47 <context contextUID="help_maemomapper_getstarted"/>
49 When you first start Maemo Mapper, you will be presented with the
50 <display_text>Settings</display_text> dialog box. Most of the
51 settings have reasonable defaults, but if you have a GPS receiver,
52 you should fill in the <display_text>MAC</display_text> field with
53 the MAC address of your GPS receiver. If you don't know the MAC,
54 turn on your GPS receiver and push the
55 <display_text>Search</display_text> button. Maemo Mapper will
56 attempt to automatically discover the MAC address of your receiver.
57 For more information about the <display_text>Settings</display_text>
58 dialog box, see <ref refid="help_maemomapper_settings"
62 When you are finished setting up Maemo Mapper to your preferences,
63 pressing the <display_text>Ok</display_text> button will lead you to
64 another dialog box: the <display_text>Manage
65 Repositories</display_text> dialog.
68 To get started quickly, press the
69 <display_text>Download...</display_text> button. Maemo Mapper will
70 download a set of pre-defined repository information for you to use.
71 If you use the pre-defined repositories, you can delete the
72 <display_text>Default</display_text> repository. For more
73 information about repositories and the <display_text>Manage
74 Repositories</display_text> dialog, see
75 <ref refid="help_maemomapper_repoman"
76 refdoc="Managing Repositories"/>.
79 Certain repositories (most notably, the commercial ones) may have
80 license agreements attached with their use. It may be illegal to
81 use a certain repository with Maemo Mapper or under certain
82 conditions. This includes the repositories downloaded via the
83 <display_text>Download...</display_text> button. If you are not
84 sure if you are legally allowed to use a particular repository, you
85 should delete it from your list of repositories. The authors of
86 Maemo Mapper cannot be held responsible for your use of a particular
90 Once you have your Repositories set up the way you like, press the
91 Ok button, and you will be presented with a blank screen, because
92 you have not yet actually downloaded any map data to your device.
93 To allow Maemo Mapper to automatically download map data as it
94 becomes needed on the display, enable the
95 <display_text>Auto-Download</display_text> checkbox in the
96 <display_text>Maps</display_text> menu.
99 If you have a working internet connection, Maemo Mapper will attempt
100 to download maps and display them on the screen automatically as
101 the downloads complete. You should see a map of the world. Be
102 careful when you enable Auto-Download, because it can quickly fill
103 your available disk space. See
104 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/> for
105 details on how to manage disk space for a particular repository.
107 <heading>The Graphical User Interface</heading>
109 The main view of Maemo Mapper emphasizes simplicity. By default,
110 the map is all that is displayed. You current position (if you have
111 a GPS receiver) is indicated by a blue circle. The blue line
112 extending from the blue circle indicates your current heading and
113 speed. <i>Tracks</i> are red and represent where you have been.
114 <i>Routes</i> are green and represent where you want to go, i.e.
115 directions to a location.
118 The hardware buttons on your device provide quick access to common
123 <graphic filename="2686KEY_full_screen"/> - Toggle
127 <graphic filename="2686KEY_zoom_in"/> - Zoom In - hold down to
128 zoom multiple levels at a time
131 <graphic filename="2686KEY_zoom_out"/> - Zoom Out - hold down to
132 zoom multiple levels at a time
135 <graphic filename="2686KEY_scroll_up"/> - Pan Up - hold down to
139 <graphic filename="2686KEY_scroll_down"/> - Pan Down - hold down
143 <graphic filename="2686KEY_scroll_left"/> - Pan Left - hold down
147 <graphic filename="2686KEY_scroll_right"/> - Pan Right - hold down
151 <graphic filename="2686KEY_scroll_center"/> - Toggle
152 <ref refid="Auto-Center" refdoc="Auto-Center"/>
155 <graphic filename="2686KEY_esc"/> - Programmable; defaults
156 to: Hide/Show Tracks and Routes
160 You can also pan around the map by tapping on the screen. Maemo
161 Mapper will center the display on where you tapped. If you had
162 <display_text>Auto-Center</display_text> enabled, tapping a location
163 to center on it will automatically disable that functionality.
166 From this point, you can use the menus to manage routes, tracks, and
167 map data; to change the view; to change settings; or to see detailed
168 GPS information (if you have a GPS receiver).
171 There is also a context-sensitive menu that appears on the map when
172 you tap and hold a location on the map. From that menu, you can
173 download directions, calculate distances, or add/modify
174 Point-of-Interest (POI) data.
177 For help with any of these features, use the
178 <ref refid="help_maemomapper_" refdoc="index"/>.
182 <topictitle>Main Menu</topictitle>
183 <context contextUID="help_maemomapper_mainmenu"/>
185 This help topic describes the functionality of each of the menu
186 items in Maemo Mapper.
188 <heading>Route</heading>
190 The <display_text>Route</display_text> menu is used to manipulate
191 the current <i>route</i>. A route in Maemo Mapper is defined as a
192 set of points and waypoints describing <i>where you would like to
193 go</i>, e.g. driving directions from 123 Main Street to 456 Elm
194 Street. It can include multiple segments. The current route is
195 empty until you open or download a route.
198 The <display_text>Route</display_text> menu has the following menu
203 <display_text>Open...</display_text> - Open a route from a GPX
204 file on the file system. The opened route is <i>appended</i> to
205 the current route, so you can string together different routes
206 together to create a trip with multiple destinations.
209 <display_text>Download...</display_text> - Download a route from
210 the internet. See <ref refid="help_maemomapper_downroute"
211 refdoc="Download Route"/> for more information.
214 <display_text>Save...</display_text> - Save the current route to a
215 GPX file on the file system.
218 <display_text>Show Distance to Next Waypoint</display_text> - Show
219 the distance left to be traveled (along the current route) until
221 This action can be assigned to the <graphic
222 filename="2686KEY_esc"/> key.
225 <display_text>Show Distance to End of Route</display_text> - Show
226 the distance left to be traveled (along the current route) until
227 the end of the current route. The calculated distance includes
228 the distance between breaks in the route (i.e. between the end of
229 one route segment and the beginning of another route segment).
230 This action can be assigned to the <graphic
231 filename="2686KEY_esc"/> key.
234 <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
235 of your progress along the current route. Use this if Maemo
236 Mapper loses track of where you are with respect to the current
240 <display_text>Reset</display_text> - Clear the current route,
241 effectively replacing it with an empty route.
244 <heading>Track</heading>
246 The <display_text>Track</display_text> menu is used to manipulate
247 your current <i>track</i>. A track in Maemo Mapper is defined as
248 a set of points along which you have been traveling, i.e. <i>where
249 you have been</i>. It can include multiple segments. Tracks are
250 most useful if you have enabled a GPS receiver. The current track
251 is empty until you get at least one valid position point from your
252 GPS receiver, and it is appendeded to whenever you stray far enough
253 from the last track point.
256 The <display_text>Track</display_text> menu has the following menu
261 <display_text>Open...</display_text> - Open a track from a GPX
262 file on the file system. In contrast to route data, the opened
263 track is <i>prepended</i> to the current track, so if you are
264 trying to rebuild previous track data, you must open the tracks
265 backward in time (most recent tracks first).
268 <display_text>Save...</display_text> - Save the current track to a
269 GPX file on the file system.
272 <display_text>Insert Mark</display_text> - Artificially insert a
273 mark in your current track data. This can be used to track, for
274 example, refueling stops. Note that Maemo Mapper automatically
275 inserts marks when contact with a GPS receiver is established or
277 This action can be assigned to the <graphic
278 filename="2686KEY_esc"/> key.
281 <display_text>Show Distance from Last Mark</display_text> - Show
282 the distance traveled (along the current track) since the last
284 This action can be assigned to the <graphic
285 filename="2686KEY_esc"/> key.
288 <display_text>Show Distance from Beginning</display_text> - Show
289 the distance traveled (along the current track) since the
290 beginning of the track. The calculated distance includes the
291 distance between breaks in the track (i.e. between when a GPS fix
292 is lost and later re-acquired).
293 This action can be assigned to the <graphic
294 filename="2686KEY_esc"/> key.
297 <display_text>Clear</display_text> - Clear the current track,
298 effectively replacing it with an empty track.
301 <heading>Maps</heading>
303 The <display_text>Maps</display_text> menu is used to control your
304 map repositories. This menu will be populated with a list of all of
305 your map repositories, from which you can select to switch to a
306 particular repository.
309 The <display_text>Maps</display_text> menu has the following menu
310 items in addition to the list of available repositories:
314 <display_text>Manage Maps...</display_text> - Download or delete
315 maps for the currently selected repository. For more details, see
316 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
319 <display_text>Manage Repositories...</display_text> - Configure
320 each of your available repositories, or add new ones. You can
321 also download a pre-defined set of repositories. For more
322 details, see <ref refid="help_maemomapper_repoman"
323 refdoc="Managing Repositories"/>.
326 <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
327 ability to automatically download maps as they are needed in order
328 to fill the screen with map data. This is useful for arbitrary
329 exploration of the world while connected to the internet, or if
330 you have a constant connection to the internet (i.e. via a
331 cellular data service).
334 <heading>View</heading>
336 The <display_text>View</display_text> menu allows you to customize
337 the view by showing or hiding certain features of the display.
340 The <display_text>View</display_text> menu has the following menu
345 <display_text>Full Screen</display_text> - Toggle full-screen
346 mode. You can also use the <graphic
347 filename="2686KEY_zoom_full_screen"/> button to toggle
351 <display_text>Route</display_text> - Toggle the display of routes.
354 <display_text>Track</display_text> - Toggle the display of tracks.
357 <display_text>Velocity Vector</display_text> - Toggle the display
358 of the velocity vector (the blue line extending from the blue
359 circle that represents your current location).
362 <display_text>POIs</display_text> - Toggle the display of POIs.
363 This action can be assigned to the <graphic
364 filename="2686KEY_esc"/> key.
367 <display_text>POI Categories...</display_text> - Define POI
368 categories and which categories are displayed on the map. For
369 more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
373 <heading>Auto-Center</heading>
375 The <display_text>Auto-Center</display_text> menu is used to control
376 whether or not Maemo Mapper should re-center the display as your
377 current location changes. The sensitivity of re-centering (how
378 close you get to the edge of the display before Maemo Mapper
379 re-centers the display) can be configured in the <ref
380 refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
383 There are three different modes of Auto-Center:
387 <display_text>Lat/Lon</display_text> - Keep your location centered
391 <display_text>Lead</display_text> - Depending on your speed, keep
392 a location in front of you centered on the screen. The faster you
393 are going, the more lead distance is used.
396 <display_text>None</display_text> - Do no re-center the display
400 <heading>Go to</heading>
402 The <display_text>Go to</display_text> menu is used to center the
403 view on a particular location.
406 The <display_text>Go to</display_text> menu has the following menu
411 <display_text>Lat/Lon...</display_text> - Specify an exact
412 Latitude and Longitude on which to center the display.
415 <display_text>GPS Position</display_text> - Center the display on
416 your current GPS position. This is the manual counter-part of
417 the <display_text>Auto-Center</display_text> functionality
421 <display_text>Next Waypoint</display_text> - Center the display on
422 the next waypoint in your route. By default, the next waypoint is
423 colored a slightly darker green than normal waypoints.
426 <display_text>Nearest POI</display_text> - Center the display on
427 the enabled POI nearest to the current view center.
430 <heading>GPS</heading>
432 The <display_text>GPS</display_text> menu is used to access features
433 of the GPS receiver, including textual information not displayed on
434 the map. It is also used to control your connection to the GPS
439 <display_text>Enable GPS</display_text> - Toggle communication
440 with a GPS receiver. You must have a GPS receiver set up in order
441 to use this menu item. When on, Maemo Mapper will constantly
442 search for the GPS receiver.
443 This action can be assigned to the <graphic
444 filename="2686KEY_esc"/> key.
447 <display_text>Show Information</display_text> - Toggle display of
448 additional information provided by the GPS receiver. This
449 information will appear in the main display as a panel on the
451 This action can be assigned to the <graphic
452 filename="2686KEY_esc"/> key.
455 <display_text>Details...</display_text> - Show even more
456 information provided by the GPS receiver, including a polar plot
457 of all GPS satellites in view.
460 <display_text>Reset Bluetooth</display_text> - Attempt to reset
461 the bluetooth radio, in case it locks up for some reason. In
462 order for this to succeed, you <i>must</i> add the following line
463 to your /etc/sudoers file (if you don't know what that means,
464 don't try it): <b>user ALL = NOPASSWD: /usr/sbin/hciconfig hci0
466 This action can be assigned to the <graphic
467 filename="2686KEY_esc"/> key.
470 <heading>Other</heading>
472 In addition to the above menus, there are a few other items in the
477 <display_text>Settings...</display_text> - Access and change
478 settings for using Maemo Mapper. For more information, see <ref
479 refid="help_maemomapper_settings" refdoc="Settings"/>.
482 <display_text>Help</display_text> - Access this help file.
485 <display_text>Close</display_text> - Close Maemo Mapper.
490 <topictitle>Context Menu</topictitle>
491 <context contextUID="help_maemomapper_cmenu"/>
493 By tapping and holding on the screen, you can access the context
494 menu to execute actions on either that location, the nearest route
495 waypoint, or the nearest POI.
498 The context menu is separated into two hierarchical levels. The
499 first level (<display_text>Location</display_text>,
500 <display_text>Waypoint</display_text>, or
501 <display_text>POI</display_text>) determines what kind of data on
502 which the operation applies.
504 <heading>Location</heading>
506 The <display_text>Location</display_text> submenu performs actions
507 on the exactly latitude and longitude on which the tap-and-hold
508 operation was performed. With that location, you can do the
513 <display_text>Show Lat/Lon</display_text> - Display the latitude
514 and longitude of the selected location, in the style chosen in
515 <display_text>Settings</display_text>
518 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
519 longitude of the selected location to the clipboard, in
520 comma-separated decimal format.
523 <display_text>Show Distance to</display_text> - Display the
524 distance (in a straight line) to the selected location.
527 <display_text>Download Route to...</display_text> - Open the
528 <ref refid="help_maemomapper_downroute"
529 refdoc="Download Route"/> dialog with the selected location
530 pre-filled as the destination.
533 <display_text>Add Route Point</display_text> - Add a point to the
534 current route, based on the selected location. The point is not a
538 <display_text>Add Waypoint...</display_text> - Add a waypoint
539 to the current route, based on the selected location. You must
540 provide a description for the waypoint to be legitimate. By
541 specifying an empty description, however, you can create a break
542 in the route. The break will not be connected to the rest of the
543 route, so it can be used to start a new segment.
546 <display_text>Add POI...</display_text> - Add a POI to the POI
547 database, based on the selected location. If the category in
548 which you place the POI is disabled, it will not be visible on the
549 map after creation, but it will still be in the database.
552 <display_text>Set as GPS Position</display_text> - Force Maemo
553 Mapper to consider the selected location to be the current GPS
554 location. This will not affect the current track, but it will
555 change the location of the blue circle that represents your
556 current location, and it can be used to calculate a route from
560 <heading>Waypoint</heading>
562 The <display_text>Waypoint</display_text> submenu performs actions
563 on the waypoint nearest to the point on which the tap-and-hold
564 operation was performed. If no waypoints are nearby, an error
565 message will be displayed.
569 <display_text>Show Lat/Lon</display_text> - Show the latitude and
570 longitude of the selected waypoint, in the style chosen in
571 <display_text>Settings</display_text>.
574 <display_text>Show Description</display_text> - Show the
575 description attached to the select waypoint. When downloading
576 routes via the <ref refid="help_maemomapper_downroute"
577 refdoc="Download Route"/> dialog, the description will contain
578 the directions needed to take at that waypoint (e.g. "Turn left at
579 Main Street. Go 2.5 kilometers.").
582 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
583 longitude of the selected waypoint to the clipboard, in
584 comma-separated decimal format.
587 <display_text>Copy Description</display_text> - Copy the
588 description of the waypoint to the clipboard.
591 <display_text>Show Distance to</display_text> - Show the distance
592 left to be traveled (along the current route) until the selected
593 waypoint. The calculated distance includes the distance between
594 breaks in the route (i.e. between the end of one route segment and
595 the beginning of another route segment).
598 <display_text>Download Route to...</display_text> - Open the
599 <ref refid="help_maemomapper_downroute"
600 refdoc="Download Route"/> dialog with the selected waypoint's
601 location pre-filled as the destination.
604 <display_text>Delete...</display_text> - Delete the selected
605 waypoint from the current route. This will delete all route
606 segments surrounding the route, including (and limited to) all the
607 points from that waypoint to the next and previous waypoints.
610 <display_text>Add POI...</display_text> - Add a POI to the POI
611 database, based on the selected waypoint's location. If the
612 category in which you place the POI is disabled, it will not be
613 visible on the map after creation, but it will still be in the
617 <heading>POI</heading>
619 The <display_text>POI</display_text> submenu performs actions
620 on the POI nearest to the point on which the tap-and-hold operation
621 was performed. If no POIs are nearby, an error message will be
626 <display_text>View/Edit</display_text> - View and/or edit the
630 <display_text>Show Distance to</display_text> - Display the
631 distance (in a straight line) to the selected POI.
634 <display_text>Download Route to...</display_text> - Open the
635 <ref refid="help_maemomapper_downroute"
636 refdoc="Download Route"/> dialog with the selected POI's
637 location pre-filled as the destination.
640 <display_text>Add Route Point</display_text> - Add a point to the
641 current route, based on the selected POI's location. The point is
645 <display_text>Add Waypoint...</display_text> - Add a waypoint
646 to the current route, based on the selected location. You must
647 provide a description for the waypoint to be legitimate. By
648 specifying an empty description, however, you can create a break
649 in the route. The break will not be connected to the rest of the
650 route, so it can be used to start a new segment.
655 <topictitle>Managing Repositories</topictitle>
656 <context contextUID="help_maemomapper_repoman"/>
658 In Maemo Mapper, map data is divided into specific areas called
659 <i>repositories</i>. A repository is a source of map data, each of
660 which has its own way of visualizing the Earth. For example,
661 repositories based on street maps typically draw roads as lines and
662 buildings as areas, whereas repositories based on satellite data
663 draw the Earth as it would appear from space. There are also
664 "hybrid" repositories that overlay street map data on top of
665 satellite data, as well as topographical maps that show altitude
669 Each repository is made up of maps at 16 different zoom levels.
670 Zoom Level 0 is the highest resolution (closest to the Earth, i.e.
671 "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest
672 from the Earth, i.e. "zoomed out"). Not all repositories are
673 available at all zoom levels, and some repositories may even produce
674 an error (which you can ignore) if you try to download maps at that
678 Once you have set up at least one repository, you can start
679 downloading maps from that repository to your device's file system.
680 For details on how to do this, see
681 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
684 You can set up any number of repositories in Maemo Mapper, but only
685 one can be active at any given time. The <display_text>Manage
686 Repositories</display_text> dialog is accessed via the
687 <display_text>Manage Repositories...</display_text> menu item of the
688 <display_text>Maps</display_text> menu, and it allows you to add,
689 edit, and remove repositories.
692 The <display_text>Manage Repositories...</display_text> has a combo
693 box that controls which repository is being viewed and edited. When
694 a repository is selected, the controls below it display the current
695 settings, which you can change:
699 <display_text>URL Format</display_text> - A specially formatted
700 string that looks like a URL, but it needs to have at least one
701 printf-style substitution strings (like %f or %s). Normally, you
702 must either get these URL formats from the internet
703 (www.internettablettalk.com is a good source), or you can use the
704 <display_text>Download...</display_text> button in the
705 Repositories dialog box to download a sample.
708 <display_text>Cache Dir.</display_text> - A directory on the file
709 system (either on the device's internal memory, or an external
710 memory card) in which maps are stored. Maps are kept here
711 indefinitely (until you delete them), so pick a directory with a
712 lot of free space. You can use the
713 <display_text>Browse...</display_text> button to select the
714 directory with a graphical file system browser, or you can enter
715 the directory manually.
718 <display_text>Download Zoom Steps</display_text> - Controls which
719 zoom levels should be avoided when automatically downloading maps
720 (i.e. Auto-Download is enabled). The lowest setting (one bar)
721 means to download every zoom level. The highest setting (four
722 bars) causes Maemo Mapper to only download every fourth zoom level
726 <display_text>View Zoom Steps</display_text> - Similar to the
727 above-described <display_text>Download Zoom Steps</display_text>
728 option, except that it controls how Maemo Mapper behaves when
729 zooming. For example, at two bars, pressing
730 <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
731 in two levels instead of just one. Setting this equal to
732 <display_text>Download Zoom Steps</display_text> ensures that you
733 see all maps at their native resolution.
737 In addition to the per-repository controls, there are a few buttons
738 that provide additional functionality:
742 <display_text>Rename...</display_text> - Renames the currently
746 <display_text>Delete...</display_text> - Deletes the currently
750 <display_text>New...</display_text> - Adds a new repository.
753 <display_text>Download...</display_text> - Downloads information
754 about several preset repositories, and adds them to your
755 repository list. They will be appended to any existing
756 repositories you already have. They are not read-only - you may
757 edit them as you wish. This is a good way to get started.
761 Certain repositories (most notably, the commercial ones) may
762 have license agreements attached with their use. It may be
763 illegal to use a certain repository with Maemo Mapper or under
764 certain conditions. This includes the repositories downloaded
765 via the <display_text>Download...</display_text> button. If you
766 are not sure if you are legally allowed to use a particular
767 repository, you should delete it from your list of repositories.
768 The authors of Maemo Mapper cannot be held responsible for your
769 use of a particular repository.
773 <topictitle>Downloading Routes</topictitle>
774 <context contextUID="help_maemomapper_downroute"/>
776 Route data can be loaded from GPX files, like the ones provided by
777 the GPX Driving Directions web service
778 (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be
779 downloaded directly within Maemo Mapper using the
780 <display_text>Download Route</display_text> dialog.
783 Downloading routes requires an active connection to the internet,
784 but once a route is loaded into Maemo Mapper, the internet
785 connection is no longer needed (unless
786 <display_text>Auto-Update</display_text> is enabled). The route
787 download functionality in Maemo Mapper actually uses the
788 aforementioned GPX Driving Directions web service.
791 The <display_text>Download Route</display_text> dialog contains the
796 <display_text>Source URL</display_text> - The web service from
797 which driving directions are retrieved. The default is fine, and
798 it is usually left unchanged.
801 <display_text>Auto-Update</display_text> - This option, only
802 available if <display_text>Use GPS Location</display_text> is
803 enabled, will cause Maemo Mapper to automatically re-download a
804 new route if you stray from the route. Note that you must have a
805 continuous connection to the internet (i.e. cellular data service)
806 for Auto-Update to work.
809 <display_text>Use GPS Location</display_text> - If selected, then
810 the current GPS location will be used as the
811 <display_text>Origin</display_text>.
814 <display_text>Use End of Route</display_text> - If selected, then
815 the end of the route will be used as the
816 <display_text>Origin</display_text>. This is useful for stringing
817 together multiple route downloads into a single route.
820 <display_text>Origin</display_text> - If selected, then you must
821 enter your own origin. An origin can be specified in any format
822 understood by Google Maps. Some examples: "25, -43" (lat/lon),
823 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
824 "5th and Main, 12151". In fact, if your route download fails with
825 a "Could not generate directions" error message, you can use
826 Google Maps to test your origin for accuracy.
829 <display_text>Destination</display_text> - The destination to
830 which the directions will lead. Like the
831 <display_text>Origin</display_text>, a destination can be
832 specified in any format understood by Google Maps.
837 <topictitle>Managing Maps</topictitle>
838 <context contextUID="help_maemomapper_mapman"/>
840 In Maemo Mapper, <i>repositories</i> represent sources of map data,
841 and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
842 drawn onto the screen. Once you have a repository set up (see
843 <ref refid="help_maemomapper_repoman"
844 refdoc="Managing Repositories"/>), you can download maps from a
845 repository into a Map Cache, which is just a directory on your
846 device's file system.
849 Maemo Mapper downloads maps from the current repository so that they
850 can be drawn onto the screen and later recalled from disk, instead
851 of downloading a map every time it is needed. This is called
852 <i>caching</i>, and it allows you to use Maemo Mapper even when you
853 are not connected to the internet.
856 Because Maemo Mapper downloads maps to your device's file system,
857 you must be aware of how much disk space your maps are taking up,
858 especially if you enable Auto-Download.
861 Aside from the Auto-Download functionality, you can also download
862 maps manually using the <display_text>Manage Maps...</display_text>
863 menu item of the <display_text>Maps</display_text> menu. The
864 <display_text>Manage Maps</display_text> dialog allows you to
865 download, overwrite, or delete maps, either by area or along your
866 current route. It contains up to three tabs, all of which control
867 which and how many maps are downloaded.
869 <heading>Setup</heading>
871 The <display_text>Setup</display_text> tab controls what you what to
872 do. You can download maps (optionally overwriting
873 already-downloaded maps) from the current repository to your
874 device's file system, or you can delete maps (pertaining to the
875 current repository) from your device's file system. Both of these
876 operations can be done either over a rectangular area or along your
881 <display_text>Download Maps</display_text> - If selected, Maemo
882 Mapper will download maps from the current repository to your
883 device's file system, for the area you specify. By default, Maemo
884 Mapper only downloads the maps that you don't already have.
887 <display_text>Overwrite</display_text> - If selected, then Maemo
888 Mapper will download maps and overwrite any maps that you may have
892 <display_text>Delete Maps</display_text> - If selected, Maemo
893 Mapper will delete maps from your file system, for the area you
897 <display_text>By Area</display_text> - If selected, Maemo Mapper
898 will download or delete maps for a particular rectangular area of
899 the world, based on the latitude and longitude of an upper-left
900 and lower-right corner. See the <display_text>Area</display_text>
901 tab to specify the coordinates.
904 <display_text>Along Route</display_text> - If selected, Maemo
905 Mapper will download or delete maps along your current route.
906 This is useful if, for example, you are about to embark on a trip
907 and want to make sure that you have maps for all points along the
911 <display_text>Radius (tiles)</display_text> - If
912 <display_text>Along Route</display_text> is selected, then you can
913 specify the radius around your route for which maps will be
914 downloaded or deleted. For example, if you specify 4 (the
915 default), then Maemo Mapper will download all tiles that are
916 within 4 tiles of your route.
919 <heading>Zoom</heading>
921 The <display_text>Zoom</display_text> tab controls which zoom levels
922 at which maps are downloaded or deleted. The current zoom level is
923 selected by default, but you can enable or disable any zoom levels
926 <heading>Area</heading>
928 The <display_text>Area</display_text> tab, available if the
929 <display_text>By Area</display_text> option is selected in the
930 <display_text>Setup</display_text> tab, defines the rectangular area
931 of the world for which maps will be downloaded or deleted. If
932 applicable, the fields are pre-filled with your current and previous
933 view center coordinates. This allows you to graphically choose your
934 rectangle by first centering on one corner of the rectangle, then
935 centering on the opposite corner, by tapping the screen or by using
936 the <display_text>Lat/Lon</display_text> menu item of the
937 <display_text>Go to</display_text> menu.
941 <topictitle>POI Categories</topictitle>
942 <context contextUID="help_maemomapper_poicat"/>
944 POI Categories are a means by which you can organize your POIs for
945 selective display. The <display_text>POI Categories</display_text>
946 dialog is accessed from the <display_text>View</display_text> menu
947 and allows you to enable/disable, add, edit, or delete categories.
950 Each row in the table represents a category. There are three
951 columns displayed for each category:
955 <display_text>Enabled</display_text> - Controls whether or not
956 POIs in this category are drawn on the map.
959 <display_text>Label</display_text> - A short label to describe the
960 category. This is the name that will be visible when viewing a
964 <display_text>Description</display_text> - A longer description of
965 the category. This description is not visible anywhere except in
966 this dialog; it is only used to get an idea of how the category is
971 Selecting a row in the table and pressing the
972 <display_text>Edit</display_text> button will allow you to edit the
973 above three attributes of a category, and to delete a category. You
974 can also add a new category by using the
975 <display_text>Add</display_text> button.
978 A POI may only be associated with a single category at a time.
982 <topictitle>Settings</topictitle>
983 <context contextUID="help_maemomapper_settings"/>
985 The <display_text>Settings</display_text> dialog (accessible from
986 the main menu) provides access to a plethora of configurable options
987 that control how Maemo Mapper appears and runs. In addition to the
988 <display_text>Colors...</display_text> button (which allows you to
989 customize the colors that are used for drawing on-map objects), there
990 are several tabs in the dialog, each of which tries to group sets of
993 <heading>GPS</heading>
995 The <display_text>GPS</display_text> tab tells Maemo Mapper which
996 bluetooth device from which to retrieve GPS data. It is only
997 applicable if you have a bluetooth GPS receiver with which to use
1001 Enter the MAC address in the field provided. If you don't know the
1002 MAC address, turn on your receiver and press the
1003 <display_text>Scan...</display_text> button to select it from a
1004 list of nearby bluetooth devices.
1007 <i>Alternatively</i>, if you are using rfcomm or any other
1008 file-system-based NMEA input source, you can provide a pathname
1009 (beginning with a leading slash) such as "/dev/rfcomm1". In this
1010 case, Maemo Mapper will read NMEA sentences from the file system
1011 instead of via bluetooth.
1013 <heading>Auto-Center</heading>
1015 The <display_text>Auto-Center</display_text> tab allows you to
1016 configure how Maemo Mapper automatically re-centers the display when
1017 either <display_text>Lat/Lon</display_text> or
1018 <display_text>Lead</display_text> is enabled from the
1019 <display_text>Auto-Center</display_text> menu. The Auto-Center
1020 feature is most useful in conjunction with a GPS receiver.
1024 <display_text>Sensitivity</display_text> - Controls how often
1025 Maemo Mapper re-centers the display, based on how close your
1026 position (or the position of your <i>lead</i>) gets to the edge of
1027 the screen. When set to a low value, Maemo Mapper will only
1028 re-center the screen when you are near the edge of the screen.
1029 When set to the maximum, Maemo Mapper will keep your position as
1030 close to the center as possible.
1033 <display_text>Lead Amount</display_text> - When Auto-Center is set
1034 to <display_text>Lead</display_text>, then Maemo Mapper will keep
1035 the center of the screen focused on an area in front of you. When
1036 driving, this allows you to view more of the road ahead of you.
1037 The distance in front of you on which the screen is centered is
1038 based on two variables: your current speed and the value of the
1039 <display_text>Lead Amount</display_text> option.
1042 <heading>Announce</heading>
1044 The <display_text>Announce</display_text> tab controls how and when
1045 Maemo Mapper displays or speaks waypoint information. When you
1046 approach a waypoint in your route (defined by the presence of a
1047 description in the GPX file), Maemo Mapper will pop up a text box
1048 with the contents of that description. When downloading routes from
1049 within Maemo Mapper, the text describes your next action, e.g. "Turn
1050 left at Main Street. Go 2.4 miles."
1053 As you approach a waypoint, Maemo Mapper will continue to display
1054 the description of that waypoint, so long as you are within the
1055 range defined by the <display_text>Advance Notice</display_text>
1056 option, or until you pass the waypoint. Because the amount of
1057 notice is dependent on your speed, it is possible to see the text,
1058 then slow down to a point where the notice disappears. This is
1059 possible, for example, if you are stopped at a red light. The text
1060 will reappear when you have picked up enough speed to again break
1061 the <display_text>Advance Notice</display_text> range.
1064 If you have installed <i>flite</i>, which is available in the same
1065 repository from which you downloaded Maemo Mapper, then Maemo Mapper
1066 can optionally also speak the same directions that appear on screen.
1067 Maemo Mapper will only speak the directions once, at the exact
1068 moment you first reach the distance from the waypoint defined by the
1069 <display_text>Advance Notice</display_text> option. The same
1070 directions are on-screen if you need to reference them.
1074 <display_text>Advance Notice</display_text> - Controls how much in
1075 advance Maemo Mapper begins to provide the waypoint description.
1076 The exact distance at which Maemo Mapper begins to announce a
1077 waypoint also depends on your speed, so the value of this option
1078 can be thought of more accurately in units of time. At the
1079 minimum value, Maemo Mapper gives you almost no notice. At the
1080 maximum value, Maemo Mapper gives you about two minutes of notice.
1081 Experiment to find your happy medium.
1084 <display_text>Enable Voice Synthesis</display_text> - If you have
1085 installed <i>flite</i>, this option will cause Maemo Mapper to
1086 speak the description of the next waypoint when you enter the
1087 range defined by the <display_text>Advance Notice</display_text>
1091 <heading>Misc.</heading>
1093 The <display_text>Misc.</display_text> and <display_text>Misc.
1094 2</display_text> tabs contain miscellaneous options.
1098 <display_text>Line Width</display_text> - Controls the thickness
1099 of all lines drawn on top of the map images. This includes your
1100 mark, all tracks and routes, and the default POI image.
1103 <display_text>Keep Display On Only in Fullscreen
1104 Mode</display_text> - Controls whether or not Maemo Mapper
1105 should limit its "Keep the display on" behavior to full screen
1106 mode only. If disabled, then Maemo Mapper will always keep the
1107 screen on, as long as you are moving. If enabled, Maemo Mapper
1108 will only keep the screen on in full screen mode.
1111 <display_text>Escape Key</display_text> - The <graphic
1112 filename="2686KEY_esc"/> key can be programmed to perform any
1113 number of functions. All of these functions are available from
1114 the main menu, except for <display_text>Toggle Speed
1115 Limit</display_text>, which is available from the
1116 <display_text>Settings</display_text> dialog.
1119 <display_text>Units</display_text> - Controls the units in which
1120 distances and speeds are displayed in the user interface.
1123 <display_text>Degrees Format</display_text> - Controls how
1124 latitude and longitudes are displayed in the user interface.
1127 <display_text>Speed Limit</display_text> - Enables notification
1128 when you have exceeded the given speed limit (specified in the
1129 units defined via the <display_text>Units</display_text> option.
1132 <display_text>Location</display_text> - Controls the location on
1133 the screen of the speed warning.
1136 <display_text>Information Font Size</display_text> - Controls the
1137 font size for all information that is popped up to the user in the
1138 upper-right corner, including waypoint descriptions.
1141 <heading>POI</heading>
1143 The <display_text>POI</display_text> tab allows you to define your
1144 POI database and how POIs are drawn on the screen.
1148 <display_text>POI database</display_text> - The location on the
1149 file system where the POI database is located. The database must
1150 be in sqlite3 format. A default (empty) POI database is
1151 automatically created for you when you first run Maemo Mapper.
1154 <display_text>Show POI below zoom</display_text> - Defines the
1155 maximum zoom (furthest away from the Earth) at which POIs will be
1156 drawn. When zoomed out beyond this level, no POIs will be drawn.
projects / maemo-mapper / blob