kmlreference.mht

KML 参考手册 KML 2.0介绍 KML全称是Keyhole Markup Language KML

ence.html#gxtourcontrol">gx:TourControl</A>=20

  <LI><A=20
  =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#gxtourprimitive">gx:TourPrimitive</A>=20

  <LI><A=20
  =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#gxwait">gx:Wait</A>=20
  </LI></UL>
<P>The complete XML schema for elements in this extension namespace is =
located=20
at <A=20
href=3D"http://code.google.com/apis/kml/schema/kml22gx.xsd">http://code.g=
oogle.com/apis/kml/schema/kml22gx.xsd</A>.</P>
<H2><A id=3Dkmlfields name=3Dkmlfields></A>KML fields</H2>
<P>KML uses common XML types such as <EM>boolean, string, double, =
float,</EM>=20
and <EM>int</EM>. In addition, it defines a number of field element =
types. The=20
following table lists some of the most commonly used types defined in =
KML and=20
links to sample elements that use them:</P>
<TABLE cellSpacing=3D0 cellPadding=3D0 summary=3D"">
  <TBODY>
  <TR>
    <TH scope=3Dcol><EM><STRONG>Field Type</STRONG></EM></TH>
    <TH scope=3Dcol><EM><STRONG>Value</STRONG></EM></TH>
    <TH scope=3Dcol><EM><STRONG>Example Use</STRONG></EM></TH></TR>
  <TR>
    <TD><STRONG>altitudeModeEnum</STRONG></TD>
    <TD>clampToGround, relativeToGround, absolute </TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#lookat">&lt;LookAt&gt;</A>=20
      and <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#region">&lt;Region&gt;</A>=20
    </TD></TR>
  <TR>
    <TD><STRONG>angle90</STRONG></TD>
    <TD>a value =E2=89=A5=E2=88=9290 and =E2=89=A490</TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#latitude">&lt;latitude&gt;</A>=20
      in &lt;Model&gt; </TD></TR>
  <TR>
    <TD><STRONG>anglepos90</STRONG></TD>
    <TD>a value =E2=89=A50 and =E2=89=A490 </TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#tilt">&lt;tilt&gt;</A>=20
      in &lt;LookAt&gt; </TD></TR>
  <TR>
    <TD><STRONG>angle180</STRONG></TD>
    <TD>a value =E2=89=A5=E2=88=92180 and =E2=89=A4180</TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#longitude">&lt;longitude&gt;</A>=20
      in &lt;Model&gt; </TD></TR>
  <TR>
    <TD><STRONG>angle360</STRONG></TD>
    <TD>a value =E2=89=A5=E2=88=92360 and =E2=89=A4360</TD>
    <TD>See &lt;heading&gt;, &lt;tilt&gt;, and &lt;roll&gt; in<BR><A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#orientation">&lt;Orientation&gt;</A>=20
    </TD></TR>
  <TR>
    <TD><STRONG>color</STRONG></TD>
    <TD>hexBinary value:<EM> aabbggrr</EM> </TD>
    <TD>See any element that extends <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#colorstyle"><EM>&lt;ColorStyle&gt;</EM></A>=20
    </TD></TR>
  <TR>
    <TD><STRONG>colorModeEnum</STRONG></TD>
    <TD>normal, random </TD>
    <TD>See any element that extends <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#colorstyle"><EM>&lt;ColorStyle&gt;</EM></A>=20
    </TD></TR>
  <TR>
    <TD><STRONG>dateTime</STRONG></TD>
    <TD><EM>dateTime, date, gYearMonth, gYear</EM></TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#timespan">&lt;TimeSpan&gt;</A>=20
      and <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#timestamp">&lt;TimeStamp&gt;=20
      </A></TD></TR>
  <TR>
    <TD><SPAN><STRONG>displayModeEnum</STRONG></SPAN></TD>
    <TD><SPAN>default, hide </SPAN></TD>
    <TD><SPAN>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#balloonstyle">&lt;BalloonStyle&gt;</A>=20
      </SPAN></TD></TR>
  <TR>
    <TD><SPAN><STRONG>gridOrigin</STRONG></SPAN></TD>
    <TD><SPAN>lowerLeft, upperLeft</SPAN></TD>
    <TD><SPAN>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#photooverlay">&lt;PhotoOverlay&gt;</A></SPAN>=20
    </TD></TR>
  <TR>
    <TD><STRONG>refreshModeEnum</STRONG></TD>
    <TD>onChange, onInterval, onExpire </TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#link">&lt;Link&gt;</A>=20
    </TD></TR>
  <TR>
    <TD><SPAN><STRONG>shapeEnum</STRONG></SPAN></TD>
    <TD><SPAN>rectangle, cylinder, sphere</SPAN></TD>
    <TD><SPAN>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#photooverlay">&lt;PhotoOverlay&gt;</A></SPAN></TD></TR>
  <TR>
    <TD><STRONG>styleStateEnum</STRONG></TD>
    <TD>normal, highlight</TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#stylemap">&lt;StyleMap&gt;</A></TD></TR>
  <TR>
    <TD><STRONG>unitsEnum</STRONG></TD>
    <TD>fraction, pixels, insetPixels </TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#hotspot">&lt;hotSpot&gt;</A>=20
      in &lt;IconStyle&gt;, <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#screenoverlay">&lt;ScreenOverlay&gt;</A></TD></TR>
  <TR>
    <TD><STRONG>vec2</STRONG></TD>
    <TD>x=3D<EM>double</EM> =
