From 92c010567ce5c88211205b6b161e0003e27e0a99 Mon Sep 17 00:00:00 2001 From: gnuite Date: Sun, 16 Mar 2008 19:04:11 +0000 Subject: [PATCH] Testing online documentation. git-svn-id: svn+ssh://garage/var/lib/gforge/svnroot/maemo-mapper/trunk@167 6c538b50-5814-0410-93ad-8bdf4c0149d1 --- data/help/en_US/maemomapper.xml | 1610 +++++++++++++++++++++++++++++++ 1 file changed, 1610 insertions(+) create mode 100644 data/help/en_US/maemomapper.xml diff --git a/data/help/en_US/maemomapper.xml b/data/help/en_US/maemomapper.xml new file mode 100644 index 0000000..ef7bd83 --- /dev/null +++ b/data/help/en_US/maemomapper.xml @@ -0,0 +1,1610 @@ + + + + Maemo Mapper + + Introduction + + Welcome to Maemo Mapper. + + Maemo Mapper is a geographical mapping tool that can be used to: + + + + Download map data to your device's main memory or to an external + memory card. + + + View that map data on the screen. + + + Navigate that map data by panning around the screen and zooming in + and out. + + + Display your position and other GPS information from a GPS + receiver. + + + Store and display Point-of-Interest (POI) data. + + + Download directions between arbitrary points on the map. + + + Save or open track data or route data. + + + + Use the to peruse the + various sections of this help document, or go to to + get up and running quickly. + + + + Getting Started + + + When you first start Maemo Mapper, you will be presented with the + Settings dialog box. Most of the + settings have reasonable defaults, but if you have a GPS receiver, + you should fill in the Bluetooth field + with the MAC address of your GPS receiver. If you don't know the + MAC, turn on your GPS receiver and push the + Search button. Maemo Mapper will + attempt to automatically discover the MAC address of your receiver. + For more information about the Settings + dialog box, see . + + + Alternatively, you can leave the + Bluetooth field blank, and Maemo Mapper + will attempt to automatically search for and use any bluetooth GPS + receivers that it can identify. This is particularly useful if you + tend to use multiple different GPS receivers. This feature is not + guaranteed to work on all Nokia devices or with all bluetooth GPS + receivers. + + + If you are using Maemo Mapper on a device with an internal GPS + receiver, then you should probably use the "Bluetooth" receiver type + and leave the field empty. + + + When you are finished setting up Maemo Mapper to your preferences, + pressing the Ok button will lead you to + another dialog box: the Manage + Repositories dialog. + + + To get started quickly, press the + Download... button. Maemo Mapper will + download a set of pre-defined repository information for you to use. + If you use the pre-defined repositories, you can delete the + Default repository. For more + information about repositories and the Manage + Repositories dialog, see + . + + + Certain repositories (most notably, the commercial ones) may have + license agreements attached with their use. It may be illegal to + use a certain repository with Maemo Mapper or under certain + conditions. This includes the repositories downloaded via the + Download... button. If you are not + sure if you are legally allowed to use a particular repository, you + should delete it from your list of repositories. The authors of + Maemo Mapper cannot be held responsible for your use of a particular + repository. + + + Once you have your Repositories set up the way you like, press the + Ok button, and you will be presented with a blank screen, because + you have not yet actually downloaded any map data to your device. + To allow Maemo Mapper to automatically download map data as it + becomes needed on the display, enable the + Auto-Download checkbox in the + Maps menu. + + + If you have a working internet connection, Maemo Mapper will attempt + to download maps and display them on the screen automatically as + the downloads complete. You should see a map of the world. Be + careful when you enable Auto-Download, because it can quickly fill + your available disk space. See + for + details on how to manage disk space for a particular repository. + + The Graphical User Interface + + The main view of Maemo Mapper emphasizes simplicity. By default, + the map is all that is displayed. You current position (if you have + a GPS receiver) is indicated by a blue circle. The blue line + extending from the blue circle indicates your current heading and + speed. Tracks are red and represent where you have been. + Routes are green and represent where you want to go, i.e. + directions to a location. + + + The hardware buttons on your device provide quick access to common + functionality: + + + + - Toggle + Full-Screen Mode + + + - Zoom In - hold down to + zoom multiple levels at a time + + + - Zoom Out - hold down to + zoom multiple levels at a time + + + - Pan Up - hold down to + scroll + + + - Pan Down - hold down + to scroll + + + - Pan Left - hold down + to scroll + + + - Pan Right - hold down + to scroll + + + - Toggle + + + + - Programmable; defaults + to: Hide/Show Tracks and Routes + + + + You can also pan around the map by tapping on the screen. Maemo + Mapper will center the display on where you tapped. If you had + Auto-Center enabled, tapping a location + to center on it will automatically disable that functionality. + + + From this point, you can use the menus to manage routes, tracks, and + map data; to change the view; to change settings; or to see detailed + GPS information (if you have a GPS receiver). + + + There is also a context-sensitive menu that appears on the map when + you tap and hold a location on the map. From that menu, you can + download directions, calculate distances, or add/modify + Point-of-Interest (POI) data. + + + For help with any of these features, use the + . + + + + Main Menu + + + This help topic describes the functionality of each of the menu + items in Maemo Mapper. + + Route + + The Route menu is used to manipulate + the current route. A route in Maemo Mapper is defined as a + set of points and waypoints describing where you would like to + go, e.g. driving directions from 123 Main Street to 456 Elm + Street. It can include multiple segments. The current route is + empty until you open or download a route. + + + The Route menu has the following menu + items: + + + + Open... - Open a route from a GPX + file on the file system. The opened route is appended to + the current route, so you can string together different routes + together to create a trip with multiple destinations. + + + Download... - Download a route from + the internet. See for more information. + + + Save... - Save the current route to a + GPX file on the file system. + + + Show Distance to Next Waypoint - Show + the distance left to be traveled (along the current route) until + the next waypoint. + + + Show Distance to End of Route - Show + the distance left to be traveled (along the current route) until + the end of the current route. The calculated distance includes + the distance between breaks in the route (i.e. between the end of + one route segment and the beginning of another route segment). + + + Reset - Reset Maemo Mapper's tracking + of your progress along the current route. Use this if Maemo + Mapper loses track of where you are with respect to the current + route. + + + Reset - Clear the current route, + effectively replacing it with an empty route. + + + Track + + The Track menu is used to manipulate + your current track. A track in Maemo Mapper is defined as + a set of points along which you have been traveling, i.e. where + you have been. It can include multiple segments. Tracks are + most useful if you have enabled a GPS receiver. The current track + is empty until you get at least one valid position point from your + GPS receiver, and it is appendeded to whenever you stray far enough + from the last track point. + + + The Track menu has the following menu + items: + + + + Open... - Open a track from a GPX + file on the file system. In contrast to route data, the opened + track is prepended to the current track, so if you are + trying to rebuild previous track data, you must open the tracks + backward in time (most recent tracks first). + + + Save... - Save the current track to a + GPX file on the file system. + + + Insert Break - Artificially insert a + break in your current track data. This simulates the loss and + re-acquisition of a GPS fix, and it can be used to track, for + example, refueling stops. + + + Insert Mark - Artificially insert a + mark with a description in your current track data. This can be + used to mark important landmarks. + + + Show Distance from Last Break - Show + the distance traveled (along the current track) since the last + break. + + + Show Distance from Beginning - Show + the distance traveled (along the current track) since the + beginning of the track. The calculated distance includes the + distance between breaks in the track (i.e. between when a GPS fix + is lost and later re-acquired). + + + Clear - Clear the current track, + effectively replacing it with an empty track. + + + Maps + + The Maps menu is used to control your + map repositories. This menu will be populated with a list of all of + your map repositories, from which you can select to switch to a + particular repository. + + + The Maps menu has the following menu + items in addition to the list of available repositories: + + + + Manage Maps... - Download or delete + maps for the currently selected repository. For more details, see + . + + + Manage Repositories... - Configure + each of your available repositories, or add new ones. You can + also download a pre-defined set of repositories. For more + details, see . + + + Auto-Download - Toggle Maemo Mapper's + ability to automatically download maps as they are needed in order + to fill the screen with map data. This is useful for arbitrary + exploration of the world while connected to the internet, or if + you have a constant connection to the internet (i.e. via a + cellular data service). + + + View + + The View menu allows you to customize + the view by showing or hiding certain features of the display. + + + The View menu has the following menu + items: + + + + Zoom In - Zoom in by one zoom level. + You can also use the button. + + + Zoom Out - Zoom out by one zoom + level. You can also use the button. + + + Full Screen - Toggle full-screen + mode. You can also use the button to toggle + full-screen mode. + + + Scale - Toggle the display of the + scale. + + + Route - Toggle the display of routes. + + + Track - Toggle the display of tracks. + + + Velocity Vector - Toggle the display + of the velocity vector (the blue line extending from the blue + circle that represents your current location). + + + POIs - Toggle the display of POIs. + + + POI Categories... - Define POI + categories and which categories are displayed on the map. For + more details, see . + + + Auto-Center + + The Auto-Center menu is used to control + whether or not Maemo Mapper should re-center the display as your + current location changes. The sensitivity of re-centering (how + close you get to the edge of the display before Maemo Mapper + re-centers the display) can be configured in the Dialog. + + + There are three different modes of Auto-Center: + + + + Lat/Lon - Keep your location centered + on the display. + + + Lead - Depending on your speed, keep + a location in front of you centered on the screen. The faster you + are going, the more lead distance is used. + + + None - Do no re-center the display + automatically. + + + Go to + + The Go to menu is used to center the + view on a particular location. + + + The Go to menu has the following menu + items: + + + + Lat/Lon... - Specify an exact + Latitude and Longitude on which to center the display. + + + GPS Position - Center the display on + your current GPS position. This is the manual counter-part of + the Auto-Center functionality + mentioned above. + + + Next Waypoint - Center the display on + the next waypoint in your route. By default, the next waypoint is + colored a slightly darker green than normal waypoints. + + + Nearest POI - Center the display on + the enabled POI nearest to the current view center. + + + GPS + + The GPS menu is used to access features + of the GPS receiver, including textual information not displayed on + the map. It is also used to control your connection to the GPS + receiver. + + + + Enable GPS - Toggle communication + with a GPS receiver. You must have a GPS receiver set up in order + to use this menu item. When on, Maemo Mapper will constantly + search for the GPS receiver. + + + Show Information - Toggle display of + additional information provided by the GPS receiver. This + information will appear in the main display as a panel on the + left. + + + Details... - Show even more + information provided by the GPS receiver, including a polar plot + of all GPS satellites in view. + + + Reset Bluetooth - Attempt to reset + the bluetooth radio, in case it locks up for some reason. In + order for this to succeed, you must add the following line + to your /etc/sudoers file (if you don't know what that means, + don't try it): user ALL = NOPASSWD: /usr/sbin/hciconfig hci0 + reset + + + Other + + In addition to the above menus, there are a few other items in the + main menu: + + + + Settings... - Access and change + settings for using Maemo Mapper. For more information, see . + + + Help... - Access this help file. + + + About... - Display version and + copyright information. + + + Close - Close Maemo Mapper. + + + + + Context Menu + + + By tapping and holding on the screen, you can access the context + menu to execute actions on either that location, the nearest route + waypoint, or the nearest POI. + + + The context menu is separated into two hierarchical levels. The + first level (Location, + Waypoint, or + POI) determines what kind of data on + which the operation applies. + + Location + + The Location submenu performs actions + on the exactly latitude and longitude on which the tap-and-hold + operation was performed. With that location, you can do the + following actions: + + + + Show Lat/Lon - Display the latitude + and longitude of the selected location, in the style chosen in + Settings + + + Copy Lat/Lon - Copy the latitude and + longitude of the selected location to the clipboard, in + comma-separated decimal format. + + + Show Distance to - Display the + distance (in a straight line) to the selected location. + + + Download Route to... - Open the + dialog with the selected location + pre-filled as the destination. + + + Add Route Point - Add a point to the + current route, based on the selected location. The point is not a + waypoint. + + + Add Waypoint... - Add a waypoint + to the current route, based on the selected location. You must + provide a description for the waypoint to be legitimate. By + specifying an empty description, however, you can create a break + in the route. The break will not be connected to the rest of the + route, so it can be used to start a new segment. + + + Add POI... - Add a POI to the POI + database, based on the selected location. If the category in + which you place the POI is disabled, it will not be visible on the + map after creation, but it will still be in the database. + + + Set as GPS Position - Force Maemo + Mapper to consider the selected location to be the current GPS + location. This will not affect the current track, but it will + change the location of the blue circle that represents your + current location, and it can be used to calculate a route from + that location. + + + Apply Map Correction - Enables and + disables the application of map correction. When enabling map + correction, the tap point is used as the correction reference point. + See the note below for more details. + + + + Map Correction is a little-used feature that corrects a rare problem + with map data. In some locations around the world (like Brazil and + Québec), road data from a particular map repository may not be + accurate, although the error is consistent. For example, as you + travel, you may find that your actual track (as indicated by your + GPS receiver) is a few hundred meters away from the road on which + Maemo Mapper is drawing your current position. Map Correction fixes + this. When your GPS receiver has an accurate fix, and if Maemo + Mapper shows your current location as somewhere other than where you + expect to be, simply tap-and-hold on the location on the map where + you think your current location should be drawn, then select + this context menu item. The correction is saved as part of your + configuration (so it persists even if you restart Maemo Mapper or + your device). + + Waypoint + + The Waypoint submenu performs actions + on the waypoint nearest to the point on which the tap-and-hold + operation was performed. If no waypoints are nearby, an error + message will be displayed. + + + + Show Lat/Lon - Show the latitude and + longitude of the selected waypoint, in the style chosen in + Settings. + + + Show Description - Show the + description attached to the select waypoint. When downloading + routes via the dialog, the description will contain + the directions needed to take at that waypoint (e.g. "Turn left at + Main Street. Go 2.5 kilometers."). + + + Copy Lat/Lon - Copy the latitude and + longitude of the selected waypoint to the clipboard, in + comma-separated decimal format. + + + Copy Description - Copy the + description of the waypoint to the clipboard. + + + Show Distance to - Show the distance + left to be traveled (along the current route) until the selected + waypoint. The calculated distance includes the distance between + breaks in the route (i.e. between the end of one route segment and + the beginning of another route segment). + + + Download Route to... - Open the + dialog with the selected waypoint's + location pre-filled as the destination. + + + Delete... - Delete the selected + waypoint from the current route. This will delete all route + segments surrounding the route, including (and limited to) all the + points from that waypoint to the next and previous waypoints. + + + Add POI... - Add a POI to the POI + database, based on the selected waypoint's location. If the + category in which you place the POI is disabled, it will not be + visible on the map after creation, but it will still be in the + database. + + + POI + + The POI submenu performs actions + on the POI nearest to the point on which the tap-and-hold operation + was performed. If no POIs are nearby, an error message will be + displayed. + + + + View/Edit - View and/or edit the + selected POI. + + + Show Distance to - Display the + distance (in a straight line) to the selected POI. + + + Download Route to... - Open the + dialog with the selected POI's + location pre-filled as the destination. + + + Add Route Point - Add a point to the + current route, based on the selected POI's location. The point is + not a waypoint. + + + Add Waypoint... - Add a waypoint + to the current route, based on the selected location. You must + provide a description for the waypoint to be legitimate. By + specifying an empty description, however, you can create a break + in the route. The break will not be connected to the rest of the + route, so it can be used to start a new segment. + + + + + Managing Repositories + + + In Maemo Mapper, map data is divided into specific units called + repositories. A repository is a source of map data, each of + which has its own way of visualizing the Earth. For example, + repositories based on street maps typically draw roads as lines and + buildings as areas, whereas repositories based on satellite data + draw the Earth as it would appear from space. There are also + "hybrid" repositories that overlay street map data on top of + satellite data, as well as topographical maps that show altitude + data. + + + Each repository is made up of maps at 16 different zoom levels. + Zoom Level 0 is the highest resolution (closest to the Earth, i.e. + "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest + from the Earth, i.e. "zoomed out"). Not all repositories are + available at all zoom levels, and some repositories may even produce + an error (which you can usually ignore) if you try to download maps + at that zoom level. + + + Once you have set up at least one repository, you can start + downloading maps from that repository to your device's file system. + For details on how to do this, see + . + + + You can set up any number of repositories in Maemo Mapper, but only + one can be active at any given time. The Manage + Repositories dialog is accessed via the + Manage Repositories... menu item of the + Maps menu, and it allows you to add, + edit, and remove repositories. + + + The Manage Repositories... has a combo + box that controls which repository is being viewed and edited. When + a repository is selected, the controls below it display the current + settings, which you can change: + + + + URL Format - A specially formatted + string that looks like a URL, but it needs to have at least one + printf-style substitution strings (like %f or %s). Normally, you + must either get these URL formats from the internet + (www.internettablettalk.com is a good source), or you can use the + Download... button in the + Repositories dialog box to download a sample. + + + Cache DB - A database file on the file + system (either on the device's internal memory, or an external + memory card) in which maps are stored. Maps are kept here + indefinitely (until you delete them), so pick a location with a + lot of free space. You can use the + Browse... button to select the + database file with a graphical file system browser, or you can enter + the filename manually. The Compact... + button can be used to compact the database if you have deleted + many maps from your database. (Otherwise, deleted space is reused + to store new maps.) + + + Download Zoom Steps - Controls which + zoom levels should be avoided when automatically downloading maps + (i.e. Auto-Download is enabled). The lowest setting (one bar) + means to download every zoom level. The highest setting (four + bars) causes Maemo Mapper to only download every fourth zoom level + (0, 4, 8, and 16). + + + View Zoom Steps - Similar to the + above-described Download Zoom Steps + option, except that it controls how Maemo Mapper behaves when + zooming. For example, at two bars, pressing + causes Maemo Mapper to zoom + in two levels instead of just one. Setting this equal to + Download Zoom Steps ensures that you + see all maps at their native resolution. + + + Double Pixels - This forces Maemo + Mapper to avoid using the native resolution of any maps, instead + using pixel-doubling. This is useful if your repository's maps + contain small, hard-to-read text, and you want to double the size + of the images to make them more readable. This setting can also + affect the zoom levels that are downloaded when Auto-Download is + enabled. + + + Next-able - This oddly-named option + determines whether or not the "Select Next Repository" action + (which can be mapped to any of the hardware keys) will be able to + select this repository. When unset, the "Select Next Repository" + action will simply skip over this repository. + + + Downloadable Zooms - This setting + governs the minimum and maximum zoom levels Maemo Mapper should + attempt to automatically download for this repository (when + Auto-Download is enabled). Some repositories support more zoom + levels than others, and supported zoom levels may even vary from + location to location. + + + + In addition to the per-repository controls, there are a few buttons + that provide additional functionality: + + + + Rename... - Renames the currently + selected repository. + + + Delete... - Deletes the currently + selected repository. + + + New... - Adds a new repository. + + + Reset... - Resets your repository + list to the factory default. This will remove all of your + repositories and replace them with the single default repository + that comes with Maemo Mapper. + + + Download... - Downloads information + about several preset repositories, and adds them to your + repository list. They will be appended to any existing + repositories you already have. They are not read-only - you may + edit them as you wish. This is a good way to get started. + + + + Certain repositories (most notably, the commercial ones) may + have license agreements attached with their use. It may be + illegal to use a certain repository with Maemo Mapper or under + certain conditions. This includes the repositories downloaded + via the Download... button. If you + are not sure if you are legally allowed to use a particular + repository, you should delete it from your list of repositories. + The authors of Maemo Mapper cannot be held responsible for your + use of a particular repository. + + + + Managing Maps + + + In Maemo Mapper, repositories represent sources of map data, + and maps are just image files (e.g. PNG or JPEG) that are + drawn onto the screen. Once you have a repository set up (see + ), you can download maps from a + repository into a Map Cache, which is just a database file on your + device's file system. + + + Maemo Mapper downloads maps from the current repository so that they + can be drawn onto the screen and later recalled from disk, instead + of downloading a map every time it is needed. This is called + caching, and it allows you to use Maemo Mapper even when you + are not connected to the internet. + + + Because Maemo Mapper downloads maps to your device's file system, + you must be aware of how much disk space your maps are taking up, + especially if you enable Auto-Download. If space is a concern, you + may also choose to go without a cache entirely. You can do this by + leaving the Map Cache DB field blank in the Manage + Repositories dialog. Note that this will cause Maemo + Mapper to download maps each time they are needed. If you are using + a cellular data plan that charges per kilobyte, you probably want to + use a cache. For more information about repositories and the + Manage Repositories dialog, see + . + + + Aside from the Auto-Download functionality, you can also download + maps manually using the Manage Maps... + menu item of the Maps menu. The + Manage Maps dialog allows you to + download, overwrite, or delete maps, either by area or along your + current route. It contains up to three tabs, all of which control + which and how many maps are downloaded. + + Setup + + The Setup tab controls what you what to + do. You can download maps (optionally overwriting + already-downloaded maps) from the current repository to your + device's file system, or you can delete maps (pertaining to the + current repository) from your device's file system. Both of these + operations can be done either over a rectangular area or along your + current route. + + + + Download Maps - If selected, Maemo + Mapper will download maps from the current repository to your + device's file system, for the area you specify. By default, Maemo + Mapper only downloads the maps that you don't already have. + + + Overwrite - If selected, then Maemo + Mapper will download maps and overwrite any maps that you may have + already downloaded. + + + Delete Maps - If selected, Maemo + Mapper will delete maps from your file system, for the area you + specify. + + + By Area - If selected, Maemo Mapper + will download or delete maps for a particular rectangular area of + the world, based on the latitude and longitude of an upper-left + and lower-right corner. See the Area + tab to specify the coordinates. + + + Along Route - If selected, Maemo + Mapper will download or delete maps along your current route. + This is useful if, for example, you are about to embark on a trip + and want to make sure that you have maps for all points along the + route. + + + Radius (tiles) - If + Along Route is selected, then you can + specify the radius around your route for which maps will be + downloaded or deleted. For example, if you specify 4 (the + default), then Maemo Mapper will download all tiles that are + within 4 tiles of your route. + + + Zoom + + The Zoom tab controls which zoom levels + at which maps are downloaded or deleted. The current zoom level is + selected by default, but you can enable or disable any zoom levels + that you like. + + Area + + The Area tab, available if the + By Area option is selected in the + Setup tab, defines the rectangular area + of the world for which maps will be downloaded or deleted. If + applicable, the fields are pre-filled with your current and previous + view center coordinates. This allows you to graphically choose your + rectangle by first centering on one corner of the rectangle, then + centering on the opposite corner, by tapping the screen or by using + the Lat/Lon menu item of the + Go to menu. + + + + Downloading Routes + + + Route data can be loaded from GPX files, like the ones provided by + the GPX Driving Directions web service + (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be + downloaded directly within Maemo Mapper using the + Download Route dialog. + + + Downloading routes requires an active connection to the internet, + but once a route is loaded into Maemo Mapper, the internet + connection is no longer needed (unless + Auto-Update is enabled). The route + download functionality in Maemo Mapper actually uses the + aforementioned GPX Driving Directions web service. + + + To download a route, you must specify an + Origin and a + Destination. The GPX Driving + Directions web service will return a route taking you from the + origin to the destination. + + + The Download Route dialog contains the + following controls: + + + + Source URL - The web service from + which driving directions are retrieved. The default is fine, and + it is usually left unchanged. + + + Auto-Update - This option, only + available if Use GPS Location is + enabled, will cause Maemo Mapper to automatically re-download a + new route if you stray from the route. Note that you must have a + continuous connection to the internet (i.e. cellular data service) + for Auto-Update to work. + + + Use GPS Location - If selected, then + the current GPS location will be used as the + Origin. + + + Use End of Route - If selected, then + the end of the route will be used as the + Origin. This is useful for stringing + together multiple route downloads into a single route. + + + Origin - If selected, then you must + enter your own origin. An origin can be specified in any format + understood by Google Maps. Some examples: "25, -43" (lat/lon), + "68712" (zip code), "San Francisco, CA", "123 Main St, 45112", + "5th and Main, 12151". In fact, if your route download fails with + a "Could not generate directions" error message, you can use + Google Maps to test your origin for accuracy. + + + Destination - The destination to + which the directions will lead. Like the + Origin, a destination can be + specified in any format understood by Google Maps. + + + + + Downloading POIs + + + Points of Interest (POIs) can be loaded from GPX files, like the + ones provided by the GPX POI Search web service + (http://www.gnuite.com/cgi-bin/poi.cgi). Or, POI data can be + downloaded directly within Maemo Mapper using the + Download POIs dialog. + + + Downloading POIs requires an active connection to the internet, + but once a POI is loaded into Maemo Mapper, the POI is accessible in + Maemo Mapper regardless of whether or not you are connected to the + internet. The POI download functionality in Maemo Mapper actually + uses the aforementioned GPX POI Search web service. + + + To search for POIs, you enter an Origin + and a Query. The GPX POI Search web + service will return up to 10 matching POIs in the vicinity of the + origin. You can access more POIs from the same query by using the + Page modifier. + + + Once you have downloaded POIs, they are automatically added to your + POI database, and you are presented with the POI + List dialog to to review the POIs that were + downloaded and added to your database. You must manually remove any + POIs that you don't want in your database. For more information + about the POI List dialog and + deleting POIs, see . + + + The Download POIs dialog contains the + following controls: + + + + Source URL - The web service from + which POIs are retrieved. The default is fine, and it is usually + left unchanged. + + + Use GPS Location - If selected, then + the current GPS location will be used as the + Origin. + + + Use End of Route - If selected, then + the end of the route will be used as the + Origin. This is useful for searching + for points of interests (like hotels or restaurants) near your + current destination. + + + Origin - If selected, then you must + enter your own origin. An origin can be specified in any format + understood by Google Maps. Some examples: "25, -43" (lat/lon), + "68712" (zip code), "San Francisco, CA", "123 Main St, 45112", + "5th and Main, 12151". In fact, if your route download fails with + a "Could not generate directions" error message, you can use + Google Maps to test your origin for accuracy. + + + Category - Specifies the default + category in which all resulting POIs will be placed. You can + always change the category later. If you have not yet entered a + Query when you select a category, + then the name of the category will be entered into the + Query field for you. This allows you + to, for example, quickly search for restaurants and put them in + the Restaurant category. + + + Page - Specifies the page of results + that you want to retrieve. Think of it as the page number in a + web search. Page 1 contains the first 10 results. Page 2 + contains results 10-19. And so on. + + + Query - A free-form text query that + describes the POIs for which you are searching. This can be + anything from "food" to "hairstylist" to "museum." Note that the + selected Category is not part of the + query unless you explicitly include it in the + Query field. + + + + + Browsing POIs + + + Once you have imported or downloaded POIs into your POI database, + you can use the Browse POIs dialog to + search for certain POIs in your database and to view those POIs in a + tabular format. + + + To browse for POIs, you enter an Origin + and a optional Query. Maemo Mapper + will search the database for all POIs matching your query, and it + will calculate the distance from each POI to your specified + Origin. You may also filter your + results by Category. + + + Once your search is performed, you are taken to the + POI List dialog, where you can view, + edit, and delete any of the POIs that matched your query. For more + information about the POI List dialog + and editing POIs, see . + + + The Browse POIs dialog contains the + following controls: + + + + Use GPS Location - If selected, then + the current GPS location will be used as the + Origin. + + + Use End of Route - If selected, then + the end of the route will be used as the + Origin. This is useful for searching + for points of interests (like hotels or restaurants) near your + current destination. + + + Origin - If selected, then you must + enter your own origin. An origin can be specified in any format + understood by Google Maps. Some examples: "25, -43" (lat/lon), + "68712" (zip code), "San Francisco, CA", "123 Main St, 45112", + "5th and Main, 12151". In fact, if your route download fails with + a "Could not generate directions" error message, you can use + Google Maps to test your origin for accuracy. + + + Category - Filters the results based + on the selected category. + + + Query - An optional substring which + must appear in either the label or description of a POI in order + for the POI to match. Any spaces, commas, or other punctiation in + the query must also be in the label or description. If left + blank, then all POIs are matched. + + + + + POI List + + + The POI List dialog is a tabular + display of POIs. With this dialog, you can go to a specific POI, + edit POIs, change the categories of a set of POIs, delete POIs, and + export POIs to the GPX file format. + + + The main view of the POI List dialog is + a table with five columns, all of which (except the checkbox) can be + sorted by tapping on the appropriate header: + + + + * - This checkbox column contains a + checkbox for each POI in the table. All of the POIs that are + checked will be affected by operations in the + Checked POI Actions dialog, described + later. You can tap on the column header to enable or disable + all of the checkboxes at once. Note that this checkbox has no + effect on whether or not the POI is visible in the map. + + + Category - The category in which the + POI belongs. Categories can be edited, enabled, and disabled with + the POI Categories dialog. For more + information about the POI Categories + dialog, see + + + Dist. - The distance from the Origin + to the given POI. + + + Bear. - The bearing (in degrees from + true north) from the Origin to the given POI. A bearing of zero + or 360 means that the POI is due north of the Origin. 90 means + east; 180 means south; and 270 means west. + + + Label - The label of the POI. + + + + Below the table are four buttons: + + + + Go to - Pans the map display to the + currently selected POI (i.e. the currently highlighted row). + Remember that you can tap and hold on the title bar of the dialog + in order to see the map behind it. + + + Edit... - Opens the + Edit POI dialog for the currently + selected POI (i.e. the currently highlighted row). You can also + double-tap on a row in the table to open this dialog. + + + Checked POI Actions... - Opens the + Checked POI Actions dialog, which + allows you to perform actions on the currently checked POIs in the + table. From that dialog, you can set the categories of the + checked POIs, delete the checked POIs, and/or export the checked + POIs to a GPX file. + + + Close - Closes the POI + List dialog. + + + + + POI Categories + + + POI Categories are a means by which you can organize your POIs for + selective display. The POI Categories + dialog is accessed from the View menu + and allows you to enable/disable, add, edit, or delete categories. + + + Each row in the table represents a category. There are three + columns displayed for each category: + + + + Enabled - Controls whether or not + POIs in this category are drawn on the map. + + + Label - A short label to describe the + category. This is the name that will be visible when viewing a + POI. + + + Description - A longer description of + the category. This description is not visible anywhere except in + this dialog; it is only used to get an idea of how the category is + meant to be used. + + + + Selecting a row in the table and pressing the + Edit button will allow you to edit the + above three attributes of a category, and to delete a category. You + can also add a new category by using the + Add button. + + + A POI may only be associated with a single category at a time. + + POI Icons + + Icons can be customized on a per-POI or per-category basis, and/or + you may provide a custom default icon for all POIs. To do so, you + should place icon files in the same directory as the POI database + itself. Most image file formats are supported, but the files + themselves must have the ".jpg" extension (even if the icons + are not in the JPEG format). + + + To customize the default POI icon (to be used instead of the simple + square), place an icon file called "poi.jpg" in the same directory + as the POI database. + + + To customize the icon for a POI category, place an icon file with + the same name as the POI category, all lower-case, plus the ".jpg" + extension. For example, if your POI category is called "Gas + Stations", the file should have the name "gas stations.jpg". + + + To customize the icon for a specific POI, place an icon file with + a name equal to the POI's label, all lower-case, plus the ".jpg" + extension. For example, if your POI's label is "Joe's House", + the file should have the name "joe's house.jpg". + + + POI-specific icons are given priority over category-specific icons, + which in turn are given priority over the default POI icon. + + + + Settings + + + The Settings dialog (accessible from + the main menu) provides access to a plethora of configurable options + that control how Maemo Mapper appears and runs. In addition to the + tabs, which are described below, there are also two buttons at the + bottom of the diagram labeled Hardware + Keys... and Colors.... + + + The Hardware Keys... button brings up + another dialog box, which allows you to customize the actions that + each hardware key causes. For example, you can map the + button to cycle through map + repositories, giving you quick access to switching among them. + + + The Colors... button allows you to + customize the colors that are used for drawing on-map objects. + + GPS + + The GPS tab tells Maemo Mapper the + source (if any) from which to retrieve GPS data. It is only + applicable if you have access to a GPS source, such as a bluetooth + GPS receiver or a GPSD server. Technically, Maemo Mapper uses GPSD + for all of its GPS receiver communication, but you can instruct + Maemo Mapper to use GPSD in one of three ways: + + + + Bluetooth - Select this option + if you are using a bluetooth GPS receiver, and enter the + MAC address in the field provided. If you don't know the MAC + address, turn on your receiver and press the + Scan... button to select it from a + list of nearby bluetooth devices. Or, leave the field blank and + Maemo Mapper will automatically try to use any bluetooth GPS + receivers that it can identify. This + option is also appropriate if you are running Maemo Mapper on a + device with an internal GPS receiver, in which case you should + leave the field blank. + + + File Path - Select this option to use + a device file on your file system, such as an RFCOMM device, and + specify the pathname of the file in the appropriate field. + + + GPSD Host - Select this option if you + want to connect Maemo Mapper to any GPSD server (local or remote). + Enter the hostname and port of the server in the fields provided. + The default values (127.0.0.1 on port 2947) cause Maemo Mapper to + use the local GPSD server, if available. + + + Auto-Center + + The Auto-Center tab allows you to + configure how Maemo Mapper automatically re-centers the display when + either Lat/Lon or + Lead is enabled from the + Auto-Center menu. The Auto-Center + feature is most useful in conjunction with a GPS receiver. + + + + Lead Amount - When Auto-Center is set + to Lead, then Maemo Mapper will keep + the center of the screen focused on an area in front of you. When + driving, this allows you to view more of the road ahead of you. + The distance in front of you on which the screen is centered is + based on two variables: your current speed and the value of the + Lead Amount option. + + + Fixed - Controls whether or not your + lead amount is affected by your speed. If checked, then your + speed will not affect the lead amount. + + + Pan Sensitivity - Controls how often + Maemo Mapper re-centers the display, based on how close your + position (or the position of your lead) gets to the edge of + the screen. When set to a low value, Maemo Mapper will only + re-center the screen when you are near the edge of the screen. + When set to the maximum, Maemo Mapper will keep your position as + close to the center as possible. + + + Min. Speed - Controls how fast you + must be moving in order for Auto-Center (and Auto-Rotate) to + activate. For example, walkers may wish to set this threshold + low, while drivers with inaccurate GPS receivers may wish to set + this high (to avoid spurious auto-rotates when parked or waiting + at a red light). The speed is specified in your chosen units. + + + Rotate Sensit. - Controls how often + Maemo Mapper rotates the display based on your heading, depending + on how far your current rotation is from your heading rotation. + + + Points - Controls which direction + on the screen your heading points to when auto-rotating. The + default is for your current heading to point up. + + + Announce + + The Announce tab controls how and when + Maemo Mapper displays or speaks waypoint information. When you + approach a waypoint in your route (defined by the presence of a + description in the GPX file), Maemo Mapper will pop up a text box + with the contents of that description. When downloading routes from + within Maemo Mapper, the text describes your next action, e.g. "Turn + left at Main Street. Go 2.4 miles." + + + As you approach a waypoint, Maemo Mapper will continue to display + the description of that waypoint, so long as you are within the + range defined by the Advance Notice + option, or until you pass the waypoint. Because the amount of + notice is dependent on your speed, it is possible to see the text, + then slow down to a point where the notice disappears. This is + possible, for example, if you are stopped at a red light. The text + will reappear when you have picked up enough speed to again break + the Advance Notice range. + + + If you have installed flite, which is available in the same + repository from which you downloaded Maemo Mapper, then Maemo Mapper + can optionally also speak the same directions that appear on screen. + Maemo Mapper will only speak the directions once, at the exact + moment you first reach the distance from the waypoint defined by the + Advance Notice option. The same + directions are on-screen if you need to reference them. + + + + Advance Notice - Controls how much in + advance Maemo Mapper begins to provide the waypoint description. + The exact distance at which Maemo Mapper begins to announce a + waypoint also depends on your speed, so the value of this option + can be thought of more accurately in units of time. At the + minimum value, Maemo Mapper gives you almost no notice. At the + maximum value, Maemo Mapper gives you about two minutes of notice. + Experiment to find your happy medium. + + + Enable Voice Synthesis - If you have + installed flite, this option will cause Maemo Mapper to + speak the description of the next waypoint when you enter the + range defined by the Advance Notice + option. + + + Misc. + + The Misc. and Misc. + 2 tabs contain miscellaneous options. + + + + Line Width - Controls the thickness + of all lines drawn on top of the map images. This includes your + mark, all tracks and routes, and the default POI image. + + + Unblank Screen - Controls when Maemo + Mapper keeps the display on without user input. When set to + When Receiving Any GPS Data, Maemo + Mapper will keep the screen on whenever a GPS receiver is + connected and producing data. When set to + Never, Maemo Mapper will not attempt + to keep the screen on, and the screen will go blank after a period + of inactivity on the user's part. The default is + When Moving (Full Screen Only) + + + Info Font Size - Controls the font + size for all information that is popped up to the user in the + upper-right corner, including waypoint descriptions. + + + Units - Controls the units in which + distances and speeds are displayed in the user interface. + + + Degrees Format - Controls how + latitude and longitudes are displayed in the user interface. + + + Auto-Download Pre-cache - Controls + how much of the world surrounding the view Maemo Mapper should + download when Auto-Download is + enabled. When set to the minimum, Maemo Mapper will only download + the maps that are required to draw the screen. As you pan around + the world, you will see black areas where Maemo Mapper has not yet + downloaded maps, until those maps are downloaded. If you increase + the Pre-cache amount, the Maemo Mapper will download more of the + surrounding areas, making it less likely that you ever actually + see black areas. A general rule of thumb is to limit the + Pre-cache based on the bandwidth of your internet connection, but + the default setting (two bars) is usually sufficient for most + people's needs. + + + Speed Limit - Enables notification + when you have exceeded the given speed limit (specified in the + units defined via the Units option). + + + Location - Controls the location on + the screen of the speed warning. + + + POI + + The POI tab allows you to define your + POI database and how POIs are drawn on the screen. + + + + POI database - The location on the + file system where the POI database is located. The database must + be in sqlite3 format. A default (empty) POI database is + automatically created for you when you first run Maemo Mapper. + + + Show POI below zoom - Defines the + maximum zoom (furthest away from the Earth) at which POIs will be + drawn. When zoomed out beyond this level, no POIs will be drawn. + + + + + About Maemo Mapper + + + Current Version: 2.4 + + + Maemo Mapper was created and developed by John Costigan (aka + gnuite). + + + Copyright © 2006-2007 John Costigan. + + + POI and GPS-Info code originally written by Cezary Jackiewicz. + + + Default map data provided by http://www.openstreetmap.org/ - other + map repositories are subject to their own licenses and may or may not + be suitable for use with Maemo Mapper. It may be illegal to use a + certain repository with Maemo Mapper or under certain conditions. This + includes the repositories downloadable directly in Maemo Mapper. If + you are not sure if you are legally allowed to use a particular + repository, you should delete it from your list of repositories. The + authors of Maemo Mapper cannot be held responsible for your use of a + particular repository. + + + Maemo Mapper is free software: you can redistribute it and/or modify it + under the terms of the GNU General Public License as published by the + Free Software Foundation, either version 3 of the License, or (at your + option) any later version. + + + Maemo Mapper is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + General Public License for more details. + + + + -- 2.44.0