== Guidepost Direction & Destination Markers ==

This downloadable preset bundle extends the built-in presets for [osmwiki:Tag:information=guidepost] by adding a convenient way to capture detailed destinations and routes, as shown on a guidepost's directional signs. It uses the schema documented at [osmwiki:Key:direction_north] for simplicity.

The presets here have been tested in JOSM and Vespucci.

=== Installation ===

In JOSM: install it from the //Presets → Preset Preferences...// menu. It shows up as "Guidepost Direction & Destination Markers (by achadwick)" in the left-hand list. Click the arrow to transfer it to your list of installed presets, on the right.

In Vespucci: go to //Preferences// [cog icon] //→ More Settings... → Presets → Add Preset//. In your web browser, copy the [[/josmfile?page=Presets/GuidepostDirectionsAndDestinations&zip=1|zipfile link]] (from the [[Presets]] table on this wiki), and paste it into the URL field back in Vespucci's presets manager. Enter a suitable Name too, such as "Guidepost Directions & Destinations". Then press `OK`, and wait for it to download. Finally, don't forget to enable the checkbox next to the new presets bundle.

=== Using these presets ===

==== Usage in JOSM ====

Once they're installed, the presets are available next to the //Guidepost// builtin in JOSM, under //Presets → Facilities → Tourism//. You can press `F3` and search for them as well. The presets only appear when you have a Node object selected.

There are two preset dialogs in JOSM, and you can navigate between them:

* [[Image(Guidepost-16a.svg)]] **Guidepost Directions & Destinations**
  * The basic form of the dialog
  * This lets you enter the texts of signs pointing in each compass bearing (N, E, S, W, NE, SE, SW, NW) separately.

* [[Image(Guidepost-16b.svg)]] **Guidepost Directions & Destinations (full)**
  * A full version of the same dialog.
  * This allows feature symbols, route references, and route names to be captured also.

==== Usage in Vespucci ====

In Vespucci, when you're adding a new tagged Node, or editing tags on a Node, the `Presets` tab allows you to search for these presets by keyword. Start typing in "guidepost" or "directions", and tap the [[Image(Guidepost-16a.svg)]] or [[Image(Guidepost-16b.svg)]] icon when you see it in the list underneath. It'll flip to the //Properties// tab for the next bit.

Everything's managed under the same //Properties// tab in Vespucci. The basic preset fields are shown first, and the fancier `:ref`, `:route`, and `:symbol` tags are shown under Additional Properties if the object has any. The fancier features can be made available by selecting the [[Image(Guidepost-16b.svg)]] icon in the icon list at the bottom while editing.

==== Tag documentation ====

* [osmwiki:Key:direction_north] - bearing-specific detail tags, docs linked in the dialog
* [osmwiki:Tag:information=guidepost] - main tag that makes an object a guidepost

=== Preset XML ===

