User Tools

Site Tools


en:notecoords

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:notecoords [2021/04/08 15:19] – [Automatic creation of waypoints] lineflyeren:notecoords [2021/11/23 11:09] (current) – [Using keywords for waypoint types] use SVG icons lineflyer
Line 1: Line 1:
 ====== Using Personal Notes to create and store waypoint information ====== ====== Using Personal Notes to create and store waypoint information ======
  
 +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/restore of your waypoints of a cache to/from the geocaching server.
 +
 +This page describes in detail how these feature work.
 ===== Automatic creation of waypoints ===== ===== Automatic creation of waypoints =====
  
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 in personal note ^ +^ Icon ^ Waypoint type ^ Keyword in personal note ^ Short ID in personal note ^ 
-|{{ :waypoint_pkg.png?nolink&40 |}}|Parking Area|PARKING|P| +|{{ :waypoint_pkg.svg?nolink&40 |}}|Parking Area|PARKING|P| 
-|{{ :waypoint_puzzle.png?nolink&40 |}}|Question to Answer|PUZZLE|X| +|{{ :waypoint_puzzle.svg?nolink&40 |}}|Question to Answer|PUZZLE|X| 
-|{{ :waypoint_stage.png?nolink&40 |}}|Stage of a Multi cache|STAGE|S| +|{{ :waypoint_stage.svg?nolink&40 |}}|Stage of a Multi cache|STAGE|S| 
-|{{ :waypoint_trailhead.png?nolink&40 |}}|Trailhead|TRAILHEAD|T| +|{{ :waypoint_trailhead.svg?nolink&40 |}}|Trailhead|TRAILHEAD|T| 
-|{{ :waypoint_waypoint.png?nolink&40 |}}|Reference Point|WAYPOINT|W| +|{{ :waypoint_waypoint.svg?nolink&40 |}}|Reference Point|WAYPOINT|W| 
-|{{ :waypoint_flag.png?nolink&40 |}}|Final Location|FINAL|F|+|{{ :waypoint_flag.svg?nolink&40 |}}|Final Location|FINAL|F|
  
 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)to define a waypoint of type "Final"+  * the ShortId surrounded by parenthesis (e.g. ''(f)'' to define a final waypoint) 
-  * the ShortId as a single word **directly before** the coordinate+  * 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.
Line 51: Line 54:
 ===== Backup waypoints in personal note ===== ===== 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 PN and thus backup your waypoint data. Due to waypoint parsing this data can then be restored to your waypoint list in case it gets lost or is deleted from your local device.+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 button ''Add/Update waypoints'' under the personal note. A textual section will be created in your personal note starting with ''{c:geo-start}'' and ending with ''{c:geo-end}''. It contains all user-defined waypoint data from the waypoint list in advanced waypoint syntax (which is explained in the next section).+To create the textual backup, use the icon {{:ic_menu_waypoint_sync.svg?nolink&30|}} under the personal note. A textual section will be created in your personal note starting with ''{c:geo-start}'' and ending with ''{c:geo-end}''. It contains all user-defined waypoint data from the waypoint list in advanced waypoint syntax (which is explained in the next section).
  
-To refresh the textual waypoint backup, tap button ''Add/Update waypoints'' again. To removeit, tap button ''Remove waypoints''.+To refresh the textual waypoint backup, tap the icon {{:ic_menu_waypoint_sync.svg?nolink&30|}} again. To remove it, tap the icon {{:ic_menu_waypoint_delete.svg?nolink&30|}}.
  
 As an example, when executed on the following waypoints: As an example, when executed on the following waypoints:
Line 65: Line 68:
 {{en:pn_with_stored_waypoints.png?direct&600|}} {{en:pn_with_stored_waypoints.png?direct&600|}}
  
 +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 ===== ===== Advanced waypoint syntax =====
  
-Perhaps you noticed that waypoints from personal note were created with default names like e.g. ''Personal Note 2''. If you want to perform more advanced waypoint operations from your personal notes you have to use advanced waypoint syntax. With this you can:+Perhaps you noticed that waypoints from personal note were created with default names like e.g. ''Personal Note 2''. If you want to perform more advanced waypoint operations from your personal notes you have to use an advanced waypoint syntax. With this you can:
   * Modify properties of predefined waypoints (=waypoints which were predefined by the cache owner in the listing): coordinate and user note   * 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   * Create or modify waypoint type, name and user note in user-defined waypoints
Line 75: Line 79:
 ''@[<prefix>]<name> (<waypointTypeId>) <coordinate> "<user note>"'' ''@[<prefix>]<name> (<waypointTypeId>) <coordinate> "<user note>"''
  
