Open Geospatial Consortium, Inc. Date: 2008-09-12 Reference number of this document: OGC 07-124r2 Version: 0.1.0 Category: Discussion Paper Editor(s): Chris Holmes OGC® OWS-5 KML Engineering Report Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. To obtain additional rights of use, visit http://www.opengeospatial.org/legal/. Warning This document is not an OGC Standard. This document is an OGC Discussion Paper and is therefore not an official position of the OGC membership. It is distributed for review and comment. It is subject to change without notice and may not be referred to as an OGC Standard. Further, an OGC Discussion Paper should not be referenced as required or mandatory technology in procurements. OGC 07-124r2 Preface Suggested additions, changes, and comments on this Discussion Paper are welcome and encouraged. Such suggestions may be submitted by email message or by making suggested changes in an edited copy of this document. The changes made in this document version, relative to the previous version, are tracked by Microsoft Word, and can be viewed if desired. If you choose to submit suggested changes by editing this document, please first accept all the current changes, and then make your suggested changes with change tracking on. Forward Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. The Open Geospatial Consortium Inc. shall not be held responsible for identifying any or all such patent rights. Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the standard set forth in this document, and to provide supporting documentation. ii Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. OGC 07-124r2 Contents Page 1 Introduction ............................................................................................................... 1 1.1 Scope ................................................................................................................... 1 1.2 Document contributor contact points .................................................................... 1 1.3 Revision history ................................................................................................... 1 1.4 Future work ......................................................................................................... 2 2 References ................................................................................................................. 3 3 Terms and definitions ................................................................................................ 4 4 Conventions .............................................................................................................. 4 4.1 Abbreviated terms ................................................................................................ 4 5 KML Overview ......................................................................................................... 5 6 Summary ................................................................................................................... 6 7 KML “core” and modules .......................................................................................... 7 7.1 Introduction ......................................................................................................... 7 7.2 KML Modules ..................................................................................................... 8 7.3 Core ..................................................................................................................... 9 7.4 Extended Data ................................................................................................... 10 7.5 Styling ............................................................................................................... 15 7.6 3d 16 7.7 Vendor Tags ...................................................................................................... 16 8 KML MIME Type and XML Namespace ................................................................ 17 8.1 KML MIME Type ............................................................................................. 17 8.2 KML XML Namespace ..................................................................................... 17 9 KML and OGC Web Services.................................................................................. 18 9.1 KML integration with OWS Context.................................................................. 19 9.2 OWS Context Simplification Recommendations ................................................ 20 9.3 Service Equivalence in OWS Context ................................................................ 23 10 KML Feature Portrayal Service ............................................................................. 24 11 KML Styling ......................................................................................................... 25 11.1 SLD to KML Transform .................................................................................... 28 12 Usage Scenarios .................................................................................................... 32 12.1 Use Case 1: Mobile Phone ................................................................................. 32 12.2 Use Case 2: Web Mapping 1 .............................................................................. 33 12.3 Use Case 3: Web Mapping 2 .............................................................................. 34 Annex A ........................................................................................................................ 36 XML Schema Documents.............................................................................................. 36 Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. iii OGC 07-124r2 Figures Page Figure 1 – KML Modules and Deployment Platforms ................................................................. 8 Tables Page Figure 1 – KML Modules and Deployment Platforms ................................................................. 8 iv Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. OpenGIS® Engineering Report OGC 07-124r2 OGC® OWS-5 KML Engineering Report 1 Introduction 1.1 Scope This OGC™ document is a report on the findings of the OWS-5 Agile Geography KML thread, giving recommendations for revisions and additions to the KML specification. 1.2 Document contributor contact points All questions regarding this document should be directed to the editor or the contributors: Name Organization Holmes, Chris The Open Planning Project Turner, Andrew Mapufacture Ingrassia, Chris Fortius One Singh, Raj OGC Burggraf, David Galdos 1.3 Revision history Date Release Editor Primary clauses Description modified 2007-09-17 0.0.1 Holmes, All Initial Version Chris 2007-09-17 0.0.2 Turner, 2.1 Added Mobile phone use case and fixed some Andrew minor formatting 2007-10-20 0.0.3 Singh, Raj 9.1, 10 Core module/profiles refinement, GML change 2007-11-15 0.0.4 Holmes, All Rewrite in to Engineering Document Chris 2007-12-05 0.0.5 Holmes, 10 Additions Chris Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. 1 OGC 07-124r2 2008-01-21 0.0.6 Holmes, All Formatting, new sections Chris 2008-03-09 0.0.7 Holmes, 6.2, 6.2.1.1, 8 Cleanup, no more GML in KML, many Chris context changes. Added Use Case 3 from C. Shorter 2008-04 1.0.0 Singh, Raj 7 Edits on OWS Context information 2008-7 0.9.0 C. Reed Various Make ready for posting as DP 1.4 Future work It is anticipated that recommendations detailed in this document will be taken up for consideration by the KML and OWS Context standards working groups and considered for future versions of those standards. 1.5 Forward Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. The Open Geospatial Consortium Inc. shall not be held responsible for identifying any or all such patent rights. Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the standard set forth in this document, and to provide supporting documentation. 2 Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. OGC 07-124r2 2 References The following documents are referenced in this document. For dated references, subsequent amendments to, or revisions of, any of these publications do not apply. For undated references, the latest edition of the normative document referred to applies. OGC 06-121r3, OpenGIS® Web Services Common Specification In addition to this document, this report includes several XML Schema Document files as specified in Annex A. Copyright © 2008 Open Geospatial Consortium, Inc. All Rights Reserved. 3 OGC 07-124r2 3 Terms and definitions For the purposes of this report, the definitions specified in Clause 4 of the OWS Common Implementation Specification [OGC 06-121r3] shall apply. In addition, the following terms and definitions apply. 4 Conventions 4.1 Abbreviated terms CRS Coordinate Reference System EPSG European Petroleum Survey Group GML Geography Markup Language GeoRSS Geographically Encoded Objects for RSS HTTP Hypertext Transfer Protocol