OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
109 Specifies the extent of a 2D bounding box.
kml:north
,
kml:south
,
kml:east
, and
kml:west
shall be specified.
11.3.3 Content
11.3.3.1 kml:rotation
11.3.3.1.1 Description
Specifies a rotation of the overlay about its center, in decimal degrees. Values can be ±180, with 0 being North. Rotations are specified in a counterclockwise direction.
11.3.3.1.2 Content
Type: kml:angle180Type
Default Value: 0.0
11.3.3.2 kml:LatLonBoxSimpleExtensionGroup
See 6.6.3.1 Simple Element Substitution.
11.3.3.3 kml:LatLonBoxObjectExtensionGroup
See 6.6.3.2 Complex Element Substitution.
OGC 07-147r2
110
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
11.3.4 Example
LatLonBox north48.25475939255556north
south48.25207367852141south east-90.86591508839973east
west-90.8714285289695west rotation39.37878630116985rotation
LatLonBox
11.4 kml:PhotoOverlay
11.4.1 Structure
kml:PhotoOverlay id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:name ... kml:name [0..1] kml:visibility ... kml:visibility [0..1]
kml:open ... kml:open [0..1] atom:author ... atom:author [0..1]
atom:link ... atom:link [0..1] kml:address ... kml:address [0..1]
xal:AddressDetails ... xal:AddressDetails [0..1] kml:phoneNumber ... kml:phoneNumber [0..1]
kml:snippet ... kml:snippet [0..1] kml:description ... kml:description [0..1]
kml:AbstractViewGroup ... kml:AbstractViewGroup [0..1] kml:AbstractTimePrimitiveGroup ... kml:AbstractTimePrimitiveGroup [0..1]
kml:styleUrl ... kml:styleUrl [0..1] kml:AbstractStyleSelectorGroup ... kml:AbstractStyleSelectorGroup [0..]
kml:Region ... kml:Region [0..1] kml:ExtendedData ... kml:ExtendedData [0..1]
kml:AbstractFeatureSimpleExtensionGroup ... kml:AbstractFeatureSimpleExtensionGroup [0..]
kml:AbstractFeatureObjectExtensionGroup ... kml:AbstractFeatureObjectExtensionGroup [0..]
kml:color ... kml:color [0..1] kml:drawOrder ... kml:drawOrder [0..1]
kml:Icon ... kml:Icon [0..1] kml:AbstractOverlaySimpleExtensionGroup ...
kml:AbstractOverlaySimpleExtensionGroup [0..] kml:AbstractOverlayObjectExtensionGroup ...
kml:AbstractOverlayObjectExtensionGroup [0..]
kml:rotation ... kml:rotation [0..1] kml:ViewVolume ... kml:ViewVolume [0..1]
kml:ImagePyramid ... kml:ImagePyramid [0..1] kml:Point ... kml:Point [0..1]
kml:shape ... kml:shape [0..1] kml:PhotoOverlaySimpleExtensionGroup ...
kml:PhotoOverlaySimpleExtensionGroup [0..] kml:PhotoOverlayObjectExtensionGroup ...
kml:PhotoOverlayObjectExtensionGroup [0..] kml:PhotoOverlay
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
111
11.4.2 Description
This element can be used wherever the following element is referenced:
• kml:AbstractOverlayGroup
The
kml:PhotoOverlay
element is used to position a photograph relative to the camera viewpoint and also to define field-of-view parameters. The
kml:PhotoOverlay
may be rendered on one of three shapes as determined by the value of
kml:shape
: a 2D planar rectangle, a cylinder for a panoramic photo, or a sphere for a spherical panorama.
The the photo overlay faces toward the viewpoint and its center is placed at the head of the view vector. The view vector is defined as the vector based at the viewpoint and in the
direction specified by the corresponding
kml:AbstractView
element. The length of the view vector is determined by the value of the
kml:near
element. The photo overlay is positioned such that the view vector points toward the photo and is orthogonal to the center of the image
see Figure 9.
Figure 9: kml:PhotoOverlay View Vector
The URL for the
kml:PhotoOverlay
image is specified in the
kml:Icon
tag, which is inherited from
kml:AbstractOverlayGroup
. The
kml:Icon
tag must contain a
kml:href
element that specifies the image resource to use for the
kml:PhotoOverlay
. A
kml:PhotoOverlay
element shall contain the
kml:Icon
,
kml:ViewVolume
,
kml:Point
, and
kml:Camera
child elements outside of an update context, that is when not a descendant of
kml:Update
.