Difference between revisions of "User Manual"

From Contribute to OSM with Keypad-Mapper 4
Jump to: navigation, search
(Die Seite wurde neu angelegt: „===new features version 3.1=== '''record voice note:'''<br> {| | 50px | File:ENAiKOON-Keypad-Mapper…“)
(new features version 3.1)
Line 2: Line 2:
'''record voice note:'''<br>
'''record voice note:'''<br>
| [[File:ENAiKOON-Keypad-Mapper-3-icon-audio-active.png | 50px]]
| [[File:ENAiKOON-Keypad-Mapper-3-icon-audio-glow.png | 50px]]
| [[File:ENAiKOON-Keypad-Mapper-3-icon-audio-on.png | 50px]]
| [[File:ENAiKOON-Keypad-Mapper-3-icon-audio-no-glow.png | 50px]]
| Recording an audio note is less conspicuous to others than taking a photo, therefore some mappers prefer to record voice memos instead of taking GPS photos in order to avoid calling the attention of passerby.<br>
| Recording an audio note is less conspicuous to others than taking a photo, therefore some mappers prefer to record voice memos instead of taking GPS photos in order to avoid calling the attention of passerby.<br>
The audio note feature works similarly to the photo feature: it allows you to record a voice memo and save it along with a GPS coordinate. Unlike .jpg files, the GPS coordinates for audio notes are stored in the .gpx file, therefore the .gpx file must be loaded in JOSM before loading the .wav file.
The audio note feature works similarly to the photo feature: it allows you to record a voice memo and save it along with a GPS coordinate. Unlike .jpg files, the GPS coordinates for audio notes are stored in the .gpx file, therefore the .gpx file must be loaded in JOSM before loading the .wav file.

Revision as of 11:44, 23 November 2013

new features version 3.1

record voice note:

ENAiKOON-Keypad-Mapper-3-icon-audio-glow.png ENAiKOON-Keypad-Mapper-3-icon-audio-no-glow.png Recording an audio note is less conspicuous to others than taking a photo, therefore some mappers prefer to record voice memos instead of taking GPS photos in order to avoid calling the attention of passerby.

The audio note feature works similarly to the photo feature: it allows you to record a voice memo and save it along with a GPS coordinate. Unlike .jpg files, the GPS coordinates for audio notes are stored in the .gpx file, therefore the .gpx file must be loaded in JOSM before loading the .wav file. The audio note entry in the .gpx file has the following content:

<wpt lat="52.49739929702362" lon="13.350353411755215">
<link href="file:///2013-06-01_16-17-13.wav"> <text>2013-06-01_16-17-13.wav></text> </link>

Audio notes and all other recorded files used for editing the data are sent to the PC using the SHARE RECORDED DATA feature.
JOSM allows you to load all mapped data including the recorded audio notes specific to the GPS position where it was recorded. Playing the audio note will help you remember details of that specific location.
Audio notes are loaded automatically along with the .gpx file if the .wav files have been saved in the directory specified in Keypad-Mapper 3 settings option '.wav file path'.
Additional details can be found here.

the RECORD button has been restored:

ENAiKOON-Keypad-Mapper-3-icon-record-stop.png ENAiKOON-Keypad-Mapper-3-icon-record-start.png Version 2.0 of Keypad-Mapper provided a 'RECORD' button that allowed users to start/stop recording and to start recording based on a new set of .osm / .gpx files. Although this button was removed in version 3.0 it has now been restored in the actual version.

In addition a new settings option 'turn off GPS' has been added. The 'recording data' feature and the 'turn off GPS' feature correlate as follows:

  • if recording is active, a .gpx track is recorded
  • if recording is active then a .gpx file is recorded even if the app is in the background;
  • if recording is off and the 'turn off GPS' feature is activated, then GPS is switched off in order to save battery power

improved history:

ENAiKOON-Keypad-Mapper-3-keypad-screen-with-arrow-to-LFR.png Two or three mapped house numbers appear on the right side of the house number entry field on the keypad screen. These house numbers are now preceded with 'L:', 'F:' or 'R:'. This makes it easier to check if recent house numbers were mapped on the correct side of the road.

the survey date is saved with each address tag:
See: Key:survey:date


<node id="-1" visible="true" lat="52.497442495127025" lon="13.350499497003666">
<tag k="survey:date" v="2013-06-01"/>
<tag k="addr:housenumber" v="15"/>

optimized screen layout for larger screens:
Some mappers are using 7" to 10" tablets for mapping. The relatively new Google Nexus 7 seems to be especially wide spread amongst mappers. This can be attributed to the fact that these devices have a longer battery life, allowing mappers to go on extended mapping tours without having to change the battery.
The new Keypad-Mapper version 3.1 provides a completely new user interface, optimised for tablet users in both landscape and portrait modes:

150px    385px
This UI is automatically activated on all devices with a minimum screen size of 7". Samsung Galaxy Note 1 and 2 are NOT using the tablet layout. Despite the fact that they are categorised as tablets the screen area available on these devices is not big enough for a proper tablet layout. The tablet layout differentiates from the phone layout as follows:

  • different sorting order of the icons in the menu bar:
    the most important icons are as close to the position of the thumb as possible
  • more icons are shown in the menu bare compared to the phone layout
  • the keypad screen and the address editor screen are both visible at the same time:
    this gives a better overview of the currently configured / mapped data
  • the house number entry field is missing in the address editor screen
  • in portrait mode, the keypad layout of the landscape mode for phone UI is used; this makes two-hand data entry possible

L/F/R and CLR on keypad screen replaced by icons:
L/F/R on keypad screen has been replaced by ENAiKOON-Keypad-Mapper-3-icon-left.png,  ENAiKOON-Keypad-Mapper-3-icon-front.png,  ENAiKOON-Keypad-Mapper-3-icon-right.png, 'CLR' has been replaced by ENAiKOON-Keypad-Mapper-3-icon-clear.png

ENAiKOON-Keypad-Mapper-3-keypad-screen-with-arrow-to-arrows.png The most important keypads on the keypad screen are the buttons for saving house numbers.
Instead of showing L/F/R, the latest version displays these keypads with arrows that indicate on which side of the street the address node will be saved.

improved usability:

  • a long tap on the house number entry field in the keypad screen opens a full keyboard for entering an unusual house number
  • various readability improvements (e.g. bigger characters, better contrast, etc.) especially for mapping under direct sunlight
  • improved response time of the app in case many house numbers were mapped
  • in the address editor screen the house name entry field was moved to the bottom of the page

additional settings options:

  • turn off GPS:
    allows you to optionally continue with the .gpx route recording even when the Keypad-Mapper 3 app is on in the background and/or while the screen is off
  • vibration on save:
    defines the duration of the vibration in milliseconds when saving an address node (when tapping on ENAiKOON-Keypad-Mapper-3-icon-left.png,  ENAiKOON-Keypad-Mapper-3-icon-front.png,  ENAiKOON-Keypad-Mapper-3-icon-right.png)
  • keypad vibration:
    defines the duration of the vibration in milliseconds when tapping on any key except ENAiKOON-Keypad-Mapper-3-icon-left.png,  ENAiKOON-Keypad-Mapper-3-icon-front.png,  ENAiKOON-Keypad-Mapper-3-icon-right.png on the keypad screen
  • use compass:
    defines a speed up to which the compass information is used instead of the GPS heading information for calculating the direction
  • .WAV file path:
    defines the .wav file path on your computer which will be used to save the recorded audio notes; this information is required by JOSM for proper loading of the .wav files

The sequence of the settings options on the settings screen has been optimized.

new in version 3.0

menu icon 'address editor':

ENAiKOON-Keypad-Mapper-3-icon-adress-editor-glow.png ENAiKOON-Keypad-Mapper-3-icon-adress-editor-no-glow.png Tapping on this icon launches the address editor screen

menu icon 'keypad screen':

ENAiKOON-Keypad-Mapper-3-icon-keypad-glow.png ENAiKOON-Keypad-Mapper-3-icon-keypad-no-glow.png Tapping on this icon launches the screen for entering house numbers

freeze GPS position:

ENAiKOON-Keypad-Mapper-3-icon-freeze-GPS-glow.png ENAiKOON-Keypad-Mapper-3-icon-freeze-GPS-no-glow.png In some cases, the entrance with the house number is mounted at a location separate from the actual entrance of the building. In these cases, you must first go to where the house number is mounted then go back to map the address node at the proper GPS position.

There are other cases, like the situation shown in the pictures below, where the house number is hidden, making it necessary for you to pass the entrance and then look back for reading the house number:

200px    200px

With the FREEZE option you can freeze the actual GPS position of the entrance (indicated by the highlighted freeze icon).
This allows you to go to the place where the house number is visible, enter the house number, and save it with the previously saved GPS position of the entrance.
After saving the house number by tapping on ENAiKOON-Keypad-Mapper-3-icon-left.png,  ENAiKOON-Keypad-Mapper-3-icon-front.png,  ENAiKOON-Keypad-Mapper-3-icon-right.png, the freeze mode is cancelled automatically and the freeze icon is no longer highlighted.

Another use case of the freeze GPS option is taking a photo with the GPS coordinates of the subject in the photo:
in this case, you can go to the place where the subject of the photo is located, use the freeze GPS option, and then relocate to take the picture of the subject.
This ensures that the GPS coordinates stored inside the JPEG file points to the position of the place and not to the position of the photographer.

take photos:

ENAiKOON-Keypad-Mapper-3-icon-camera-glow.png ENAiKOON-Keypad-Mapper-3-icon-camera-no-glow.png The day-to-day experience of mapping house numbers has proven that GPS photos are useful for remembering complicated situations or additional information that has nothing to do with house numbers but is interesting enough to being mapped. In many cases, such photos save the mapper from entering additional text (e.g. for remembering a complete address printed on a menu, hints for special signs, etc.). The photo is taken with GPS information stored in the Template:Wikipedia of the JPEG file. The photo can be uploaded along with the .gpx and .osm files to JOSM or to any other OSM editor and will be shown on the map where it was taken.

optional text entry:
A separate field has been implemented for entering additional text, assigned to TAG key 'name'. While entering such additional text, a full keyboard is shown on top of the keypad with all required characters.
This is especially helpful when saving notes for future reference when optimising the data later in an OSM editor or if a house number must be mapped with characters different from the ones on the keypad.
The note is stored in the .osm file assigned to a TAG with type 'name'.

<node id="-1" visible="true" lat="52.49750275564635" lon="13.35025888569893">
<tag k="name" v="this is your additional text"/>
<tag k="addr:housenumber" v="51"/>

This information can be deleted with the OSM editor after using it or it can be assigned to the correct TAG type.

The number shown in the circle of the app icon indicates the number of house numbers mapped that day.

optimisation of the keypad screen for small devices:
Users of devices with small screens can hide several elements of the keypad screen:

  • question mark for launching the help screen
  • display of street name and postcode
  • entry field for additional text

In addition fewer characters are shown on smaller screens.
In case that you are using a small screen, all characters are made available if you turn the device to landscape orientation:

150px    338px

150px    338px

The last two or three stored house numbers are continuously shown on the right side of the house number entry field.
The amount of shown house numbers depends on the size of the screen.


50px ENAiKOON-Keypad-Mapper-3-icon-undo-grey.png This option removes the most recently added house number from the .osm file.
It is not possible to undo more than one previously recorded house number.

display of current street name and postal code:
Current street name and postal code are shown based on NOMINATIM data (only visible if the device is online). This allows seeing if the data already stored in the OSM database is correct and complete and whether there are typos in the existing data.

connect to the internet via Wi-Fi only:
This option is especially helpful if your current GSM data plan is expensive or if the amount of free data is limited.

measurement units:
Both metric and imperial measurement units in metres and feet are supported for entering the distance between the current device position and the position of the address nodes. This allows the use of the software in countries with imperial measuring units.

keep screen on:
This option keeps the screen of the device on while mapping.

swipe from screen to screen:
The user has the choice to either tap on a menu item to open another screen or to swipe horizontally over the screen with one finger to get to another screen.

share recorded data:

ENAiKOON-Keypad-Mapper-3-icon-share-glow.png ENAiKOON-Keypad-Mapper-3-icon-share-no-glow.png Conveniently sends all recorded data (.osm files, .gpx files, audio notes, and photos) by e-mail, Bluetooth, or Wi-Fi directly to the PC which runs the OSM editor.
The e-mail address entered is stored on the device for future use and can be changed at any time.

delete all recorded data:
This option is normally used to free some space on the device as soon as the collected data has been successfully sent to the PC running the OSM editor.

detailed help text:
A detailed help text in all nine supported languages is available for a quick understanding of the app's main features.

nine languages:

  • Dutch
  • English
  • French
  • German
  • Greek
  • Italian
  • Polish
  • Russian
  • Spanish

Special thanks to Template:OsmUser for the Italian translation as well as for the promotion of Keypad-Mapper 3 on talk-it
Additional thanks to Template:OsmUser for the Polish translation and to Template:OsmUser for the Dutch translation.

If you would like to translate the Keypad-Mapper 3 into another language, please contact User:Markus59.

resource editor integration:
All text resources and graphics resources used by the app are maintained in the ENAiKOON resource editor. This is a server-based web application.
Advantage: an additional language or any changes of some existing resources are immediately available for all users of the app without the need of updating the entire app.

crash reports:
In case the app crashes, there is an option to send a crash report with important information (e.g. a stack trace) to the Keypad-Mapper 3 developers.
This allows them to find and fix the bug in order to ensure the highest possible quality. No private data, including passwords, is sent to the developers.

only one version for all Android versions:
All Android versions from 2.1 to 4.x are supported.

app icon:

50px The app has its own app icon which indicates that mapping house numbers is the main purpose of the app, and its version, which is currently 3. The 'About' screen provides the exact version number of the currently installed version.

'GPS precision' screen:
The screen 'GPS precision' gives information about the current GPS reception.

ENAiKOON-Keypad-Mapper-3-icon-GPS-without-needle-glow.png ENAiKOON-Keypad-Mapper-3-icon-GPS-without-needle-no-glow.png The GPS precision icon in the menu bar shows the GPS precision in metres or feet depending on the measurement unit settings.
ENAiKOON-Keypad-Mapper-3-icon-GPS-with-needle-glow.png ENAiKOON-Keypad-Mapper-3-icon-GPS-with-needle-no-glow.png If the compass of the device is used for calculating the direction, then a compass needle in the GPS icon is shown.
ENAiKOON-Keypad-Mapper-3-icon-GPS-wo-digit-glow.png ENAiKOON-Keypad-Mapper-3-icon-GPS-wo-digit-no-glow.png If the GPS precision icon in the menu bar shows no number, then there might be GPS reception, but quality is not good enough for the Keypad-Mapper.

other great apps for mapping house numbers:
The main idea behind Keypad-Mapper 3 is to map house numbers, and eventually address nodes, as efficiently as possible for a seamless editing of data later at home with JOSM or any other OSM editor.

Many mappers feel that adding tags other than the house numbers while mapping is a waste of time and that it can be done more effectively and conveniently later at home.

Other OSM mappers prefer completing the data immediately while collecting it, including a precise position of the node on the map.
OSM mappers with this preference might prefer OsmPad.

OSM mappers that prefer not to specialize in house number mapping but would rather map multiple geo data at a given position may prefer the OSMtracker app.