== United Kingdom addresses preset ==

These presets allow convenient use of the UK-specific addressing tags described in https://wiki.openstreetmap.org/wiki/Addresses_in_the_United_Kingdom

The icons are my own work, and are hereby released into the public domain. As the icons are 16x16 low-detail representations of well-known and commonly available items used on paper envelopes, no infringement upon the trade marks or copyrights of The Royal Mail Group Limited or its subsidiaries is intended or could reasonably be inferred from their use in map editing software or otherwise. No sponsorship or endorsement is implied, or would be accepted.

=== Usage ===

The main `UK Address` preset coverts all the accepted tags for tagging. There's a second preset that can be use for migrating tags that are deprecated in the UK to better accepted alternatives in the UK schema.

=== The preset itself ===

{{{
#!preset
<?xml version="1.0" encoding="UTF-8"?>
<presets xmlns="http://josm.openstreetmap.de/tagging-preset-1.0"
  author="achadwick"
  description="United Kingdom addresses"
  shortdescription="UK Addresses"
  version="1.[[revision]]_[[date]]"
  >
<group name="Annotation">

    <!-- UK address -->
    <item name="UK Address"
      preset_name_label="true"
      icon="stamp1-16.svg"
      icon_size="48"
      type="node,way,closedway,multipolygon"
    >

    <link href="https://wiki.openstreetmap.org/wiki/Addresses_in_the_United_Kingdom"/>

    <optional text="Premises">
      <!-- Sub-building name -->
      <text key="addr:unit"
        text="Single Unit (&quot;Flat 1&quot;, &quot;Unit B&quot;, &quot;17&quot;)"
        match="key"
      />
      <text key="addr:flats"
        text="Multiple Units (e.g. &quot;3-7;10;14;16-18&quot;)"
        match="key"
      />

      <!-- Building name/number -->
      <text key="addr:housename"
        text="Building Name"
        match="key"
      />
      <text key="addr:housenumber"
        auto_increment="-2,-1,+1,+2"
        text="Building Number"
        match="key"
      />
    </optional>

    <optional text="Thoroughfare. Street-based if possible, non-street-based if needed.">

      <text key="addr:substreet"
        use_last_as_default="true"
        text="Non-Street grouping"
        match="key"
      />
      <text key="addr:street"
        use_last_as_default="true"
        text="Street (closest)"
        match="key"
      />
      <text key="addr:parentstreet"
        use_last_as_default="true"
        text="Street (parent, if needed)"
        match="key"
      />
    </optional>

      <optional text="Locality. Subareas include hamlets/villages/towns/suburbs. One intermediate max.">
        <text key="addr:suburb"
          use_last_as_default="true"
          text="Optional: Subarea (of Post Town)"
          match="key"
        />
        <text key="addr:hamlet"
          use_last_as_default="true"
          text="Rare: Intermediate (if hamlet)"
          match="key"/>
        <text key="addr:village"
          use_last_as_default="true"
          text="Rare: Intermediate (if village)"
          match="key"
        />
        <text key="addr:town"
          use_last_as_default="true"
          text="Rare: Intermediate (if town)"
          match="key"
        />
        <text key="addr:city"
          use_last_as_default="true"
          text="Required: Post Town (or city)"
          match="key"
        />
        <space />
        <text key="addr:postcode"
          use_last_as_default="true"
          text="Postcode"
          match="key"
        />
      </optional>
    </item>


    <!-- Addresses with tags that are deprecated in the UK -->

    <item
      name="UK Address: Deprecated Tags"
      preset_name_label="true"
      icon="stamp2-16.svg"
      icon_size="48"
      type="node,way,closedway,multipolygon">

      <link href="https://wiki.openstreetmap.org/wiki/Addresses_in_the_United_Kingdom#Tags_to_avoid"/>

      <optional text="Avoid: too vague, or they duplicate approved tags">
        <text key="addr:terrace"
          text="Terrace [1]"
          match="key"
        />
        <text
          key="addr:place"
          text="Place [1, 2]"
          match="key"
        />
        <text
          key="addr:locality"
          text="Locality [2]"
          match="key"
        />
        <text
          key="addr:site"
          text="Site [1]"
          match="key"
        />
      </optional>

      <optional text="Avoid: the UK doesn't have these administrative area types">
        <text key="addr:subdistrict"
          text="Sub-district [2]"
          match="key"
        />
        <text key="addr:province"
          text="Province"
          match="key"
        />
        <text key="addr:state"
          text="State"
          match="key"
        />
      </optional>

      <optional text="Not needed: OSM admin boundaries are sufficient">
        <text key="addr:district"
          text="Local Authority"
          match="key"
        />
        <text key="addr:county"
          text="County"
          match="key"
        />
        <text key="addr:country"
          text="Country"
          match="key"
        />
      </optional>

      <!--
        Make it easier to replace deprecated tags with accepted ones
        by putting the most common accpeted alternatives here.
      -->

      <optional text="Hint: consider replacing [1]s and [2]s above with…">

        <text key="addr:substreet"
          use_last_as_default="true"
          text="[1] Non-Street grouping"
          match="none"
        />

        <text key="addr:suburb"
          use_last_as_default="true"
          text="[2] Subarea of Post Town"
          match="none"
        />

        <space />

        <preset_link
          preset_name="UK Address"
          text="Or use one of the accepted tags from the full list:"
        />
      </optional>

    </item>

  </group>
</presets>
}}}