OGC 07-147r2
154
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved. • kml:AbstractObjectGroup
Specifies the location
kml:href
for an icon used in the list view to reflect the state
kml:state
of the
kml:Folder
or
kml:NetworkLink
to which it is associated.
kml:ItemIcon
shall contain the
kml:href
element outside of an update context, that is when not a descendant of
kml:Update
.
12.14.3 Content 12.14.3.1 kml:state
12.14.3.1.1 Description
Specifies the current state of the
kml:NetworkLink
or
kml:Folder
. Icons associated with
the open and closed modes are used for
kml:Folders
. Icons associated with the error and fetching0, fetching1, and fetching2 modes are used for
kml:NetworkLinks
. Sample icons for each state are shown in the following diagram.
12.14.3.1.2 Content
Type: kml:itemIconStateType
Default Value: none
12.14.3.2 kml:href
See 12.9.3.1 kml:href.
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
155
12.14.3.3 kml:ItemIconSimpleExtensionGroup
See 6.6.3.1 Simple Element Substitution.
12.14.3.4 kml:ItemIconObjectExtensionGroup
See 6.6.3.2 Complex Element Substitution.
OGC 07-147r2
156
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
13 Links
13.1 kml:Link, kml:Icon kml:LinkType
13.1.1 Structure
kml:Link id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:href ... kml:href [0..1] kml:BasicLinkSimpleExtensionGroup ... kml:BasicLinkSimpleExtensionGroup
[0..] kml:BasicLinkObjectExtensionGroup ... kml:BasicLinkObjectExtensionGroup
[0..]
kml:refreshMode ... kml:refreshMode [0..1] kml:refreshInterval ... kml:refreshInterval [0..1]
kml:viewRefreshMode ... kml:viewRefreshMode [0..1] kml:viewRefreshTime ... kml:viewRefreshTime [0..1]
kml:viewBoundScale ... kml:viewBoundScale [0..1] kml:viewFormat ... kml:viewFormat [0..1]
kml:httpQuery ... kml:httpQuery [0..1] kml:LinkSimpleExtensionGroup ... kml:LinkSimpleExtensionGroup [0..]
kml:LinkObjectExtensionGroup ... kml:LinkObjectExtensionGroup [0..] kml:Link
kml:Icon id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:href ... kml:href [0..1] kml:BasicLinkSimpleExtensionGroup ... kml:BasicLinkSimpleExtensionGroup
[0..] kml:BasicLinkObjectExtensionGroup ... kml:BasicLinkObjectExtensionGroup
[0..]
kml:refreshMode ... kml:refreshMode [0..1] kml:refreshInterval ... kml:refreshInterval [0..1]
kml:viewRefreshMode ... kml:viewRefreshMode [0..1] kml:viewRefreshTime ... kml:viewRefreshTime [0..1]
kml:viewBoundScale ... kml:viewBoundScale [0..1] kml:viewFormat ... kml:viewFormat [0..1]
kml:httpQuery ... kml:httpQuery [0..1] kml:LinkSimpleExtensionGroup ... kml:LinkSimpleExtensionGroup [0..]
kml:LinkObjectExtensionGroup ... kml:LinkObjectExtensionGroup [0..] kml:Icon
13.1.2 Description
This element can be used wherever the following element is referenced:
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
157
• kml:AbstractObjectGroup NOTE:
The schema type for kml:Link and kml:Icon derives by extension from kml:BasicLinkType
, whose content model is described in 12.9 kml:Icon kml:BasicLinkType.
kml:Link
and
kml:Icon
have the same content model. They both specify the location
kml:href
and handling of a resource. For both elements
kml:href
shall be specified when not being used feature update context, that is when not a descendant of
kml:Update
. The resource should be loaded and refreshed according to the refresh parameters supplied.
Two different sets of refresh parameters can be specified: one based on time
kml:refreshMode
and
kml:refreshInterval
and one based on the current view
kml:viewRefreshMode
and
kml:viewRefreshTime
. In addition,
kml:Link
and
kml:Icon
specifies whether to scale any bounding box parameters
kml:viewBoundScale
, and provides a set of optional viewing parameters
kml:viewFormat
as well as a set of optional parameters containing version and language information
kml:httpQuery
. The valid URL request shall be the concatenation of three pieces of information:
• the
kml:href
URL that specifies the resource location; • the
kml:viewFormat
string value used to specify any view parameters; • the
kml:httpQuery
string value used to specify any other query parameters. An earth browser shall substitute relevant values for query parameters within the URL
request. If
kml:viewFormat
or
kml:httpQuery
are specified, they should contain at least one parameter.
If the resource specified in
kml:href
is a local resource, the
kml:viewFormat
and
kml:httpQuery
elements shall be ignored.
kml:Link
and
kml:Icon
shall contain the
kml:href
child element outside of an update context, that is when not a descendant of
kml:Update
. 13.1.3
Content 13.1.3.1
kml:href
See 12.9.3.1 kml:href.
OGC 07-147r2
158
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
13.1.3.2 kml:refreshMode
