--- 1/draft-ietf-netmod-geo-location-00.txt 2019-04-29 05:13:16.523115065 -0700 +++ 2/draft-ietf-netmod-geo-location-01.txt 2019-04-29 05:13:16.571116274 -0700 @@ -1,18 +1,18 @@ Network Working Group C. Hopps Internet-Draft LabN Consulting, L.L.C. -Intended status: Standards Track April 20, 2019 -Expires: October 22, 2019 +Intended status: Standards Track April 29, 2019 +Expires: October 31, 2019 YANG Geo Location - draft-ietf-netmod-geo-location-00 + draft-ietf-netmod-geo-location-01 Abstract This document defines a generic geographical location object YANG grouping. The geographical location grouping is intended to be used in YANG models for specifying a location on or in reference to the Earth or any other astronomical object. Status of This Memo @@ -22,21 +22,21 @@ Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." - This Internet-Draft will expire on October 22, 2019. + This Internet-Draft will expire on October 31, 2019. Copyright Notice Copyright (c) 2019 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents @@ -206,21 +206,21 @@ deal with a location but rather describe something more about the object that is at the location. Module authors are free to add these non-location attributes along with their use of this location grouping. 2.6. Tree The following is the YANG tree diagram [RFC8340] for the geo-location grouping. - module: geo-location + module: ietf-geo-location +-- geo-location +-- reference-frame | +-- alternate-system? string {alternate-systems}? | +-- astronomical-body? string | +-- geodetic-system | +-- geodetic-datum? string | +-- coord-accuracy? decimal64 | +-- height-accuracy? decimal64 +-- (location) | +--:(ellipsoid) @@ -322,50 +322,51 @@ "The system in which the astronomical body and geodetic-datum is defined. Normally, this value is not present and the system is the natural universe; however, when present this value allows for specifying alternate systems (e.g., virtual realities). An alternate-system modifies the definition (but not the type) of the other values in the reference frame."; } leaf astronomical-body { type string { - pattern - '[-0-9a-z #x22#x23#x5B#x5D' + - '!$%&()*+,\./:;<=>?@\\^_`{|}~]+'; + pattern '[ -@\[-\^_-~]*'; } default "earth"; description "An astronomical body as named by the International Astronomical Union (IAU) or according to the alternate system if specified. Examples include 'sun' (our star), 'earth' (our planet), 'moon' (our moon), 'enceladus' (a moon of Saturn), 'ceres' (an asteroid), '67p/churyumov-gerasimenko (a comet). The value should be comprised of all lower case ASCII characters not including control characters (i.e., values 32..64, and - 91..126)"; + 91..126). Any preceding 'the' in the name should not + be included."; } container geodetic-system { description "The geodetic system of the location data."; leaf geodetic-datum { type string { - pattern - '[-0-9a-z#x22#x23#x5B#x5D' + - '!$%&()*+,\./:;<=>?@\\^_`{|}~]+'; + pattern '[ -@\[-\^_-~]*'; } default "wgs-84"; description "A geodetic-datum defining the meaning of latitude, longitude and height. The default is 'wgs-84' which is - used by the Global Positioning System (GPS)"; + used by the Global Positioning System (GPS). The value + SHOULD be comprised of all lower case ASCII characters + not including control characters (i.e., values 32..64, + and 91..126). The IANA registry further restricts the + value by converting all spaces (' ') to dashes ('-')"; } leaf coord-accuracy { type decimal64 { fraction-digits 6; } description "The accuracy of the latitude longitude pair. When coord-accuracy is specified it overrides the geodetic-datum implied accuracy. If Cartesian coordinates are in use this accuracy corresponds to @@ -860,51 +862,49 @@ . [W3CGEO] Popescu, A., "Geolocation API Specification", 11 2016, . Appendix A. Examples Below is a fictitious module that uses the geo-location grouping. - file "ietf-uses-geo-location@2019-02-02.yang" - module ietf-uses-geo-location { + module example-uses-geo-location { namespace - "urn:ietf:params:xml:ns:yang:ietf-uses-geo-location"; + "urn:example:example-uses-geo-location"; prefix ugeo; - import geo-location { prefix geo; } + import ietf-geo-location { prefix geo; } organization "Empty Org"; contact "Example Author "; description "Example use of geo-location"; revision 2019-02-02 { reference "None"; } container locatable-items { description "container of locatable items"; list locatable-item { key name; description "A of locatable item"; leaf name { type string; description "name of locatable item"; } uses geo:geo-location; } } } - Figure 3: Example YANG module using geo location. Below is a the YANG tree for the fictitious module that uses the geo- location grouping. - module: ietf-uses-geo-location + module: example-uses-geo-location +--rw locatable-items +--rw locatable-item* [name] +--rw name string +--rw geo-location +--rw reference-frame | +--rw alternate-system? string {alternate-systems}? | +--rw astronomical-body? string | +--rw geodetic-system | +--rw geodetic-datum? string | +--rw coord-accuracy? decimal64 @@ -921,22 +921,21 @@ +--rw velocity | +--rw v-north? decimal64 | +--rw v-east? decimal64 | +--rw v-up? decimal64 +--rw timestamp? types:date-and-time Below is some example YANG XML data for the fictitious module that uses the geo-location grouping. - + Gaetana's 40.73297 -74.007696 Pont des Arts