User Manual

From Contribute to OSM with Keypad-Mapper 4
Jump to: navigation, search

Contents

10002.svg
10001.svg
10002.svg
10001.svg
10002.svg
10001.svg
10002.svg
10001.svg
10002.svg
10001.svg
10002.svg
10001.svg
10002.svg

App Icon Features

Keypad-mapper-wiki-icon-v4.png The app has its own app icon indicating the app version, which is currently 4.
The 'About' screen provides the exact version number of the currently installed version. It can be found as last option in the settings screen.

Main menu

Tapping on the app icon opens the main menu.

The main menu provides access to all functionalities of the app.

150px

Motivation

While mapping, the number shown in the circle of the app icon indicates the number of map features mapped on the current day.

Keypad Screen

The main idea behind the Keypad-Mapper 4 keypad screen 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.

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

If the keypad screen is currently displayed, then this icon has a glow, otherwise not.

Arrow Buttons

ENAiKOON-Keypad-Mapper-3-keypad-screen-with-arrow-to-arrows.png The most important keypads on the keypad screen are the arrow buttons for saving house numbers.

Instead of version 2 showing L/F/R, the latest Keypad-Mapper 3 version displays ENAiKOON-Keypad-Mapper-3-icon-left.png,  ENAiKOON-Keypad-Mapper-3-icon-front.png,  ENAiKOON-Keypad-Mapper-3-icon-right.png.
The arrows indicate on which side of the street the address node will be saved.


Back Button

150px A short tap on this back button deletes the last character entered into the house number entry field.

A long tap on this back button clears the content of the house number entry field as well as the text note entry field.

For removing a character of the text note entry field the back button of the full keyboard can be used.
The full keyboard opens after tapping inside the text note entry field.

Shift Button

150px Tapping short on this keypad displays the next keypad icons group.

Details regarding the keypad icons management can be found here.
Keypad icons groups can be used to map additional information for house numbers, e.g. type of entrance, building height, wheelchair information etc.

History

ENAiKOON-Keypad-Mapper-3-keypad-screen-with-arrow-to-LFR.png Depending on the screen size 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 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.


Entering Complicate House Numbers

150px A long tap on the house number entry field in the keypad screen opens a full keyboard for entering an unusual house number.

The data entered in this way is stored in the .osm file as value of an addr:housenumber key.

Optional Text Entry

A separate field is available 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 optimizing the data later in an OSM editor or if a house number must be mapped with characters different from the ones provided on the keypad.
The note is stored in the .osm file assigned to a TAG with type 'name'.
Example:

<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"/>
</node>

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

Display of current Street Name and Postal Code

Current street name and postal code are shown based on NOMINATIM data.
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.
Street name and postal code are only visible if the device is online.

Icons on Keypads

Some mappers might want to add additional information to a newly mapped house number / address node. Typical examples might be a 'wheelchair=*' tag or an 'entrance=main' tag.

Optional icons on the numeric keypads of the keypad screen allow to do so. By factory default icons of map features related to entrances and buildings are present on all numeric keypads of the keypad screen.

If an icon is present on a keypad, then the following options are available:

Short Tap

A short tap is used to enter the digit noted on the keypad (e.g. to type a house number)

Long Tap

A long tap is used to activate the additional key/value data stored for the icon being present on a keypad.
These additional key/value pairs will then be stored along with the currently mapped house number / address. If no house number is entered, the key/value pars will be stored without a house number node.

When executing a long tap the keypad gets yellow:
150px

The key/value pairs of multiple keypads can be activated at the same time. A 2nd long tap deactivates the previously activated keypad.

If a key/value pair assigned to an icon present on a keypad does not contain any data on the right side of the equal sign, then after a long tap on the keypad a popup screen opens that allows to enter the missing data.
In this case an additional check box is presented. Example: In case the key/value pair 'entrance=" was assigned to a keypad then after a long tap a popup screen pops up as follows:
150px

A check box inside the popup screen allows to decide, if the entered data should be cleared after saving it to the local database or if it should be kept for subsequent address nodes going to be mapped later on.

Tapping on "ok" saves the values entered for the keys without predefined values.

All data entered for an address node is stored only in the local database for further use in an OSM editor after tapping on one of the arrow keys inside the keypad screen.

