5139
PROPOSED STANDARD

Revised Civic Location Format for Presence Information Data Format Location Object (PIDF-LO)

Authors: M. Thomson, J. Winterbottom
Date: February 2008
Area: rai
Working Group: geopriv
Stream: IETF
Updates: RFC 4119

Abstract

This document defines an XML format for the representation of civic location. This format is designed for use with Presence Information Data Format Location Object (PIDF-LO) documents and replaces the civic location format in RFC 4119. The format is based on the civic address definition in PIDF-LO, but adds several new elements based on the civic types defined for Dynamic Host Configuration Protocol (DHCP), and adds a hierarchy to address complex road identity schemes. The format also includes support for the xml:lang language tag and restricts the types of elements where appropriate. [STANDARDS-TRACK]

RFC 5139: Revised Civic Location Format for Presence Information Data Format Location Object (PIDF-LO) [RFC Home] [TEXT|PDF|HTML] [Tracker] [IPR] [Info page]

PROPOSED STANDARD
Network Working Group                                         M. Thomson
Request for Comments: 5139                               J. Winterbottom
Updates: <a href="./rfc4119">4119</a>                                                     Andrew
Category: Standards Track                                  February 2008


                   <span class="h1">Revised Civic Location Format for</span>
       <span class="h1">Presence Information Data Format Location Object (PIDF-LO)</span>

Status of This Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Abstract

   This document defines an XML format for the representation of civic
   location.  This format is designed for use with Presence Information
   Data Format Location Object (PIDF-LO) documents and replaces the
   civic location format in <a href="./rfc4119">RFC 4119</a>.  The format is based on the civic
   address definition in PIDF-LO, but adds several new elements based on
   the civic types defined for Dynamic Host Configuration Protocol
   (DHCP), and adds a hierarchy to address complex road identity
   schemes.  The format also includes support for the xml:lang language
   tag and restricts the types of elements where appropriate.























<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 1]</span>

<span id="page-2" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


Table of Contents

   <a href="#section-1">1</a>.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  <a href="#page-3">3</a>
   <a href="#section-2">2</a>.  Terminology  . . . . . . . . . . . . . . . . . . . . . . . . .  <a href="#page-3">3</a>
   <a href="#section-3">3</a>.  Changes from PIDF-LO . . . . . . . . . . . . . . . . . . . . .  <a href="#page-3">3</a>
     <a href="#section-3.1">3.1</a>.  Additional Civic Address Types . . . . . . . . . . . . . .  <a href="#page-3">3</a>
     <a href="#section-3.2">3.2</a>.  New Thoroughfare Elements  . . . . . . . . . . . . . . . .  <a href="#page-4">4</a>
       <a href="#section-3.2.1">3.2.1</a>.  Street Numbering . . . . . . . . . . . . . . . . . . .  <a href="#page-5">5</a>
       <a href="#section-3.2.2">3.2.2</a>.  Directionals and Other Qualifiers  . . . . . . . . . .  <a href="#page-5">5</a>
     <a href="#section-3.3">3.3</a>.  Country Element  . . . . . . . . . . . . . . . . . . . . .  <a href="#page-6">6</a>
     <a href="#section-3.4">3.4</a>.  A1 Element . . . . . . . . . . . . . . . . . . . . . . . .  <a href="#page-6">6</a>
     <a href="#section-3.5">3.5</a>.  Languages and Scripts  . . . . . . . . . . . . . . . . . .  <a href="#page-6">6</a>
       <a href="#section-3.5.1">3.5.1</a>.  Converting from the DHCP Format  . . . . . . . . . . .  <a href="#page-7">7</a>
       3.5.2.  Combining Multiple Elements Based on Language
               Preferences  . . . . . . . . . . . . . . . . . . . . .  <a href="#page-7">7</a>
     <a href="#section-3.6">3.6</a>.  Whitespace . . . . . . . . . . . . . . . . . . . . . . . .  <a href="#page-7">7</a>
   <a href="#section-4">4</a>.  Civic Address Schema . . . . . . . . . . . . . . . . . . . . .  <a href="#page-8">8</a>
   <a href="#section-5">5</a>.  Example  . . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a>
   <a href="#section-6">6</a>.  Security Considerations  . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a>
   <a href="#section-7">7</a>.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . <a href="#page-10">10</a>
     7.1.  URN sub-namespace registration for
           'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr'  . . . . <a href="#page-10">10</a>
     <a href="#section-7.2">7.2</a>.  XML Schema Registration  . . . . . . . . . . . . . . . . . <a href="#page-11">11</a>
     <a href="#section-7.3">7.3</a>.  CAtype Registry Update . . . . . . . . . . . . . . . . . . <a href="#page-11">11</a>
   <a href="#section-8">8</a>.  References . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-12">12</a>
     <a href="#section-8.1">8.1</a>.  Normative References . . . . . . . . . . . . . . . . . . . <a href="#page-12">12</a>
     <a href="#section-8.2">8.2</a>.  Informative References . . . . . . . . . . . . . . . . . . <a href="#page-12">12</a>
   <a href="#appendix-A">Appendix A</a>.  Acknowledgements  . . . . . . . . . . . . . . . . . . <a href="#page-13">13</a>