xunits=3D<EM>kml:unitsEnum</EM><BR>y=3D<EM>double</EM>=20
      yunits=3D<EM>kml:unitsEnum</EM></TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#hotspot">&lt;hotSpot&gt;</A>=20
      in &lt;IconStyle&gt;, <BR><A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#screenoverlay">&lt;ScreenOverlay&gt;</A>=20
    </TD></TR>
  <TR>
    <TD><STRONG>viewRefreshEnum</STRONG></TD>
    <TD>never, onRequest, onStop, onRegion </TD>
    <TD>See <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#link">&lt;Link&gt;</A>=20
    </TD></TR></TBODY></TABLE>
<H2>&nbsp;</H2>
<H2><A class=3Danchor id=3Dabstractview=20
name=3Dabstractview></A>&lt;AbstractView&gt;</H2>
<H3>Syntax </H3><PRE>&lt;!-- abstract element; do not create --&gt;
<STRONG>&lt;!--<EM> AbstractView</EM> --&gt;</STRONG>                   =
&lt;!-- Camera, LookAt --&gt;               =20
  &lt;!-- extends <SPAN class=3Dstyle1>Object</SPAN> --&gt;
  <EM>&lt;TimePrimitive&gt;...&lt;/TimePrimitive&gt;</EM>                =
        &lt;!-- gx:TimeSpan or gx:TimeStamp --&gt;
<STRONG>&lt;-- /<EM>AbstractView</EM> --&gt;</STRONG></PRE>
<H3>Description </H3>
<P>This is an abstract element and cannot be used directly in a KML =
file. This=20
element is extended by the <A=20
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#camera">&lt;Camera&gt;</A>=20
and <A=20
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#lookat">&lt;LookAt&gt;</A>=20
elements. </P>
<H3>Extends</H3>
<UL>
  <LI><A=20
  =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#object">&lt;Object&gt;</A>=20
  </LI></UL>
<H3>Extended By</H3>
<UL>
  <LI><A=20
  =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#camera">&lt;Camera&gt;</A>=20

  <LI><A=20
  =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#lookat">&lt;LookAt&gt;</A>=20
  </LI></UL>
