This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:notecoords [2020/08/19 20:21] – add first draft for advanced waypoint syntax eddiemuc | 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. Two coordinates are consideres " | + | 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 ^ ShortId | + | ^ Icon ^ Waypoint type ^ Keyword in personal note ^ Short ID in personal note ^ |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
- | |{{ : | + | |{{ : |
c:geo will recognize the following keyword formats as waypoint type identifiers (all of them case-insensitive): | c:geo will recognize the following keyword formats as waypoint type identifiers (all of them case-insensitive): | ||
* the keyword itself | * the keyword itself | ||
- | * the ShortId surrounded by parenthesis (e.g. "(f)" | + | * the ShortId surrounded by parenthesis (e.g. '' |
- | * the ShortId | + | * the ShortId **directly |
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. | ||
Line 49: | Line 52: | ||
{{: | {{: | ||
- | ===== Advanced waypoint creation: name, user note and prefix | + | ===== Backup waypoints in personal |
- | Perhaps you noticed that up to now waypoints were created with default names like e.g. '' | + | 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. |
- | If you want to create or edit waypoints | + | |
+ | 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 | ||
+ | * 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 | ||
'' | '' | ||
- | Such a format is only recognized when it begins | + | The advanced |
- | * **Waypoint | + | * **Waypoint |
* **Prefix**: If the '' | * **Prefix**: If the '' | ||
* **User note**: If the coordinate is immediately followed by ''"'' | * **User note**: If the coordinate is immediately followed by ''"'' | ||
- | * **Waypoint type**: same rules apply as discussed in previous | + | * **Waypoint type**: same rules apply as discussed in previous |
+ | * **Coordinate**: | ||
+ | * **Formula**: | ||
The geocaches waypoint list is modified with this information as follows: | 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. | + | * If a **prefix** is parsed and a waypoint is found with the same prefix, then it is assumed that this waypoint should be modified. |
- | * If a waypoint is found with the same coordinate as the waypoint parsed, then it is assumed that this waypoint should be modified | + | * 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 | + | * Otherwise a new waypoint is created. |
In case a waypoint is modified, the following rules apply: | In case a waypoint is modified, the following rules apply: | ||
- | * For predefined waypoints the only things that can be modified are the coordinate and the user note. | + | * For predefined waypoints the only things that can be modified are the coordinate |
- | * Information is only overridden | + | * In existing waypoints, fields are only overridden |
+ | * 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 ^ | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||
+ | | '' | ||