<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 2]</span>

<span id="page-3" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>.  Introduction</span>

   Since the publication of the original PIDF-LO civic specification, in
   [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>], it has been found that the specification is lacking a
   number of additional parameters that can be used to more precisely
   specify a civic location.  These additional parameters have been
   largely captured in [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>].

   This document revises the GEOPRIV civic form to include the
   additional civic parameters captured in [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>].  The document also
   introduces a hierarchical structure for thoroughfare (road)
   identification, which is employed in some countries.  New elements
   are defined to allow for even more precision in specifying a civic
   location.

<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>.  Terminology</span>

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].

   The term "thoroughfare" is used in this document to describe a road
   or part of a road or other access route along which a final point is
   identified.  This is consistent with the definition used in
   [<a href="#ref-UPU-S42" title=""International Postal Address Components and Templates"">UPU-S42</a>].

<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>.  Changes from PIDF-LO</span>

<span class="h3"><a class="selflink" id="section-3.1" href="#section-3.1">3.1</a>.  Additional Civic Address Types</span>

   [<a id="ref-RFC4776">RFC4776</a>] provides a full set of parameters that may be used to
   describe a civic location.  Specifically, [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>] lists several
   civic address types (CAtypes) that require support in the formal
   PIDF-LO definition that are not in [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>].

   These changes include new elements that are required to support more
   complex structures for naming street addresses.  This is described in
   more detail in <a href="#section-3.2">Section 3.2</a>.













<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 3]</span>

<span id="page-4" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


   +-----------+--------+-------------------------------+--------------+
   | New Field | CAtype | Description                   | Example      |
   +-----------+--------+-------------------------------+--------------+
   | BLD       |   25   | Building (structure)          | Hope Theatre |
   |           |        |                               |              |
   | UNIT      |   26   | Unit (apartment, suite)       | 12a          |
   |           |        |                               |              |
   | ROOM      |   28   | Room                          | 450F         |
   |           |        |                               |              |
   | PLC       |   29   | Place-type                    | office       |
   |           |        |                               |              |
   | PCN       |   30   | Postal community name         | Leonia       |
   |           |        |                               |              |
   | POBOX     |   31   | Post office box (P.O. box)    | U40          |
   |           |        |                               |              |
   | ADDCODE   |   32   | Additional Code               | 13203000003  |
   |           |        |                               |              |
   | SEAT      |   33   | Seat (desk, cubicle,          | WS 181       |
   |           |        | workstation)                  |              |
   |           |        |                               |              |
   | RD        |   34   | Primary road or street        | Broadway     |
   |           |        |                               |              |
   | RDSEC     |   35   | Road section                  | 14           |
   |           |        |                               |              |
   | RDBR      |   36   | Road branch                   | Lane 7       |
   |           |        |                               |              |
   | RDSUBBR   |   37   | Road sub-branch               | Alley 8      |
   |           |        |                               |              |
   | PRM       |   38   | Road pre-modifier             | Old          |
   |           |        |                               |              |
   | POM       |   39   | Road post-modifier            | Extended     |
   +-----------+--------+-------------------------------+--------------+

                     Table 1: New Civic PIDF-LO Types

   A complete description of these types is included in [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>].

