KML Validator Galdos Systems Inc.

KML Validator Help

This is the official documentation for the KML Validator. Additional documentation and help will be added based on user feedback and suggestions.

Please use the feedback form that is included for this purpose.

Table of Contents

Using the KML Validator

The KML Validator accepts both KML files and KMZ archives. When submitting a KMZ archive, it must contain one and only one KML file.

A KML file may be submitted for validation in one of two ways. Click one of the option buttons to select:

  • Validate by: URI — use the Address field to enter the URI of a KML file or KMZ archive that is on a publicly-accessible server or website;
  • Validate by: File Upload — use the File field and Browse button to upload a KML file or KMZ archive.

The KML Validator performs strict validation on any KML file or KMZ archive that is submitted and returns a report listing all the issues that were found. The issues are grouped by level in the report.

Use the report for fixing the errors in a KML file to make it valid or to implement the suggestions for increasing its level of interoperability. Fixing all the Level 1 errors will make the KML file minimally valid. Fixing the Level 2 and Level 3 issues will make the KML file increasingly interoperable.

Important Things to Know About KML

KML (previously known as Keyhold Markup Language) is an XML-based language for specifying how to display and navigate between geographic content within an Earth browser.

Because KML uses a tag-based structure, with elements and attributes, it provides a rich language for describing this type of data. Markup languages are platform independent, so they are ideal for exchanging data between different systems and organizations.

The more strictly the KML file conforms to the Standard, the more likely it will be that the KML data can be exchanged with another person, application, or organization and that it will be displayed as expected.

Important Things to Know About Validation

The KML Validator validates a submitted file against an abstract test suite for the OGC® KML 2.2 Specification. The KML 2.2 Specification defines three levels of validation and the KML Validator groups the error messages in the same way:

  • Level 1 — Errors: Errors indicate that one or more requirements have not been met. All errors must be fixed for the KML to be valid.
  • Level 2 — Recommendations: The utility, portability and interoperability of the KML would be improved by implementing these recommendations.
  • Level 3 — Suggestions: If these suggestions are followed, the KML would have the greatest portability and interoperability and follow best practices.

Common Validation Errors

As a way to get started, some initial Help documentation has been provided about some of the most likely problems that might be encountered when developing KML files:

(C) 2008 by Galdos Systems Inc.      Disclaimer