<H2><A name=3Dgxaltitudemode></A>&lt;gx:altitudeMode&gt;</H2>
<TABLE class=3Dnote width=3D"60%">
  <TBODY>
  <TR>
    <TD class=3Dnote>This element is an extension of the <A=20
      href=3D"http://www.opengeospatial.org/standards/kml/">OGC KML 2.2=20
      standard</A> and is supported in Google Earth 5.0. <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#kmlextensions">Learn=20
      more</A></TD></TR></TBODY></TABLE>
<H3>Syntax</H3><PRE>&lt;gx:altitudeMode&gt;clampToGround&lt;/gx:altitudeM=
ode&gt;   =20
  &lt;!-- gx:altitudeModeEnum: <EM>relativeToSeaFloor, =
clampToSeaFloor</EM>, <EM>relativeToGround</EM>, <EM>clampToGround</EM>, =
<EM>absolute</EM> --&gt;</PRE>
<H3>Description</H3>
<P>Can be used instead of the OGC KML standard =
<CODE>&lt;altitudeMode&gt;</CODE>=20
element, and accepts the following values in addition to the standard=20
altitudeMode values:</P>
<UL>
  <LI><STRONG>relativeToSeaFloor</STRONG> - Interprets the altitude as a =
value=20
  in meters above the sea floor. If the KML feature is above land rather =
than=20
  sea, the altitude will be interpreted as being above the ground.=20
  <LI><STRONG>clampToSeaFloor</STRONG> - The altitude specification is =
ignored,=20
  and the KML feature will be positioned on the sea floor. If the KML =
feature is=20
  on land rather than at sea, <STRONG>clampToSeaFloor</STRONG> will =
instead=20
  clamp to ground. </LI></UL>
<P>As with <CODE>&lt;altitudeMode&gt;</CODE>,=20
<CODE>&lt;gx:altitudeMode&gt;</CODE> affects:</P>
<UL>
  <LI>the altitude coordinate within the =
<CODE>&lt;coordinates&gt;</CODE>=20
  element=20
  <LI><CODE>&lt;minAltitude&gt;</CODE> and =
<CODE>&lt;maxAltitude&gt;</CODE>=20
  within <CODE>&lt;LatLonAltBox&gt;</CODE>=20
  <LI><CODE>&lt;altitude&gt;</CODE> within =
<CODE>&lt;Location&gt;</CODE>,=20
  <CODE>&lt;GroundOverlay&gt;</CODE>, and <CODE>AbstractView</CODE>=20
  (<CODE>&lt;LookAt&gt;</CODE> and <CODE>&lt;Camera&gt;</CODE>). =
</LI></UL>
<P>More information about altitude modes is available in the <A=20
href=3D"http://code.google.com/apis/kml/documentation/altitudemode.html">=
Altitude=20
Modes</A> chapter of the <STRONG>KML Developer's Guide</STRONG>.=20
<H3>Example</H3>
<P><IMG height=3D16 alt=3D""=20
src=3D"http://code.google.com/apis/kml/documentation/Images/kml_feed_smal=
l.png"=20
width=3D16>&nbsp;<A=20
href=3D"http://code.google.com/apis/kml/documentation/kmlfiles/altitudemo=
de_reference.kml">altitudemode_reference.kml</A></P><PRE>&lt;?xml =
version=3D"1.0" encoding=3D"UTF-8"?&gt;
&lt;kml xmlns=3D"http://www.opengis.net/kml/2.2"
 xmlns:gx=3D"http://www.google.com/kml/ext/2.2"&gt;   &lt;!-- required =
when using gx-prefixed elements --&gt;

&lt;Placemark&gt;
  &lt;name&gt;gx:altitudeMode Example&lt;/name&gt;
  &lt;LookAt&gt;
    &lt;longitude&gt;146.806&lt;/longitude&gt;
    &lt;latitude&gt;12.219&lt;/latitude&gt;
    &lt;heading&gt;-60&lt;/heading&gt;
    &lt;tilt&gt;70&lt;/tilt&gt;
    &lt;range&gt;6300&lt;/range&gt;
    =
