When dealing with heavy KML files, please add the object returned by this method to the map display immediately. This method returns an empty nokia.maps.map.Container object and starts a nokia.maps.util.Coroutine which asynchronously fills it with objects held provided by the kmlDocument object. As a result, some of the kmlDocument objects may be rendered before others are added. When an entire kmlDocument is parsed and all the required containers and objects are created, the state of the KMLResultSet object is set to "finished". To receive notification of the state change, attach an observer as shown in the example below:

	var kmlManager = new nokia.maps.kml.Manager(),
		resultSet;

	kmlManager.addObserver("state", function (kmlManager) {
		// KML file was successfully loaded
		if (kmlManager.state == "finished") {
			// KML file was successfully parsed
			resultSet = new nokia.maps.kml.component.KMLResultSet(kmlManager.kmlDocument, map);
			resultSet.addObserver("state", function (resultSet) {
				if (resultSet.state == "finished") {
					// KML object tree was successfully converted into map objects
					// Get the bounding box of container
					boundingBox = resultSet.container.getBoundingBox();
					// Switch the viewport of the map do show all KML map objects within the container
					if (boundingBox) {
						map.zoomTo(boundingBox);
					}
				}
			});
			map.objects.add(resultSet.create());
		}
	});
	kmlManager.parseKML("sampleFile.kml");

The method uses a modified Breadth-first search algorithm to traverse the tree.