<span class="h3"><a class="selflink" id="section-3.2" href="#section-3.2">3.2</a>.  New Thoroughfare Elements</span>

   In some countries, a thoroughfare can be broken up into sections, and
   it is not uncommon for street numbers to be repeated between
   sections.  A road section identifier is required to ensure that an
   address is unique.  For example, "West Alice Parade" in the figure
   below has 5 sections, each numbered from 1; unless the section is
   specified, "7 West Alice Parade" could exist in 5 different places.
   The "RDSEC" element is used to specify the section.





<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 4]</span>

<span id="page-5" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


   Minor streets can share the same name, so that they can only be
   distinguished by the major thoroughfare with which they intersect.
   For example, both "West Alice Parade, <a href="#section-3">Section 3</a>" and "Bob Street"
   could both be intersected by a "Carol Lane".  The "RDBR" element is
   used to specify a road branch where the name of the branch does not
   uniquely identify the road.  Road branches MAY also be used where a
   major thoroughfare is split into sections.

   Similar to the way that a road branch is associated with a road, a
   road sub-branch is associated with a road branch.  The "RDSUBBR"
   element is used to identify road sub-branches.

   The "A6" element is retained for use in those countries that require
   this level of detail.  Where "A6" was previously used for street
   names in [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>], it MUST NOT be used; the "RD" element MUST be
   used for thoroughfare data.

   The following figure shows a fictional arrangement of roads where
   these new thoroughfare elements are applicable.

         |                                                 ||
         |                                  ---------------||
         | Carol La.                           Carol La.   || Bob
         |                                                 || St.
         |              West Alice Pde.                    ||
    ==========/=================/===============/==========||===========
       Sec.1       Sec.2           Sec.3   |       Sec.4   ||   Sec.5
                                           |               ||
                                 ----------| Carol         ||
                                  Alley 2  |  La.          ||
                                           |               ||

<span class="h4"><a class="selflink" id="section-3.2.1" href="#section-3.2.1">3.2.1</a>.  Street Numbering</span>

   The introduction of new thoroughfare elements affects the
   interpretation of several aspects of more specific civic address
   data.  In particular, street numbering (the "HNO" element) applies to
   the most specific road element specified, that is, the first
   specified element from "RDSUBBR", "RDBR", "RDSEC", or "RD".

<span class="h4"><a class="selflink" id="section-3.2.2" href="#section-3.2.2">3.2.2</a>.  Directionals and Other Qualifiers</span>

   The "PRM", "POM", "PRD", "POD", and "STS" elements always apply to
   the value of the "RD" element only.  If road branches or sub-branches
   require street suffixes or qualifiers, they MUST be included in the
   "RDBR" or "RDSUBBR" element text.





<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 5]</span>

<span id="page-6" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


<span class="h3"><a class="selflink" id="section-3.3" href="#section-3.3">3.3</a>.  Country Element</span>

   The "country" element differs from that defined in [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>] in that
   it now restricts the value space of the element to two uppercase
   characters, which correspond to the alpha-2 codes in [<a href="#ref-ISO.3166-1" title=""Codes for the representation of names of countries and their subdivisions - Part 1: Country codes"">ISO.3166-1</a>].