{{{
#!preset
<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"
  author="achadwick"
  description="Guidepost Direction &amp; Destination Markers"
  shortdescription="Guidepost Directions &amp; Destinations"
  icon="Guidepost-16a.svg"
  version="1.[[revision]]_[[date]]"
>
  <group name="Facilities/Tourism">

    <item name="Guidepost Directions &amp; Destinations"
      preset_name_label="true"
      icon="Guidepost-16a.svg"
      type="node"
    >
      <link wiki="Key:direction_north"/>
      <space />

      <label text="Destination or route texts shown on directional guidepost markers." />
      <space />

      <key key="tourism" value="information"/>
      <key key="information" value="guidepost"/>
      <combo
        key="guide_type"
        text="Guidepost type"
        values="destination,intermediary,numbered"
        default="destination"
        display_values="Directions to named destinations,Intermediary trail mark or arrow on a route,Directions to other numbered guideposts"
        editable="false"
      />
      <space />

      <text
        text="N-bound text"
        key="direction_north"
      />
      <text
        text="E-bound text"
        key="direction_east"
      />
      <text
        text="S-bound text"
        key="direction_south"
      />
      <text
        text="W-bound text"
        key="direction_west"
      />
      <space />

      <text
        text="NE-bound text"
        key="direction_northeast"
      />
      <text
        text="NW-bound text"
        key="direction_northwest"
      />
      <text
        text="SE-bound text"
        key="direction_southeast"
      />
      <text
        text="SW-bound text"
        key="direction_southwest"
      />
      <space />

      <label text="Use semicolons to separate multiple values." />
      <space />

      <preset_link preset_name="Guidepost"/>
      <preset_link preset_name="Guidepost Directions &amp; Destinations (full)"/>
    </item>

    <item name="Guidepost Directions &amp; Destinations (full)"
      preset_name_label="true"
      icon="Guidepost-16b.svg"
      type="node"
    >
      <link wiki="Key:direction_north"/>
      <space />

      <label text="Destination or route texts/refs/symbols shown on directional guidepost markers." />
      <space />

      <key key="tourism" value="information"/>
      <key key="information" value="guidepost"/>
      <combo
        key="guide_type"
        text="Guidepost type"
        values="destination,intermediary,numbered"
        default="destination"
        display_values="Directions to named destinations,Intermediary trail mark or arrow on a route,Directions to other numbered guideposts"
        editable="false"
      />
      <space />

      <text
        text="N-bound text"
        key="direction_north"
      />
      <text
        text="N-bound route ref"
        key="direction_north:ref"
      />
      <text
        text="N-bound route name"
        key="direction_north:route"
      />
      <text
        text="N-bound symbols"
        key="direction_north:symbol"
      />
      <space/>

      <text
        text="E-bound text"
        key="direction_east"
      />
      <text
        text="E-bound route ref"
        key="direction_east:ref"
      />
      <text
        text="E-bound route name"
        key="direction_east:route"
      />
      <text
        text="E-bound symbols"
        key="direction_east:symbol"
      />
      <space/>

      <text
        text="S-bound text"
        key="direction_south"
      />
      <text
        text="S-bound route ref"
        key="direction_south:ref"
      />
      <text
        text="S-bound route name"
        key="direction_south:route"
      />
      <text
        text="S-bound symbols"
        key="direction_south:symbol"
      />
      <space/>

      <text
        text="W-bound text"
        key="direction_west"
      />
      <text
        text="W-bound route ref"
        key="direction_west:ref"
      />
      <text
        text="W-bound route name"
        key="direction_west:route"
      />
      <text
        text="W-bound symbols"
        key="direction_west:symbol"
      />
      <space/>

      <text
        text="NE-bound text"
        key="direction_northeast"
      />
      <text
        text="NE-bound route ref"
        key="direction_northeast:ref"
      />
      <text
        text="NE-bound route name"
        key="direction_northeast:route"
      />
      <text
        text="NE-bound symbols"
        key="direction_northeast:symbol"
      />
      <space/>

      <text
        text="NW-bound text"
        key="direction_northwest"
      />
      <text
        text="NW-bound route ref"
        key="direction_northwest:ref"
      />
      <text
        text="NW-bound route name"
        key="direction_northwest:route"
      />
      <text
        text="NW-bound symbols"
        key="direction_northwest:symbol"
      />
      <space/>

      <text
        text="SE-bound text"
        key="direction_southeast"
      />
      <text
        text="SE-bound route ref"
        key="direction_southeast:ref"
      />
      <text
        text="SE-bound route name"
        key="direction_southeast:route"
      />
      <text
        text="SE-bound symbols"
        key="direction_southeast:symbol"
      />
      <space/>

      <text
        text="SW-bound text"
        key="direction_southwest"
      />
      <text
        text="SW-bound route ref"
        key="direction_southwest:ref"
      />
      <text
        text="SW-bound route name"
        key="direction_southwest:route"
      />
      <text
        text="SW-bound symbols"
        key="direction_southwest:symbol"
      />
      <space />

      <label text="Use semicolons to separate multiple values." />
      <space />

      <preset_link preset_name="Guidepost"/>
      <preset_link preset_name="Guidepost Directions &amp; Destinations"/>
    </item>

  </group>
</presets>
}}}