Network Working Group J. Polk Request for Comments: 3825 J. Schnizlein Category: Standards Track M. Linsner Cisco Systems July 2004 Dynamic Host Configuration Protocol Option for Coordinate-based Location Configuration Information 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. Copyright Notice Copyright (C) The Internet Society (2004).
AbstractThis document specifies a Dynamic Host Configuration Protocol Option for the coordinate-based geographic location of the client. The Location Configuration Information (LCI) includes latitude, longitude, and altitude, with resolution indicators for each. The reference datum for these values is also included.
The resulting location information using this resolution method is a small fixed length Configuration Information that can be easily carried in protocols, such as DHCP, which have limited packet size because this LCI is only 18 bytes long. Finally, the appendix of this document provides some arithmetic examples of the implication of different resolution values on the La/Lo/Alt. 3].
7]. The integer parts of these fields are 9 bits long to accommodate +/- 180 degrees. The fractional part is 25 bits long, better than the precision of 7 decimal digits. The length of each field is 40 bits, 34 of which is the sum of the integer (9) and fractional (25) bits, plus 6 bits of resolution. Altitude is determined by the Altitude Type (AT) indicated by the AT field, which is 4 bits long. Two Altitude Types are defined here, meters (code=1) and floors (code=2), both of which are 2s-complement fixed-point with 22 bits of integer part and 8 bits of fractional part. Additional Altitude Types MAY be assigned by IANA. The "floors" Altitude Type is provided because altitude in meters may not be known within a building, and a floor indication may be more useful. GPS systems today can use WGS84 for horizontal and vertical datums;  defines WGS84 as a three-dimensional datum. For other datum values that do not include a vertical component, both the horizontal and vertical datum of reference will be specified in the IANA record. Each of these 3 elements begins with an accuracy sub-field of 6 bits, indicating the number of bits of resolution. This resolution sub- field accommodates the desire to easily adjust the precision of a reported location. Contents beyond the claimed resolution MAY be randomized to obscure greater precision that might be available.
The LCI format is as follows: 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Code 123 | 16 | LaRes | Latitude + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Latitude (cont'd) | LoRes | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Longitude | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | AT | AltRes | Altitude | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Alt (cont'd) | Datum | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
AT = 2 for Floors enables representing altitude in a form more relevant in buildings which have different floor-to-floor dimensions. An altitude coded as AT = 2, AltRes = 30, and Altitude = 0.0 is meaningful even outside a building, and represents ground level at the given latitude and longitude. Inside a building, 0.0 represents the floor level associated with ground level at the main entrance. This document defines a number; one must arrive at the number by counting floors from the floor defined to be 0.0. The values represented by this AT will be of local significance. Since buildings and floors can vary due to lack of common control, the values chosen to represent the characteristics of an individual building will be derived and agreed upon by the operator of the building and the intended users of the data. Attempting to standardize this type of function is beyond the scope this document. Sub-floors can be represented by non-integer values. Example: a mezzanine between floor 1 and floor 2 could be represented as a value = 1.1. Example: (2) mezzanines between floor 4 and floor 5 could be represented as values = 4.1 and 4.2 respectively. Floors located below ground level could be represented by negative values. Larger values represent floors that are above (higher in altitude) floors with lower values. The AltRes field SHOULD be set to maximum precision when AT = 2 (floors) when a floor value is included in the DHCP Reply, or the AT = 0 to denote the floor isn't known. Any additional LCI Altitude Types(s) to be defined for use via this DHC Option MUST be done through a Standards Track RFC. Datum: The Map Datum used for the coordinates given in this Option The datum must include both a horizontal and a vertical reference. Since the WGS 84 reference datum is three-dimensional, it includes both. For any additional datum parameters, the datum codepoint must specify both horizontal datum and vertical datum references. The Datum byte has 256 possibilities, of which 3 have been registered with IANA by this document (all derived from specification in ): 1: WGS 84 (Geographical 3D) - World Geodesic System 1984, CRS Code 4327, Prime Meridian Name: Greenwich
2: NAD83 - North American Datum 1983, CRS Code 4269, Prime Meridian Name: Greenwich; The associated vertical datum is the North American Vertical Datum of 1988 (NAVD88) This datum pair is to be used when referencing locations on land, not near tidal water (which would use Datum = 3 below) 3: NAD83 - North American Datum 1983, CRS Code 4269, Prime Meridian Name: Greenwich; The associated vertical datum is Mean Lower Low Water (MLLW) This datum pair is to be used when referencing locations on water/sea/ocean Any additional LCI datum(s) to be defined for use via this DHC Option MUST be done through a Standards Track RFC. 4] SHOULD be used to protect the integrity of the DHCP options. Since there is no privacy protection for DHCP messages, an eavesdropper who can monitor the link between the DHCP server and requesting client can discover this LCI. To minimize the unintended exposure of location information, the LCI option SHOULD be returned by DHCP servers only when the DHCP client has included this option in its 'parameter request list' (section 3.5 ). When implementing a DHC server that will serve clients across an uncontrolled network, one should consider the potential security risks. Section 2) and the Datum field (see Section 2). The datum indicator MUST include specification of both horizontal and vertical datum. New values for the Altitude (AT) field are assigned through "Standards Action" [RFC 2434]. The initial values of the Altitude registry are as follows:
AT = 1 meters of Altitude defined by the vertical datum specified. AT = 2 building Floors of Altitude. Datum = 1 denotes the vertical datum WGS 84 as defined by the EPSG as their CRS Code 4327; CRS Code 4327 also specifies WGS 84 as the vertical datum Datum = 2 denotes the vertical datum NAD83 as defined by the EPSG as their CRS Code 4269; North American Vertical Datum of 1988 (NAVD88) is the associated vertical datum for NAD83 Datum = 3 denotes the vertical datum NAD83 as defined by the EPSG as their CRS Code 4269; Mean Lower Low Water (MLLW) is the associated vertical datum for NAD83 Any additional LCI datum(s) to be defined for use via this DHC Option MUST be done through a Standards Track RFC.
south-southwest of Los Angeles, CA due north to the North Pole. This would cover an area of about one-sixth of the globe, approximately 20 million square nautical miles (nm). If: LaRes is expressed as value 3 (0x03 or 000011) and LoRes is expressed as value 3 (0x03 or 000011), then it would describe a geo-location area that is north from the equator to 63 degrees north, and -65 degrees to -128 degrees longitude. This area includes south of a line from Anchorage, AL to eastern Nunavut, CN, and from the Amazons of northern Brazil to approximately 4400km south-southwest of Los Angeles, CA. This area would include North America, Central America, and parts of Venezuela and Columbia, except portions of Alaska and northern and eastern Canada, approximately 10 million square nm. If: LaRes is expressed as value 5 (0x05 or 000101) and LoRes is expressed as value 5 (0x05 or 000101), then it would describe a geo-location area that is latitude 32 north of the equator to latitude 48 and extends from -64 degrees to -80 degrees longitude. This is approximately an east-west boundary of a time zone, an area of approximately 700,000 square nm. If: LaRes is expressed as value 9 (0x09 or 001001) and LoRes is expressed as value 9 (0x09 or 001001), which includes all the integer bits, then it would describe a geo-location area that is latitude 38 north of the equator to latitude 39 and extends from -77 degrees to -78 degrees longitude. This is an area of approximately 9600 square km (111.3km x 86.5km). If: LaRes is expressed as value 18 (0x12 or 010010) and LoRes is expressed as value 18 (0x12 or 010010), then it would describe a geo-location area that is latitude 38.8984375 north to latitude 38.9003906 and extends from -77.0390625 degrees to -77.0371094 degrees longitude. This is an area of approximately 36,600 square meters (169m x 217m). If: LaRes is expressed as value 22 (0x16 or 010110) and LoRes is expressed as value 22 (0x16 or 010110), then it would describe a geo-location area that is latitude 38.896816 north to latitude 38.8985596 and extends from -77.0372314 degrees to -77.0371094 degrees longitude. This is an area of approximately 143 square meters (10.5m x 13.6m). If: LaRes is expressed as value 28 (0x1c or 011100) and LoRes is expressed as value 28 (0x1c or 011100), then it would describe a geo-location area that is latitude 38.8986797 north to latitude
38.8986816 and extends from -77.0372314 degrees to -77.0372296 degrees longitude. This is an area of approximately 339 square centimeters (20.9cm x 16.23cm). If: LaRes is expressed as value 30 (0x1e or 011110) and LoRes is expressed as value 30 (0x1e or 011110), then it would describe a geo-location area that is latitude 38.8986797 north to latitude 38.8986802 and extends from -77.0372300 degrees to -77.0372296 degrees longitude. This is an area of approximately 19.5 square centimeters (50mm x 39mm). If: LaRes is expressed as value 34 (0x22 or 100010) and LoRes is expressed as value 34 (0x22 or 100010), then it would describe a geo-location area that is latitude 38.8986800 north to latitude 38.8986802 and extends from -77.0372300 degrees to -77.0372296 degrees longitude. This is an area of approximately 7.5 square millimeters (3.11mm x 2.42mm). In the (White House) example, the requirement of emergency responders in North America via their NENA Model Legislation  could be met by a LaRes value of 21 and a LoRes value of 20. This would yield a geo-location that is latitude 38.8984375 north to latitude 38.8988616 north and longitude -77.0371094 to longitude -77.0375977. This is an area of approximately 89 feet by 75 feet or 6669 square feet, which is very close to the 7000 square feet requested by NENA. In this example, a service provider could enforce that a device send a Location Configuration Information with this minimum amount of resolution for this particular location when calling emergency services.
Longitude 87.63602 degrees West (or -87.63602 degrees) Using 2s complement, 34 bit fixed point, 25 bit fraction Longitude = 0xf50ba5b97, Longitude = 1101010000101110100101101110010111 Altitude 103 In this example, we are inside a structure, therefore we will assume an altitude value of 103 to indicate the floor we are on. The Altitude Type value is 2, indicating floors. The AltRes field would indicate that all bits in the Altitude field are true, as we want to accurately represent the floor of the structure where we are located. AltRes = 30, 0x1e, 011110 AT = 2, 0x02, 000010 Altitude = 103, 0x00006700, 000000000000000110011100000000 For the accuracy of the latitude and longitude, the best information available to us was supplied by a generic mapping service that shows a single geo-loc for all of the Sears Tower. Therefore we are going to show LaRes as value 18 (0x12 or 010010) and LoRes as value 18 (0x12 or 010010). This would be describing a geo-location area that is latitude 41.8769531 to latitude 41.8789062 and extends from -87.6367188 degrees to -87.6347657 degrees longitude. This is an area of approximately 373412 square feet (713.3 ft. x 523.5 ft.).  Droms, R., "Dynamic Host Configuration Protocol", RFC 2131, March 1997.  Patrick, M., "DHCP Relay Agent Information Option", RFC 3046, January 2001.  Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.  Droms, R. and W. Arbaugh, "Authentication for DHCP Messages", RFC 3118, June 2001.  European Petroleum Survey Group, http://www.epsg.org/ and http://www.ihsenergy.com/epsg/geodetic2.html  World Geodetic System 1984 (WGS 84), MIL-STD-2401, http://www.wgs84.com/
BCP 78, 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 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 BCP 78 and BCP 79. 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 http://www.ietf.org/ipr. 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 ietf- email@example.com. Acknowledgement Funding for the RFC Editor function is currently provided by the Internet Society.