== 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.

The preset dialogs come in two forms in JOSM, and you can navigate between them:

* [[Image(Guidepost-16a.svg)]] //**Guidepost Directions & Destinations**//

  The basic form of the dialog. Thus 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 one of the icons above when you see it in the list underneath. It'll flip to the //Properties// tab for the next bit.

Everything's managed in 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, and can be made available by selecting red+brown 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>
}}}