draft-ietf-geopriv-revised-civic-lo-01.txt   draft-ietf-geopriv-revised-civic-lo-02.txt 
GEOPRIV WG M. Thomson GEOPRIV WG M. Thomson
Internet-Draft J. Winterbottom Internet-Draft J. Winterbottom
Expires: July 7, 2006 Andrew Expires: October 30, 2006 Andrew
January 3, 2006 April 28, 2006
Revised Civic Location Format for PIDF-LO Revised Civic Location Format for PIDF-LO
draft-ietf-geopriv-revised-civic-lo-01.txt draft-ietf-geopriv-revised-civic-lo-02.txt
Status of this Memo Status of this Memo
By submitting this Internet-Draft, each author represents that any By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79. aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
skipping to change at page 1, line 34 skipping to change at page 1, line 34
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt. http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/shadow.html.
This Internet-Draft will expire on July 7, 2006. This Internet-Draft will expire on October 30, 2006.
Copyright Notice Copyright Notice
Copyright (C) The Internet Society (2006). Copyright (C) The Internet Society (2006).
Abstract Abstract
This document defines an XML format for the representation of civic This document defines an XML format for the representation of civic
location. This format is designed for use with PIDF Location Object location. This format is designed for use with PIDF Location Object
(PIDF-LO) documents. The format is based on the civic address (PIDF-LO) documents. The format is based on the civic address
skipping to change at page 2, line 15 skipping to change at page 2, line 15
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 4
3. Changes from PIDF-LO . . . . . . . . . . . . . . . . . . . . . 5 3. Changes from PIDF-LO . . . . . . . . . . . . . . . . . . . . . 5
3.1. Additional Civic Address Types . . . . . . . . . . . . . . 5 3.1. Additional Civic Address Types . . . . . . . . . . . . . . 5
3.2. New Thoroughfare Elements . . . . . . . . . . . . . . . . 7 3.2. New Thoroughfare Elements . . . . . . . . . . . . . . . . 7
3.2.1. Street Numbering . . . . . . . . . . . . . . . . . . . 8 3.2.1. Street Numbering . . . . . . . . . . . . . . . . . . . 8
3.2.2. Directionals and other Qualifiers . . . . . . . . . . 8 3.2.2. Directionals and other Qualifiers . . . . . . . . . . 8
3.3. Country Element . . . . . . . . . . . . . . . . . . . . . 9 3.3. Country Element . . . . . . . . . . . . . . . . . . . . . 9
3.4. Languages and Scripts . . . . . . . . . . . . . . . . . . 9 3.4. A1 Element . . . . . . . . . . . . . . . . . . . . . . . . 9
3.5. Whitespace . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5. Languages and Scripts . . . . . . . . . . . . . . . . . . 9
4. Civic Address Schema . . . . . . . . . . . . . . . . . . . . . 10 3.6. Whitespace . . . . . . . . . . . . . . . . . . . . . . . . 10
5. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 4. Civic Address Schema . . . . . . . . . . . . . . . . . . . . . 11
6. Security Considerations . . . . . . . . . . . . . . . . . . . 13 5. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14 6. Security Considerations . . . . . . . . . . . . . . . . . . . 14
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 15
7.1. URN sub-namespace registration for 7.1. URN sub-namespace registration for
'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr' . . . . 14 'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr' . . . . 15
7.2. XML Schema Registration . . . . . . . . . . . . . . . . . 14 7.2. XML Schema Registration . . . . . . . . . . . . . . . . . 15
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 15 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 16
8.1. Normative References . . . . . . . . . . . . . . . . . . . 15 8.1. Normative References . . . . . . . . . . . . . . . . . . . 16
8.2. Informative References . . . . . . . . . . . . . . . . . . 15 8.2. Informative References . . . . . . . . . . . . . . . . . . 16
Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 16 Appendix A. Acknowledgements . . . . . . . . . . . . . . . . . . 18
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 17 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 19
Intellectual Property and Copyright Statements . . . . . . . . . . 18 Intellectual Property and Copyright Statements . . . . . . . . . . 20
1. Introduction 1. Introduction
Since the publication of the original PIDF-LO civic specification, in Since the publication of the original PIDF-LO civic specification, in
[I-D.ietf-geopriv-pidf-lo], it has been found that the specification [I-D.ietf-geopriv-pidf-lo], it has been found that the specification
is lacking a number of additional parameters that can be used to more is lacking a number of additional parameters that can be used to more
precisely specify a civic location. These additional parameters have precisely specify a civic location. These additional parameters have
been largely captured in [I-D.ietf-geopriv-dhcp-civil]. been largely captured in [I-D.ietf-geopriv-dhcp-civil].
This document revises the GEOPRIV civic form to include the This document revises the GEOPRIV civic form to include the
skipping to change at page 9, line 9 skipping to change at page 9, line 9
The "PRM", "POM", "PRD", "POD" and "STS" elements always apply to the The "PRM", "POM", "PRD", "POD" and "STS" elements always apply to the
value of the "RD" element only. If road branches or sub-branches value of the "RD" element only. If road branches or sub-branches
require street suffixes or qualifiers, they MUST be included in the require street suffixes or qualifiers, they MUST be included in the
"RDBR" or "RDSUBBR" element text. "RDBR" or "RDSUBBR" element text.
3.3. Country Element 3.3. Country Element
The "country" element differs from that defined in [I-D.ietf-geopriv- The "country" element differs from that defined in [I-D.ietf-geopriv-
pidf-lo] in that it now restricts the value space of the element to pidf-lo] in that it now restricts the value space of the element to
two upper case characters, which more closely matches the definition two upper case characters, which correspond to the alpha-2 codes in
in [ISO.3166.1988]. [ISO.3166-1].
3.4. Languages and Scripts 3.4. A1 Element
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
[ISO.3166-2] for a country subdivision SHOULD be used. The ISO
3166-2 code is a 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; 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>
3.5. Languages and Scripts
The XML schema defined for civic addresses allows for the addition of The XML schema defined for civic addresses allows for the addition of
the "xml:lang" attribute to all elements except "country" and "PLC", the "xml:lang" attribute to all elements except "country" and "PLC",
which both contain enumerated values. which both contain enumerated values.
The "script" field defined in [I-D.ietf-geopriv-dhcp-civil] is The "script" field defined in [I-D.ietf-geopriv-dhcp-civil] is
omitted in favour of using the "xml:lang" attribute. omitted in favour of using the "xml:lang" attribute.
It is RECOMMENDED that each "civicAddress" element use one language It is RECOMMENDED that each "civicAddress" element use one language
only, or a combination of languages that is consistent. Where a only, or a combination of languages that is consistent. Where a
civic location is represented in multiple languages multiple civic location is represented in multiple languages multiple
"civicAddress" elements SHOULD be included in the PIDF-LO document. "civicAddress" elements SHOULD be included in the PIDF-LO document.
3.5. Whitespace 3.6. Whitespace
The XML schema [W3C.REC-xmlschema-2-20041028] defined in Section 4 The XML schema [W3C.REC-xmlschema-2-20041028] defined in Section 4
uses a base type of "token" instead of "string" as used in [I-D.ietf- uses a base type of "token" instead of "string" as used in [I-D.ietf-
geopriv-pidf-lo]. geopriv-pidf-lo].
The "token" type ensures that whitespace within instance documents is The "token" type ensures that whitespace within instance documents is
normalized and collapsed before being passed to a processor. This normalized and collapsed before being passed to a processor. This
ensures that the following fragments are considered equivalent by XML ensures that the following fragments are considered equivalent by XML
processors: processors:
<A1>New South Wales</A1> <A4>North Wollongong</A4>
<A1>New <A1>North
South Wales</A1> Wollongong</A1>
<A1> <A1>
New South North Wollongong
Wales </A1> </A1>
Whitespace may still be included in values by using character Whitespace may still be included in values by using character
references, such as "&#x20;". references, such as "&#x20;".
4. Civic Address Schema 4. Civic Address Schema
<?xml version="1.0"?> <?xml version="1.0"?>
<xs:schema <xs:schema
targetNamespace="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr" targetNamespace="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr"
xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:ca="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr" xmlns:ca="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr"
xmlns:xml="http://www.w3.org/XML/1998/namespace" xmlns:xml="http://www.w3.org/XML/1998/namespace"
elementFormDefault="qualified" attributeFormDefault="unqualified"> elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:import namespace="http://www.w3.org/XML/1998/namespace" <xs:import namespace="http://www.w3.org/XML/1998/namespace"
schemaLocation="http://www.w3.org/2001/xml.xsd"/> schemaLocation="http://www.w3.org/2001/xml.xsd"/>
<xs:simpleType name="iso3166"> <xs:simpleType name="iso3166a2">
<xs:restriction base="xs:token"> <xs:restriction base="xs:token">
<xs:pattern value="[A-Z]{2}"/> <xs:pattern value="[A-Z]{2}"/>
</xs:restriction> </xs:restriction>
</xs:simpleType> </xs:simpleType>
<xs:complexType name="caType"> <xs:complexType name="caType">
<xs:simpleContent> <xs:simpleContent>
<xs:extension base="xs:token"> <xs:extension base="xs:token">
<xs:attribute ref="xml:lang" use="optional"/> <xs:attribute ref="xml:lang" use="optional"/>
</xs:extension> </xs:extension>
</xs:simpleContent> </xs:simpleContent>
</xs:complexType> </xs:complexType>
<xs:element name="civicAddress" type="ca:civicAddress"/> <xs:element name="civicAddress" type="ca:civicAddress"/>
<xs:complexType name="civicAddress"> <xs:complexType name="civicAddress">
<xs:sequence> <xs:sequence>
<xs:element name="country" type="ca:iso3166" minOccurs="0"/> <xs:element name="country" type="ca:iso3166a2" minOccurs="0"/>
<xs:element name="A1" type="ca:caType" minOccurs="0"/> <xs:element name="A1" type="ca:caType" minOccurs="0"/>
<xs:element name="A2" 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="A3" type="ca:caType" minOccurs="0"/>
<xs:element name="A4" 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="A5" type="ca:caType" minOccurs="0"/>
<xs:element name="A6" 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="PRM" type="ca:caType" minOccurs="0"/>
<xs:element name="PRD" 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="RD" type="ca:caType" minOccurs="0"/>
<xs:element name="STS" type="ca:caType" minOccurs="0"/> <xs:element name="STS" type="ca:caType" minOccurs="0"/>
skipping to change at page 12, line 11 skipping to change at page 13, line 11
<xs:attribute ref="xml:lang" use="optional"/> <xs:attribute ref="xml:lang" use="optional"/>
</xs:complexType> </xs:complexType>
</xs:schema> </xs:schema>
5. Example 5. Example
<?xml version="1.0"?> <?xml version="1.0"?>
<civicAddress xml:lang="en-AU" <civicAddress xml:lang="en-AU"
xmlns="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr"> xmlns="urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr">
<country>AU</country> <country>AU</country>
<A1> New South Wales </A1> <A1>NSW</A1>
<A3> Wollongong <A3> Wollongong
</A3><A4>North Wollongong </A3><A4>North Wollongong
</A4> </A4>
<RD>Flinders</RD><STS>Street</STS> <RD>Flinders</RD><STS>Street</STS>
<RDBR>Campbell Street</RDBR> <RDBR>Campbell Street</RDBR>
<LMK> <LMK>
Gilligan's Island Gilligan's Island
</LMK> <LOC>Corner</LOC> </LMK> <LOC>Corner</LOC>
<NAM> Video Rental Store </NAM> <NAM> Video Rental Store </NAM>
<PC>2500</PC> <PC>2500</PC>
skipping to change at page 15, line 21 skipping to change at page 16, line 21
[W3C.REC-xmlschema-2-20041028] [W3C.REC-xmlschema-2-20041028]
Malhotra, A. and P. Biron, "XML Schema Part 2: Datatypes Malhotra, A. and P. Biron, "XML Schema Part 2: Datatypes
Second Edition", W3C REC REC-xmlschema-2-20041028, Second Edition", W3C REC REC-xmlschema-2-20041028,
October 2004. October 2004.
[I-D.ietf-geopriv-dhcp-civil] [I-D.ietf-geopriv-dhcp-civil]
Schulzrinne, H., "Dynamic Host Configuration Protocol Schulzrinne, H., "Dynamic Host Configuration Protocol
(DHCPv4 and DHCPv6) Option for Civic Addresses (DHCPv4 and DHCPv6) Option for Civic Addresses
Configuration Information", Configuration Information",
draft-ietf-geopriv-dhcp-civil-08 (work in progress), draft-ietf-geopriv-dhcp-civil-09 (work in progress),
December 2005. January 2006.
[I-D.ietf-geopriv-location-types-registry] [I-D.ietf-geopriv-location-types-registry]
Schulzrinne, H. and H. Tschofenig, "Location Types Schulzrinne, H. and H. Tschofenig, "Location Types
Registry", draft-ietf-geopriv-location-types-registry-03 Registry", draft-ietf-geopriv-location-types-registry-05
(work in progress), August 2005. (work in progress), March 2006.
[ISO.3166.1988] [ISO.3166-1]
International Organization for Standardization, "Codes for International Organization for Standardization, "Codes for
the representation of names of countries, 3rd edition", the representation of names of countries and their
ISO Standard 3166, August 1988. subdivisions - Part 1: Country codes", ISO Standard 3166-
1:1997, 1997,
<http://www.iso.org/iso/en/prods-services/iso3166ma/>.
[ISO.3166-2]
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,
<http://www.iso.org/iso/en/prods-services/iso3166ma/>.
8.2. Informative References 8.2. Informative References
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
January 2004. January 2004.
[I-D.ietf-geopriv-pidf-lo] [I-D.ietf-geopriv-pidf-lo]
Peterson, J., "A Presence-based GEOPRIV Location Object Peterson, J., "A Presence-based GEOPRIV Location Object
Format", draft-ietf-geopriv-pidf-lo-03 (work in progress), Format", draft-ietf-geopriv-pidf-lo-03 (work in progress),
September 2004. September 2004.
[UPU-S42] Universal Postal Union (UPU), "International Postal [UPU-S42] Universal Postal Union (UPU), "International Postal
Address Components and Templates", UPS SB42-4, July 2004. Address Components and Templates", UPS SB42-4, July 2004.
Appendix A. Acknowledgements Appendix A. Acknowledgements
The authors would like to thank Henning Schulzrinne for his The authors would like to thank Henning Schulzrinne for his
assistance in defining the additional civic address types, assistance in defining the additional civic address types,
particularly his research into different addressing schemes that lead particularly his research into different addressing schemes that lead
to the introduction of the thoroughfare elements. In addition we to the introduction of the thoroughfare elements. Rohan Mahy
would like to thank Jon Peterson for his work in defining the suggested the ISO 3166-2 recommendation for A1. In addition we would
PIDF-LO. like to thank Jon Peterson for his work in defining the PIDF-LO.
Authors' Addresses Authors' Addresses
Martin Thomson Martin Thomson
Andrew Andrew
PO Box U40 PO Box U40
Wollongong University Campus, NSW 2500 Wollongong University Campus, NSW 2500
AU AU
Phone: +61 2 4221 2915 Phone: +61 2 4221 2915
 End of changes. 19 change blocks. 
40 lines changed or deleted 76 lines changed or added

This html diff was produced by rfcdiff 1.29, available from http://www.levkowetz.com/ietf/tools/rfcdiff/