The 'long tap' option is not available if currently no icon of a map feature is assigned to the selected keypad in the keypad screen.

Very Long Tap

A very long tap on one of the numeric keypads in the keypad screen allows to modify the key/value pairs as well as the icon assigned to the keypad.

Details can be found in the description of the settings option Keypad Icons Management

Missing House Numbers

ENAiKOON-Keypad-Mapper-3-icon-missing-house-numbers-glow.png ENAiKOON-Keypad-Mapper-3-icon-missing-house-numbers-no-glow.png There are areas which already have mapped house numbers. The missing house numbers option provides a list with all missing house numbers near by.

After tapping on the missing house numbers icon the user can specify the radius of the area around him with the following slider:
50px
Now the app loads all street names around the current GPS position of the user and povides the amount of missing house numbers per street name:
50px
The mapper can now tap on any of the found street names. A list containing each missing house number is provided as follows:
50px
Now the mapper can walk to the first missing house number and map it by tapping on the left arrow or on the right arrow. After tapping on any of the two arrows, the data is stored in the local database and the house number is removed from the list of missing house numbers.
If the house number does not exist in reality, then the mapper can tap on the 50px icon. This stores the information, that this house number is not existing in reality, in the local database of the phone. A future version of the Keypad-Mapper 3 will synchronize this information with a central database which then avoids that other mappers waste their time with double checking the same not in reality existing house number again.
After mapping the last missing house number of the selected street the app returns to the list of streets with missing house numbers near by.
If all missing house numbers of all streets near by have been mapped the app shows an empty list of streets with an according message for the user as follows: 50px

Download Offline Data

ENAiKOON-Keypad-Mapper-3-icon-offline-data-glow.png ENAiKOON-Keypad-Mapper-3-icon-offline-data-no-glow.png  ???:

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.

The address editor can be used to enter a complete address. This address will then be used for all subsequently added map features until the screen is cleared or changed.

A typical use case would be mapping house numbers in a street. Before walking down the street the mapper adds all address information to the address editor screen and then records all house numbers as usual.
After uploading the data to JOSM or any other OSM editor for each house number key/value pairs will be present for all related addr:* keys.

Features

ENAiKOON-Keypad-Mapper-3-icon-features-glow.png ENAiKOON-Keypad-Mapper-3-icon-features-no-glow.png Map features are database entries of the OSM database.

The Keypad-Mapper 3 allows to map any Node based map feature you can think of with any key/value pairs you would like to use.

Predefined Map Features

The app comes with more than 800 ??? predefined templates for map features.

These cover

  • all features that are present on the map features page
  • all features for which taginfo reports more than 1,000 database entries
  • some other map features that might be interesting

Details regarding each single map feature template can be found here

Self Defined Map Features

The user can define his own map features with one or multiple key-value pairs.

This process can be initiated by tapping on the ENAiKOON-Keypad-Mapper-3-icon-add-feature.png icon at the bottom of each feature group screen.
After tapping on the icon the user is presented with the following screen: 30px
This screen allow to define

  • the name of the feature shown below the icon in the feature group screen
  • the feature group the new map feature belongs to
  • all key/value pairs to be used in conjunction with this map feature

The ENAiKOON-Keypad-Mapper-3-icon-add-feature-condensed.png icon allows displaying all key/value pairs assigned to a certain map feature in a condensed way. ENAiKOON-Keypad-Mapper-3-icon-add-feature-expand.png allows to expand the list of assigned key/value pairs.
This allows to see more information on a small screen of if may key/value pairs have been assigned to a map feature:
50px

Map Feature Groups

The predefined map features as well as the self defined map features can be assigned to feature groups. This allows to click through the feature groups and find a certain feature very fast while mapping.
The predefined feature groups can be divided in two groups:

  • real feature groups: they contain templates of map features
  • virtual feature groups: they contain features, that are stored in another feature group but where it makes sense to group them with other features at the same time for logical reasons.
    Example: feature group "women´s fav places":
    this map feature group consists of map features stored in map feature groups "shops", "amenities", and "crafts". The commonality of all these map features is, that they are highly interesting for women.

Importing / Exporting Map Feature Groups

It is possible to import and export map feature groups.
This allows for ex. to compose an own set of map features with specialized key/value pairs and then to export it and to offer it to other users of the Keypad-Mapper 3, e.g. by uploading it to a web site.

The official place where to publish self-made map feature groups is here

Details regarding the feature group management can be found 'here'

Mapping a Map Feature

There are two ways to map a map feature:

  • based on the actual GPS coordinate of the GPS receiver
  • based on the actual position selected by zooming and panning the map

Details regarding both workflows can be found here

Use Current GPS Coordinate

  1. open the navigation menu by tapping on the app icon Keypad-mapper-wiki-icon-v4.png
  2. launch the map feature selection screen by tapping on ENAiKOON-Keypad-Mapper-3-icon-features-no-glow.png.
    the app will display the feature screen and the navigation menu closes;
    if you reopen the navigation menu, the feature icon will be highlighted as follows: ENAiKOON-Keypad-Mapper-3-icon-features-glow.png
  3. skim through the various screens with map features by tapping on the skim through icon ENAiKOON-Keypad-Mapper-3-icon-skim-through.png until you find the map feature you are looking for or use the search button ENAiKOON-Keypad-Mapper-3-icon-search-no-glow.png to find it.
  4. tap on the desired map feature
  5. enter the data if any is requested
  6. tap on "ok" at the bottom of the list of key/value pairs for saving the data to the local database; if no data is required for the selected map feature then after tapping on it it is immediately added to the local database - no further action required
  7. resume with 2. if you want to add another map feature to the OSM database

Zoom and Pan the Map

  1. open the navigation menu by tapping on the app icon 25px
  2. launch the map by tapping on ENAiKOON-Keypad-Mapper-3-icon-map-no-glow.png.
    the app will display the map screen and the navigation menu closes;
    if you reopen the navigation menu, the map icon will be highlighted as follows: ENAiKOON-Keypad-Mapper-3-icon-map-glow.png
  3. zoom and pan the map until the desired position of the new map feature is exactly beneath the cross of the target icon: ENAiKOON-Keypad-Mapper-3-icon-target.png
  4. tap on the 'feature' button in the lever left corner of the map screen --> the map feature screen opens and the GPS position is stored
  5. skim through the various screens with map features by tapping on the skim through icon ENAiKOON-Keypad-Mapper-3-icon-skim-through.png until you find the map feature you are looking for or use the search button ENAiKOON-Keypad-Mapper-3-icon-search-no-glow.png to find it.
  6. tap on the desired map feature
  7. enter the data if any is requested
  8. tap on "ok" at the bottom of the list of key/value pairs for saving the data to the local database; if no data is required for the selected map feature then after tapping on it it is immediately added to the local database - no further action required
  9. the app returns to the map screen
  10. resume with 3. if you want to add another map feature to the OSM database

Map

ENAiKOON-Keypad-Mapper-3-icon-map-glow.png ENAiKOON-Keypad-Mapper-3-icon-map-no-glow.png The map functionality allows setting the GPS position of a new map feature by zooming and panning the map manually to the desired position of the new map feature.
The advantage of this option is, that the GPS position of the newly added map features are very precise and therefore no further refinement of the data in an OpenStreetMap editor is required.

The tiles of the map are directly loaded from openstreetmap.org. No tiles are buffered on the mobile device.
This ensures, that the map always shows the latest content of the OSM database.

For adding a new map feature to the database please proceed as follows:

  1. set the GPS position of the new map feature
    1. pan the map to the area where the new map featrue will be mapped; you can tap on the ENAiKOON-Keypad-Mapper-3-icon-own-position.png icon if the position of the new map feature is near to your current position and if the GPS receiver receives a valid GPS position
    2. zoom the map with the ENAiKOON-Keypad-Mapper-3-icon-zoom-in.png or ENAiKOON-Keypad-Mapper-3-icon-zoom-out.png zoom buttons or with the pinch-to zoom gesture
    3. pan the map in a way, that the desired position of the new map feature is exactly in the middle of the screen below this cross: ENAiKOON-Keypad-Mapper-3-icon-target.png

  2. tap on the "feature" button if you want to add any map feature;
    in this moment the app saves the GPS coordinate selected by zooming and panning the map for the actual map feature to be mapped; the GPS coordinate of the GPS receiver is NOT used in this case even if the GPS-receiver is on
    1. the last used screen with map features opens and a popup menu, that allows to select a feature group, opens on top of it
    2. select the desired map feature group by tapping on any of the popup menu options or tap somewhere besided the popup menu for closing it
    3. tap on the desired map feature
      1. keys are assigned to the selected map feature that need user input
        1. a screen opens to enter the data; leave entry fields empty that you do not want to fill in; they will not be added to the OSM database in this case.
        2. decide if you want to keep the input data for the next occurrence of the same map feature;
          Example: if you are mapping all street lamps in a street it might be helpful to keep the operator and the type of lamp instead of entering the same information again and again
        3. tap on the "ok" button; the device vibrates and saves the data to the local database
      2. no keys are assigned to the map feature that need user input:
        in this case the selected map feature is saved immediately after tapping on it to the local database

  3. tap on the "address" button if you want to add a house number or address;
    in this moment the app saves the GPS coordinate selected by zooming and panning the map for the actual house number to be mapped; the GPS coordinate of the GPS receiver is NOT used in this case even if the GPS-receiver is on
    1. the keypad screen opens to enter the house number; enter the house number and optionally any other desired information and/or a text note; all features described here are available
    2. tap on one of the arrow keys to save the data in the local database; the app saves the data, the device vibrates and then the app returns to the map screen

Tipps and tricks:

  • the UNDO button in the menu bar allows to undo the last selection of a map feature
  • tapping on the "feature" or "address" button after saving the data of the new map feature and BEFORE changing the position set by the map you can reopen and correct the data saved for the last map feature.
  • since the map screen is the main screen of the app tapping on the device back button while the map is shown quits the app

Share Recorded Data

ENAiKOON-Keypad-Mapper-3-icon-space.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.

Undo

ENAiKOON-Keypad-Mapper-3-icon-undo-yellow.png ENAiKOON-Keypad-Mapper-3-icon-undo-grey.png This option removes the most recently added map feature from the local database.
It is not possible to undo more than one previously recorded map feature at the same time.

Freeze GPS Position

ENAiKOON-Keypad-Mapper-3-icon-freeze-GPS-glow.png ENAiKOON-Keypad-Mapper-3-icon-freeze-GPS-no-glow.png This option is valid only if you are using the data of the GPS receiver for setting the GPS position of a new map feature.

Typical applications:

  1. entrance with the house number is mounted at a location separate from the actual entrance of the building
    In this case, first go to where the house number is mounted then go back to map the address node at the proper GPS position.

  2. house number is hidden
    there are 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:

    ENAiKOON-house number hidden.jpg      ENAiKOON-house number visible.jpg

    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.

  3. take a photo with the GPS coordinates of the subject in the photo
    normally the photographer is some distance away from the subject he wants to take a picture of; in this case, one can go to the place where the subject of the photo is located, activate 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 point to the position of the subject and not to the position of the photographer.

GPS precision

There are two ways to see the current precision of the GPS signal:

GPS Precision Icon

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.


GPS Precision Screen

The screen 'GPS precision' gives information about the current GPS reception. The GPS precision icon in the menu bar shows the GPS precision in metres or feet depending on the measurement unit settings.
150px

Camera

ENAiKOON-Keypad-Mapper-3-icon-camera-glow.png ENAiKOON-Keypad-Mapper-3-icon-camera-no-glow.png The day-to-day experience of mapping with the Keypad-Mapper has proven that GPS photos are useful for remembering complicated situations or additional information for later use in the OSM editor.

Such photos might save the mapper from entering additional notes (e.g. for remembering a complete address printed on a menu, hints for special signs, etc.) or from taking notes elsewhere.

The photo is taken with GPS information stored in the Exif meta data format inside the JPEG file.
The photo can be uploaded along with the .gpx and .osm files to JOSM and will be shown inside JOSM on the map where it was taken to support the mapper adding the correct information to the OSM database.

Recording Data

ENAiKOON-Keypad-Mapper-3-icon-record-stop.png ENAiKOON-Keypad-Mapper-3-icon-record-start.png The 'recording data' menu option in conjunction with the 'turn off GPS' settings option provides the following functionality:
  • if 'recording data' is active a .gpx track is recorded while the app is in the foreground; the actual setting of 'turn off GPS' is not taken into account
  • if 'recording data' is active a .gpx track is recorded even if the app is in the background; the actual setting of 'turn off GPS' is not taken into account
  • if 'recording data' is off AND the 'turn off GPS' feature is not activated, then GPS remains on
  • if 'recording data' is off AND the 'turn off GPS' feature is activated, then GPS is switched off in order to save battery power

