OGC 07-147r2
82
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
10.5.4 Example
kml xmlns=http:www.opengis.netkml2.2 Placemark
nameLinearRing.kmlname Polygon
outerBoundaryIs
LinearRing
coordinates -122.365662,37.826988,0
-122.365202,37.826302,0 -122.364581,37.82655,0
-122.365038,37.827237,0 -122.365662,37.826988,0
coordinates
LinearRing
outerBoundaryIs Polygon
Placemark kml
10.6 kml:tessellate
10.6.1 Structure
kml:tessellate ... kml:tessellate
10.6.2 Description
Specifies whether to drape a geometry over the terrain. A value of 1 or true specifies to drape; a value of 0 or false specifies not to drape. To enable tessellation, the value for
kml:altitudeMode
shall be clampToGround.
See also 6.3 Geometry Interpolation for 3D Earth Browsers.
10.6.3 Content
Type: xsd:boolean Default Value:
0 or false
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
83
10.7 kml:LineString
10.7.1 Structure
kml:LineString id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:AbstractGeometrySimpleExtensionGroup ... kml:AbstractGeometrySimpleExtensionGroup [0..]
kml:AbstractGeometryObjectExtensionGroup ... kml:AbstractGeometryObjectExtensionGroup [0..]
kml:extrude ... kml:extrude [0..1] kml:tessellate ... kml:tessellate [0..1]
kml:altitudeModeGroup ... kml:altitudeModeGroup [0..1] kml:coordinates ... kml:coordinates [0..1]
kml:LineStringSimpleExtensionGroup ... kml:LineStringSimpleExtensionGroup [0..]
kml:LineStringObjectExtensionGroup ... kml:LineStringObjectExtensionGroup [0..]
kml:LineString
10.7.2 Description
This element can be used wherever the following element is referenced:
• kml:AbstractGeometryGroup
Defines a list of one or more contiguous line segments.
10.7.3 Content
10.7.3.1 kml:extrude
Specifies whether to extend the
kml:LineString
to the ground when displayed in the geographic view. When a
kml:LineString
is extruded, the points of each line segment are extended to the terrain toward the Earths center of mass, forming a polygon that looks like a
wall or fence. See 10.4 kml:extrude.
10.7.3.2 kml:tessellate
See 10.6 kml:tessellate.
10.7.3.3 kml:altitudeModeGroup
See 9.16 kml:altitudeModeGroup and 9.17 kml:altitudeMode.
OGC 07-147r2
84
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
10.7.3.4 kml:coordinates
10.7.3.4.1 Description
Two or more coordinate tuples.
10.7.3.4.2 Content
Type: kml:coordinatesType
Default Value: none
10.7.3.5 kml:LineStringSimpleExtensionGroup
See 6.6.3.1 Simple Element Substitution.
10.7.3.6 kml:LineStringObjectExtensionGroup
See 6.6.3.2 Complex Element Substitution.
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
85
10.7.4 Example
kml xmlns=http:www.opengis.netkml2.2 Document
nameLineString.kmlname open1open
LookAt longitude-122.36415longitude
latitude37.824553latitude altitude0altitude
range150range tilt50tilt
heading0heading LookAt
Placemark nameunextrudedname
LineString extrude0extrude
tessellate1tessellate coordinates
-122.364383,37.824664,0 -122.364152,37.824322,0 coordinates
LineString Placemark
Placemark nameextrudedname
LineString
extrude1extrude tessellate1tessellate
altitudeModerelativeToGroundaltitudeMode coordinates
-122.364167,37.824787,50 -122.363917,37.824423,50 coordinates
LineString
Placemark Document
kml
10.8 kml:Polygon
10.8.1 Structure
kml:Polygon id=ID [0..1]
targetId=NCName [0..1] kml:ObjectSimpleExtensionGroup ... kml:ObjectSimpleExtensionGroup [0..]
kml:AbstractGeometrySimpleExtensionGroup ... kml:AbstractGeometrySimpleExtensionGroup [0..]
kml:AbstractGeometryObjectExtensionGroup ... kml:AbstractGeometryObjectExtensionGroup [0..]
kml:extrude ... kml:extrude [0..1] kml:tessellate ... kml:tessellate [0..1]
kml:altitudeModeGroup ... kml:altitudeModeGroup [0..1] kml:outerBoundaryIs ... kml:outerBoundaryIs [0..1]
kml:innerBoundaryIs ... kml:innerBoundaryIs [0..] kml:PolygonSimpleExtensionGroup ... kml:PolygonSimpleExtensionGroup [0..]
kml:PolygonObjectExtensionGroup ... kml:PolygonObjectExtensionGroup [0..]
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
OGC 07-147r2
90
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
Tilt – rotation about the model X-axis
Heading – Rotation about the model Z-axis
kml:Model:
• shall contain
kml:Link
and
kml:Location
elements; • shall contain a
kml:ResourceMap
element that has a
kml:Alias
element for each texture file, if the target resource has texture files;
outside of an update context, that is when not a descendant of
kml:Update
.
OGC 07-147r2
Copyright © 2007, 2008 Open Geospatial Consortium, Inc. All Rights Reserved.
91
10.9.3 Content