This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:notecoords [2019/06/12 12:57] – Typo lineflyer | en:notecoords [2021/11/23 11:09] (current) – [Using keywords for waypoint types] use SVG icons lineflyer | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
+ | c:geo can generate waypoints from the content of your personal note. It also supports a backup of your user-modified or user-defined waypoints in c:geo to the personal note. As both ways are compatible it can also easily be used as a backup/ | ||
+ | |||
+ | This page describes in detail how these feature work. | ||
===== Automatic creation of waypoints ===== | ===== Automatic creation of waypoints ===== | ||
Line 16: | Line 19: | ||
<WRAP center round tip 80%> | <WRAP center round tip 80%> | ||
- | If the waypoints of a cache already contain the same coordinates as found in your personal note, c:geo will not create a new waypoint for these coordinates as it assumes them to be an unnecessary duplicate in this case. | + | If the waypoints of a cache already contain the same coordinates as found in your personal note, c:geo will not create a new waypoint for these coordinates as it assumes them to be an unnecessary duplicate in this case. Two coordinates are consideres " |
</ | </ | ||
Line 26: | Line 29: | ||
You just place one of the following keywords in front of the coordinates: | You just place one of the following keywords in front of the coordinates: | ||
- | ^ Icon ^ Waypoint type ^ Keyword in personal note ^ | + | ^ Icon ^ Waypoint type ^ Keyword |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
+ | |||
+ | c:geo will recognize the following keyword formats as waypoint type identifiers (all of them case-insensitive): | ||
+ | * the keyword itself | ||
+ | * the ShortId surrounded by parenthesis (e.g. '' | ||
+ | * the ShortId **directly in front of** the coordinate | ||
Additionally localized waypoint type names (in the language you are using c:geo) will also work, however as c:geo is available in many languages we only list the English keywords here. | Additionally localized waypoint type names (in the language you are using c:geo) will also work, however as c:geo is available in many languages we only list the English keywords here. | ||
- | In our example | + | As an example |
- | {{:en:personalnote_wp_3.png? | + | {{:en:pn_with_waypoints.png? |
which then automatically creates these waypoints for you: | which then automatically creates these waypoints for you: | ||
- | {{:en:personalnote_wp_4.png? | + | {{:en:pn_created_waypoints.png? |
+ | |||
+ | ===== Backup waypoints in personal note ===== | ||
+ | |||
+ | It is possible to create a textual backup of all your user-modified waypoint data in the personal note. You can upload this note to the geocaching server (if the used geocaching provider supports it) and thus easily backup your custom waypoint data. Due to the above described waypoint parsing this data can then be restored to your waypoint list in case it gets lost or is deleted from your local device. | ||
+ | |||
+ | To create the textual backup, use the icon {{: | ||
+ | |||
+ | To refresh the textual waypoint backup, tap the icon {{: | ||
+ | |||
+ | As an example, when executed on the following waypoints: | ||
+ | |||
+ | {{en: | ||
+ | |||
+ | This function will create this textual backup: | ||
+ | |||
+ | {{en: | ||
+ | |||
+ | If you upload this personal note to the geocaching server, then delete the cache on your local device and later store it again in c:geo, the waypoints from the personal note will be automatically restored. | ||
+ | ===== Advanced waypoint syntax ===== | ||
+ | |||
+ | Perhaps you noticed that waypoints from personal note were created with default names like e.g. '' | ||
+ | * Modify properties of predefined waypoints (=waypoints which were predefined by the cache owner in the listing): coordinate and user note | ||
+ | * Create or modify waypoint type, name and user note in user-defined waypoints | ||
+ | |||
+ | To do this, use the following syntax in your personal note: | ||
+ | |||
+ | '' | ||
+ | |||
+ | The advanced format is recognized when it starts with a '' | ||
+ | * **Waypoint name**: everything between the '' | ||
+ | * **Prefix**: If the '' | ||
+ | * **User note**: If the coordinate is immediately followed by ''"'' | ||
+ | * **Waypoint type**: same rules apply as discussed in previous sections. | ||
+ | * **Coordinate**: | ||
+ | * **Formula**: | ||
+ | |||
+ | The geocaches waypoint list is modified with this information as follows: | ||
+ | * If a **prefix** is parsed and a waypoint is found with the same prefix, then it is assumed that this waypoint should be modified. This is usually only used for predefined waypoints. | ||
+ | * If a waypoint is found with the same coordinate as the waypoint parsed, then it is assumed that this waypoint should be modified. | ||
+ | * Otherwise a new waypoint is created. | ||
+ | |||
+ | In case a waypoint is modified, the following rules apply: | ||
+ | * For predefined waypoints the only things that can be modified are the coordinate (if the cache owner defined it empty) and the user note. | ||
+ | * In existing waypoints, fields are only overridden when they are empty or filled with a default value (e.g. system-generated waypoint name) | ||
+ | * A formula in '' | ||
+ | |||
+ | The following examples show different texts on the left and the waypoints created out of them on the right | ||
+ | ^ Personal note text ^ produced waypoint ^ | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||