The 'recording data' feature is by default ON after launching the app.
The 'turn off GPS' feature is by default ON after launching the app.

Light

ENAiKOON-Keypad-Mapper-3-icon-light-glow.png ENAiKOON-Keypad-Mapper-3-icon-light-no-glow.png The "light" menu option allows to switch the flash light of the mobile device on and off.
This allows to read information while mapping outdoor even if it is dark conveniently.

Audio 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>
<ele>89.50511403620409</ele>
</wpt>

Audio notes as well as all other recorded files used for editing the data are sent to the PC using the share recorded data feature.

JOSM allows to load all mapped data including the recorded audio notes specific to the GPS position where it was recorded. Playing the audio note can help to 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 regarding audio mapping can be found here.

Text Note

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

The text note feature works similarly to the photo feature or to the audio note feature: it allows you recording a text memo and saving it along with a GPS coordinate.

The keypad screen provides its own text note feature which can be hided or active. Details can be found here.
In case the text note entry field is activated by activating the related settings option AND the keypad screen is actually shown then the 'T' option is neither shown in the navigation menu nor in the menu bar.

Screen Rotation

ENAiKOON-Keypad-Mapper-3-icon-rotate-glow.png ENAiKOON-Keypad-Mapper-3-icon-rotate-no-glow.png This menu option allows to activate / deactivate automatic screen rotation depending on the current device orientation independently of the settings of the mobile device conveniently.

This setting is used solely in the Keypad-Mapper 3 app and does not affect any other app running on the device.

Settings

General

Language

The current version is available in nine languages:

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

Special thanks to the following Keypad-Mapper 3 contributors:

Stefano for the Italian translation as well as for the promotion of Keypad-Mapper 3 on talk-it
Adam for the Polish translation
Harry for the Dutch translation

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

Measurement Units

Both metric and imperial measurement units in meters 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.

Picture / Icon management

???

Keypad Icons Management

This settings option allows to define, which map feature should be present on which numeric keypad in the keypad screen.

Icon Groups

After launching this settings option a list with 'icon groups' is shown.
Icon groups are groups of map features being present on the keypad screen at the same time.

Factory default is one icon group named 'Default'.
Tapping on the ENAiKOON-Keypad-Mapper-3-icon-add-feature.png icon allows to add an icon group.

If multiple icon groups are defined, then

  • the keypad below the '7' keypad on the keypad screen allows to skim through the different icon groups
  • the white arrows at the right border of the list of icon groups allows to rearrange the icon groups by dragging them with the finger up or down;
    this influences the sequence of the icon groups when skimming them thru on the keypad screen

A long tap on an icon group in the list of icon groups allows to edit the icon group meta data:

  • icon group name
  • shift key text
  • description

In addition a long tap on an icon group allows to delete an icon group.

The 'import' button on the bottom of the list of icon groups allows to import an icon group that was previously exported, e.g. by another Keypad-Mapper 3 user.
If the icon group name of the icon group to be imported already exists on the phone, then the current data of the icon group will be replaced with the imported data.
If the icon group name of the icon group to be imported not yet exists on the phone, then the new icon group will be added to the list of icon groups.

Tapping in the list of icon groups on one icon group and then subsequently on the 'import' button and then selecting any icon group stored on the phone, then the icon group inside which the import button was tapped will be replaced by the newly selected icon group.

Tapping in the list of icon groups on one icon group and then subsequently on the 'export' button then the icon group is exported to the Keypad-Mapper 3 directory on the SD card. The file is named 'keypad_<icon_group_name>_<timestamp>.kpm (values in <> to be replaced by the actual data)

Changing a Map Feature shown on a Keypad

After tapping short on an icon group in the list of icon groups and subsequently tapping short on one of the 10 keypads presented it is possible to configure the map feature assigned to the selected keypad in the selected icon group.

At the top border of the screen the selected numeric keypad is shown as well as as the assigned icon.

Below it the name of the currently selected icon group is shown.

A filter entry field allows to filter the icons present on the phone by their tags and description.

The 'load icon from SD card' button allows to import an icon into the Keypad-Mapper 3 after selecting the part of a picture to be used as an icon.

