Class: KmlDocument

KmlDocument(options)

Contains the data associated with Document options.

Constructor

new KmlDocument(options)

Constructs an KmlDocument. Applications usually don't call this constructor. It is called by KmlFile as objects from Kml file are read. This object is already concrete implementation.
Parameters:
Name Type Description
options Object
Properties
Name Type Description
objectNode Node Node representing the document.
Source:
See:
Throws:
If the options is null or undefined.
Type
ArgumentError

Extends

Members

displayName :String

The display name of the renderable.
Type:
  • String
Inherited From:
Default Value:
  • "Renderable"
Source:

enabled :Boolean

Indicates whether to display this renderable.
Type:
  • Boolean
Inherited From:
Default Value:
  • true
Source:

(readonly) id :String

Every object, which is part of the KML document has its identity. We will use it for changes in the document for binding.
Type:
  • String
Inherited From:
Source:

(readonly) kmlAbstractView :KmlAbstractView

It represents one of the AbstractViews associated with current Feature. Specific implementation of AbstractView will be returned.
Type:
Inherited From:
Source:

(readonly) kmlAddress :String

It represents unstructured address associated with the Feature.
Type:
  • String
Inherited From:
Source:

(readonly) kmlDescription :String

It represents description of this feature. It can be displayed as a part of the feature.
Type:
  • String
Inherited From:
Source:

(readonly) kmlName :String

Name of this feature. Every feature should have name.
Type:
  • String
Inherited From:
Source:

(readonly) kmlOpen :Boolean

It is applied only to Document, Folder and NetworkLink and represents whether they should be rendered collapsed or expanded.
Type:
  • Boolean
Inherited From:
Source:

(readonly) kmlPhoneNumber :String

It represents phone number associated with current feature. Quite probably irrelevant information.
Type:
  • String
Inherited From:
Source:

(readonly) kmlRegion :KmlRegion

Features and geometry associated with a Region are drawn only when the Region is active. See <Region>.
Type:
Inherited From:
Source:

(readonly) kmlSchemas :Array.<Schema>

Specifies a custom KML schema that is used to add custom data to KML Features. The "id" attribute is required and must be unique within the KML file. <Schema> is always a child of <Document>. This is array of all Schemas in current document
Type:
  • Array.<Schema>
Source:
See:
  • {Schema}

(readonly) kmlShapes :Array.<Node>

Specifies any amount of features, which are part of this document.
Type:
  • Array.<Node>
Source:
See:

(readonly) kmlSnippet :String

A short description of the feature. In Google Earth, this description is displayed in the Places panel under the name of the feature. If a Snippet is not supplied, the first two lines of the <description> are used. In Google Earth, if a Placemark contains both a description and a Snippet, the <Snippet> appears beneath the Placemark in the Places panel, and the <description> appears in the Placemark's description balloon. This tag does not support HTML markup. <Snippet> has a maxLines attribute, an integer that specifies the maximum number of lines to display.
Type:
  • String
Inherited From:
Source:

(readonly) kmlStyleSelector :KmlStyle

One style element per Feature, with possible children of different substyles.
Type:
Inherited From:
Source:

(readonly) kmlStyleUrl :String

URL of a <Style> or <StyleMap> defined in a Document. If the style is in the same file, use a # reference. If the style is defined in an external file, use a full URL along with # referencing. If it references remote URL, this server must support CORS for us to be able to download it.
Type:
  • String
Inherited From:
Source:

(readonly) kmlTimePrimitive :KmlTimePrimitive

It represents one of the TimePrimitives associated with current Feature. Specific implementation of TimePrimitive will be returned.
Type:
Inherited From:
Source:

(readonly) kmlVisibility :Boolean

Visibility of current feature. It is possible for some features to be invisible.
Type:
  • Boolean
Inherited From:
Source:

(readonly) node :Node

Node of this object. It may be overridden by other users of some functions like parse.
Type:
  • Node
Inherited From:
Source:

pickDelegate :Object

Indicates the object to return as the userObject of this shape when picked. If null, then this shape is returned as the userObject.
Type:
  • Object
Inherited From:
Default Value:
  • null
Source:
See:

userProperties :Object

An application defined object associated with this renderable. A typical use case is to associate application defined data with a picked renderable.
Type:
  • Object
Inherited From:
Default Value:
  • An empty object
Source:

Methods

getStyle() → {Promise|undefined}

It retrieves the style for current element, regardless of whether it is local or remote.
Inherited From:
Source:
Returns:
Promise of the file to deliver
Type
Promise | undefined

getTagNames() → {Array.<String>}

Returns tag name of all descendants of abstract node or the tag name for current node.
Overrides:
Source:
Returns:
Type
Array.<String>

hook(controls, options)

It calls all controls associated with current KmlFile with the link to this.
Parameters:
Name Type Description
controls Array.<KmlControls> Controls associated with current tree.
options Object Options to pass into the controls.
Inherited From:
Source:

render(dc)

Render this renderable. Some shapes actually draw themselves during this call, others only add themselves to the draw context's ordered rendering list for subsequent drawing when their renderOrdered method is called. This method is intended to be called by layers such as RenderableLayer and not by applications.
Parameters:
Name Type Description
dc DrawContext The current draw context.
Inherited From:
Source:

solveRegion(dc) → {boolean}

Internal use only It solves whether the feature should be visible based on the Region.
Parameters:
Name Type Description
dc DrawContext Draw context associated with current processing.
Inherited From:
Source:
Returns:
true if there is no region or the feature is in the region.
Type
boolean

solveStyle(dc, kmlOptions)

Internal use only It solves style which should be applied to current feature.
Parameters:
Name Type Description
dc DrawContext DrawContext associated with current processing.
kmlOptions Object
Properties
Name Type Description
lastStyle KmlStyle Style representing the one to apply to current information.
Inherited From:
Source:

solveTimeVisibility()

Internal function for solving the time visibility. The element is visible when its whole range is inside the time range chosen by user.
Inherited From:
Source:

solveVisibility(dc, kmlOptions)

Internal use only It solves whether current feature should be visible. It takes into account the visibility of parent elements, Time constraints, region, visibility.
Parameters:
Name Type Description
dc DrawContext Draw context associated with current processing.
kmlOptions Object
Inherited From:
Source: