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
223 <display_text>Show Distance to End of Route</display_text> - Show
224 the distance left to be traveled (along the current route) until
225 the end of the current route. The calculated distance includes
226 the distance between breaks in the route (i.e. between the end of
227 one route segment and the beginning of another route segment).
230 <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
231 of your progress along the current route. Use this if Maemo
232 Mapper loses track of where you are with respect to the current
236 <display_text>Reset</display_text> - Clear the current route,
237 effectively replacing it with an empty route.
240 <heading>Track</heading>
242 The <display_text>Track</display_text> menu is used to manipulate
243 your current <i>track</i>. A track in Maemo Mapper is defined as
244 a set of points along which you have been traveling, i.e. <i>where
245 you have been</i>. It can include multiple segments. Tracks are
246 most useful if you have enabled a GPS receiver. The current track
247 is empty until you get at least one valid position point from your
248 GPS receiver, and it is appendeded to whenever you stray far enough
249 from the last track point.
252 The <display_text>Track</display_text> menu has the following menu
257 <display_text>Open...</display_text> - Open a track from a GPX
258 file on the file system. In contrast to route data, the opened
259 track is <i>prepended</i> to the current track, so if you are
260 trying to rebuild previous track data, you must open the tracks
261 backward in time (most recent tracks first).
264 <display_text>Save...</display_text> - Save the current track to a
265 GPX file on the file system.
268 <display_text>Insert Break</display_text> - Artificially insert a
269 break in your current track data. This simulates the loss and
270 re-acquisition of a GPS fix, and it can be used to track, for
271 example, refueling stops.
274 <display_text>Insert Mark</display_text> - Artificially insert a
275 mark with a description in your current track data. This can be
276 used to mark important landmarks.
279 <display_text>Show Distance from Last Break</display_text> - Show
280 the distance traveled (along the current track) since the last
284 <display_text>Show Distance from Beginning</display_text> - Show
285 the distance traveled (along the current track) since the
286 beginning of the track. The calculated distance includes the
287 distance between breaks in the track (i.e. between when a GPS fix
288 is lost and later re-acquired).
291 <display_text>Clear</display_text> - Clear the current track,
292 effectively replacing it with an empty track.
295 <heading>Maps</heading>
297 The <display_text>Maps</display_text> menu is used to control your
298 map repositories. This menu will be populated with a list of all of
299 your map repositories, from which you can select to switch to a
300 particular repository.
303 The <display_text>Maps</display_text> menu has the following menu
304 items in addition to the list of available repositories:
308 <display_text>Manage Maps...</display_text> - Download or delete
309 maps for the currently selected repository. For more details, see
310 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
313 <display_text>Manage Repositories...</display_text> - Configure
314 each of your available repositories, or add new ones. You can
315 also download a pre-defined set of repositories. For more
316 details, see <ref refid="help_maemomapper_repoman"
317 refdoc="Managing Repositories"/>.
320 <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
321 ability to automatically download maps as they are needed in order
322 to fill the screen with map data. This is useful for arbitrary
323 exploration of the world while connected to the internet, or if
324 you have a constant connection to the internet (i.e. via a
325 cellular data service).
328 <heading>View</heading>
330 The <display_text>View</display_text> menu allows you to customize
331 the view by showing or hiding certain features of the display.
334 The <display_text>View</display_text> menu has the following menu
339 <display_text>Zoom In</display_text> - Zoom in by one zoom level.
340 You can also use the <graphic
341 filename="2686KEY_zoom_in"/> button.
344 <display_text>Zoom Out</display_text> - Zoom out by one zoom
345 level. You can also use the <graphic
346 filename="2686KEY_zoom_out"/> button.
349 <display_text>Full Screen</display_text> - Toggle full-screen
350 mode. You can also use the <graphic
351 filename="2686KEY_full_screen"/> button to toggle
355 <display_text>Scale</display_text> - Toggle the display of the
359 <display_text>Route</display_text> - Toggle the display of routes.
362 <display_text>Track</display_text> - Toggle the display of tracks.
365 <display_text>Velocity Vector</display_text> - Toggle the display
366 of the velocity vector (the blue line extending from the blue
367 circle that represents your current location).
370 <display_text>POIs</display_text> - Toggle the display of POIs.
373 <display_text>POI Categories...</display_text> - Define POI
374 categories and which categories are displayed on the map. For
375 more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
379 <heading>Auto-Center</heading>
381 The <display_text>Auto-Center</display_text> menu is used to control
382 whether or not Maemo Mapper should re-center the display as your
383 current location changes. The sensitivity of re-centering (how
384 close you get to the edge of the display before Maemo Mapper
385 re-centers the display) can be configured in the <ref
386 refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
389 There are three different modes of Auto-Center:
393 <display_text>Lat/Lon</display_text> - Keep your location centered
397 <display_text>Lead</display_text> - Depending on your speed, keep
398 a location in front of you centered on the screen. The faster you
399 are going, the more lead distance is used.
402 <display_text>None</display_text> - Do no re-center the display
406 <heading>Go to</heading>
408 The <display_text>Go to</display_text> menu is used to center the
409 view on a particular location.
412 The <display_text>Go to</display_text> menu has the following menu
417 <display_text>Lat/Lon...</display_text> - Specify an exact
418 Latitude and Longitude on which to center the display.
421 <display_text>GPS Position</display_text> - Center the display on
422 your current GPS position. This is the manual counter-part of
423 the <display_text>Auto-Center</display_text> functionality
427 <display_text>Next Waypoint</display_text> - Center the display on
428 the next waypoint in your route. By default, the next waypoint is
429 colored a slightly darker green than normal waypoints.
432 <display_text>Nearest POI</display_text> - Center the display on
433 the enabled POI nearest to the current view center.
436 <heading>GPS</heading>
438 The <display_text>GPS</display_text> menu is used to access features
439 of the GPS receiver, including textual information not displayed on
440 the map. It is also used to control your connection to the GPS
445 <display_text>Enable GPS</display_text> - Toggle communication
446 with a GPS receiver. You must have a GPS receiver set up in order
447 to use this menu item. When on, Maemo Mapper will constantly
448 search for the GPS receiver.
451 <display_text>Show Information</display_text> - Toggle display of
452 additional information provided by the GPS receiver. This
453 information will appear in the main display as a panel on the
457 <display_text>Details...</display_text> - Show even more
458 information provided by the GPS receiver, including a polar plot
459 of all GPS satellites in view.
462 <display_text>Reset Bluetooth</display_text> - Attempt to reset
463 the bluetooth radio, in case it locks up for some reason. In
464 order for this to succeed, you <i>must</i> add the following line
465 to your /etc/sudoers file (if you don't know what that means,
466 don't try it): <b>user ALL = NOPASSWD: /usr/sbin/hciconfig hci0
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>About...</display_text> - Display version and
486 copyright information.
489 <display_text>Close</display_text> - Close Maemo Mapper.
494 <topictitle>Context Menu</topictitle>
495 <context contextUID="help_maemomapper_cmenu"/>
497 By tapping and holding on the screen, you can access the context
498 menu to execute actions on either that location, the nearest route
499 waypoint, or the nearest POI.
502 The context menu is separated into two hierarchical levels. The
503 first level (<display_text>Location</display_text>,
504 <display_text>Waypoint</display_text>, or
505 <display_text>POI</display_text>) determines what kind of data on
506 which the operation applies.
508 <heading>Location</heading>
510 The <display_text>Location</display_text> submenu performs actions
511 on the exactly latitude and longitude on which the tap-and-hold
512 operation was performed. With that location, you can do the
517 <display_text>Show Lat/Lon</display_text> - Display the latitude
518 and longitude of the selected location, in the style chosen in
519 <display_text>Settings</display_text>
522 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
523 longitude of the selected location to the clipboard, in
524 comma-separated decimal format.
527 <display_text>Show Distance to</display_text> - Display the
528 distance (in a straight line) to the selected location.
531 <display_text>Download Route to...</display_text> - Open the
532 <ref refid="help_maemomapper_downroute"
533 refdoc="Download Route"/> dialog with the selected location
534 pre-filled as the destination.
537 <display_text>Add Route Point</display_text> - Add a point to the
538 current route, based on the selected location. The point is not a
542 <display_text>Add Waypoint...</display_text> - Add a waypoint
543 to the current route, based on the selected location. You must
544 provide a description for the waypoint to be legitimate. By
545 specifying an empty description, however, you can create a break
546 in the route. The break will not be connected to the rest of the
547 route, so it can be used to start a new segment.
550 <display_text>Add POI...</display_text> - Add a POI to the POI
551 database, based on the selected location. If the category in
552 which you place the POI is disabled, it will not be visible on the
553 map after creation, but it will still be in the database.
556 <display_text>Set as GPS Position</display_text> - Force Maemo
557 Mapper to consider the selected location to be the current GPS
558 location. This will not affect the current track, but it will
559 change the location of the blue circle that represents your
560 current location, and it can be used to calculate a route from
564 <heading>Waypoint</heading>
566 The <display_text>Waypoint</display_text> submenu performs actions
567 on the waypoint nearest to the point on which the tap-and-hold
568 operation was performed. If no waypoints are nearby, an error
569 message will be displayed.
573 <display_text>Show Lat/Lon</display_text> - Show the latitude and
574 longitude of the selected waypoint, in the style chosen in
575 <display_text>Settings</display_text>.
578 <display_text>Show Description</display_text> - Show the
579 description attached to the select waypoint. When downloading
580 routes via the <ref refid="help_maemomapper_downroute"
581 refdoc="Download Route"/> dialog, the description will contain
582 the directions needed to take at that waypoint (e.g. "Turn left at
583 Main Street. Go 2.5 kilometers.").
586 <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
587 longitude of the selected waypoint to the clipboard, in
588 comma-separated decimal format.
591 <display_text>Copy Description</display_text> - Copy the
592 description of the waypoint to the clipboard.
595 <display_text>Show Distance to</display_text> - Show the distance
596 left to be traveled (along the current route) until the selected
597 waypoint. The calculated distance includes the distance between
598 breaks in the route (i.e. between the end of one route segment and
599 the beginning of another route segment).
602 <display_text>Download Route to...</display_text> - Open the
603 <ref refid="help_maemomapper_downroute"
604 refdoc="Download Route"/> dialog with the selected waypoint's
605 location pre-filled as the destination.
608 <display_text>Delete...</display_text> - Delete the selected
609 waypoint from the current route. This will delete all route
610 segments surrounding the route, including (and limited to) all the
611 points from that waypoint to the next and previous waypoints.
614 <display_text>Add POI...</display_text> - Add a POI to the POI
615 database, based on the selected waypoint's location. If the
616 category in which you place the POI is disabled, it will not be
617 visible on the map after creation, but it will still be in the
621 <heading>POI</heading>
623 The <display_text>POI</display_text> submenu performs actions
624 on the POI nearest to the point on which the tap-and-hold operation
625 was performed. If no POIs are nearby, an error message will be
630 <display_text>View/Edit</display_text> - View and/or edit the
634 <display_text>Show Distance to</display_text> - Display the
635 distance (in a straight line) to the selected POI.
638 <display_text>Download Route to...</display_text> - Open the
639 <ref refid="help_maemomapper_downroute"
640 refdoc="Download Route"/> dialog with the selected POI's
641 location pre-filled as the destination.
644 <display_text>Add Route Point</display_text> - Add a point to the
645 current route, based on the selected POI's location. The point is
649 <display_text>Add Waypoint...</display_text> - Add a waypoint
650 to the current route, based on the selected location. You must
651 provide a description for the waypoint to be legitimate. By
652 specifying an empty description, however, you can create a break
653 in the route. The break will not be connected to the rest of the
654 route, so it can be used to start a new segment.
659 <topictitle>Managing Repositories</topictitle>
660 <context contextUID="help_maemomapper_repoman"/>
662 In Maemo Mapper, map data is divided into specific areas called
663 <i>repositories</i>. A repository is a source of map data, each of
664 which has its own way of visualizing the Earth. For example,
665 repositories based on street maps typically draw roads as lines and
666 buildings as areas, whereas repositories based on satellite data
667 draw the Earth as it would appear from space. There are also
668 "hybrid" repositories that overlay street map data on top of
669 satellite data, as well as topographical maps that show altitude
673 Each repository is made up of maps at 16 different zoom levels.
674 Zoom Level 0 is the highest resolution (closest to the Earth, i.e.
675 "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest
676 from the Earth, i.e. "zoomed out"). Not all repositories are
677 available at all zoom levels, and some repositories may even produce
678 an error (which you can ignore) if you try to download maps at that
682 Once you have set up at least one repository, you can start
683 downloading maps from that repository to your device's file system.
684 For details on how to do this, see
685 <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
688 You can set up any number of repositories in Maemo Mapper, but only
689 one can be active at any given time. The <display_text>Manage
690 Repositories</display_text> dialog is accessed via the
691 <display_text>Manage Repositories...</display_text> menu item of the
692 <display_text>Maps</display_text> menu, and it allows you to add,
693 edit, and remove repositories.
696 The <display_text>Manage Repositories...</display_text> has a combo
697 box that controls which repository is being viewed and edited. When
698 a repository is selected, the controls below it display the current
699 settings, which you can change:
703 <display_text>URL Format</display_text> - A specially formatted
704 string that looks like a URL, but it needs to have at least one
705 printf-style substitution strings (like %f or %s). Normally, you
706 must either get these URL formats from the internet
707 (www.internettablettalk.com is a good source), or you can use the
708 <display_text>Download...</display_text> button in the
709 Repositories dialog box to download a sample.
712 <display_text>Cache Dir.</display_text> - A directory on the file
713 system (either on the device's internal memory, or an external
714 memory card) in which maps are stored. Maps are kept here
715 indefinitely (until you delete them), so pick a directory with a
716 lot of free space. You can use the
717 <display_text>Browse...</display_text> button to select the
718 directory with a graphical file system browser, or you can enter
719 the directory manually.
722 <display_text>Download Zoom Steps</display_text> - Controls which
723 zoom levels should be avoided when automatically downloading maps
724 (i.e. Auto-Download is enabled). The lowest setting (one bar)
725 means to download every zoom level. The highest setting (four
726 bars) causes Maemo Mapper to only download every fourth zoom level
730 <display_text>View Zoom Steps</display_text> - Similar to the
731 above-described <display_text>Download Zoom Steps</display_text>
732 option, except that it controls how Maemo Mapper behaves when
733 zooming. For example, at two bars, pressing
734 <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
735 in two levels instead of just one. Setting this equal to
736 <display_text>Download Zoom Steps</display_text> ensures that you
737 see all maps at their native resolution.
740 <display_text>Double Pixels</display_text> - This forces Maemo
741 Mapper to avoid using the native resolution of any maps, instead
742 using pixel-doubling. This is useful if your repository's maps
743 contain small, hard-to-read text, and you want to double the size
744 of the images to make them more readable. This setting can also
745 affect the zoom levels that are downloaded when Auto-Download is
749 <display_text>Next-able</display_text> - This oddly-named option
750 determines whether or not the "Select Next Repository" action
751 (which can be mapped to any of the hardware keys) will be able to
752 select this repository. When unset, the "Select Next Repository"
753 action will simply skip over this repository.
757 In addition to the per-repository controls, there are a few buttons
758 that provide additional functionality:
762 <display_text>Rename...</display_text> - Renames the currently
766 <display_text>Delete...</display_text> - Deletes the currently
770 <display_text>New...</display_text> - Adds a new repository.
773 <display_text>Reset...</display_text> - Resets your repository
774 list to the factory default. This will remove all of your
775 repositories and replace them with the single default repository
776 that comes with Maemo Mapper.
779 <display_text>Download...</display_text> - Downloads information
780 about several preset repositories, and adds them to your
781 repository list. They will be appended to any existing
782 repositories you already have. They are not read-only - you may
783 edit them as you wish. This is a good way to get started.
787 Certain repositories (most notably, the commercial ones) may
788 have license agreements attached with their use. It may be
789 illegal to use a certain repository with Maemo Mapper or under
790 certain conditions. This includes the repositories downloaded
791 via the <display_text>Download...</display_text> button. If you
792 are not sure if you are legally allowed to use a particular
793 repository, you should delete it from your list of repositories.
794 The authors of Maemo Mapper cannot be held responsible for your
795 use of a particular repository.
799 <topictitle>Downloading Routes</topictitle>
800 <context contextUID="help_maemomapper_downroute"/>
802 Route data can be loaded from GPX files, like the ones provided by
803 the GPX Driving Directions web service
804 (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be
805 downloaded directly within Maemo Mapper using the
806 <display_text>Download Route</display_text> dialog.
809 Downloading routes requires an active connection to the internet,
810 but once a route is loaded into Maemo Mapper, the internet
811 connection is no longer needed (unless
812 <display_text>Auto-Update</display_text> is enabled). The route
813 download functionality in Maemo Mapper actually uses the
814 aforementioned GPX Driving Directions web service.
817 The <display_text>Download Route</display_text> dialog contains the
822 <display_text>Source URL</display_text> - The web service from
823 which driving directions are retrieved. The default is fine, and
824 it is usually left unchanged.
827 <display_text>Auto-Update</display_text> - This option, only
828 available if <display_text>Use GPS Location</display_text> is
829 enabled, will cause Maemo Mapper to automatically re-download a
830 new route if you stray from the route. Note that you must have a
831 continuous connection to the internet (i.e. cellular data service)
832 for Auto-Update to work.
835 <display_text>Use GPS Location</display_text> - If selected, then
836 the current GPS location will be used as the
837 <display_text>Origin</display_text>.
840 <display_text>Use End of Route</display_text> - If selected, then
841 the end of the route will be used as the
842 <display_text>Origin</display_text>. This is useful for stringing
843 together multiple route downloads into a single route.
846 <display_text>Origin</display_text> - If selected, then you must
847 enter your own origin. An origin can be specified in any format
848 understood by Google Maps. Some examples: "25, -43" (lat/lon),
849 "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
850 "5th and Main, 12151". In fact, if your route download fails with
851 a "Could not generate directions" error message, you can use
852 Google Maps to test your origin for accuracy.
855 <display_text>Destination</display_text> - The destination to
856 which the directions will lead. Like the
857 <display_text>Origin</display_text>, a destination can be
858 specified in any format understood by Google Maps.
863 <topictitle>Managing Maps</topictitle>
864 <context contextUID="help_maemomapper_mapman"/>
866 In Maemo Mapper, <i>repositories</i> represent sources of map data,
867 and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
868 drawn onto the screen. Once you have a repository set up (see
869 <ref refid="help_maemomapper_repoman"
870 refdoc="Managing Repositories"/>), you can download maps from a
871 repository into a Map Cache, which is just a directory on your
872 device's file system.
875 Maemo Mapper downloads maps from the current repository so that they
876 can be drawn onto the screen and later recalled from disk, instead
877 of downloading a map every time it is needed. This is called
878 <i>caching</i>, and it allows you to use Maemo Mapper even when you
879 are not connected to the internet.
882 Because Maemo Mapper downloads maps to your device's file system,
883 you must be aware of how much disk space your maps are taking up,
884 especially if you enable Auto-Download.
887 Aside from the Auto-Download functionality, you can also download
888 maps manually using the <display_text>Manage Maps...</display_text>
889 menu item of the <display_text>Maps</display_text> menu. The
890 <display_text>Manage Maps</display_text> dialog allows you to
891 download, overwrite, or delete maps, either by area or along your
892 current route. It contains up to three tabs, all of which control
893 which and how many maps are downloaded.
895 <heading>Setup</heading>
897 The <display_text>Setup</display_text> tab controls what you what to
898 do. You can download maps (optionally overwriting
899 already-downloaded maps) from the current repository to your
900 device's file system, or you can delete maps (pertaining to the
901 current repository) from your device's file system. Both of these
902 operations can be done either over a rectangular area or along your
907 <display_text>Download Maps</display_text> - If selected, Maemo
908 Mapper will download maps from the current repository to your
909 device's file system, for the area you specify. By default, Maemo
910 Mapper only downloads the maps that you don't already have.
913 <display_text>Overwrite</display_text> - If selected, then Maemo
914 Mapper will download maps and overwrite any maps that you may have
918 <display_text>Delete Maps</display_text> - If selected, Maemo
919 Mapper will delete maps from your file system, for the area you
923 <display_text>By Area</display_text> - If selected, Maemo Mapper
924 will download or delete maps for a particular rectangular area of
925 the world, based on the latitude and longitude of an upper-left
926 and lower-right corner. See the <display_text>Area</display_text>
927 tab to specify the coordinates.
930 <display_text>Along Route</display_text> - If selected, Maemo
931 Mapper will download or delete maps along your current route.
932 This is useful if, for example, you are about to embark on a trip
933 and want to make sure that you have maps for all points along the
937 <display_text>Radius (tiles)</display_text> - If
938 <display_text>Along Route</display_text> is selected, then you can
939 specify the radius around your route for which maps will be
940 downloaded or deleted. For example, if you specify 4 (the
941 default), then Maemo Mapper will download all tiles that are
942 within 4 tiles of your route.
945 <heading>Zoom</heading>
947 The <display_text>Zoom</display_text> tab controls which zoom levels
948 at which maps are downloaded or deleted. The current zoom level is
949 selected by default, but you can enable or disable any zoom levels
952 <heading>Area</heading>
954 The <display_text>Area</display_text> tab, available if the
955 <display_text>By Area</display_text> option is selected in the
956 <display_text>Setup</display_text> tab, defines the rectangular area
957 of the world for which maps will be downloaded or deleted. If
958 applicable, the fields are pre-filled with your current and previous
959 view center coordinates. This allows you to graphically choose your
960 rectangle by first centering on one corner of the rectangle, then
961 centering on the opposite corner, by tapping the screen or by using
962 the <display_text>Lat/Lon</display_text> menu item of the
963 <display_text>Go to</display_text> menu.
967 <topictitle>POI Categories</topictitle>
968 <context contextUID="help_maemomapper_poicat"/>
970 POI Categories are a means by which you can organize your POIs for
971 selective display. The <display_text>POI Categories</display_text>
972 dialog is accessed from the <display_text>View</display_text> menu
973 and allows you to enable/disable, add, edit, or delete categories.
976 Each row in the table represents a category. There are three
977 columns displayed for each category:
981 <display_text>Enabled</display_text> - Controls whether or not
982 POIs in this category are drawn on the map.
985 <display_text>Label</display_text> - A short label to describe the
986 category. This is the name that will be visible when viewing a
990 <display_text>Description</display_text> - A longer description of
991 the category. This description is not visible anywhere except in
992 this dialog; it is only used to get an idea of how the category is
997 Selecting a row in the table and pressing the
998 <display_text>Edit</display_text> button will allow you to edit the
999 above three attributes of a category, and to delete a category. You
1000 can also add a new category by using the
1001 <display_text>Add</display_text> button.
1004 A POI may only be associated with a single category at a time.
1008 <topictitle>Settings</topictitle>
1009 <context contextUID="help_maemomapper_settings"/>
1011 The <display_text>Settings</display_text> dialog (accessible from
1012 the main menu) provides access to a plethora of configurable options
1013 that control how Maemo Mapper appears and runs. In addition to the
1014 tabs, which are described below, there are also two buttons at the
1015 bottom of the diagram labeled <display_text>Hardware
1016 Keys...</display_text> and <display_text>Colors...</display_text>.
1019 The <display_text>Hardware Keys...</display_text> button brings up
1020 another dialog box, which allows you to customize the actions that
1021 each hardware key causes. For example, you can map the
1022 <graphic filename="2686KEY_esc"/> button to cycle through map
1023 repositories, giving you quick access to switching among them.
1026 The <display_text>Colors...</display_text> button allows you to
1027 customize the colors that are used for drawing on-map objects.
1029 <heading>GPS</heading>
1031 The <display_text>GPS</display_text> tab tells Maemo Mapper which
1032 bluetooth device from which to retrieve GPS data. It is only
1033 applicable if you have a bluetooth GPS receiver with which to use
1037 Enter the MAC address in the field provided. If you don't know the
1038 MAC address, turn on your receiver and press the
1039 <display_text>Scan...</display_text> button to select it from a
1040 list of nearby bluetooth devices.
1043 <i>Alternatively</i>, if you are using rfcomm or any other
1044 file-system-based NMEA input source, you can provide a pathname
1045 (beginning with a leading slash) such as "/dev/rfcomm1". In this
1046 case, Maemo Mapper will read NMEA sentences from the file system
1047 instead of via bluetooth.
1049 <heading>Auto-Center</heading>
1051 The <display_text>Auto-Center</display_text> tab allows you to
1052 configure how Maemo Mapper automatically re-centers the display when
1053 either <display_text>Lat/Lon</display_text> or
1054 <display_text>Lead</display_text> is enabled from the
1055 <display_text>Auto-Center</display_text> menu. The Auto-Center
1056 feature is most useful in conjunction with a GPS receiver.
1060 <display_text>Sensitivity</display_text> - Controls how often
1061 Maemo Mapper re-centers the display, based on how close your
1062 position (or the position of your <i>lead</i>) gets to the edge of
1063 the screen. When set to a low value, Maemo Mapper will only
1064 re-center the screen when you are near the edge of the screen.
1065 When set to the maximum, Maemo Mapper will keep your position as
1066 close to the center as possible.
1069 <display_text>Lead Amount</display_text> - When Auto-Center is set
1070 to <display_text>Lead</display_text>, then Maemo Mapper will keep
1071 the center of the screen focused on an area in front of you. When
1072 driving, this allows you to view more of the road ahead of you.
1073 The distance in front of you on which the screen is centered is
1074 based on two variables: your current speed and the value of the
1075 <display_text>Lead Amount</display_text> option.
1078 <heading>Announce</heading>
1080 The <display_text>Announce</display_text> tab controls how and when
1081 Maemo Mapper displays or speaks waypoint information. When you
1082 approach a waypoint in your route (defined by the presence of a
1083 description in the GPX file), Maemo Mapper will pop up a text box
1084 with the contents of that description. When downloading routes from
1085 within Maemo Mapper, the text describes your next action, e.g. "Turn
1086 left at Main Street. Go 2.4 miles."
1089 As you approach a waypoint, Maemo Mapper will continue to display
1090 the description of that waypoint, so long as you are within the
1091 range defined by the <display_text>Advance Notice</display_text>
1092 option, or until you pass the waypoint. Because the amount of
1093 notice is dependent on your speed, it is possible to see the text,
1094 then slow down to a point where the notice disappears. This is
1095 possible, for example, if you are stopped at a red light. The text
1096 will reappear when you have picked up enough speed to again break
1097 the <display_text>Advance Notice</display_text> range.
1100 If you have installed <i>flite</i>, which is available in the same
1101 repository from which you downloaded Maemo Mapper, then Maemo Mapper
1102 can optionally also speak the same directions that appear on screen.
1103 Maemo Mapper will only speak the directions once, at the exact
1104 moment you first reach the distance from the waypoint defined by the
1105 <display_text>Advance Notice</display_text> option. The same
1106 directions are on-screen if you need to reference them.
1110 <display_text>Advance Notice</display_text> - Controls how much in
1111 advance Maemo Mapper begins to provide the waypoint description.
1112 The exact distance at which Maemo Mapper begins to announce a
1113 waypoint also depends on your speed, so the value of this option
1114 can be thought of more accurately in units of time. At the
1115 minimum value, Maemo Mapper gives you almost no notice. At the
1116 maximum value, Maemo Mapper gives you about two minutes of notice.
1117 Experiment to find your happy medium.
1120 <display_text>Enable Voice Synthesis</display_text> - If you have
1121 installed <i>flite</i>, this option will cause Maemo Mapper to
1122 speak the description of the next waypoint when you enter the
1123 range defined by the <display_text>Advance Notice</display_text>
1127 <heading>Misc.</heading>
1129 The <display_text>Misc.</display_text> and <display_text>Misc.
1130 2</display_text> tabs contain miscellaneous options.
1134 <display_text>Line Width</display_text> - Controls the thickness
1135 of all lines drawn on top of the map images. This includes your
1136 mark, all tracks and routes, and the default POI image.
1139 <display_text>Keep Display On Only in Fullscreen
1140 Mode</display_text> - Controls whether or not Maemo Mapper
1141 should limit its "Keep the display on" behavior to full screen
1142 mode only. If disabled, then Maemo Mapper will always keep the
1143 screen on, as long as you are moving. If enabled, Maemo Mapper
1144 will only keep the screen on in full screen mode.
1147 <display_text>Information Font Size</display_text> - Controls the
1148 font size for all information that is popped up to the user in the
1149 upper-right corner, including waypoint descriptions.
1152 <display_text>Units</display_text> - Controls the units in which
1153 distances and speeds are displayed in the user interface.
1156 <display_text>Degrees Format</display_text> - Controls how
1157 latitude and longitudes are displayed in the user interface.
1160 <display_text>Speed Limit</display_text> - Enables notification
1161 when you have exceeded the given speed limit (specified in the
1162 units defined via the <display_text>Units</display_text> option.
1165 <display_text>Location</display_text> - Controls the location on
1166 the screen of the speed warning.
1169 <heading>POI</heading>
1171 The <display_text>POI</display_text> tab allows you to define your
1172 POI database and how POIs are drawn on the screen.
1176 <display_text>POI database</display_text> - The location on the
1177 file system where the POI database is located. The database must
1178 be in sqlite3 format. A default (empty) POI database is
1179 automatically created for you when you first run Maemo Mapper.
1182 <display_text>Show POI below zoom</display_text> - Defines the
1183 maximum zoom (furthest away from the Earth) at which POIs will be
1184 drawn. When zoomed out beyond this level, no POIs will be drawn.
1189 <topictitle>About Maemo Mapper</topictitle>
1190 <context contextUID="help_maemomapper_about"/>
1192 Current Version: 1.4.4
1195 Maemo Mapper was created and developed by John Costigan (aka
1196 <display_text>gnuite</display_text>).
1199 Copyright © 2006-2007 John Costigan.
1202 POI and GPS-Info code originally written by Cezary Jackiewicz.
1205 Default map data provided by http://www.openstreetmap.org/ - other
1206 map repositories are subject to their own licenses and may or may not
1207 be suitable for use with Maemo Mapper. It may be illegal to use a
1208 certain repository with Maemo Mapper or under certain conditions. This
1209 includes the repositories downloadable directly in Maemo Mapper. If
1210 you are not sure if you are legally allowed to use a particular
1211 repository, you should delete it from your list of repositories. The
1212 authors of Maemo Mapper cannot be held responsible for your use of a
1213 particular repository.
1216 This program is free software; you can redistribute it and/or modify
1217 it under the terms of the GNU General Public License as published by
1218 the Free Software Foundation; either version 2 of the License, or
1219 (at your option) any later version.
1222 This program is distributed in the hope that it will be useful,
1223 but WITHOUT ANY WARRANTY; without even the implied warranty of
1224 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1225 GNU General Public License for more details.
1228 You should have received a copy of the GNU General Public License along
1229 with this program; if not, write to the Free Software Foundation, Inc.,
1230 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.