<STRONG>&lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;=
</STRONG>
  &lt;/LookAt&gt;
  &lt;LineString&gt;
    &lt;extrude&gt;1&lt;/extrude&gt;
    &lt;gx:altitudeMode&gt;relativeToSeaFloor&lt;/gx:altitudeMode&gt;
    &lt;coordinates&gt;
      146.825,12.233,400
      146.820,12.222,400
      146.812,12.212,400
      146.796,12.209,400
      146.788,12.205,400
    &lt;/coordinates&gt;
  &lt;/LineString&gt;
&lt;/Placemark&gt;

&lt;/kml&gt;
</PRE>
<P>&nbsp;</P>
<H2><A name=3Dgxanimatedupdate></A>&lt;gx:AnimatedUpdate&gt;</H2>
<TABLE class=3Dnote width=3D"60%">
  <TBODY>
  <TR>
    <TD class=3Dnote>This element is an extension of the <A=20
      href=3D"http://www.opengeospatial.org/standards/kml/">OGC KML 2.2=20
      standard</A> and is supported in Google Earth 5.0. <A=20
      =
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#kmlextensions">Learn=20
      more</A></TD></TR></TBODY></TABLE>
<H3>Syntax</H3><PRE>&lt;gx:AnimatedUpdate&gt;
  &lt;gx:duration&gt;0.0&lt;/gx:duration&gt;    &lt;!-- double, =
specifies time in seconds --&gt;
  &lt;Update&gt;
    &lt;targetHref&gt;...&lt;/targetHref&gt;    &lt;!-- required; can =
contain a URL or be left blank --&gt;
                                                &lt;!-- (to target =
elements within the same file --&gt;
    &lt;Change&gt;...&lt;/Change&gt;
    &lt;Create&gt;...&lt;/Create&gt;
    &lt;Delete&gt;...&lt;/Delete&gt;
  &lt;/Update&gt;
&lt;/gx:AnimatedUpdate&gt;</PRE>
<H3>Description </H3>
<P><CODE>&lt;gx:AnimatedUpdate&gt;</CODE> controls changes during a tour =
to KML=20
features, using <CODE><A=20
href=3D"http://code.google.com/intl/zh-CN/apis/kml/documentation/kmlrefer=
ence.html#update">&lt;Update&gt;</A></CODE>.=20
Changes to KML features will not modify the DOM - that is, any changes =
will be=20
reverted when the tour is over, and will not be saved in the KML at any=20
time.</P>
<P><CODE>&lt;gx:AnimatedUpdate&gt;</CODE> should also contain a=20
<CODE>&lt;gx:duration&gt;</CODE> value to specify the length of time in =
seconds=20
over which the update takes place. Integer, float, and color fields are =
smoothly=20
animated from original to new value across the duration; boolean, =
string, and=20
other values that don't lend to interpolation are updated at the end of =
the=20
duration.</P>
<P>Refer to <A=20
href=3D"http://code.google.com/apis/kml/documentation/touring.html#tourti=
melines">Tour=20
timelines</A> in the <STRONG>Touring</STRONG> chapter of the <STRONG>KML =

Developer's Guide</STRONG> for information about=20
<CODE>&lt;gx:AnimatedUpdate&gt;</CODE> and the tour timeline.</P>
<H3>Example</H3>
<P>The example below demonstrates a change in icon size. This change =
will be=20
animated over a 5 second duration.</P>
<P><IMG height=3D16 alt=3D""=20
src=3D"http://code.google.com/apis/kml/documentation/Images/kml_feed_smal=
l.png"=20
width=3D16>&nbsp;<A=20
href=3D"http://code.google.com/apis/kml/documentation/kmlfiles/animatedup=
date_example.kml">animatedupdate_example.kml</A></P><PRE>&lt;?xml =
version=3D"1.0" encoding=3D"UTF-8"?&gt;
&lt;kml xmlns=3D"http://www.opengis.net/kml/2.2"
 xmlns:gx=3D"http://www.google.com/kml/ext/2.2"&gt