SharpKML

The OGC KML specification requires the http://www.opengis.com/kml/2.2 namespace. However, older or non-standard files may use different namespaces, such as http://earth.google.com/kml/2.2.

To handle these files, use the Parser class and call ParseString with the ignoreNamespaces parameter set to true. After parsing, wrap the parser.Root element in a KmlFile using KmlFile.Create(parser.Root, true) to restore a usable object model.

Note: When you save a file parsed this way, the OGC namespace will be used, overwriting the original non-standard namespace. This behavior is consistent with libkml.

using System;
using SharpKml.Base;
using SharpKml.Dom;
using SharpKml.Engine;

class Program
{
    const string Xml = 
        "<kml xmlns='http://earth.google.com/kml/2.2'>" +
            "<Placemark>" +
                "<name>SamplePlacemark</name>" +
            "</Placemark>" +
        "</kml>";

    static KmlFile ParseLegacyFile()
    {
        // Manually parse the Xml
        Parser parser = new Parser();
        parser.ParseString(Xml, false); // Ignore the namespaces

        // The element will be stored in parser.Root - wrap it inside
        // a KmlFile
        return KmlFile.Create(parser.Root, true);
    }

    static void Main(string[]() args)
    {
        KmlFile file = ParseLegacyFile();

        // Prove it worked ok
        Kml kml = (Kml)file.Root;
        Placemark placemark = (Placemark)kml.Feature;
        Console.WriteLine(placemark.Name); // Outputs "SamplePlacemark"
    }
}

To extract specific elements (like Polygon, Placemark, etc.) from a KML structure, use the Flatten() extension method provided by SharpKml.Engine. This method allows you to iterate over every element in the KML tree regardless of its depth. When combined with LINQ's OfType<T>(), you can easily filter and select only the specific types of elements you need for processing.

Requirements:

• Ensure you have using SharpKml.Dom; and using SharpKml.Engine; in your file.
• The Flatten() method is an extension method on the KML element tree.

using System;
using System.IO;
using System.Linq;
using System.Text;
using SharpKml.Dom;
using SharpKml.Engine;

// ... setup KmlFile ...

// Use the Flatten extension method to iterate over all elements,
// then use LINQ OfType to select only the desired type (e.g., Polygon)
foreach (var poly in file.Root.Flatten().OfType<Polygon>())
{
    Console.WriteLine(poly.Id);
}

The Examples folder in the repository contains several concrete implementations for common KML tasks. Use these as templates for your own development:

• Creating KML/KMZ: CreateKml.cs (creating KML from code) and CreateKmz.cs (creating compressed KMZ archives).
• Parsing and Extraction: ParseKml.cs (using the Parser class to parse files while ignoring XML namespaces) and ExtractingElements.md (for extracting specific types).
• Styling: CreateIconStyle.cs (creating IconStyle), InlineStyles.cs (using StyleResolver.InlineStyles to move styles inside a Feature), and SplitStyles.cs (moving styles from a Feature to a Document).
• Data Manipulation: Change.cs (using Update elements and the Process extension method), Clone.cs (copying Elements), and SortPlacemarks.cs (sorting placemarks by name).
• Feature Inspection: BalloonFeatures.cs (displaying balloon text) and ShowStyles.cs (iterating over styles).

You can create Google Earth tours by using classes within the SharpKml.Dom.GX namespace. A typical tour involves creating a FlyTo primitive with a specific FlyToMode, adding it to a Playlist, and then assigning that Tour to the Feature property of a Kml object.

Important: You must add the GX22 namespace prefix to the Kml object for the tour to be valid in Google Earth.

using System;
using System.Reflection;
using System.Xml;
using SharpKml.Base;
using SharpKml.Dom;

class Program
{
    static void Main(string[]() args)
    {
        var flyTo = new SharpKml.Dom.GX.FlyTo
        {
            Mode = SharpKml.Dom.GX.FlyToMode.Bounce,
        };

        var tour = new SharpKml.Dom.GX.Tour
        {
            Playlist = new SharpKml.Dom.GX.Playlist(),
        };
        tour.Playlist.AddTourPrimitive(flyTo);

        var kml = new Kml();
        kml.AddNamespacePrefix(KmlNamespaces.GX22Prefix, KmlNamespaces.GX22Namespace);
        kml.Feature = tour;

        Serializer serializer = new Serializer();
        serializer.Serialize(kml);
        Console.WriteLine(serializer.Xml);
    }
}