OGC 07-147r2
86
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
kml:Polygon
10.8.2 Description
This element can be used wherever the following element is referenced:
• kml:AbstractGeometryGroup
A
kml:Polygon
shall have an outer boundary ring outside of an update context, that is when not a descendant of
kml:Update
. It may have 0 or more inner boundary rings. Each ring is defined by a
kml:LinearRing
. It is advised that the rings not cross each other.
10.8.3 Content
10.8.3.1 kml:extrude
10.8.3.1.1 Description
Specifies whether to connect the
kml:Polygon
to the ground when displayed in the geographic view.
When a
kml:Polygon
is extruded, each boundary point is extended to the terrain toward the earths center of mass, which gives the appearance of a building or a box.
Only the
kml:Polygon
boundary is extruded, not the
kml:Polygon
interior for example, a rectangle turns into a box with five faces.
See 10.4 kml:extrude.
10.8.3.2 kml:tessellate
See 10.6 kml:tessellate.
10.8.3.3 kml:altitudeModeGroup
See 9.16 kml:altitudeModeGroup and 9.17 kml:altitudeMode.
10.8.3.4 kml:outerBoundaryIs
Specifies the exterior boundary of the
kml:Polygon
defined by a
kml:LinearRing
element. See 10.5 kml:LinearRing.
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
87
10.8.3.5 kml:innerBoundaryIs
Specifies an inner boundary of the
kml:Polygon
defined by a
kml:LinearRing
element. See 10.5 kml:LinearRing.
10.8.3.6 kml:PolygonSimpleExtensionGroup
See 6.6.3.1 Simple Element Substitution.
10.8.3.7 kml:PolygonObjectExtensionGroup
See 6.6.3.2 Complex Element Substitution.
OGC 07-147r2
88
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
10.8.4 Example
kml xmlns=http:www.opengis.netkml2.2 Document
namePolygon.kmlname open0open
Placemark namehollow boxname
Polygon
extrude1extrude altitudeModerelativeToGroundaltitudeMode
outerBoundaryIs LinearRing
coordinates -122.366278,37.818844,30
-122.365248,37.819267,30 -122.365640,37.819861,30
-122.366669,37.819429,30 -122.366278,37.818844,30
coordinates LinearRing
outerBoundaryIs innerBoundaryIs
LinearRing coordinates
-122.366212,37.818977,30 -122.365424,37.819294,30
-122.365704,37.819731,30 -122.366488,37.819402,30
-122.366212,37.818977,30 coordinates
LinearRing innerBoundaryIs
Polygon
Placemark Document
kml
10.9 kml:Model
10.9.1 Structure
kml:Model id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:AbstractGeometrySimpleExtensionGroup ... kml:AbstractGeometrySimpleExtensionGroup [0..]
kml:AbstractGeometryObjectExtensionGroup ... kml:AbstractGeometryObjectExtensionGroup [0..]
kml:altitudeModeGroup ... kml:altitudeModeGroup [0..1] kml:Location ... kml:Location [0..1]
kml:Orientation ... kml:Orientation [0..1] kml:Scale ... kml:Scale [0..1]
kml:Link ... kml:Link [0..1] kml:ResourceMap ... kml:ResourceMap [0..1]
kml:ModelSimpleExtensionGroup ... kml:ModelSimpleExtensionGroup [0..]
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
89
kml:ModelObjectExtensionGroup ... kml:ModelObjectExtensionGroup [0..] kml:Model
10.9.2 Description
This element can be used wherever the following element is referenced:
• kml:AbstractGeometryGroup
Specifies the location and orientation of a textured 3D object resource. The structure and appearance of the textured 3D object are not defined in this specification.
A local earth-fixed frame X’-Y’-Z’ is defined as follows. The Z-axis is defined by the local surface normal local to the tangent plane at the location
point, the Y-axis is defined by the intersection of the meridian plane defined by the longitude of the location point, and the tangent plane, and the X-axis is chosen so that X-Y-
Z form a right handed orthogonal frame.
A model-fixed frame X-Y-Z is defined as follows. The Y-axis is +ve through the front of the model. The Z-axis is +ve through the top of the model and the X-axis is chosen so that
X-Y-Z forms a right handed orthogonal frame.
The orientation of the model is then defined by the orientation of the model-fixed frame X- Y-Z relative to the local earth-fixed frame X’-Y’-Z’ as follows:
Roll – rotation about the model Y-axis