<span class="h3"><a class="selflink" id="section-3.4" href="#section-3.4">3.4</a>.  A1 Element</span>

   The "A1" element is used for the top-level subdivision within a
   country.  In the absence of a country-specific guide on how to use
   the A-series of elements, the second part of the ISO 3166-2 code
   [<a href="#ref-ISO.3166-2" title=""Codes for the representation of names of countries and their subdivisions - Part 2: Country subdivision code"">ISO.3166-2</a>] for a country subdivision SHOULD be used.  The ISO
   3166-2 code is formed of a country code and hyphen plus a code of
   one, two, or three characters or numerals.  For the "A1" element, the
   leading country code and hyphen are omitted and only the subdivision
   code is included.

   For example, the codes for Canada include CA-BC, CA-ON, CA-QC;
   Luxembourg has just three single-character codes, LU-D, LU-G, and
   LU-L; Australia uses both two- and three-character codes, AU-ACT,
   AU-NSW, AU-NT; and France uses numerical codes for mainland France
   and letters for territories, FR-75, FR-NC.  This results in the
   following fragments:

      <country>CA</country><A1>ON</A1>

      <country>LU</country><A1>L</A1>

      <country>AU</country><A1>ACT</A1>

      <country>FR</country><A1>75</A1>

<span class="h3"><a class="selflink" id="section-3.5" href="#section-3.5">3.5</a>.  Languages and Scripts</span>

   The XML schema defined for civic addresses allows for the addition of
   the "xml:lang" attribute to all elements except "country" and "PLC",
   which both contain language-neutral values.  The range of allowed
   values for "country" is defined in [<a href="#ref-ISO.3166-1" title=""Codes for the representation of names of countries and their subdivisions - Part 1: Country codes"">ISO.3166-1</a>]; the range of allowed
   values for "PLC" is described in the IANA registry defined by
   [<a href="./rfc4589" title=""Location Types Registry"">RFC4589</a>].

   The "script" field defined in [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>] is omitted in favor of using
   the "xml:lang" attribute with a script subtag [<a href="./rfc4646" title=""Tags for Identifying Languages"">RFC4646</a>].

   It is RECOMMENDED that each "civicAddress" element use one language
   only, or a combination of languages that is consistent.  Where a
   civic location is represented in multiple languages, multiple
   "civicAddress" elements SHOULD be included in the PIDF-LO document.



<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 6]</span>

<span id="page-7" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


   For civic addresses that form a complex to describe the same
   location, these SHOULD be inserted into the same tuple.

<span class="h4"><a class="selflink" id="section-3.5.1" href="#section-3.5.1">3.5.1</a>.  Converting from the DHCP Format</span>

   The DHCP format for civic addresses [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>] permits the inclusion
   of an element multiple times with different languages or scripts.
   However, this XML form only permits a single instance of each
   element.  Multiple "civicAddress" elements are required if any
   element is duplicated with different languages.  If the same language
   and script are used for all elements, or no elements are duplicated,
   the format can be converted into a single civic address.

   Where there are duplicated elements in different languages, a
   "civicAddress" element is created for each language that is present.
   All elements that are in that language are included.  Elements that
   are language independent, like the "country" and "PLC" elements, are
   added to all "civicAddress" elements.

<span class="h4"><a class="selflink" id="section-3.5.2" href="#section-3.5.2">3.5.2</a>.  Combining Multiple Elements Based on Language Preferences</span>

   If the receiver of the XML representation is known, and that receiver
   has indicated language preferences, a single XML format can be
   constructed using those preferences.  For example, language
   preferences can be indicated by the "Accept-Language" header in the
   SIP or HTTP protocols.

   All elements that have only one value, irrespective of language, are
   used.  Where multiple values exist, each value is assigned a
   weighting based on the language preferences.  The value with the
   highest weighting is selected.  An arbitrary value is selected if two
   values have the same preference, if there is no preference for the
   available languages, or if there are conflicting values with the same
   language.

<span class="h3"><a class="selflink" id="section-3.6" href="#section-3.6">3.6</a>.  Whitespace</span>

   The XML schema [<a href="#ref-W3C.REC-xmlschema-2-20041028">W3C.REC-xmlschema-2-20041028</a>] defined in <a href="#section-4">Section 4</a>
   uses a base type of "token" instead of "string" as used in [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>].












<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 7]</span>

<span id="page-8" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


   The "token" type ensures that whitespace within instance documents is
   normalized and collapsed before being passed to a processor.  This
   ensures that the following fragments are considered equivalent by XML
   processors:

   <A4>North Wollongong</A4>

   <A1>North
     Wollongong</A1>

   <A1>
     North   Wollongong
     </A1>

   Whitespace may still be included in values by using character
   references, such as "&#x20;".