The 'edit key/value data' entry field allows to enter all desired key/value pairs.
If no value is entered on the right side of an equal sign the app will later ask for this value when mapping a node with this set of key/value pairs.

The 'description' entry field allows to enter any description that might help recipients or users of an icon group to understand the purpose of the icon group.

The 'clear' button allows to clear any data assigned to the selected keypad.
The 'save' button allows to save the configured data.

Feature Groups Management

This settings option allows to define, which feature groups should be present and which map features should be assigned to which element of each feature group.

Feature Groups

After launching this settings option a list with 'feature groups' is shown.
Feature groups are groups of map features. Typical feature groups are 'amenity', 'leisure' or 'man_made'. Details can be found here

Tapping on the ENAiKOON-Keypad-Mapper-3-icon-add-feature.png icon allows to add a feature group.

If multiple feature groups are defined, then

  • the 'skim through' icon ENAiKOON-Keypad-Mapper-3-icon-skim-through.png allows to skim from feature group to feature group
  • the white arrows at the right border of the list of feature groups allows to rearrange the feature groups by dragging them with the finger up or down;
    this influences the sequence of the feature groups when skimming them thru in the feature screen

A long tap on a feature group in the list of feature groups allows to edit the feature group meta data:

  • feature group name
  • description

In addition a long tap on a feature group allows to delete a feature group.

The 'import' button on the bottom of the list of feature groups allows to import a feature group that was previously exported, e.g. by another Keypad-Mapper 3 user.
If the feature group name of the feature group to be imported already exists on the phone, then the current data of the feature group will be replaced with the imported data.
If the feature group name of the feature group to be imported not yet exists on the phone, then the new feature group will be added to the list of icon groups.

Tapping in the list of icon groups on one feature group and then subsequently on the 'import' button and then selecting any feature group stored on the phone, then the feature group inside which the import button was tapped will be replaced by the newly selected feature group.

Tapping in the list of feature groups on one feature group and then subsequently on the 'export' button then the feature group is exported to the Keypad-Mapper 3 directory on the SD card. The file is named 'feature_<feature_group_name>_<timestamp>.kpm (values in <> to be replaced by the actual data).

Changing a Map Feature Template

After tapping short on a feature group in the list of feature groups and subsequently tapping short on one of the templates presented it is possible to configure the selected map feature template.

??? At the top border of the screen the selected numeric keypad is shown as well as as the assigned icon.

Below it the name of the currently selected icon group is shown.

A filter entry field allows to filter the icons present on the phone by their tags and description.

The 'load icon from SD card' button allows to import an icon into the Keypad-Mapper 3 after selecting the part of a picture to be used as an icon.

The 'edit key/value data' entry field allows to enter all desired key/value pairs.
If no value is entered on the right side of an equal sign the app will later ask for this value when mapping a node with this set of key/value pairs.

The 'description' entry field allows to enter any description that might help recipients or users of an icon group to understand the purpose of the icon group.

The 'clear' button allows to clear any data assigned to the selected keypad.
The 'save' button allows to save the configured data.

Rate the App on Google Play

Good ratings are important for the success of any app.

If you like the app then we´d highly appreciate if you would rate it on Google Play!

Keep Screen On

This option keeps the screen of the device permanently on while mapping independent of the device settings.

Turn Off GPS

This settings option allows to decide, if GPS should be switched off while the 'Recording Data' feature is switched off.

The advantage of switching GPS off is that the battery of the mobile device might last significantly longer. The disadvantage of activating this feature is that after switching GPS on again it might take longer to get a valid GPS fix.

Data

Distance of the Address Nodes

This settings option allows to set the distance between GPS based nodes and the current position of the device when storing the map feature in the local database.

A different distance can be set for each of the three directions:

  • nodes on the left side
  • nodes on the right side
  • nodes ahead of the current position.

Typical use case:
when walking down a wide road for ex. on the left side then the houses on the right side are significantly more far away from the current position than the houses on the left side.
This can be compensated by e.g. setting the distance of the newly added nodes on the left side to 2 meters and the distance of the nodes on the right side to 15 meters.

30px

Distance between Waypoints

This settings option allows to set the distance between two way points stored in a .gpx file.

For better orientation while fine tuning the data in an OSM editor before uploading it to the OSM database the Keypad-Mapper 3 creates a .gpx track consisting of multiple way points.