-Advanced format is recognized when it starts with a ''@'' at the beginning of a new line. The following content is parsed: +The advanced format is recognized when it starts with a ''@'' at the beginning of a new line. The following content is parsed: 
-  * **Waypoint Name**: everything between the ''@'' and the coordinate is considered to be a part of the waypoint name, except when it is in parenthesis ''()''+  * **Waypoint name**: everything between the ''@'' and the coordinate is considered to be a part of the waypoint name, except when it is in parenthesis ''()''
   * **Prefix**: If the ''@'' is directly followed by square brackets ''[]'', then the content of these brackets is considered to be the prefix of the waypoint you want to edit   * **Prefix**: If the ''@'' is directly followed by square brackets ''[]'', then the content of these brackets is considered to be the prefix of the waypoint you want to edit
   * **User note**: If the coordinate is immediately followed by ''"'' (in same or next line), then everything between this ''"'' and the next ''"'' is considered to be part of the waypoint's **user note** (including line breaks). If the coordinate is not followed by ''"'' but has additional content on same line, then this content is considered to be the waypoint's user note   * **User note**: If the coordinate is immediately followed by ''"'' (in same or next line), then everything between this ''"'' and the next ''"'' is considered to be part of the waypoint's **user note** (including line breaks). If the coordinate is not followed by ''"'' but has additional content on same line, then this content is considered to be the waypoint's user note
   * **Waypoint type**: same rules apply as discussed in previous sections.   * **Waypoint type**: same rules apply as discussed in previous sections.
   * **Coordinate**: same rules apply as discussed in previous sections. Additionally there is a "special" coordinate tag ''(NO-COORD)'' which can be used to specify an empty coordinate (this is necessary in the very special case that one wants to modify the user note of a predefined waypoint which has no coordinate)   * **Coordinate**: same rules apply as discussed in previous sections. Additionally there is a "special" coordinate tag ''(NO-COORD)'' which can be used to specify an empty coordinate (this is necessary in the very special case that one wants to modify the user note of a predefined waypoint which has no coordinate)
 +  * **Formula**: same rules apply as discussed in previous sections. Additionally there is a "special" formula tag ''(F-PLAIN)'' which can be used to specify a formula in the ''plain''-format. Cache-listings often contains already formulas in this format. You can specify any already known value for the variables separate by the ''|''-symbol. \\ The syntax of the formula must satisfy the criterias as described in [[en:coordinatedialog#using_plain_coordinate_format|Using Plain Coordinate Format]]. \\ If you can determine the values for the variables only step by step, it is recommended to enable ''Prevent waypoints extraction'' until you have entered all variables in the personal note. Then the waypoint can be created with all values and the coordinates are calculated. (Note: the other formats are in progress)
  
 The geocaches waypoint list is modified with this information as follows: The geocaches waypoint list is modified with this information as follows:
Line 90: Line 95:
   * For predefined waypoints the only things that can be modified are the coordinate (if the cache owner defined it empty) and the user note.   * 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)   * 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 ''Plain''-format will only be adopted if no formula or coordinate has been entered yet.
  
 The following examples show different texts on the left and the waypoints created out of them on the right The following examples show different texts on the left and the waypoints created out of them on the right
Line 96: Line 102:
 | ''@ A good parking place N50 11.456 E010 35.345 park under the oak tree'' | {{:en:parkingplace.png}}| | ''@ A good parking place N50 11.456 E010 35.345 park under the oak tree'' | {{:en:parkingplace.png}}|
 | ''@ (X) marks the spot N50 12.010 E010 33.783'' |{{:en:marksthespot.png}} | | ''@ (X) marks the spot N50 12.010 E010 33.783'' |{{:en:marksthespot.png}} |
-| ''@[S5]Station 5 (X) (NO-COORD) "We have to think about this later"'' \\ (Note: this example assumes that there is a predefined waypoint in the listing with prefix S5)|{{:en:station5.png}} | +| ''@[S5]Station 5 (X) (NO-COORD) "We have to think about this later"'' \\ \\ //Note: this example assumes that there is a predefined waypoint in the listing with prefix S5//|{{:en:station5.png}} | 
 +| ''@Final (F) (F-PLAIN) N48 AB.(C*D/2) E 9 (C-D).(A+B) |A=a+b|a=5| "Formula is calculated with the variables"'' \\ \\ //Note: The formula is then transferred to the waypoint calculator (format ''Plain'')//|{{:en:final_calculated.png}} |
  
en/notecoords.1617887967.txt.gz · Last modified: 2021/04/08 15:19 by lineflyer