<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>.  Civic Address Schema</span>

   <?xml version="1.0"?>
   <xs:schema
     targetNamespace="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
     xmlns:ca="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr"
     xmlns:xml="http://www.w3.org/XML/1998/namespace"
     elementFormDefault="qualified" attributeFormDefault="unqualified">

     <xs:import namespace="http://www.w3.org/XML/1998/namespace"
                schemaLocation="http://www.w3.org/2001/xml.xsd"/>

     <xs:simpleType name="iso3166a2">
       <xs:restriction base="xs:token">
         <xs:pattern value="[A-Z]{2}"/>
       </xs:restriction>
     </xs:simpleType>

     <xs:complexType name="caType">
       <xs:simpleContent>
         <xs:extension base="xs:token">
           <xs:attribute ref="xml:lang" use="optional"/>
         </xs:extension>
       </xs:simpleContent>
     </xs:complexType>








<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 8]</span>

<span id="page-9" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


     <xs:element name="civicAddress" type="ca:civicAddress"/>
     <xs:complexType name="civicAddress">
       <xs:sequence>
         <xs:element name="country" type="ca:iso3166a2" minOccurs="0"/>
         <xs:element name="A1" type="ca:caType" minOccurs="0"/>
         <xs:element name="A2" type="ca:caType" minOccurs="0"/>
         <xs:element name="A3" type="ca:caType" minOccurs="0"/>
         <xs:element name="A4" type="ca:caType" minOccurs="0"/>
         <xs:element name="A5" type="ca:caType" minOccurs="0"/>
         <xs:element name="A6" type="ca:caType" minOccurs="0"/>
         <xs:element name="PRM" type="ca:caType" minOccurs="0"/>
         <xs:element name="PRD" type="ca:caType" minOccurs="0"/>
         <xs:element name="RD" type="ca:caType" minOccurs="0"/>
         <xs:element name="STS" type="ca:caType" minOccurs="0"/>
         <xs:element name="POD" type="ca:caType" minOccurs="0"/>
         <xs:element name="POM" type="ca:caType" minOccurs="0"/>
         <xs:element name="RDSEC" type="ca:caType" minOccurs="0"/>
         <xs:element name="RDBR" type="ca:caType" minOccurs="0"/>
         <xs:element name="RDSUBBR" type="ca:caType" minOccurs="0"/>
         <xs:element name="HNO" type="ca:caType" minOccurs="0"/>
         <xs:element name="HNS" type="ca:caType" minOccurs="0"/>
         <xs:element name="LMK" type="ca:caType" minOccurs="0"/>
         <xs:element name="LOC" type="ca:caType" minOccurs="0"/>
         <xs:element name="FLR" type="ca:caType" minOccurs="0"/>
         <xs:element name="NAM" type="ca:caType" minOccurs="0"/>
         <xs:element name="PC" type="ca:caType" minOccurs="0"/>
         <xs:element name="BLD" type="ca:caType" minOccurs="0"/>
         <xs:element name="UNIT" type="ca:caType" minOccurs="0"/>
         <xs:element name="ROOM" type="ca:caType" minOccurs="0"/>
         <xs:element name="SEAT" type="ca:caType" minOccurs="0"/>
         <xs:element name="PLC" type="xs:token" minOccurs="0"/>
         <xs:element name="PCN" type="ca:caType" minOccurs="0"/>
         <xs:element name="POBOX" type="ca:caType" minOccurs="0"/>
         <xs:element name="ADDCODE" type="ca:caType" minOccurs="0"/>
         <xs:any namespace="##other" processContents="lax"
                 minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>
   </xs:schema>











<span class="grey">Thomson & Winterbottom      Standards Track                     [Page 9]</span>