Some Keypad-Mapper 3 users also use the Keypad-Mapper 3 for recording tracks without mapping map features.
This is also the reason why the Keypad-Mapper 3 allows to record a .gpx track even when run in the background.

The closer the way points are, the bigger the .gpx file will get.

Use Compass

This settings option defines a speed up to which the information of the compass built into the device is used for calculating the direction instead of the GPS heading information.

If no compass is available in the device, this option is greyed out.

Share Recorded Data

After mapping data with the Keypad-Mapper 3 it is required to transfer the data to a device running an OSM editor for further processing.

The 'share recorded data' option can be used for this task.
All options some software installed on the device offers like e-mail, Bluetooth, wire transfer etc. are supported by the Keypad-Mapper

This option attaches all files generated by the Keypad-Mapper 3 mapper for ex. to an e-mail including

  • .gpx files
  • .osm files
  • .wav files
  • pictures
  • .kpm files

Delete all Collected Data

This option is normally used to free some space on the mobile as soon as the collected data has been successfully sent to the PC running the OSM editor.
In addition this option ensures, that you do not get confused by transferring the same data multiple times from the device to the PC.

Wi-Fi data only

This option is especially helpful if your current GSM data plan is expensive or if the amount of free data is limited.
It allows to limit the internet connection to situation where a Wi-Fi connection is available. In case no internet connection is available the following features of the software are not available:

  • postcode and street name cannot be updated on the keypad screen
  • the map cannot be updated
  • the list of missing house numbers cannot be retrieved
  • the text resources cannot be updated

.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

Show Note Entry Field

On the keypad screen below the house number entry field a text note entry field exists.
On small screens the text note entry field covers a serious amount of space. Therefore this settings option has been implemented that allows to show or hide the text entry field.

If the text entry field is hided then instead of the text entry field a button with a 'T' is shown in the menu bar that allows to open a popup screen for entering a text note.
This text note is then stored in a note=* tag when saving the next map feature to the local database.

Vibration

Vibration on Save

This settings option allows to set the duration of the vibration in milliseconds when saving a 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

This settings option allows to set 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.

Error Reporting

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 of the app. No private data, including passwords, is sent to the developers.

Help

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

The help text can be shown by either selecting the 'help' option the settings screen or by tapping on the ENAiKOON-Keypad-Mapper-3-icon-question-mark.png icon.

Message to Developer

This feature allows to send a feedback regarding the app directly to the developers: - feature requests - icon requests - bug reports - suggestions for improvements - praise and blame

About

The 'About' option in the settings screen shows some information about ENAiKOON - the developers of the latest version of the app - as well as the exact version number.

Survey Date

The survey key is saved with each address tag.
This ensures that if there is a serious gap between the day recording the data and the day uploading it to OSM thi is logged along with the data.
In case the upload date and the mapping date is almost the same, then pls remove this tag from all newly recorded map features before uploading the data to the OSM database.
For more details regarding the survey:date key please see: survey:date=*

Example:

<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"/>
</node>

Screen layouts

The layout of some screens as well as the content of the keypad screen depend on the screen size as follows:

Smartphone Screens

Low Resolution Screens

Users of devices with low resolution screens (MDPI) can hide several elements of the keypad screen for gaining bigger keypads

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

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

ENAiKOON-Keypad-Mapper-klein-hoch-mit-31 EN.png    ENAiKOON-Keypad-Mapper-klein-quer-mit-31 EN.png

ENAiKOON-Keypad-Mapper-klein-hoch-ohne-31.png    ENAiKOON-Keypad-Mapper-klein-quer-ohne-31.png

Medium / High Resolution Screens

??? (HDPI / XHDPI)

Tablet Screens

Some mappers are using 7" to 10" tablets for mapping. 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.
Keypad-Mapper 3 provides an optimised screen layout for tablet users in both landscape and portrait modes:

ENAiKOON-Keypad-Mapper-tablet-portrait.png    ENAiKOON-Keypad-Mapper-tablet-landscape.png
This UI is automatically activated on all devices with a minimum screen size of 7".
Samsung Galaxy Note 1, 2 and 3 are NOT using the tablet layout. Despite the fact that they are categorized 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

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.

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.
ENAiKOON-ressource-editor.jpg