<span id="page-10" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>.  Example</span>

   <civicAddress xml:lang="en-AU"
     xmlns="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr">
     <country>AU</country>
     <A1>NSW</A1>
     <A3>     Wollongong
     </A3><A4>North Wollongong
     </A4>
     <RD>Flinders</RD><STS>Street</STS>
     <RDBR>Campbell Street</RDBR>
     <LMK>
       Gilligan's Island
     </LMK> <LOC>Corner</LOC>
     <NAM> Video Rental Store </NAM>
     <PC>2500</PC>
     <ROOM> Westerns and Classics </ROOM>
     <PLC>store</PLC>
     <POBOX>Private Box 15</POBOX>
   </civicAddress>

<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>.  Security Considerations</span>

   The XML representation described in this document is designed for
   inclusion in a PIDF-LO document.  As such, it is subject to the same
   security considerations as are described in [<a href="./rfc4119" title=""A Presence-based GEOPRIV Location Object Format"">RFC4119</a>].
   Considerations relating to the inclusion of this representation in
   other XML documents are outside the scope of this document.

<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>.  IANA Considerations</span>

<span class="h3"><a class="selflink" id="section-7.1" href="#section-7.1">7.1</a>.  URN sub-namespace registration for</span>
      'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr'

   This document defines a new XML namespace (as per the guidelines in
   [<a href="./rfc3688" title=""The IETF XML Registry"">RFC3688</a>]) that has been registered with IANA.

   URI:  urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr

   Registrant Contact:  IETF, GEOPRIV working group ([email protected]),
      Martin Thomson ([email protected]).










<span class="grey">Thomson & Winterbottom      Standards Track                    [Page 10]</span>

<span id="page-11" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


   XML:

       BEGIN
         <?xml version="1.0"?>
         <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
           "<a href="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</a>">
         <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
           <head>
             <title>GEOPRIV Civic Address</title>
           </head>
           <body>
             <h1>Format for Distributing Civic Address in GEOPRIV</h1>
             <h2>urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr</h2>
             <p>See <a href="http://www.rfc-editor.org/rfc/rfc5139.txt">
                 <a href="./rfc5139">RFC5139</a></a>.</p>
           </body>
         </html>
       END

<span class="h3"><a class="selflink" id="section-7.2" href="#section-7.2">7.2</a>.  XML Schema Registration</span>

   This section registers an XML schema as per the procedures in
   [<a href="./rfc3688" title=""The IETF XML Registry"">RFC3688</a>].

   URI:  urn:ietf:params:xml:schema:pidf:geopriv10:civicAddr

   Registrant Contact:  IETF, GEOPRIV working group ([email protected]),
      Martin Thomson ([email protected]).

      The XML for this schema can be found as the entirety of <a href="#section-4">Section 4</a>
      of this document.

<span class="h3"><a class="selflink" id="section-7.3" href="#section-7.3">7.3</a>.  CAtype Registry Update</span>

   This document updates the civic address type registry established by
   [<a href="./rfc4776" title=""Dynamic Host Configuration Protocol (DHCPv4 and DHCPv6) Option for Civic Addresses Configuration Information"">RFC4776</a>].  The "PIDF" column of the CAtypes table has been updated
   to include the types shown in the first column of Table 1.














<span class="grey">Thomson & Winterbottom      Standards Track                    [Page 11]</span>

<span id="page-12" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>.  References</span>

<span class="h3"><a class="selflink" id="section-8.1" href="#section-8.1">8.1</a>.  Normative References</span>

   [<a id="ref-RFC2119">RFC2119</a>]    Bradner, S., "Key words for use in RFCs to Indicate
                Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.

   [<a id="ref-W3C.REC-xmlschema-2-20041028">W3C.REC-xmlschema-2-20041028</a>]
                Biron, P. and A. Malhotra, "XML Schema Part 2: Datatypes
                Second Edition", World Wide Web Consortium
                Recommendation REC-xmlschema-2-20041028, October 2004,
                <<a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028">http://www.w3.org/TR/2004/REC-xmlschema-2-20041028</a>>.

   [<a id="ref-RFC4119">RFC4119</a>]    Peterson, J., "A Presence-based GEOPRIV Location Object
                Format", <a href="./rfc4119">RFC 4119</a>, December 2005.

   [<a id="ref-RFC4589">RFC4589</a>]    Schulzrinne, H. and H. Tschofenig, "Location Types
                Registry", <a href="./rfc4589">RFC 4589</a>, July 2006.

   [<a id="ref-RFC4646">RFC4646</a>]    Phillips, A. and M. Davis, "Tags for Identifying
                Languages", <a href="https://www.rfc-editor.org/bcp/bcp47">BCP 47</a>, <a href="./rfc4646">RFC 4646</a>, September 2006.

   [<a id="ref-RFC4776">RFC4776</a>]    Schulzrinne, H., "Dynamic Host Configuration Protocol
                (DHCPv4 and DHCPv6) Option for Civic Addresses
                Configuration Information", <a href="./rfc4776">RFC 4776</a>, November 2006.

   [<a id="ref-ISO.3166-1">ISO.3166-1</a>] International Organization for Standardization, "Codes
                for the representation of names of countries and their
                subdivisions - Part 1: Country codes", ISO Standard
                3166- 1:1997, 1997.

   [<a id="ref-ISO.3166-2">ISO.3166-2</a>] International Organization for Standardization, "Codes
                for the representation of names of countries and their
                subdivisions - Part 2: Country subdivision code",
                ISO Standard 3166-2:1998, 1998.

<span class="h3"><a class="selflink" id="section-8.2" href="#section-8.2">8.2</a>.  Informative References</span>

   [<a id="ref-RFC3688">RFC3688</a>]    Mealling, M., "The IETF XML Registry", <a href="https://www.rfc-editor.org/bcp/bcp81">BCP 81</a>, <a href="./rfc3688">RFC 3688</a>,
                January 2004.

   [<a id="ref-UPU-S42">UPU-S42</a>]    Universal Postal Union (UPU), "International Postal
                Address Components and Templates", UPS SB42-4,
                July 2004.







<span class="grey">Thomson & Winterbottom      Standards Track                    [Page 12]</span>

<span id="page-13" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


<span class="h2"><a class="selflink" id="appendix-A" href="#appendix-A">Appendix A</a>.  Acknowledgements</span>

   The authors would like to thank Henning Schulzrinne for his
   assistance in defining the additional civic address types,
   particularly his research into different addressing schemes that led
   to the introduction of the thoroughfare elements.  Rohan Mahy
   suggested the ISO 3166-2 recommendation for A1.  In addition, we
   would like to thank Jon Peterson for his work in defining the
   PIDF-LO.

Authors' Addresses

   Martin Thomson
   Andrew
   PO Box U40
   Wollongong University Campus, NSW  2500
   AU

   Phone: +61 2 4221 2915
   EMail: [email protected]
   URI:   <a href="http://www.andrew.com/">http://www.andrew.com/</a>


   James Winterbottom
   Andrew
   PO Box U40
   Wollongong University Campus, NSW  2500
   AU

   Phone: +61 2 4221 2938
   EMail: [email protected]
   URI:   <a href="http://www.andrew.com/">http://www.andrew.com/</a>



















<span class="grey">Thomson & Winterbottom      Standards Track                    [Page 13]</span>

<span id="page-14" ></span>
<span class="grey"><a href="./rfc5139">RFC 5139</a>                    Revised Civic LO               February 2008</span>


Full Copyright Statement

   Copyright (C) The IETF Trust (2008).

   This document is subject to the rights, licenses and restrictions
   contained in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a>, and except as set forth therein, the authors
   retain all their rights.

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
   THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
   OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
   THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; nor does it represent that it has
   made any independent effort to identify any such rights.  Information
   on the procedures with respect to rights in RFC documents can be
   found in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and <a href="https://www.rfc-editor.org/bcp/bcp79">BCP 79</a>.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use of
   such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository at
   <a href="http://www.ietf.org/ipr">http://www.ietf.org/ipr</a>.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights that may cover technology that may be required to implement
   this standard.  Please address the information to the IETF at
   [email protected].












Thomson & Winterbottom      Standards Track                    [Page 14]

Additional Resources