KML 參考資料

本節包含由 KML 2.2 版定義的所有 KML 元素,以及 Google 擴充功能命名空間中所含的字母/參照資料。KML 元素的類別樹狀結構如下所示。在樹狀圖中,樹狀結構中特定分支版本的右側元素是左側元素的「擴充功能」。例如,地標是特殊的 Feature 類型。其中包含屬於地圖項目的所有元素,並加入一些與地標元素專屬的元素。

KML 是開放式的開放標準,名為 OpenGIS® KML 編碼標準 (OGC KML)。由 Open Geospatial Consortium, Inc. (OGC) 維護。您可以在 http://www.opengeospatial.org/standards/KML/ 參閱 OGC KML 的完整規格。

KML 的完整 XML 架構位於 http://schemas.opengis.net/KML/

注意:按一下圖表中的元素名稱,即可直接跳到該參考資料部分中的項目。

課程樹狀圖 物件元素 (父項) gx:導覽元素;特徵的子項 NetworkLink 元素;特徵的子項 地標元素;特徵的子項 重疊元素;特徵的子項 容器元素;特徵的子項 特徵元素 幾何圖形元素;物件的子項 PhotoOverlay 元素;疊加層子項 ScreenOverlay;重疊廣告的下層 GroundOverlay 元素;疊加層子項 資料夾元素;容器的子項 文件元素;容器的子項 點元素;幾何圖形的子項 LineString 元素;幾何圖形中的子項 LinearRing 元素;幾何圖形中的子項 連結元素:物件的子項 圖示元素;Link 的子項 方向元素;物件子項 位置元素;物件子項 比例元素;物件子項 多邊形元素;幾何圖形之子項 多重幾何圖形元素;幾何圖形的子項 模型元素;多重幾何圖形的子項 gx:Track 元素;幾何圖形的子項 樣式元素;StyleSelector 的子項 gx:MultiTrack 元素;幾何圖形的子項 StyleSelector 元素;物件的子項 StyleMap 元素;樣式選取器的子項 TimePrimitive 元素;物件的子項 TimeSpan 元素;TimePrimitive 的子項 gx:TimeStamp AbstractView 元素;物件的子項 相機元素;AbstractView 的子項 LookAt 元素;AbstractView 的子項 區域元素;物件的子項 Lod 元素;物件的子項 LatLonBox 元素;物件的子項 LatLonAltBox 元素;物件的子項 gx:LatLonQuad 元素;物件的物件 SubStyle 元素;物件副本 BalloonStyle 元素;SubStyle 的子項 ColorStyle 元素;SubStyle 的子項 ListStyle 元素;SubStyle 的子項 gx:TimeSpan 元素;TimeSpan 的子項 TimeStamp 元素;TimePrimitive 的子項 LineStyle 元素;ColorStyle 的子項 PolyStyle 元素;ColorStyle 的子項 IconStyle 元素;ColorStyle 的子項 LabelStyle 元素;ColorStyle 的子項 gx:TourPrimitive 元素;物件的子項 gx:動畫更新 gx:FlyTo 元素;TourPrimitive 的子項 gx:SoundCue 元素; TourPrimitive 的子項 gx:TourControl 元素;gx:TourPrimitive 的子項 gx:Wait 元素;gx:TourPrimitive 的子項 gx:PlayList 元素;物件的子項

請注意,KML 檔案實際上並未使用抽像元素 (如圖中的方塊所示)。這是一種單一元素,可做為多個相似 (但不同) 衍生元素的程式輔助基礎。瞭解這個物件導向的階層也有助於瞭解 KML,因為您可以輕鬆查看相關元素的分組。

Object 衍生的所有元素皆可獲得指派的 id。KML 更新機制 (請參閱 <Update>) 會使用透過 NetworkLink 載入的檔案來使用這個 id。它也由共用樣式使用 (請見 <Style>)。id 是標準的 XML ID

由於 KML 是 XML 文法和檔案格式,因此標記名稱有大小寫之分,且必須如此處所示。如果您熟悉 XML,也很有興趣瞭解 KML 2.2 架構。編輯 KML 文字檔案時,您可以將這個結構定義載入任何 XML 編輯器,然後透過該 KML 驗證 KML 程式碼。

提示:檢視 KML 以檢視 Google 地球功能

「Google 地球」的便利功能讓您可輕鬆檢視任何地圖項目的 KML 檔案,在「Google 地球」中的 [位置] 面板中,於 [地圖項目] 上按一下滑鼠右鍵,即可複製該地圖項目。如要查看複製物件的對應 KML,請開啟您慣用的文字編輯器,並將選取項目貼到其中。

相容性

KML 版本具備雙編號系統:majorVersion.minorVersion。所有具有相同 majorVersion 的版本都相容。因此,如果您將命名空間變更為「2.2」(也就是 xmlns="http://www.opengis.net/kml/2.2"),則所有 KML 2.1 檔案都必須在 KML 2.2 架構中進行驗證。

關於此參考資料

每個參照項目都包含一個語法區段,其中列出主要元素中包含的元素。這個「語法」區段是非正式的列表,採用簡單的簡短摘要來概述元素。這個部分也包含下列內容:

  • 每個元素的預設值 (如果是複雜元素,則沒有刪節號)
  • 值的 type (請參閱 KML 欄位)

您可以複製「語法」區段,並做為 KML 檔案內所有非抽像元素的範本。

KML 擴充功能命名空間和 gx 前置字元

OGC KML 標準提供擴充功能的機制,其中包含其他元素以外的資訊 (進一步瞭解 w3.org 上的 XML 命名空間)。隨著「Google 地球」5.0 版正式推出,Google 提供了 KML 的擴充功能,以支援多項新功能。這些擴充功能使用 gx 前置字串和下列命名空間 URI:

 xmlns:gx="http://www.google.com/kml/ext/2.2"

任何命名空間 URI 都必須透過使用 gx- 前置字元的元素在任何 KML 檔案的 <kml> 元素中加入:

<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

並非所有地理瀏覽器都支援 KML 擴充功能。如果您的瀏覽器不支援特定擴充功能,請自動忽略這些擴充功能中的資料,且其他 KML 檔案應可正常載入。

目前使用 gx 前置字元的元素如下:

這個擴充功能命名空間元素的完整 XML 架構位於 http://developers.google.com/KML/schema/KML22gx.xsd

KML 欄位

KML 使用常見的 XML 類型,例如 布林 (值)、字串、雙精度浮點 (浮點)、浮點 (float)整數。此外,KML 也定義了多個欄位元素類型。下表列出 KML 中定義的一些常用類型,並提供這些類型之元素元素的連結:

欄位類型 使用範例
heightModeEnum clampToGround、relativeToGround、絕對值 查看<LookAt><Region>
角度 90 值 ≥-90 和 ≤90 請查看<Model>的<緯度>
anglepos9 值為 ≥0 且 ≤90 查看 <LookAt> 的 <tilt>
角度 180 值 ≥-180 和 ≤180 請查看<Model>的「<經度>
角度 360 值為 ≥-360 且 ≤360 請在 <Orientation> 中查看 <heading>
顏色 十六進位二進位檔值:aabbggrr 查看延伸 <ColorStyle> 的任何元素
色彩模式 Enum 正常,隨機 查看延伸 <ColorStyle> 的任何元素
日期時間 dateTime、date、gYearMonth、gYear 請參閱 <TimeSpan><TimeStamp>
displayModeEnum 預設、隱藏 請參閱 <BalloonStyle>
gridOrigin lowerLeft、upLeft 詳情請參閱 <PhotoOverlay>
RefreshModeEnum onChange, onInterval, onExpire 請參閱 <Link>
shapeEnum 矩形、圓柱、球體 詳情請參閱 <PhotoOverlay>
styleStateEnum 正常,醒目顯示 查看 <StyleMap>
單位 分數, 像素, insetPixels 查看 <IconStyle> 和 <ScreenOverlay><hotSpot>
vec2 x=double xunits=KML:unitsEnum
y=double yunits=KML:unitsEnum
查看 <IconStyle> 中的 <hotSpot>
<ScreenOverlay>
viewRefreshEnum 永不、onRequest、onStop、onRegion 請參閱 <Link>

 

<AbstractView>

語法

<!-- abstract element; do not create -->
<!-- AbstractView -->                       <!-- Camera, LookAt -->
  <!-- extends Object -->
  <TimePrimitive>...</TimePrimitive>        <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <gx:option name="" enabled=boolean />   <!-- name="streetview",
                                                      "historicalimagery",
                                                   or "sunlight" -->
  </gx:ViewerOptions>
<-- /AbstractView -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。這個元素以 <Camera><LookAt> 元素延伸。

擴充

AbstractView 專用的元素

<gx:ViewerOptions>
這個元素可在 Google 地球 6.0 以上版本中使用特殊的觀看模式。包含一或多個 <gx:option> 子元素。<gx:option> 元素具有 name 屬性和 enabled 屬性。「name」指定下列其中一項:街景服務圖像 (「街景服務」)、歷史圖像 (「歷史史」) 以及特定時段的日光效果 (「日光」)。enabled 屬性是用來開啟或關閉指定的檢視模式。
<gx:horizFov>
定義導覽期間,AbstractView 的水平視野。這個元素對導覽外的 AbstractView 沒有影響。Google 地球用戶端 (6.1 以上版本) 會在遊覽錄製期間自動插入 <gx:horizFov>。一般 AbstractViews 被指定的值為 60,而街景服務中的檢視畫面值則是 85,以符合 Google 地球的標準街景服務欄位。設定完畢後,該值就會套用至後續的檢視畫面,直到指定新的值為止。

已擴充

<gx:heightMode>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:altitudeMode>clampToGround</gx:altitudeMode>
  <!-- gx:altitudeModeEnum: relativeToSeaFloor, clampToSeaFloor, relativeToGround, clampToGround, absolute -->

說明

您可以使用 OGC KML 標準 <altitudeMode> 元素來代替 OGC KML 標準元素,除了標準 ElevationMode 值之外,也接受以下值:

  • relativeToSeaFloor:將高度解讀為以公尺為單位的高度。如果 KML 功能在陸地上,而不是海平面,系統會將高度視為地上。
  • clampToSeaFloor - 系統會略過高度規格,同時將 KML 功能放置在海平面上。如果 KML 功能在陸上而非海上,則 clampToSeaFloor 會改為採用地面。

<altitudeMode> 一樣,<gx:altitudeMode> 會影響:

  • <coordinates> 元素內的高度座標
  • <LatLonAltBox> 中的 <minAltitude><maxAltitude>
  • <Location><GroundOverlay>AbstractView 中的 <altitude> (<LookAt><Camera>)。

如要進一步瞭解高度模式,請參閱 KML 開發人員指南的「高度模式」章節。

範例

heightmode_reference.gp

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">   <!-- required when using gx-prefixed elements -->

<Placemark>
  <name>gx:altitudeMode Example</name>
  <LookAt>
    <longitude>146.806</longitude>
    <latitude>12.219</latitude>
    <heading>-60</heading>
    <tilt>70</tilt>
    <range>6300</range>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
  </LookAt>
  <LineString>
    <extrude>1</extrude>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
    <coordinates>
      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
    </coordinates>
  </LineString>
</Placemark>

</kml>

 

<gx:AnimatedUpdate>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:AnimatedUpdate id="ID">
  <gx:duration>0.0</gx:duration>     <!-- double, specifies time in seconds -->
  <Update>
    <targetHref>...</targetHref>     <!-- required; can contain a URL or be left blank -->
                                      <!-- (to target elements within the same file) -->
    <Change>...</Change>
    <Create>...</Create>
    <Delete>...</Delete>
  </Update>
  <gx:delayedStart>0</gx:delayedStart>  <!-- double, specifies time in seconds -->
</gx:AnimatedUpdate>

說明

<gx:AnimatedUpdate> 會使用 <Update> 控制導覽 KML 功能期間的異動。對 KML 功能所做的變更不會修改 DOM,也就是說,只要導覽結束後,所有變更都會還原,且一律不會儲存在 KML 中。

<gx:AnimatedUpdate> 也應包含 <gx:duration> 值,以指定更新作業進行的時間長度 (以秒為單位)。整數、浮點及顏色欄位會在整個期間順暢地以原始格式繪製到新的值;布林 (值)、字串 (及其他) 與內插值無關的值則會在持續時間結束時更新。

如要進一步瞭解 <gx:AnimatedUpdate> 和遊覽行程,請參閱 KML 開發人員指南中「遊覽」章節的「導覽時間表」

<gx:duration>
指定更新作業的時間長度 (以秒為單位)。
<gx:delayedStart> >
指定在開始更新前,必須等待的秒數 (內嵌起始位置後方)。

範例

以下範例說明圖示大小的變化。這項變更會在 5 秒內播放動畫。

animatedupdate_example.KML

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

<Document>
  <name>gx:AnimatedUpdate example</name>

  <Style id="pushpin">
    <IconStyle id="mystyle">
<Icon>
<href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href> <scale>1.0</scale>
</Icon>
</IconStyle>
</Style> <Placemark id="mountainpin1"> <name>Pin on a mountaintop</name> <styleUrl>#pushpin</styleUrl>
<Point>
<coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
</Point> </Placemark> <gx:Tour> <name>Play me!</name> <gx:Playlist> <gx:FlyTo>
<gx:flyToMode>bounce</gx:flyToMode>
<gx:duration>3</gx:duration>
<Camera>
<longitude>170.157</longitude>
<latitude>-43.671</latitude>
<altitude>9700</altitude>
<heading>-6.333</heading>
<tilt>33.5</tilt>
</Camera>
</gx:FlyTo> <gx:AnimatedUpdate> <gx:duration>5</gx:duration> <Update> <targetHref></targetHref> <Change> <IconStyle targetId="mystyle"> <scale>10.0</scale> </IconStyle> </Change> </Update> </gx:AnimatedUpdate> <gx:Wait> <gx:duration>5</gx:duration> </gx:Wait> </gx:Playlist> </gx:Tour> </Document> </kml>

擴充

包含

<BalloonStyle>

語法

<BalloonStyle id="ID">
  <!-- specific to BalloonStyle -->
  <bgColor>ffffffff</bgColor>            <!-- kml:color -->
  <textColor>ff000000</textColor>        <!-- kml:color -->
  <text>...</text>                       <!-- string -->
  <displayMode>default</displayMode>     <!-- kml:displayModeEnum -->
</BalloonStyle>

說明

指定如何繪製地標的說明框的繪製方式。說明圖示中的 <bgColor> 會做為氣球的背景顏色。請參閱 <Feature> 的圖表,瞭解 Google 地球預設說明的說明框。

BalloonStyle 專用的元素

<bgColor>
氣球的背景顏色 (選填)。顏色和透明度 (Alpha) 值會以十六進位標記法表示。任何顏色的值範圍為 0 到 255 (00ff)。運算式的順序為 aabbggrr,其中 aa=alpha (00 至 ff);bb=blue (00 至 ff);gg=green(00 至 ff);rr=red (00 至 ff)。如果是 Alpha 版,00 會完全透明,ff 完全不透明。例如,如果您想在疊加層中套用透明度為 50% 的藍色顏色,請指定下列內容:<bgColor>7fff0000</bgColor>,其中 alpha=0x7f、blue=0xff、green=0x00 和 red=0x00。預設值為不透明白色 (ffffffff)。

注意:<BalloonStyle> 內的 <color> 元素已淘汰。請改用 <bgColor>。

<textColor>
文字的前景顏色。預設值為黑色 (ff000000)。
<text>
說明框中顯示的文字。如未指定文字,Google 地球會繪製預設氣球 (以粗體標示的地圖項目 <名稱>、功能 <說明>、行車路線連結、白色背景,以及附加在功能點座標 (如有指定) 的尾部。
你可以使用下列格式在 <text> 標記中加入實體,以參照「地圖項目」的子元素:$[name]$[description]$[address]$[id]$[Snippet]。Google 地球會在目前的 Feature 中尋找對應的字串實體,並以資訊框取代該資訊。如要在氣球中加入目的地至此處的行車路線,請使用 $[geDirections] 標記。如要避免出現氣球的連結在說明框中,請加入 <text> 元素和部分內容,或使用 $[description] 取代基本的 <description> 屬性。
舉例來說,下列 KML 摘錄,$[name]$[description] 欄位將由 Ball 中所用的 <name> 和 <description> 欄位取代
<displayMode>
如果 <displayMode> 為預設設定,Google 地球會使用 <text> 提供的資訊來建立氣球。如果 <displayMode> 為 hide,Google 地球就不會顯示說明框。在「Google 地球」中,按一下氣球的 <displayMode> 為隱藏的「地標」的「清單檢視」圖示,就能讓「Google 地球」飛到「地標」。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document> <name>BalloonStyle.kml</name>
<open>1</open>
<Style id="exampleBalloonStyle">
<BalloonStyle>
<!-- a background color for the balloon -->
<bgColor>ffffffbb</bgColor>
<!-- styling of the balloon text -->
<text><![CDATA[
<b><font color="#CC0000" size="+3">$[name]</font></b>
<br/><br/>
<font face="Courier">$[description]</font>
<br/><br/>
Extra text that will appear in the description balloon
<br/><br/>
<!-- insert the to/from hyperlinks -->
$[geDirections]
]]></text>
</BalloonStyle>
</Style>
<Placemark>
<name>BalloonStyle</name>
<description>An example of BalloonStyle</description>
<styleUrl>#exampleBalloonStyle</styleUrl>
<Point>
<coordinates>-122.370533,37.823842,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

擴充

包含

返回頁首

<gx:balloonVisibility>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:balloonVisibility>0</gx:balloonVisibility>    <!-- 0 (not visible) or 1 (visible) -->

說明

切換說明框的瀏覽權限。待更新氣球必須透過物件的 XML ID 識別 (例如 <Placemark targetId="xxx">)。

範例

第一個範例顯示包含地標的 <gx:balloonVisibility>。地標載入後,說明框就會開啟。
balloonvisibility_example.KML

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 

This description balloon opens
when the Placemark is loaded. </description> <gx:balloonVisibility>1</gx:balloonVisibility> <Point> <coordinates>2.294785,48.858093,0</coordinates> </Point> </Placemark> </kml>

第二個範例說明在導覽中使用 <gx:balloonVisibility>。巡迴演出期間開啟和關閉許多氣球,提供觀眾資訊。
balloonvisibility_tourexample.KML

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>balloonVisibility Example</name>
    <open>1</open>

    <gx:Tour>
      <name>Play me</name>
      <gx:Playlist>

        <gx:FlyTo>
          <gx:duration>8.0</gx:duration>
          <gx:flyToMode>bounce</gx:flyToMode>
          <LookAt>
            <longitude>-119.748584</longitude>
            <latitude>33.736266</latitude>
            <altitude>0</altitude>
            <heading>-9.295926</heading>
            <tilt>84.0957450</tilt>
            <range>4469.850414</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.782630</longitude>
            <latitude>33.862855</latitude>
            <altitude>0</altitude>
            <heading>-9.314858</heading>
            <tilt>84.117317</tilt>
            <range>6792.665540</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.849578</longitude>
            <latitude>33.968515</latitude>
            <altitude>0</altitude>
            <heading>-173.948935</heading>
            <tilt>23.063392</tilt>
            <range>3733.666023</range>
            <altitudeMode>relativeToGround</altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="onland">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>

    <Placemark id="underwater1">
      <name>Underwater off the California Coast</name>
      <description>
        The tour begins near the Santa Cruz Canyon,
        off the coast of California, USA.
      </description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.749531,33.715059,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="underwater2">
      <name>Still swimming...</name>
      <description>We're about to leave the ocean, and visit the coast...</description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.779550,33.829268,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="onland">
      <name>The end</name>
      <description>
        <![CDATA[The end of our simple tour.
        Use <gx:balloonVisibility>1</gx:balloonVisibility>
        to show description balloons.]]>
      </description>
      <Point>
        <coordinates>-119.849578,33.968515,0</coordinates>
      </Point>
    </Placemark>


  </Document>
</kml>

擴充

<相機>

語法

<Camera id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to Camera -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos180 -->
  <roll>0</roll>                      <!-- kml:angle180 -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute -->
        <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
</Camera> 

說明

定義檢視場景的虛擬相機。這項元素可定義相機相對於地球表面的位置,以及相機的檢視方向。攝影機位置由 <經度>、<緯度>、<海拔高度> 以及 <海拔高度模式> 或 <gx:海拔高度模式定義。相機的檢視方向由 <heading>、<tilt> 及 <roll> 定義。<Camera> 可以是任何 Feature 或 <NetworkLinkControl> 的子項元素。a<<相機名稱>> 相同。

<Camera> 提供 6 自由度的視圖自由度控制選項,因此您可以將相機放置在空間內,然後沿著 XYZ 軸旋轉。最重要的是,你可以傾斜相機鏡頭,將天地的視角俯瞰天空。

<Camera> 也可能包含 TimePrimitive (<gx:TimeSpan> 或 <gx:TimeStamp>)。「相機」中的時間值會影響歷史圖像、日光,或有時間戳記效果的功能顯示。如需詳細資訊,請參閱《開發人員指南》中「時間與動畫」章節中的「搭配 AbstractViews 的時間」。

定義檢視

在 Feature 或 <NetworkLinkControl> 中,使用 <Camera> 或 <LookAt> 物件 (但不得同時使用同一個物件)。<Camera> 物件會根據檢視者的位置和方向定義檢視點。<Camera> 物件可讓您指定不在地球表面上的視圖。<LookAt> 物件可依據使用者正在檢視的內容定義檢視點。<LookAt> 物件的範圍比 <Camera> 更為有限,且通常要求檢視方向與地球表面相交。

下圖顯示連接至虛擬相機的 XYZ 軸。

  • X 軸指向相機右側,稱為右側向量
  • Y 軸可定義與螢幕相關的「向上」方向,也稱為 向上向量
  • 「Z」軸從螢幕中央朝向眼點。攝影機往下看 --Z 軸,也就是檢視向量

轉換順序

輪播順序很重要。在預設狀態下,攝影機會朝地球的方向向下看 -Z 軸。在旋轉之前,相機沿著 Z 軸轉譯為 <海拔高度>。轉換順序如下所示:

  1. <altitude> - 沿著 Z 軸平移至 <海拔高度>
  2. <heading> - 沿著「Z」軸旋轉。
  3. <tilt> - 圍繞「X」軸
  4. <roll> - 再旋轉「Z」軸。

請注意,每次套用旋轉方向時,兩個相機軸的方向都會改變方向。

相機專用的元素

<longitude>
虛擬相機的經度 (眼點)。相對於本初子午線的角度距離角度。Meridian 西方的值介於 -180 到 0 度之間。梅里達文的東方值介於 0 到 180 度之間。
<latitude>
虛擬相機的位置。度量等於赤道以南或南度 (0 度)。這個值的範圍介於 -90 度到 90 度之間。
<altitude>
相機與地球表面之間的距離,單位為公尺。依照相機的 <海拔高度模式> 或 <gx:海拔高度模式> 解讀。
<heading>
攝影機的方向 (方位角度),以度為單位。Default=0 (true North)。(請參閱圖表)。範圍從 0 到 360 度。
<tilt>
相機沿著 X 軸旋轉的度數 (以度為單位)。如果這個值為 0,表示將檢視畫面直接朝向地球 (最常見的情況)。如果 <tilt> 的值為 90,表示檢視畫面正以水平顯示。如果值超過 90,表示檢視畫面指向天空。<tilt> 的值會固定在 +180 度以上。
<roll>
相機沿著 Z 軸旋轉的度數 (以度為單位)。這個值的範圍介於 -180 至 +180 度之間。
<altitudeMode>
指定系統為相機指定的 <海拔高度> 的解讀方式。可能的值如下:
  • relativeToGround - (預設) 將 <height> 解讀為地面上公尺內的值。如果該點超過水位,系統會將 <海拔高度> 解讀為高於海平面的公尺值。請參閱下方的 <gx:heightMode> 來指定相對於海平面的點。
  • clampToGround - 對相機而言,這項設定也會將相機放置在 relativeToGround,因為將相機置於地形高度時,表示眼睛與地形相交 (檢視區塊也會遭到封鎖)。
  • 絕對 - 將 <海拔高度> 的值呈現為高於海平面的單位值。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <Elevation> 規格,且攝影機會放置在海床上。如果攝影機位於陸上而非海上,攝影機就會定位在地面上。

擴充

包含

返回頁首

<ColorStyle>

語法

<!-- abstract element; do not create -->
<!-- ColorStyle id="ID" -->          <!-- IconStyle,LabelStyle,LineStyle,PolyStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->
<!-- /ColorStyle -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。提供用來指定擴充樣式類型的色彩和色彩模式的元素。

ColorStyle 專用的元素

<color>
顏色和透明度 (Alpha) 值會以十六進位標記法表示。任何顏色的值範圍是 0 到 255 (00ff)。如果是 Alpha,00 是完全透明的,ff 則是完全不透明。運算式的順序為 aabbggrr,其中 aa=alpha (00 至 ff);bb=blue (00 至 ff);gg=green (00 至 ff);rr=red (00 至 ff)。舉例來說,如果您想要在疊加層中套用透明度為 50% 的藍色顏色,請指定下列內容:<color>7fff0000</color>,其中 alpha=0x7f、blue=0xff、green=0x00 和 red=0x00。
<colorMode>
<colorMode> 的值為 normal (無效果) 和 random。「隨機」的值是將隨機線性比例套用至基本 <color>,如下所示。
  • 如要隨機選取顏色,請指定白色 (ffffffff) 的基礎 <color>。
  • 如果您指定一個單一色彩元件 (例如,red 的值為 ff0000ff),系統會選取該元件 (紅色) 的隨機色彩值。在這個範例中,這個值的範圍介於 00 (black) 到 ff (full red) 之間。
  • 如果您針對這兩個顏色元件指定值,或是同時為這三種色彩元件指定任何隨機線性比例,則系統會隨機套用線性比例比例,並將結果範圍從黑色到各元件的最大值。
  • 色彩的不透明度來自 <color> 的 alpha 元件,且永遠不會隨機產生。

擴充

擴充者

返回頁首

<容器

語法

<!-- abstract element; do not create -->
<!-- Container id="ID" -->              <!-- Document,Folder -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <address>...</address>                <!-- string -->
  <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">...
</AddressDetails> <!-- string --> <phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- LookAt or Camera --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <atom:author>...<atom:author> <!-- xmlns:atom="http://www.w3.org/2005/Atom" --> <atom:link href=" "/> <!-- specific to Container -->
<!-- 0 or more Features --> <!-- /Container -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。容器元素包含一或多項特徵,並允許建立巢狀階層。

擴充

擴充者

返回頁首

<Document>

語法

<Document id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                 <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to Document --> <!-- 0 or more Schema elements --> <!-- 0 or more Feature elements --> </Document>

說明

文件是一種功能與樣式的容器,如果您的 KML 檔案使用了共用樣式,則此為必要元素。建議您使用共用樣式,因此必須完成以下步驟:

  1. 定義文件中的所有樣式。為每個樣式指定專屬的 ID
  2. 在特定 Feature 或 StyleMap 中,使用 <styleUrl> 元素參照樣式的 ID。

請注意,文件中的功能不會沿用共用樣式。

每項功能都必須明確參照 <styleUrl> 元素中使用的樣式。如果是文件適用的樣式 (例如 ListStyle),文件本身必須明確參照 <styleUrl>。例如:

<Document>
  <Style id="myPrettyDocument">
   <ListStyle> ... </ListStyle>

  </Style>
  <styleUrl#myPrettyDocument">
  ...
</Document> 

不要將共用樣式放入資料夾。

以下範例說明如何使用共用樣式。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Document.kml</name>
<open>1</open> <Style id="exampleStyleDocument">
<LabelStyle>
<color>ff0000cc</color>
</LabelStyle>
</Style>
<Placemark>
<name>Document Feature 1</name>
<styleUrl>#exampleStyleDocument</styleUrl>
<Point>
<coordinates>-122.371,37.816,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>Document Feature 2</name>
<styleUrl>#exampleStyleDocument</styleUrl>
<Point>
<coordinates>-122.370,37.817,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

擴充

包含

返回頁首

<gx:duration>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:duration>0.0</gx:duration>            <!-- double -->

說明

<gx:duration> 會指定事件的時間範圍,藉此擴充 gx:TourPrimitive。時間使用 XML 的 double 資料類型以秒計算。

時間長度和 <gx:FlyTo>

如果 <gx:FlyTo> 元素中含有時間長度,就會指定瀏覽器從上一個點到指定點之間經過的時間。

<gx:FlyTo>
  <gx:flyToMode>bounce</gx:flyToMode>
  <gx:duration>10.2</gx:duration>

  <!-- AbstractView -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

時間長度及 <gx:AnimatedUpdate>

指定更新作業的時間長度。整數、浮點及顏色欄位會在整個期間順暢地以原始格式繪製到新的值;布林 (值)、字串 (及其他) 與內插值無關的值則會在持續時間結束時更新。

<gx:AnimatedUpdate>
  <gx:duration>5.0</gx:duration>
  <Update>

    ....

  </Update>
</gx:AnimatedUpdate>

 

<ExtendedData>

語法

<ExtendedData>                       
<Data name="string">
  <displayName>...</displayName>    <!-- string -->
   <value>...</value>                <!-- string -->
</Data> <SchemaData schemaUrl="anyURI">
<SimpleData name=""> ... </SimpleData>   <!-- string -->
</SchemaData> <namespace_prefix:other>...</namespace_prefix:other> </ExtendedData>

說明

ExtendedData 元素提供三種技巧,可將自訂資料新增至 KML 功能 (NetworkLink、地標、GroundOverlay、PhotoOverlay、ScreenOverlay、文件、資料夾)。這些技巧就是

  • 使用 <Data> 元素新增未輸入的資料/值組合 (基本)
  • 使用 <Schema> 元素宣告新的輸入欄位,然後使用 <SchemaData> 元素 (進階) 進行欄位解析
  • 參照 KML 檔案中的外部命名空間 (基本) 參照其他命名空間定義的 XML 元素

這些技巧可以結合在單一 KML 檔案或 功能中,針對不同的資料進行組合。

如需詳細資訊,請參閱「KML 主題」中的新增自訂資料

ExtendedData 專用的元素

<資料名稱 ="字串">
建立一個未命名的名稱/值組合。名稱可分為兩個版本:namedisplayNamename 屬性可用來識別 KML 檔案中的檔案組合。當 Google 地球顯示格式正確的名稱 (含空格和 HTML 格式) 時,系統就會使用 displayName 元素。在 <BalloonStyle> 的 <text> 元素中,標記 $[name/displayName] 會換成 <displayName>。如果以這個格式取代 <Data> 元素的 name 屬性值 (例如 $[holeYardage]),屬性值會替換為 <value>。根據預設,「地標」名稱與說明框的組合將以 <value> 取代。
<顯示名稱>
選擇性的名稱格式設定版本,用於顯示用途。
<值>
資料集的值。
<Placemark>
  <name>Club house</name>
  <ExtendedData>
    <Data name="holeNumber">
      <value>1</value>
    </Data>
    <Data name="holeYardage">
      <value>234</value>
    </Data>
    <Data name="holePar">
      <value>4</value>
    </Data>
  </ExtendedData>
</Placemark>
<SchemaData schemaUrl="anyURI
這個元素會與 <Schema> 搭配使用,可在 KML 特徵中新增打字的自訂資料。結構定義元素 (由 schemaUrl 屬性識別) 會宣告自訂資料類型。實際資料物件 (「自訂資料」的「執行個體」) 是使用 SchemaData 元素來定義。
<schemaURL> 可以是完整網址、參照外部 KML 檔案中定義的結構定義 ID,或同一個 KML 檔案中定義的結構定義 ID 的參照。以下所有規格均可接受:
schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"
schemaUrl="AnotherFile.kml#my-schema-id"
schemaUrl="#schema-id"   <!-- same file -->
Schema 元素一律為 Document 的子項。ExtendedData 元素是包含自訂資料的 Feature 子項。
<SimpleData name="string">
這個元素會將值指派給由 name 屬性識別的自訂資料欄位。此自訂資料欄位的類型及名稱會在 <Schema> 元素中宣告。
以下是定義兩個自訂資料元素的範例:
<Placemark>
  <name>Easy trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Pi in the sky</SimpleData>
      <SimpleData name="TrailLength">3.14159</SimpleData>
      <SimpleData name="ElevationGain">10</SimpleData>
    </SchemaData>
    </ExtendedData>
    <Point>
      <coordinates>-122.000,37.002</coordinates>
    </Point>
</Placemark>
<Placemark>
  <name>Difficult trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Mount Everest</SimpleData>
      <SimpleData name="TrailLength">347.45</SimpleData>
      <SimpleData name="ElevationGain">10000</SimpleData>
    </SchemaData>
  </ExtendedData>
  <Point>
    <coordinates>-122.000,37.002</coordinates>
  </Point>
</Placemark>
<命名空間名稱:<其他>>
這個元素可讓您新增未輸入的自訂資料。請務必參照您檔案的 <KML> 元素中的命名空間前置字元,或是 <ExtendedData> 元素的屬性,並在每個資料元素的名稱前面加上命名空間前置字元。以這種方式新增的自訂資料會保留在 KML 檔案中,但「Google 地球」並不會以任何方式使用這些資料。並且隨檔案一起儲存。
以下範例說明如何使用「camp」露營區的前置字串:
<ExtendedData xmlns:prefix="camp">
<camp:number>14</camp:number>
<camp:parkingSpaces>2</camp:parkingSpaces>
<camp:tentSites>4</camp:tentSites>
</ExtendedData>

包含

另請參閱

<功能>

語法

<!-- abstract element; do not create -->
<!-- Feature id="ID" -->                <!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <!-- TimeStamp or TimeSpan --> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 -->
<-- /Feature -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。下方圖表顯示「Google 地球」中某個地圖項目的元素。

各項功能專用的元素

<name>
3D 檢視器中顯示的使用者定義文字,顯示為物件標籤 (例如地標、資料夾或 NetworkLink)。
<visibility>
布林值。指定當初始載入時地圖項目是否繪製在 3D 檢視器中。如要讓地圖項目顯示,其所有上階的 <visibility> 標記也必須設為 1。在「Google 地球」清單檢視中,每項功能都具備核取方塊,可讓使用者控制「功能」的顯示設定。
<open>
布林值。指定第一次載入「位置」面板時,文件或資料夾是關閉還是開啟。0=收合 (預設),1=展開。另請參閱 <ListStyle>。這個元素僅適用於文件、資料夾和 NetworkLink。
<atom:author>

KML 2.2 支援新的元素,可在 KML 檔案中加入作者及相關網站的資料。這些資訊會顯示在地理搜尋結果中,包括「Google 地球」瀏覽器 (如「Google 地球」) 及其他應用程式 (例如「Google 地圖」)。KML 中使用的指令碼元素如下:

  • atom:author 元素 - Atom:name 的父項元素
  • atom:name 元素 - 作者的名稱
  • atom:link 元素 - 包含 href 屬性
  • href 屬性 - 包含 KML/KMZ 檔案的網頁網址

這些元素是由 Atom 供稿格式定義。如要查看完整規格資訊,請前往 http://atompub.org (請參閱下方的範例)。

<atom:author> 元素是 <atom:name> 的父項元素,用來指定 KML 功能的作者。

<atom:link href="..." >
指定包含這個 KML 或 KMZ 檔案的網站網址。 您必須在任何包含此元素的 KML 檔案中納入此元素的命名空間:xmlns:atom="http://www.w3.org/2005/Atom" (請參閱下面的範例)。
<address>
字串值,代表以標準街道、城市、州/省和/或郵遞區號寫入的非結構化地址。您可以使用 <address> 標記來指定點的位置,不要使用經緯度座標。(不過,如果您提供 <Point>,優先順序高於 <address>)。若要找出 Google 地球支援這個標記的語言代碼,請前往 Google 地圖說明
<xal:地址詳細資料>
採用 xAL 的結構化地址,或採用 eXtensible Address Language 的國際位址格式標準。KML 只會使用 <xal:AddressDetails> 進行 Google 地圖地理編碼。詳情請參閱 Google Maps API 說明文件Google 地球目前尚未使用這項元素,請改用 <address>。請務必在任何使用此元素的 KML 檔案中納入此元素的命名空間:xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"
<phoneNumber>
代表電話號碼的字串值。這個元素只會用於「Google 地圖行動版」。支援 Java 的行動電話符合業界標準 RFC2806。
詳情請參閱 http://www.ietf.org/rfc /rfc2806.txt。 
<片段 maxLines="2" >
功能的簡短說明。在「Google 地球」中,這項說明會顯示在功能名稱下方的「地點」面板中。如未提供程式碼片段,則會使用 <description> 的前兩行。在「Google 地球」中,如果「地標」同時包含說明和程式碼片段,「地點」面板中的地標下方會顯示 <Snippet>,而「地標」的說明說明框中會顯示 <description>。這個標記不支援 HTML 標記。<snippet> 具有 maxLines 屬性,一個整數可以指定要顯示的行數上限。
<description>

顯示在說明框中的使用者提供內容。

<description> 元素的支援內容已從「Google 地球」4.3 版變更為「5.0 版」。以下列出各個版本的專屬資訊,以及兩者的常見資訊。

Google 地球 5.0 版

「Google 地球」5.0 版 (及更新版本) 支援說明框中的純文字內容,以及完整的 HTML 和 JavaScript。內容描述標記的內容是由 WebKit 開放原始碼網路瀏覽器引擎所轉譯,而且顯示方式與任何以 WebKit 為基礎的瀏覽器相同。

一般限制

一般來說,系統不允許使用本機檔案的連結。這樣可以防止惡意程式碼損害您的系統或存取您的資料。如要允許存取本機檔案系統,請依序選取 [偏好設定] > [允許存取本機檔案和個人資料]。系統一律允許本機檔案系統中的圖片檔連結 (如果包含在 <img> 標記內)。

即使壓縮檔案位於本機檔案系統中,也能存取已壓縮為 KMZ 檔案的內容。

Cookie 已啟用,但基於相同來源政策,本機內容不會與任何其他內容 (包括其他本機內容) 共用網域。

HTML

HTML 主要轉譯出,就像它在 WebKit 瀏覽器中一樣。

直接寫入 KML 的 HTML 時,系統會忽略目標;所有這類連結都會以目標設定設為 _blank 的方式開啟。並忽略任何指定的目標。

不過,iframe 中包含的 HTML 或以 JavaScript 或 DHTML 動態產生的 HTML 均會採用 target="_self" 做為預設值。可以指定其他支援的目標。

您無法透過 iFrame 包含的 HTML 指定 KMZ 檔案、本機錨點連結和 ;flyto 方法的內容。

如果使用者為 iFrame 的寬度指定 width="100%",那麼 iFrame 的寬度將取決於氣球中的所有其他內容;基本上,系統在計算版面配置大小時,應該予以忽略。這項規則也會套用到氣球內的任何其他區塊元素。

JavaScript

系統支援大多數 JavaScript。無法建立對話方塊 - 系統不會顯示 Alert() 和提示()等函式。但會將其寫入系統控制台,其他錯誤和例外狀況也會寫入系統控制台。

CSS

可使用 CSS。如同一般網路瀏覽器中的 CSS,CSS 可用於設定文字、頁面元素的樣式,以及控制說明框的大小和外觀。

Google 地球 4.3 版

<description> 元素支援純文字及部分 HTML 格式設定元素,包括表格 (請參閱下方的 KML 範例)。但不支援其他網頁式技術,例如動態網頁標記 (PHP、JSP、ASP)、指令碼語言 (VBScript、JavaScript),也不支援應用程式語言 (Java、Python)。Google 地球 4.2 版支援影片。(請參閱下方的範例)。

常見資訊

如果你的說明未包含 HTML 標記,Google 地球會嘗試格式化該格式,並以 <br> 取代一行,並以錨定標記換行。全球資訊網的有效網址字串會自動轉換為該網址的超連結 (例如,http://www.google.com)。因此,您不需要用 <a href="http://.."></a> 標記包圍網址,就能取得簡單的連結。

使用 HTML 在特定字詞周圍建立超連結,或是在 HTML 中加入圖片時,您必須使用 HTML 實體參照或 CDATA 元素來逸出角括號、單引號和其他特殊字元。CDATA 元素會指示 XML 剖析器忽略括號中使用的特殊字元。這個元素的格式如下:

<![CDATA[
  special characters here
]]> 

如果不想使用 CDATA 元素,您可以使用實體參照來取代所有特殊字元。

<description>
  <![CDATA[
This is an image
<img src="icon.jpg">
  ]]>
</description>

使用<a>元素指定的其他行為

KML 支援在 <a> 元素中使用兩個屬性:hreftype

錨點元素 <a> 包含指定網址的 href 屬性。

如果 href 是 KML 檔案,並且具有 .jpeg.kmz 副檔名,則 Google 地球會在使用者點選檔案時直接載入。如果網址的結尾是 Google 地球無法辨識的擴充功能 (例如 .html),系統會將網址傳送到瀏覽器。

href 可以是片段網址,也就是有 # 符號,後面接著 KML 識別碼的網址。當使用者點選包含片段網址的連結時,根據預設,瀏覽器會呼叫 ID 與片段相符的功能。如果「地圖項目」包含 LookAt 或相機元素,系統就會從指定的視角檢視該地圖項目。

您可以在片段網址附加下列三個字串中的其中一個,藉此進一步指定行為:

  • ;flyto (預設) - 飛往功能
  • ;balloon - 開啟這項功能的氣球,但不會飛向功能
  • ;balloonFlyto - 開啟這項功能的氣球,飛向這項功能

舉例來說,下列程式碼表示開啟檔案 CraftsFairs.KML,飛到 ID 為「Albuquerque」的地標,然後開啟其說明框:

<description>
  <![CDATA[ 
<a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto">
One of the Best Art Shows in the West</a> ]]> </description>

href 屬性並非以 .map.kmz 結尾,因此 type 屬性用於 <a> 元素內,但必須以 KML 來解讀參照內容。請指定下列項目:

type="application/vnd.google-earth.kml+xml" 

舉例來說,即使副檔名為 .php,下列網址還是會使用 type 屬性通知 Google 地球嘗試載入檔案:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">
<AbstractView>
定義與從「特徵」衍生的任何元素相關聯的檢視點。請參閱 <Camera><LookAt>
<TimePrimitive>
將此功能與一段時間 (<TimeSpan>) 或時間點 (<TimeStamp>) 建立關聯。
<styleUrl>
文件中定義的 <Style><StyleMap> 網址。如果樣式位於同一個檔案中,請使用 # 參照。如果在外部檔案中定義了樣式,請使用完整網址和 # 參照。範例:
<styleUrl>#myIconStyleID</styleUrl>
<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>
<styleUrl>eateries.kml#my-lunch-spot</styleUrl>
<StyleSelector>
您可以定義一個或多個樣式和樣式的樣式,以自訂任何由「地標」或「幾何圖形」幾何圖形所衍生出的元素。(請參閱 <BalloonStyle><ListStyle><StyleSelector><ColorStyle> 衍生的樣式)。定義為 <Document> 子項的樣式稱為「共用樣式」。共用樣式必須具有已定義的 id。這個 ID 是由 <Document> 中的一個或多個特徵參照。如果在共用架構中以「樣式」定義樣式元素,也就是資料夾、GroundOverlay、NetworkLink、Placemark 或 ScreenOverlay 的內嵌樣式,則該地圖項目的內嵌樣式值會優先於共用樣式的值。
<Region>
只有在啟用區域時,系統才會繪製與區域相關聯的功能和幾何圖形。請參閱 <Region>
<Metadata>
<ExtendedData>
可讓您將自訂資料新增至 KML 檔案。此信息可以是 (1) 引用外部 XML 模式、(2) 未打字的設備/值配對或 (3) 打字的設備。特定的 KML 功能可包含這些自訂資料的組合。

在說明中使用 HTML 元素的範例

此範例說明 Google 地球 4.3 版中 <description> 元素支援的一組 HTML 元素。Google 地球 5.0 以上版本支援 HTML 和 JavaScript。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
<name>Feature.kml</name> <Snippet maxLines="4">
The snippet is a way of
providing an alternative
description that will be
shown in the List view.
</Snippet>
<description>
<![CDATA[
Styles: <i>Italics</i>, <b>Bold</b>, <u>Underlined</u>,
<s>Strike Out</s>, subscript<sub>subscript</sub>,
superscript<sup>superscript</sup>,
<big>Big</big>, <small>Small</small>, <tt>Typewriter</tt>,
<em>Emphasized</em>, <strong>Strong</strong>, <code>Code</code>
<hr />
Fonts:
<font color="red">red by name</font>,
<font color="#408010">leaf green by hexadecimal RGB</font>,
<font size=1>size 1</font>, <font size=2>size 2</font>,
<font size=3>size 3</font>, <font size=4>size 4</font>,
<font size=5>size 5</font>, <font size=6>size 6</font>,
<font size=7>size 7</font>,
<font face=times>Times</font>,
<font face=verdana>Verdana</font>,
<font face=arial>Arial</font>
<br/>
<hr />
Links:
<a href="http://doc.trolltech.com/3.3/qstylesheet.html">
QT Rich Text Rendering
</a>
<br />
<hr />
Alignment:
<br />
<p align=left>left</p><p align=center>center</p>
<p align=right>right</p>
<hr />
Ordered Lists:
<br />
<ol><li>First</li><li>Second</li><li>Third</li></ol>
<ol type="a"><li>First</li><li>Second</li><li>Third</li></ol>
<ol type="A"><li>First</li><li>Second</li><li>Third</li></ol>
<hr />
Unordered Lists:
<br />
<ul><li>A</li><li>B</li><li>C</li></ul>
<ul type="circle"><li>A</li><li>B</li><li>C</li></ul>
<ul type="square"><li>A</li><li>B</li><li>C</li></ul>
<hr />
Definitions:
<br />
<dl>
<dt>Scrumpy</dt>
<dd>Hard English cider from the west country</dd>
<dt>Pentanque</dt>
<dd>A form of boules where the goal is to throw metal ball as
close as possible to a jack</dd>
</dl>
<hr />
Block Quote:
<br />
<blockquote>
We shall not cease from exploration<br />
And the end of all our exploring<br />
Will be to arrive where we started<br />
And know the place for the first time
</blockquote>
<br />
<hr />
Centered:
<br />
<center>See, I have a Rhyme assisting<br />
my feeble brain,<br />
its tasks oft-times resisting!</center>
<hr />
Headings:
<br />
<h1>Header 1</h1>
<h2>Header 2</h2>
<h3>Header 3</h3>
<h3>Header 4</h4>
<h3>Header 5</h5>
<hr />
Images:
<br />
<img src="icon.jpg">
and we have a link http://www.google.com.]]> </description> <Point>
<coordinates>-122.378927,37.826793,0</coordinates>
</Point>
</Placemark>
</kml>

處方藥元素使用範例

此範例顯示使用 Atom 命名空間的 <atom:author>、<atom:name> 和 <atom:link> 元素。請注意,您必須在 <KML> 元素中參照此命名空間。

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:atom="http://www.w3.org/2005/Atom"> 
  <Document>
    <atom:author>
      <atom:name>J. K. Rowling</atom:name>
    </atom:author>
    <atom:link href="http://www.harrypotter.com" />
    <Placemark>
      <name>Hogwarts</name>
      <Point>
        <coordinates>1,1</coordinates>
      </Point>
    </Placemark>
    <Placemark>
      <name>Little Hangleton</name>
      <Point>
        <coordinates>1,2</coordinates>
      </Point>
    </Placemark>
  </Document>
</kml>

影片樣本

此範例顯示如何在說明框中嵌入 Flash 影片。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document> <name>Video Example</name>
<Style id="sn_blue-dot_copy3">
<IconStyle>
<Icon>
<href>http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png</href>
</Icon>
</IconStyle>
</Style>
<Placemark>
<name>Placemark</name>
<description>
<![CDATA[<div style="font-size:larger">
<div>
<div style="width: 212px; font-size: 12px;">
<b>The Spaghetti Film</b>
</div>
<div style="font-size: 11px;">
<a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc">
http://www.youtube.com/?v=FICUvrVlyXc</a><br>
</div><br>
<div style="margin-left: auto; margin-right:auto;">
<object height="175" width="212">
<param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie">
<param value="transparent" name="wmode">
<embed wmode="transparent" type="application/x-shockwave-flash"
src="http://www.youtube.com/v/FICUvrVlyXc" height="175"
width="212">

</object>
</div>
</div>
</div>
<div style="font-size: smaller; margin-top: 1em;">Saved from
<a href="http://maps.google.com/ig/add?synd=mpl&pid=mpl&moduleurl=
http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&hl=en&gl=us">
YouTubeVideos</a>
</div>
]]>
</description>
<styleUrl>#sn_blue-dot_copy3</styleUrl>
<Point>
<coordinates>-93.47875999999999,45.083248,0</coordinates>
</Point>
</Placemark>
</Document> </kml>

擴充

擴充者

<gx:FlyTo>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:FlyTo id="ID">
  <gx:duration>0.0</gx:duration>         <!-- double -->
  <gx:flyToMode>bounce</gx:flyToMode>    <!-- smooth or bounce -->
  <!-- AbstractView -->                        <!-- Camera or LookAt -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

說明

<gx:FlyTo> 會指定瀏覽器在導覽期間飛到的某個點。其中必須包含一個 AbstractView,且應包含 <gx:duration><gx:flyToMode> 元素,分別指定從目前點飛往指定點所需的時間,以及航班的方法。

<gx:flyToMode>

<gx:flyToMode> 可以使用兩個值:smoothbounce

  • 流暢」FlyTos 允許不中斷 (或不限) 的不間斷航班。一系列順暢的 FlyTo 系列,將以零的速度開始和結束,而且在各個時間點都不會變慢。一系列光滑的 FlyTos 因下列任何元素而中斷:
    • <gx:flyToMode>bounce</gx:flyToMode>
    • <gx:Wait>
    這表示在上述任一元素之前,流暢的 FlyTo 處理速率將為零。一系列順暢的 FlyTo 並不會因 <gx:AnimatedUpdate> 元素而中斷。

  • 跳出每個 FlyTo 都是以零的速度開始和結束。

示例

<gx:FlyTo>
<gx:duration>2.55</gx:duration>
<gx:flyToMode>smooth</gx:flyToMode>
<Camera>
<longitude>-113.084448</longitude>
<latitude>36.567081</latitude>
<altitude>41277.571403</altitude>
<heading>116.150227</heading>
<altitudeMode>absolute</altitudeMode>
</Camera>
</gx:FlyTo>

擴充

包含

<Folder>

語法

<Folder id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- specific to Folder --> <!-- 0 or more Feature elements --> </Folder>

說明

「資料夾」可用來安排其他「階層」項目 (「資料夾」、「地標」、「NetworkLinks」或「疊加層」)。僅可看見該地圖項目及其所有上階的特徵。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Folder>
<name>Folder.kml</name> <open>1</open>
<description>
A folder is a container that can hold multiple other objects
</description>
<Placemark>
<name>Folder object 1 (Placemark)</name>
<Point>
<coordinates>-122.377588,37.830266,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>Folder object 2 (Polygon)</name>
<Polygon>
<outerBoundaryIs>
<LinearRing>
<coordinates>
-122.377830,37.830445,0
-122.377576,37.830631,0
-122.377840,37.830642,0
-122.377830,37.830445,0
</coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
</Placemark>
<Placemark>
<name>Folder object 3 (Path)</name>
<LineString>
<tessellate>1</tessellate>
<coordinates>
-122.378009,37.830128,0 -122.377885,37.830379,0
</coordinates>
</LineString>
</Placemark>
</Folder>
</kml>

擴充

包含

<幾何圖形>

語法

<!-- abstract element; do not create -->
<!-- Geometry id="ID" -->
                                              <!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model,
                                               gx:Track -->
<!-- /Geometry -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。可為所有衍生的幾何圖形物件提供預留位置物件。

擴充

擴充者

<GroundOverlay>

語法

<GroundOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon>...</Icon> <!-- specific to GroundOverlay --> <altitude>0</altitude> <!-- double --> <altitudeMode>clampToGround</altitudeMode> <!-- kml:altitudeModeEnum: clampToGround or absolute --> <!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor --> <LatLonBox> <north>...</north> <! kml:angle90 --> <south>...</south> <! kml:angle90 --> <east>...</east> <! kml:angle180 --> <west>...</west> <! kml:angle180 --> <rotation>0</rotation> <! kml:angle180 --> </LatLonBox> <gx:LatLonQuad> <coordinates>...</coordinates> <!-- four lon,lat tuples --> </gx:LatLonQuad> </GroundOverlay>

說明

這個元素會繪製出重疊在地形上的影像重疊。<Icon> 的 <href> 子元素會指定要當做疊加層使用的圖片。這個檔案可存放在本機檔案系統或網路伺服器上。如果省略這個元素或不含 <href>,系統會使用區域疊加層定義的色彩和 LatLonBox 邊界繪製矩形。

GroundOverlay 專用的元素

<altitude>
指定地球表面上方距離 (單位為公尺),並依據高度模式解讀。
<altitudeMode>
指定系統如何解讀 <海拔高度>。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格,並重疊在地形上。
  • 絕對 - 設定疊加層相對於海平面的高度,無論元素之下的地形實際海拔高度為何。例如,若您使用絕對高度模式將疊加層的高度設定為 10 公尺,當下方的地形也高於海平面 10 公尺時,疊加層將顯示為地面。如果地形距離海平面 3 公尺,在地形上方會出現 7 公尺的疊加層。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <Elevation> 規格,疊加層會重疊於海平面上。如果點位於地上 (而非大海),疊加層會固定在地面上。
<LatLonBox>
指定區域疊加層的定界框頂端、底部、右側和左側對齊。
  • <north> 指定定界框北端的緯度,以 0 到 ±90 的小數度數表示。
  • <south> 指定定界框南端的緯度,以 0 到 ±90 的小數度數表示。
  • <east> 指定定界框東側邊緣的經度,以 0 到 ±180 的小數度數表示。(如果是與 180° 經度重疊的重疊範圍,值可以超出該範圍)。
  • <west> 指定定界框西側的經度,以 0 到 ±180 的小數度數表示。(如果是與 180° 經度重疊的重疊範圍,值可以超出該範圍)。
  • <rotation> 指定疊加層的中心旋轉角度 (以度為單位)。值可以是 ±180。預設值為 0 (北)。旋轉的方向必須是逆時針方向。
<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox> 
<gx:LatLonQuad>
用於非矩形四邊形區域疊加層。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
<name>GroundOverlay.kml</name>
<color>7fffffff</color>
<drawOrder>1</drawOrder>
<Icon>
<href>http://www.google.com/intl/en/images/logo.gif</href>
<refreshMode>onInterval</refreshMode>
<refreshInterval>86400</refreshInterval>
<viewBoundScale>0.75</viewBoundScale>
</Icon>
<LatLonBox>
<north>37.83234</north>
<south>37.832122</south>
<east>-122.373033</east>
<west>-122.373724</west>
<rotation>45</rotation>
</LatLonBox>
</GroundOverlay>
</kml>

擴充

包含

<Icon>

語法

<Icon id="ID">
  <!-- specific to Icon -->
  <href>...</href>                         <!-- anyURI -->
  <gx:x>0<gx:x/>                           <!-- int -->
  <gx:y>0<gx:y/>                           <!-- int -->
  <gx:w>-1<gx:w/>                          <!-- int -->
  <gx:h>-1<gx:h/>                          <!-- int -->
  <refreshMode>onChange</refreshMode>
    <!-- kml:refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>     <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>     <!-- float -->
  <viewBoundScale>1</viewBoundScale>       <!-- float -->
  <viewFormat>...</viewFormat>             <!-- string -->
  <httpQuery>...</httpQuery>               <!-- string -->
</Icon>

說明

定義與圖示樣式或疊加層相關的圖片。必要的 <href> 子元素會定義用於疊加層或地標圖示的圖片位置。這個位置可以是本機檔案系統或遠端網路伺服器。<gx:x>、<gx:y>、<gx:w> 和 <gx:h> 元素是用來從含有多個圖示 (通常稱為「圖示調色盤」) 的圖片中選取一個圖示。

<Icon>
  <href>Sunset.jpg</href>   <!-- Here, the image contains only one icon -->
</Icon>
<Icon>
  <href>/home/mydir/myiconpalette.jpg</href>
  <gx:w>138</gx:w>
  <gx:h>138</gx:h>
    <!-- Since x and y values are omitted, these measurements are made starting at
    the lower-left corner of the icon palette image -->
</Icon>

圖示專用的元素

<href>
用來載入圖示的 HTTP 位址或本機檔案規格。
<gx:x>
<gx:y> 鍵
如果 <href> 指定了圖示調色盤,這些元素會以像素為單位,從圖示調色盤的左下角標示出偏移值。如未指定 x 和 y 的值,系統會將圖示調色盤的左下角視為要使用的圖示左下角。
<gx:w> 鍵
<gx:h>
如果 <href> 指定了圖示調色盤,這些元素就會指定要使用的圖示寬度 (<gx:w>) 和高度 (<gx:h>)。
<refreshMode>
如需 <refreshMode> 和下方其他元素的說明,請參閱 <Link>
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

包含

<IconStyle>

語法

<IconStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum:normal or random -->

  <!-- specific to IconStyle -->
  <scale>1</scale>                   <!-- float -->
  <heading>0</heading>               <!-- float -->
  <Icon>
    <href>...</href>
  </Icon>
  <hotSpot x="0.5"  y="0.5"
    xunits="fraction" yunits="fraction"/>    <!-- kml:vec2 -->
</IconStyle>

說明

指定在「地點」面板和「Google 地球」的 3D 檢視器中,地點點的繪製方式。<Icon> 元素可指定圖示圖片。<scale> 元素指定圖示的 x, y 縮放比例。<IconStyle> 的 <color> 元素中指定的顏色會與 <Icon> 的顏色混合。

IconStyle 專用的元素

<scale>
調整圖示大小。

注意:<geomScale> 標記已淘汰。請改用 <scale>。

<heading>
方向 (亦即北、南、東、西),以度為單位。預設值:0 (北)。(請參閱圖表)。範圍從 0 到 360 度。
<Icon>
自訂圖示。在 <IconStyle> 中,<Icon> 的唯一子項元素是 <href>:
  • <href>:用來載入圖示的 HTTP 位址或本機檔案規格。
<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">
指定「圖示」中「錨點」指向「地標」中指定的 <Point> 的位置。xy 值可透過三種不同方式指定:像素 ("pixels")、圖示的分數 ("fraction")插邊像素 ("insetPixels"),可由像素右上角的偏移偏移 (以像素為單位)。xy 的位置可以用不同的方式指定,例如,x 可以是像素,y 可以是小部分。座標系統的起點位於圖示的左下角。
  • x - 像素數、圖示的小數部分,或圖示代表像素上的點的 x 元件。
  • y - 像素數、圖示的部分元件,或代表圖示中某個點的 y 元件的像素插邊。
  • xunits - 指定 x 值的單位。fraction 值表示 x 值是圖示的一小部分,像素的值表示以像素表示的 x 值。insetPixels 值表示從圖示右側邊緣縮排。
  • yunits - 指定 y 值的單位。fraction 值表示 y 值為圖示的一小部分。像素的值表示以 y 表示的像素值。insetPixels 的值表示從圖示上方邊緣開始縮排。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Style id="randomColorIcon">
<IconStyle>
<color>ff00ff00</color>
<colorMode>random</colorMode>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon21.png</href>
</Icon>
</IconStyle>
</Style>
<Placemark>
<name>IconStyle.kml</name>
<styleUrl>#randomColorIcon</styleUrl>
<Point>
<coordinates>-122.36868,37.831145,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

擴充

包含

包含

<kml>

語法

<kml xmlns="http://www.opengis.net/kml/2.2" hint="target=sky"> ... </kml>

說明

KML 檔案的根元素。此元素為必填欄位。其以檔案開頭的 XML 宣告為依據。提示屬性可用來當做 Google 地球的信號,用來以檔案形式呈現檔案。

<KML> 元素也可以包含檔案參照的任何外部 XML 架構的命名空間。

基本的 <KML> 元素包含 0 或 1 的特徵以及 0 或 1 的 NetworkLinkControl:

<kml xmlns="http://www.opengis.net/kml/2.2">
  <NetworkLinkControl> ... </NetworkLinkControl>
  <!-- 0 or 1 Feature elements -->
</kml>

<LabelStyle>

語法

<LabelStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to LabelStyle -->
  <scale>1</scale>                   <!-- float -->
</LabelStyle>

說明

指定地圖項目的 <name> 在 3D 檢視器中如何繪製。您可以為標籤 (名稱) 指定自訂色彩、色彩模式和縮放比例。

注意:<labelColor> 標記已淘汰。請改用 <LabelStyle>。

<LabelStyle>專用

<scale>
調整標籤大小。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Style id="randomLabelColor">
<LabelStyle>
<color>ff0000cc</color>
<colorMode>random</colorMode>
<scale>1.5</scale>
</LabelStyle>
</Style>
<Placemark>
<name>LabelStyle.kml</name>
<styleUrl>#randomLabelColor</styleUrl>
<Point>
<coordinates>-122.367375,37.829192,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

擴充

包含

<gx:LatLonQuad>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<GroundOverlay id="ID">
  ...
  <Icon>...</Icon>
  <altitude>0</altitude>
  <altitudeMode>clampToGround</altitudeMode>                   <!-- or absolute -->
         <!-- can substitute <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode> -->

  <gx:LatLonQuad>
    <coordinates>...</coordinates>              <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

說明

允許非方形四邊形區域疊加層。

指定四邊形的四邊角座標,用來定義疊加層區域。只能提供四個座標組,每個包含對經度和緯度的浮點值。在元組之間插入空格。請勿在元組內加入空格。座標必須按照逆時針順序指定,第一個座標對應到重疊影像的左下角。這些邊角所描述的形狀必須是凸面。

如果將任何值插入任何元組 (代表高度),系統會忽略該值。設定引數時,請使用 <altitude><altitudeMode> (或 <gx:altitudeMode>),擴充 <GroundOverlay>。允許的高度模式為絕對clampToGround 以及 clampToSeaFloor

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:gx="http://www.google.com/kml/ext/2.2"> <GroundOverlay> <name>gx:LatLonQuad Example</name> <Icon> <href>http://developers.google.com/kml/documentation/images/rectangle.gif</href> <viewBoundScale>0.75</viewBoundScale> </Icon> <gx:LatLonQuad> <coordinates> 81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015 </coordinates> </gx:LatLonQuad> </GroundOverlay> </kml>

擴充

包含

<LinearRing>

語法

<LinearRing id="ID">
  <!-- specific to LinearRing -->
  <gx:altitudeOffset>0</gx:altitudeOffset>   <!-- double -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
    <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
    <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples -->
</LinearRing>

說明

定義封閉線條字串,通常是多邊形的外邊界。您可以視需要使用 LinearRing 做為多邊形的內邊界,在多邊形中建立孔。多邊形可能包含多個 <LinearRing> 元素,做為內部邊界。

注意:在「Google 地球」中,具有 <ElevationMode> 的 clampToGround 路徑的多邊形會跟隨常駐航線;但是,如果 <高度模式> 為 clampToGround 的 LinearRing 會跟隨大圓線。

LinearRing 專屬的元素

<gx:heightOffset>
Google 擴充功能命名空間中的 KML 擴充功能,可用來修改高度值的顯示方式。此偏移可讓您將整個 LinearRing 上下移動,而不修改構成 LinearRing 的所有個別座標值。(雖然 LinearRing 使用高度偏移值顯示,但是原始高度值會保留在 KML 檔案中)。單位為公尺。
<extrude>
布林值。指定是否要將 LinearRing 連接至地面。因此,海拔高度模式必須是 relativeToGroundrelativeToSeaFloor絕對。只有 LinearRing 的頂點會擴開,而不是幾何圖形的中心。頂點會朝著地球球中心延伸。
<tessellate>
布林值。指定是否允許 LinearRing 追蹤地形。必須啟用 clampToGround 或是 clampToSeaFloor,才能啟用 <ElevationMode> 的值。非常大的 LinearRings 應該啟用紋路,讓它們跟隨地球的彎曲度 (否則可能會被進入地下隱形)。
<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,<協調中心 s>代碼)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。這個模式的常見用途是放置電話桿或滑雪纜車。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。飛機通常用於這個模式。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <height> 規格,並將該點放置在海平面上。如果該點位於陸上而非海上,則該點會置於地面上。
<座標> (必填)
4 個以上的元組,每個包含由經度緯度高度的浮點值。海拔高度是選用元件。請勿在元組內加入空格。最後一個座標必須與第一個座標相同。座標僅以小數表示。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
<name>LinearRing.kml</name>
<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>

擴充

包含

<LineString>

語法

<LineString id="ID">
  <!-- specific to LineString -->
  <gx:altitudeOffset>0</gx:altitudeOffset>  <!-- double -->
  <extrude>0</extrude>                      <!-- boolean -->
  <tessellate>0</tessellate>                <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:drawOrder>0</gx:drawOrder>            <!-- integer -->
  <coordinates>...</coordinates>            <!-- lon,lat[,alt] -->
</LineString>

說明

定義一組相連的區隔。使用 <LineStyle> 指定線條的顏色、顏色模式和寬度。當 LineString 被斷開時,線條會延伸到地面,形成類似外牆或圍欄的多邊形。在已延伸的 LineString 中,線條本身會使用目前的 LineStyle,而 extrusion 則使用目前的 PolyStyle。請參閱 KML 教學課程,瞭解 LineString (或路徑) 的範例。

LineString 專用的元素

<gx:heightOffset>
Google 擴充功能命名空間中的 KML 擴充功能,可用來修改高度值的顯示方式。此偏移可讓您將整個 LineString 上下移動,而不需要修改構成 LineString 的所有個別座標值。(雖然 / 透過「海拔高度」值顯示 LineString,但在 KML 檔案中會保留原始的高度值)。單位為公尺。
<extrude>
布林值。指定是否要將 LineString 連結至地面。要使 LineString 執行,海拔模式必須為 relativeToGroundrelativeToSeaFloor絕對。LineString 中的頂點被延伸到地球球中心。
<tessellate>
布林值。指定是否允許 LineString 跟隨地形。必須啟用 clampToGroundclampToSeaFloor,才能啟用銷售模式。非常大的 LineString 應啟用紋路,讓它們跟隨地球的彎曲度 (否則可能會被進入地面並隱藏)。
<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,在 <Coordinates> 標記中)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。這個模式的常見用途是放置電話桿或滑雪纜車。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。飛機通常用於這個模式。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <height> 規格,並將該點放置在海平面上。如果該點位於陸上而非海上,則該點會置於地面上。
<gx:drawOrder>
一個整數值,用於指定繪製多個線條字串的順序。優先繪製的 LineString 可能會部分或完整地被 LineString 遮掩 (稍後繪製)。當雙色線條互相交會時,此元素可能需要與 <LineStyle> 中的 <gx:outerColor><gx:outerWidth> 元素搭配使用。
<座標> (必填)
兩個以上的座標組,每個包含由經度緯度高度的浮點值。海拔高度是選用元件。在元組之間插入空格。請勿在元組內加入空格。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>LineString.kml</name>
<open>1</open>
<LookAt>
<longitude>-122.36415</longitude>
<latitude>37.824553</latitude>
<altitude>0</altitude>
<range>150</range>
<tilt>50</tilt>
<heading>0</heading>
</LookAt>
<Placemark>
<name>unextruded</name>
<LineString>
<extrude>1</extrude>
<tessellate>1</tessellate>
<coordinates>
-122.364383,37.824664,0 -122.364152,37.824322,0 </coordinates>
</LineString>
</Placemark>
<Placemark>
<name>extruded</name>
<LineString>
<extrude>1</extrude>
<tessellate>1</tessellate>
<altitudeMode>relativeToGround</altitudeMode>
<coordinates>
-122.364167,37.824787,50 -122.363917,37.824423,50 </coordinates>
</LineString>
</Placemark>
</Document>
</kml>

擴充

包含

<LineStyle>

語法

<LineStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- colorModeEnum: normal or random -->

  <!-- specific to LineStyle -->
  <width>1</width>                            <!-- float -->
  <gx:outerColor>ffffffff</gx:outerColor>     <!-- kml:color -->
  <gx:outerWidth>0.0</gx:outerWidth>          <!-- float -->
  <gx:physicalWidth>0.0</gx:physicalWidth>    <!-- float -->
  <gx:labelVisibility>0</gx:labelVisibility>  <!-- boolean -->
</LineStyle>

說明

指定所有線條幾何圖形的繪圖樣式 (顏色、色彩模式和線條寬度)。線條幾何圖形包括外框多邊形的外框以及「地標」圖示 (如果已啟用擴充系統) 且「延伸」的「延伸」線。

LineStyle 專用的元素

<width>
線條寬度,以像素為單位。
<gx:outerColor>
<gx:outerWidth> 定義的線條部分顏色。請注意,當 <LineStyle> 套用到 <Polygon> 和 <LinearRing> 時,系統會忽略 <gx:outerColor> 和 <gx:outerWidth> 元素。
<gx:outerWidth>
0.0 到 1.0 之間的值,用於指定使用 <gx:outerColor> 的行數比例。這只會套用至設定寬度為 <gx:physicalWidth> 的行;不適用於使用 <width> 的行。另請參閱 <LineString> 中的 <gx:drawOrder>。如果雙色線條互相交會 (例如顯示高速公路交會處),則可能需要繪製繪製順序值。
<gx:physicalWidth>
線條的實體寬度,單位為公尺。
<gx:labelVisibility>
布林值,用於定義是否要在 LineString 上顯示文字標籤。LineString 的標籤包含在 <name> 元素中,這是 <LineString> 的同層級 (即包含在同一個 <Placemark> 元素中)。

根據預設,Google 地球 6.1 以上版本不會顯示標籤,只要將 <gx:labelVisibility> 設為 1,即可為每個 LineString 啟用標籤。

Google 地球 6.1 版已知問題:沒有 <gx:physicalWidth> 元素的 LineString 只會在行距大於 100 公尺 * 標籤中的字元數時才會顯示標籤。舉例來說,只有在行距超過 700 公尺時,才會顯示含有七個字元 (「範例」) 的標籤。這不會影響含有 <gx:physicalWidth> 值的 LineString。

範例

以下範例為寬度為 4 像素的 50% 不透明紅色線條。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineStyle.kml</name>
  <open>1</open>
  <Style id="linestyleExample">
    <LineStyle>
      <color>7f0000ff</color>
      <width>4</width>
      <gx:labelVisibility>1</gx:labelVisibility>
    </LineStyle>
  </Style>
  <Placemark>
    <name>LineStyle Example</name>
    <styleUrl>#linestyleExample</styleUrl>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

擴充

包含

語法

<Link id="ID">
  <!-- specific to Link -->
  <href>...</href>                      <!-- string -->
  <refreshMode>onChange</refreshMode>
    <!-- refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>  <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>  <!-- float -->
  <viewBoundScale>1</viewBoundScale>    <!-- float -->
  <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</viewFormat>
                                        <!-- string -->
  <httpQuery>...</httpQuery>            <!-- string -->
</Link>

說明

<Link> 會指定以下任一項目的位置:

  • 透過網路連結擷取的 KML 檔案
  • 任何疊加層中使用的圖片檔 (<Icon> 元素會指定疊加層中的圖片;<Icon> 的欄位與 <Link> 相同)
  • <Model> 元素中使用的模型檔案

視此處提供的重新整理參數而定,檔案會有條件地載入及重新整理。您可以指定兩組不同的重新整理參數:一組以 time (<refreshMode> 和 <refreshInterval>) 為基準,另一組以目前的「camera」檢視 (<viewRefreshMode> 和 <viewRefreshTime>) 為基準。此外,Link 會指定是否要將傳送至

擷取檔案時,傳送到伺服器的 URL 是由三個資訊組成:

  • 用來指定要載入檔案的 href (超文參照)。
  • 任意格式字串 (透過您在 <viewFormat> 元素中指定的參數或 (b) 定界框參數所建立,此為預設值,如果檔案中沒有 <viewFormat> 元素,則系統會使用此字串)。
  • 在 <httpQuery> 元素中指定的第二個格式字串。

如果 <href> 中指定的檔案是本機檔案,系統就不會使用 <viewFormat> 和 <httpQuery> 元素。

<Link> 元素會取代先前 KML 版本中所含 <NetworkLink> 的 <Url> 元素,並新增 <Region> 元素 (在 KML 2.1 中推出) 的功能。在 Google 地球 3.0 以下版本中,系統會忽略 <Link> 元素。

<href>
網址 (HTTP 位址或本機檔案規格)。當 <Link> 的父項為 NetworkLink 時,<href> 是 KML 檔案。當 <Link> 的父項為 Model 時,<href> 是 COLLADA 檔案。當 <Icon> 的父項 (與 <Link> 相同的欄位) 為疊加層時,<href> 為圖片。這個標記中會使用相對網址,並依據內含的 KML 檔案加以評估。如要進一步瞭解如何在 KML 和 KMZ 檔案中建構相對參照,請參閱 KMZ 檔案
<refreshMode>
指定以時間為基礎的重新整理模式,可以是下列其中一種:
  • onChange - 在載入檔案及連結參數變更時重新整理 (預設)。
  • onInterval - 每 n 秒重新整理 (在 <refreshInterval> 中指定)。
  • onExpire:在到期時間到期時重新整理檔案。如果擷取的檔案包含 NetworkLinkControl,<expires> 時間的優先順序會高於 HTTP 標頭中指定的到期時間。如未指定 <expires> 時間,則會使用 HTTP max-age 標頭 (如有)。如果沒有 max-age,則會使用 到期 HTTP 標頭 (如果有的話)。(如要進一步瞭解 HTTP 標頭欄位,請參閱「超文本傳輸通訊協定 - HTTP 1.1」的 RFC261b 一節)。
<refreshInterval>
表示每 n 秒重新整理一次檔案。
<viewRefreshMode>
指定「相機」變更時,連結重新整理的方式。
可以是下列其中一個值:
  • never (預設):忽略檢視畫面中的變更。另外,請忽略 <viewFormat> 參數 (如果有的話)。
  • onStop - 在移動停止後 n 秒重新整理檔案,其中 <viewRefreshTime> 中指定了 n
  • onRequest - 只在使用者明確要求時才重新整理檔案。(舉例來說,在「Google 地球」中,使用者按一下滑鼠右鍵並選取 [內容] 選單中的 [重新整理])。
  • onRegion - 在區域啟用時重新整理檔案。請參閱 <Region>
<viewRefreshTime>
相機移動停止後,指定要在多久後重新整理重新整理的秒數。(請參閱上方的 <viewRefreshMode> 和 onStop)。
<viewBoundScale>
縮放 BBOX 參數後,再將其傳送至伺服器。如果值小於 1,指定使用小於完整檢視 (螢幕)。大於 1 的值會指定擷取超出目前檢視畫面邊緣區域的區域。
<viewFormat>
指定在擷取檔案之前,會附加在連結 <href> 後方的查詢字串格式 (如果 <href> 指定了本機檔案,系統會忽略這個元素)。
如果您指定 onStop 的 <viewRefreshMode> 且 未在檔案中加入 <viewFormat> 標記,系統就會將以下資訊自動附加到查詢字串:

BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]

這項資訊符合網路地圖服務 (WMS) 定界框規格,
如果指定了空白的 <viewFormat> 標記,查詢字串就不會附加任何資訊。
您也可以指定要加入查詢字串的自訂檢視參數組合。如果您提供格式字串,系統會使用這項資訊而非 BBOX 資訊。如果您需要 BBOX 資訊,必須新增這些參數以及自訂參數。
您可以在格式字串中使用下列任一參數 (Google 地球會在建立查詢字串時,替換適當的目前值):
  • [lookatLon], [lookatLat] - <LookAt> 正在檢視點的經度和緯度
  • [lookatRange][lookatTilt][lookatHeading] - <LookAt> 元素使用的值 (請參閱 <LookAt> 中的 <range><tilt><heading> 的說明)
  • [lookatTerrainLon]、[lookatTerrainLat] 和 [lookatTerrainAlt] - 指向 <LookAt> 正在檢視的地形溫度/公尺度
  • [cameraLon]、[cameraLat]、[cameraAlt] - 相機視角的度數/公尺
  • [horizFov][vertFov] - 相機的橫向、垂直視野
  • [horizPixels] - [vertPixels] - 3D 檢視器的像素大小
  • [terrainEnabled] - 表示 3D 檢視器是否顯示地形
<httpQuery>
根據指定的參數,將資訊附加至查詢字串。(「Google 地球」會在建立查詢字串時,替換適當的目前值)。系統支援下列參數:
  • [用戶端版本]
  • [KMLVersion]
  • [客戶姓名]敬上
  • [語言]

範例

<NetworkLink>
  <name>NE US Radar</name>
  <flyToView>1</flyToView>
  <Link>
    <href>http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml</href>
    <refreshMode>onInterval</refreshMode>
    <refreshInterval>30</refreshInterval>
    <viewRefreshMode>onStop</viewRefreshMode>
    <viewRefreshTime>7</viewRefreshTime>
    <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\
      [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\
      [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled]</viewFormat>
  </Link>
</NetworkLink> 

擴充

包含

另請參閱

<ListStyle>

語法

<ListStyle id="ID">
  <!-- specific to ListStyle -->
  <listItemType>check</listItemType> <!-- kml:listItemTypeEnum:check,
                                          checkOffOnly,checkHideChildren,
                                         radioFolder -->
  <bgColor>ffffffff</bgColor>        <!-- kml:color -->
  <ItemIcon>                         <!-- 0 or more ItemIcon elements -->
    <state>open</state>
      <!-- kml:itemIconModeEnum:open, closed, error, fetching0, fetching1, or fetching2 -->
    <href>...</href>                 <!-- anyURI -->
  </ItemIcon>
</ListStyle>

說明

指定功能在清單檢視中的顯示方式。清單檢視是容器和子項的階層;在 Google 地球中,這是「地點」面板。

ListStyle 專用的元素

<listItemType>
指定功能在清單檢視畫面中的顯示方式。可能的值包括:
  • 勾選 (預設):此功能的瀏覽權限與該項目的核取方塊相關聯。
  • RadioFolder - 指定容器時,一次只能顯示一個容器項目
  • checkOffOnly - 指定容器或網路連結時,可一次停止顯示所有項目;也就是說,使用者可以關閉容器或網路連結中的所有內容,但無法同時開啟所有項目。這項設定適用於包含大量資料的容器或網路連結。
  • checkHideChildren - 使用一般核取方塊進行瀏覽權限,但不在清單檢視中顯示容器或網路連結的子項。核取方塊可讓使用者透過檢視區塊中的子物件切換狀態。
<bgColor>
程式碼片段的背景顏色。顏色和透明度值以十六進位標記法表示。任何顏色的值範圍是 0 到 255 (00ff)。如果是 Alpha,00 是完全透明的,ff 則是完全不透明。運算式的順序為 aabbggrr,其中 aa=alpha (00 至 ff);bb=blue (00 至 ff);gg=green (00 至 ff);rr=red (00 至 ff)。例如,如果您想在疊加層中套用透明度為 50% 的藍色顏色,請指定下列內容:<color>7fff0000</color>,其中 alpha=0x7f、blue=0xff、green=0x00 和 red=0x00。
<ItemIcon>
清單檢視中使用的圖示,代表資料夾或連結擷取的狀態。與開放式封閉式模式相關聯的圖示會用於資料夾和網路連結。與 errorfetching0fetching1fetching2 模式相關聯的圖示會用於網路連結。下列螢幕畫面擷取說明瞭下列狀態的 Google 地球圖示:
<州/省>
指定 NetworkLink 或資料夾的目前狀態。可能的值包括 openclosederrorfetching0fetching1fetching2。只要在兩個值之間插入空格 (不以逗號分隔),即可合併這些值。
<href>
指定功能清單「清單檢視」中使用的映像檔 URI。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>ListStyle.kml</name>
<open>1</open>
<Style id="bgColorExample">
<ListStyle>
<bgColor>ff336699</bgColor>
</ListStyle>
</Style>
<Style id="checkHideChildrenExample">
<ListStyle>
<listItemType>checkHideChildren</listItemType>
</ListStyle>
</Style>
<Style id="radioFolderExample">
<ListStyle>
<listItemType>radioFolder</listItemType>
</ListStyle>
</Style>
<Folder>
<name>ListStyle Examples</name>
<open>1</open>
<Folder>
<name>bgColor example</name>
<open>1</open>
<Placemark>
<name>pl1</name>
<Point>
<coordinates>-122.362815,37.822931,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl2</name>
<Point>
<coordinates>-122.362825,37.822931,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl3</name>
<Point>
<coordinates>-122.362835,37.822931,0</coordinates>
</Point>
</Placemark>
<styleUrl>#bgColorExample</styleUrl>
</Folder>
<Folder>
<name>checkHideChildren example</name>
<open>1</open>
<Placemark>
<name>pl4</name>
<Point>
<coordinates>-122.362845,37.822941,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl5</name>
<Point>
<coordinates>-122.362855,37.822941,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl6</name>
<Point>
<coordinates>-122.362865,37.822941,0</coordinates>
</Point>
</Placemark>
<styleUrl>#checkHideChildrenExample</styleUrl>
</Folder>
<Folder>
<name>radioFolder example</name>
<open>1</open>
<Placemark>
<name>pl7</name>
<Point>
<coordinates>-122.362875,37.822951,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl8</name>
<Point>
<coordinates>-122.362885,37.822951,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl9</name>
<Point>
<coordinates>-122.362895,37.822951,0</coordinates>
</Point>
</Placemark>
<styleUrl>#radioFolderExample</styleUrl>
</Folder>
</Folder>
</Document>
</kml>

擴充

包含

<LookAt>

語法

<LookAt id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
    <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to LookAt -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos90 -->
  <range></range>                     <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
          <!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute -->
          <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->

</LookAt>

說明

定義與衍生自 Feature 的任何元素相關聯的虛擬相機。LookAt 元素會將「鏡頭」置於正在檢視的物體上。在「Google 地球」中,當使用者按兩下「位置」面板中的項目或按兩下 3D 檢視器中的圖示,此檢視畫面會「對應到」此 LookAt 檢視點。

LookAt 專屬的元素

<longitude>
相機視角的經度。相對於本初子午線的角度距離角度。Meridian 西方的值介於 -180 到 0 度之間。梅里達文的東方值介於 0 到 180 度之間。
<latitude>
相機視角。度量等於赤道以南或南度 (0 度)。這個值的範圍介於 -90 度到 90 度之間。
<altitude>
與地球表面之間的距離,單位為公尺。依照 LookAt 的高度模式解讀。
<heading>
方向 (亦即北、南、東、西),以度為單位。預設值:0 (北)。(請參閱下圖)。範圍從 0 到 360 度。
<tilt>
從 LookAt 的位置角度到地球表面的正常角度。(請參閱下圖)。範圍從 0 到 90 度。<tilt> 的值不能是負數。0 度的 <tilt> 值表示直接從正上方檢視。90 度的 <tilt> 值表示沿著水平線進行檢視。
<range>(必填)
從 <經度>、<緯度> 和 <高度> 指定的點 (距離單位) 至 LookAt 位置的距離 (單位為公尺)。(請參閱下圖)。
<altitudeMode>
指定如何解讀 LookAt 點的 <Elevation>。可能的值如下:
  • clampToGround - (預設) 表示忽略 <高度> 規格,並將 LookAt 定位放在地面上。
  • relativeToGround - 將 <Elevation> 的值設為地面以上公尺。
  • 絕對 - 將 <海拔高度> 的值呈現為高於海平面的單位值。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <Elevation> 規格,且 LookAt 將放置在海床上。如果點位於地上 (而非海上),LookAt 將置於地面。

此圖表說明 <range>、<tilt> 及 <height> 元素:

 

下圖說明 <heading> 元素:

 

東=90,南=180,西=270
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>LookAt.kml</name>
    <LookAt>
      <gx:TimeStamp>
        <when>1994</when>
      </gx:TimeStamp>
      <longitude>-122.363</longitude>
      <latitude>37.81</latitude>
      <altitude>2000</altitude>
      <range>500</range>
      <tilt>45</tilt>
      <heading>0</heading>
      <altitudeMode>relativeToGround</altitudeMode>
    </LookAt>
    <Point>
      <coordinates>-122.363,37.82,0</coordinates>
    </Point>
  </Placemark>
</kml>

擴充

包含

<型號>

語法

<Model id="ID">
  <!-- specific to Model -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround,relativeToGround,or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <Location>
    <longitude></longitude> <!-- kml:angle180 -->
    <latitude></latitude>   <!-- kml:angle90 -->
    <altitude>0</altitude>  <!-- double -->
  </Location>
  <Orientation>
    <heading>0</heading>    <!-- kml:angle360 -->
    <tilt>0</tilt>          <!-- kml:anglepos180 -->
    <roll>0</roll>          <!-- kml:angle180 -->
  </Orientation>
  <Scale>
    <x>1</x>                <!-- double -->
    <y>1</y>                <!-- double -->
    <z>1</z>                <!-- double -->
  </Scale>
  <Link>...</Link>
  <ResourceMap>
    <Alias>
      <targetHref>...</targetHref>   <!-- anyURI -->
      <sourceHref>...</sourceHref>   <!-- anyURI -->
    </Alias>
  </ResourceMap>
</Model>

說明

COLLADA 檔案中所述的 3D 物件 (在 <Link> 標記中參照)。COLLADA 檔案的副檔名是 .dae。模型會在其專屬的座標空間中建立,然後定位、定位及調整「Google 地球」的位置。如需詳細資訊,請參閱模型中的「KML 主題」頁面。

Google 地球支援 COLLADA 通用設定檔,但有以下例外:

  • Google 地球僅支援三角形和線條做為原始類型。可使用的三角形數量上限為 21845 個。
  • Google 地球不支援動畫或護膚功能。
  • Google 地球不支援外部幾何圖形參照。

模型專用的元素

<altitudeMode>
指定<地區>中指定的<海拔高度>的解讀方式。可能的值如下:
  • clampToGround - (預設) 表示忽略 <Elevation> 規格,並將模型置於地面。
  • relativeToGround - 將 <Elevation> 的值設為地面以上公尺。
  • 絕對 - 將 <海拔高度> 的值呈現為高於海平面的單位值。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面,系統會將 <海拔高度> 解讀為地面上方。
  • clampToSeaFloor - 系統會忽略 <Elevation> 規格,並將模型定位在海床上。如果點位於陸上而非海上,模型就會置於地面上。
<位置>
指定模型在緯度、經度和高度中的確切座標。緯度經度 測量單位為標準的 W 軸 GS 投影高度是指地球表面上方的距離,單位為公尺,並依照 <海拔高度模式> 或 <gx:海拔高度模式> 解讀。
<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location> 
<Orientation>
說明 3D 模型座標系統的旋轉角度,以便在 Google 地球中定位該物件。請參閱下圖。
<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation> 

按照以下順序將模型套用到模型:

  1. <roll>
  2. <tilt>
  3. <heading>
<heading>
以「z」軸為中心旋轉 (通常是指地球表面)。如果值為 0 (預設值),則等於北方。正轉軸沿著 z 軸順時針方向旋轉,以 0 到 360 的度數指定度數。
<tilt>
旋轉 x 軸。正轉軸沿著 x 軸順時針方向旋轉,以 0 到 180 的度數指定度數。
<roll>
旋轉「y」軸。正旋轉由 y 軸順時針方向旋轉,以 0 到 180 度的角度表示。
朝向原點向下移動軸時,以順時針方向指定標題、傾斜和捲軸
下圖說明模型軸線的一般方向:
以一般模型來說,+x 位於右方,+y 表示向北且正面朝向,+z 則向上
<比例>
根據模型座標空間中的 xyz 軸,對模型進行縮放。
<Scale>
<x>2.5</x>
<y>2.5</y>
<z>3.5</z>
</Scale>
指定要載入的檔案和選用的重新整理參數。請參閱 <Link>
<ResourceMap>
指定 0 或多個 <Alias> 元素,每個元素都是原始 Collada 檔案的紋理檔案路徑和包含 Model 的 KML 或 KMZ 檔案之間的對應。這個元素可讓您移動及重新命名紋理檔案,而無需更新參照這些紋理的原始 Collada 檔案。一個 <ResourceMap> 元素可以包含多個從不同 (來源) Collada 檔案對應到同一個 (目標) KMZ 檔案的多個對應。
<Alias>
<targetHref>../images/foo.jpg</targetHref> <sourceHref>c:\mytextures\foo.jpg</sourceHref> </Alias>
<Alias> 包含從 <sourceHref> 對應至 <targetHref> 的對應:
<targetHref>
指定 Google 地球要擷取的紋理檔案。此參考資料可以是 .kmz 封存檔內圖片檔的相對參照,也可是檔案的絕對參照 (例如網址)。
<sourceHref>
在 Collada .dae 檔案中為紋理檔案指定的路徑。
如果 Google 地球未提供此對應,就會使用下列規則找出 Collada (.dae) 檔案所參照的紋理:
  • 無路徑:如果紋理名稱不包含路徑,Google 地球會在與 .dae 檔案相同的目錄中尋找紋理。
  • 相對路徑如果紋理名稱包含相對路徑 (例如 ../images/mytexture.jpg),Google 地球會將路徑解讀為參照該路徑的 .dae 檔案。
  • 絕對路徑:如果紋理名稱是絕對路徑 (c:\mytexture.jpg) 或網路路徑 (例如 http://myserver.com/mytexture.jpg),Google 地球會在指定的位置尋找檔案,不論 .dae 檔案的所在位置為何。

範例

<Model id="khModel543"> 
<altitudeMode>relativeToGround</altitudeMode>
<Location>
<longitude>39.55375305703105</longitude>
<latitude>-118.9813220168456</latitude>
<altitude>1223</altitude>
</Location>
<Orientation>
<heading>45.0</heading>
<tilt>10.0</tilt>
<roll>0.0</roll>
</Orientation>
<Scale>
<x>1.0</x>
<y>1.0</y>
<z>1.0</z>
</Scale>
<Link>
<href>house.dae</href>
<refreshMode>once</refreshMode>
</Link>
<ResourceMap>
<Alias>
<targetHref>../files/CU-Macky---Center-StairsnoCulling.jpg</targetHref>
<sourceHref>CU-Macky---Center-StairsnoCulling.jpg</sourceHref>
</Alias>
<Alias>
<targetHref>../files/CU-Macky-4sideturretnoCulling.jpg</targetHref>
<sourceHref>CU-Macky-4sideturretnoCulling.jpg</sourceHref>
</Alias>
<Alias>
<targetHref>../files/CU-Macky-Back-NorthnoCulling.jpg</targetHref>
<sourceHref>CU-Macky-Back-NorthnoCulling.jpg</sourceHref>
</Alias>
</ResourceMap>
</Model>

擴充

包含

<MultiGeometry>

語法

<MultiGeometry id="ID">
  <!-- specific to MultiGeometry -->
  <!-- 0 or more Geometry elements -->
</MultiGeometry>

說明

用於容器的零特徵或多個基元。

注意:<GeometryCollection> 標記已淘汰。請改用 <MultiGeometry>。

多重幾何圖形專用的元素

範例

<Placemark>
  <name>SF Marina Harbor Master</name>
<visibility>0</visibility>
<MultiGeometry> <LineString>
<!-- north wall --> <coordinates>
-122.4425587930444,37.80666418607323,0
-122.4428379594768,37.80663578323093,0 </coordinates>
</LineString> <LineString>
<!-- south wall -->
<coordinates>
-122.4425509770566,37.80662588061205,0
-122.4428340530617,37.8065999493009,0
</coordinates> </LineString>
</MultiGeometry> </Placemark>

擴充

包含

<gx:多重音軌>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.2 以上版本。瞭解詳情

語法

<gx:MultiTrack id="ID">
  <!-- specific to MultiTrack -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:interpolate>0<gx:interpolate>   <!-- boolean -->
  <gx:Track>...</gx:Track>            <!-- one or more gx:Track elements -->
</gx:MultiTrack>

說明

使用多軌道元素,將多個軌道元素結合成一個概念單元。例如,假設您在一天的單車騎乘中收集了 GPS 資料,其中包括數個休息站和午餐停靠站。由於時間中斷,因此在繪製時間和位置時,單車騎乘可能會以四個不同的軌道顯示。將這些 <gx:Track> 元素分組成一個 <gx:MultiTrack> 容器,會導致這些元素在 Google 地球中顯示為單一路徑的一部分。當圖示在一個片段結束時顯示,就會移到下一個區段的開頭。<gx:interpolate> 元素可指定是否要在一個軌道結束時停止,並立即跳到下一首的起點,或插入兩個音軌之間缺少的值。

gx:MultiTrack 專用的元素

<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,在 <gx:coord> 元素中)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓您掌握相對於海底的高度,可能的值如下:
  • relativeToSeaFloor:將高度解讀為以公尺為單位的高度。如果海拔高度是陸上而非海上,系統會將這些高度解讀為高於地面。
  • clampToSeaFloor - 忽略高度規格,並將該點放置在海床上。如果該點位於陸上而非海上,則該點會置於地面上。
<gx:interpolate>
布林值。如果多軌軌道中有多項 <gx:Track> 元素使用預設值 (0) 時,圖示或模型會在一個軌跡結束時停止,然後跳到下一首曲目的起點。

包含

語法

<NetworkLink id="ID">
  <!-- inherited from Feature element --><name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
   <atom:link href=" "/>               <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to NetworkLink --> <refreshVisibility>0</refreshVisibility> <!-- boolean --> <flyToView>0</flyToView> <!-- boolean --> <Link>...</Link> </NetworkLink>

說明

參照區域網路或遠端網路上的 KML 檔案或 KMZ 封存檔。使用 <Link> 元素指定 KML 檔案的位置。您可在該元素中,根據時間和相機的變化定義更新檔案的重新整理選項。NetworkLinks 可與區域搭配使用,以有效率地處理超大型資料集。

<refreshVisibility>
布林值。值為 0,表示 Google 地球使用者能控制的功能。將值設為 1 即可在每次 NetworkLink 重新整理時重設功能的瀏覽權限。舉例來說,假設已連結 KML 檔案中的地標將 <visibility> 設為 1,且 NetworkLink 的 <refreshVisibility> 設為 1。檔案初次載入「Google 地球」時,使用者可以取消勾選項目旁邊的核取方塊,以關閉 3D 檢視器的顯示功能。不過,當 NetworkLink 重新整理時,由於原始瀏覽權限狀態為 TRUE,系統會再次顯示地標。
<flyToView>。
布林值。值為 1 時,Google 地球會飛到 NetworkLinkControl 中的 LookAt 或 Camera 檢視 (如果有的話)。如果 NetworkLinkControl 不含 AbstractView 元素,則 Google 地球會在重新整理檔案的 <KML> 元素內,將地圖項目置於 LookAt 或 Camera 元素。如果 <KML> 元素並未指定 LookAt 或相機,檢視畫面將維持不變。舉例來說,Google 地球會飛到父文件「文件」的 <LookAt> 檢視,而不是在文件所含地標的 <LookAt>。

提示:如要在清單檢視中顯示網路連結中的頂層資料夾或文件,請為該資料夾或文件指派 ID。如果沒有這個 ID,清單檢視中就只會顯示子物件名稱。

範例

<Document>
  <visibility>1</visibility>
  <NetworkLink>
    <name>NE US Radar</name>
    <refreshVisibility>1</refreshVisibility>
    <flyToView>1</flyToView>
    <Link>...</Link></NetworkLink>
</Document>

擴充

包含

<NetworkLinkControl>

語法

<NetworkLinkControl>
  <minRefreshPeriod>0</minRefreshPeriod>           <!-- float -->
  <maxSessionLength>-1</maxSessionLength>          <!-- float --> 
  <cookie>...</cookie>                             <!-- string -->
  <message>...</message>                           <!-- string -->
  <linkName>...</linkName>                         <!-- string -->
  <linkDescription>...</linkDescription>           <!-- string -->
  <linkSnippet maxLines="2">...</linkSnippet>      <!-- string -->
  <expires>...</expires>                           <!-- kml:dateTime -->
  <Update>...</Update>                             <!-- Change,Create,Delete -->
  <AbstractView>...</AbstractView>                 <!-- LookAt or Camera -->
</NetworkLinkControl>

說明

控制由 <NetworkLink> 擷取的檔案的行為。

NetworkLinkControl 專用的元素

<minRefreshPeriod>
以秒為單位,指定 <minRefreshPeriod> 是允許擷取檔案之間的最短間隔時間。這項參數可讓伺服器對特定檔案進行擷取,並且根據資料的預期速率調整重新整理頻率。舉例來說,使用者可能會將連結重新整理設為 5 秒,但您可以把重新整理的最短期間設為 3600,藉此限制重新整理頻率為每小時一次。
<maxSessionLength>
<maxSessionLength> 是秒數,代表 Client NetworkLink 可保持連線的最長時間。如果預設值為 -1,表示不明確終止工作階段。
這個 元素會在下次重新整理網路連結時,在網址查詢中附加字串。您可以在指令碼中使用這些資料,在伺服器端提供更聰明的處理作業,包括版本查詢和條件式檔案傳送。
<message>
您可以傳送彈出式訊息,例如您網路連結的使用指南。網路連結第一次載入「Google 地球」或網路連結控制項中有所變更時,就會顯示此訊息。
<linkName>
你可以透過伺服器控管網路連結的名稱,讓用戶端覆寫用戶端名稱的變更。
<linkDescription>
你可以透過伺服器控制網路連結的說明,讓伺服器對用戶端說明進行的變更遭到伺服器覆寫。
<linksnippet maxLines="2" >
你可以從伺服器控制聯播網連結的程式碼片段,讓用戶端的程式碼片段出現變更。<linksnippet> 具有一個 maxLines 屬性,一個整數可以指定要顯示的行數上限。
<expires>
你可以指定應重新整理連結的日期/時間。只有在 <Link> 中的 <refreshMode> 的值為 onExpire 時,此規格才會生效。請參閱 <refreshMode>
<Update>
使用 <Update> 時,您可以為 請參閱 <Update>
<AbstractView>

範例

<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLinkControl>
   <message>This is a pop-up message. You will only see this once</message>
   <cookie>cookie=sometext</cookie>
   <linkName>New KML features</linkName>
   <linkDescription><![CDATA[KML now has new features available!]]></linkDescription>
</NetworkLinkControl>
</kml>

擴充

  • 這是 <KML> 元素的直接子項。

包含

  • <kml>

另請參閱

<物件>

語法

<!-- abstract element; do not create -->
<!-- Object id="ID" targetId="NCName" -->
<!-- /Object> -->

說明

這是一種抽象基礎類別,無法直接在 KML 檔案中使用。它提供 id 屬性 (允許對 KML 元素的不重複識別),以及 [IdId] 屬性 (用於參照已載入至 Google 地球的物件)。如果要使用 <Update> 機制,就必須指派 id 屬性。

<重疊元素>

語法

<!-- abstract element; do not create -->
<!-- Overlay id="ID" -->                    <!-- GroundOverlay,ScreenOverlay -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to Overlay --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon> <href>...</href> </Icon> <!-- /Overlay -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。<Overlay> 是顯示在地球表面或螢幕上的影像重疊基本類型。<Icon> 指定要使用的圖片,可設定成根據計時器或攝影機變更來重新載入圖片。這個元素也包含多個疊加層的堆疊順序,以及在基本圖片中新增色彩和透明度值。

疊加層專屬的元素

<color>
顏色值以十六進位標記法表示,包括不透明度 (alpha) 值。表式的順序為 Alpha、藍色、綠色、紅色 (aabbggrr)。任何顏色的值範圍都是 0 到 255 (00ff).)。對於透明度,00 是完全透明的,ff 則是完全不透明。舉例來說,如果您想為重疊圖層套用透明度為 50% 的藍色顏色,請指定下列項目:<color>7fff0000</color>

注意:<geomColor> 元素已淘汰。請改用 <color>。

<drawOrder>
此元素定義重疊重疊圖片的堆疊順序。系統會將 <drawOrder> 值較高的疊加層繪製在 <drawOrder> 值較低的疊加層之上。
<Icon>
定義與重疊廣告相關聯的圖片,<href> 元素會定義要當做疊加層使用的圖片位置。這個位置可以是本機檔案系統或網路伺服器中。如果省略這個元素或未包含 <href>,系統會使用地面或螢幕疊加層定義的色彩和大小繪製矩形。
<Icon>
   <href>icon.jpg</href>
</Icon>

擴充

已擴充

<PhotoOverlay>

語法

<PhotoOverlay>
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon> <href>...</href> <!-- anyURI --> ... </Icon> <!-- specific to PhotoOverlay --> <rotation>0</rotation> <!-- kml:angle180 --> <ViewVolume> <leftFov>0</leftFov> <!-- kml:angle180 --> <rightFov>0</rightFov> <!-- kml:angle180 --> <bottomFov>0</bottomFov> <!-- kml:angle90 --> <topFov>0</topFov> <!-- kml:angle90 --> <near>0</near> <!-- double --> </ViewVolume> <ImagePyramid> <tileSize>256</tileSize> <!-- int --> <maxWidth>...</maxWidth> <!-- int --> <maxHeight>...</maxHeight> <!-- int --> <gridOrigin>lowerLeft</gridOrigin> <!-- lowerLeft or upperLeft --> </ImagePyramid> <Point> <coordinates>...</coordinates> <!-- lon,lat[,alt] --> </Point> <shape>rectangle</shape> <!-- kml:shape --> </PhotoOverlay>

說明

<PhotoOverlay> 元素可讓您在地理上定位相片,並在該疊加層中指定此 PhotoOverlay。PhotoOverlay 可以是簡單的 2D 矩形、局部或完整圓柱體或球體 (用於球型全景)。重疊廣告會放在指定的位置,且朝向視角呈現。

由於 <PhotoOverlay> 衍生自 <Feature>,所以它可能包含 <AbstractView> 的兩個元素之一 <Camera> 或 <LookAt>。Camera (或 LookAt) 指定了視角檢視方向 (也稱為檢視向量)。PhotoOverlay 是與視角相關的位置。具體來說,2D 矩形圖片的平面正交 (左右的角度),可用來檢視檢視向量。這個平面的正常方向 (也就是相片的正面) 是指向視角。

PhotoOverlay 圖像的網址是在 <Icon> 標記中指定,而該標記是沿用自 <Overlay>。<Icon> 標記必須包含 <href> 元素,用於指定 PhotoOverlay 要使用的圖片檔。針對超大型圖片,<href> 是一種特殊網址,可建立索引為不同解析度的圖片金字塔 (請參閱 ImagePyramid)。

如需詳細資訊,請參閱 PhotoOverlay 中的「KML 中的主題」頁面。

PhotoOverlay 專用的元素

<rotation>
調整相片在檢視畫面欄位中的位置。如果您的相片已旋轉,而且偏離所需水平的檢視畫面,便很適合使用這項元素。
<ViewVolume>
定義目前情境的可見程度。指定視角與指定實體相機中的鏡頭開關類似。小型視野 (例如望遠鏡頭) 著重於場景的一小部分。大視野,就像廣角鏡頭一樣,能聚焦在拍攝場景的很大一部分。
<leftFov>
從相機的視角到畫面左側左側之間,呈現的角度。
<rightFov>
以度數 (度) 為單位,攝影機的視角與檢視畫面的右方之間有角度。
<bottomFov>
從相機的視角到畫面底下方,以角度為單位測量角度。
<topFov>
從相機的視角到檢視角度的上方,以角度為單位測量角度。
<near>
從相機視角到 PhotoOverlay 形狀的觀察方向,以公尺為單位進行測量。
PhotoOverlay 的視野由四個平面定義,每個平面會以相對於檢視向量的角度指定。這四個平面定義了視野的上、下、左、右,其形狀是切割金字塔的形狀,如下所示:
下圖顯示這個金字塔內四個視圖的角度:
<ImagePyramid>
如果是非常大的圖片,你需要建構圖片金字塔,這是一組階層式的圖片,每張圖片的解析度比原始圖片越來越低。金字塔中的每個圖片都會細分成圖塊,因此您只需要載入檢視畫面中的部分內容。「Google 地球」會計算目前的檢視點,並載入符合使用者與圖片距離的圖塊。當視角接近 PhotoOverlay 時,Google 地球會載入高解析度的圖塊。由於原始圖片中的所有像素無法在畫面上同時檢視,因此這項處理功能可讓「Google 地球」達到最高效能,因為系統只會載入目前檢視的影像內容部分,並且只可在目前檢視點以使用者分辨的像素細節。
指定圖片金字塔時,您必須修改 <Icon> 元素中的 <href> 以加入要載入哪些圖塊的規格。
<tileSize>
圖塊的大小,以像素為單位。圖塊必須是方形,<tileSize> 必須是 2 的冪次方。建議大小為 256 (預設) 或 512。原始圖片分為不同尺寸的圖塊,且解析度不同。
<maxWidth>
原始圖片的寬度 (以像素為單位)。
<maxHeight>
原始圖片的高度 (以像素為單位)。
<gridOrigin>
指定從金字塔的每一層開始標示編號的位置。值為 lowerLeft 的值,表示每個圖層的第 1 列第 1 列位於格狀網的左下角。
<點數>
<Point> 元素在 <Placemark> 元素中扮演 <Point> 元素。它會繪製一個圖示來標示 PhotoOverlay 的位置。您繪製的圖示是由 <styleUrl> 和 <StyleSelector> 欄位指定,就像 <Placemark> 一樣。
<shape>
PhotoOverlay 投影到 <shape> 上。<shape> 可以是下列任一值:

rectangle (預設) - 用於一般相片

cylinder - 適用於全景,可以是部分或完整圓柱體

sphere:適用於球型全景

範例

<PhotoOverlay>
  <!-- Feature elements -->
  <name>A simple non-pyramidal photo</name>
  <description>High above the ocean</description>
  <!-- Overlay elements -->
  <Icon>
  <!-- A simple normal jpeg image -->
  <href>small-photo.jpg</href>
  </Icon>
  <!-- PhotoOverlay elements -->
  <!-- default: <rotation> default is 0 -->
  <ViewVolume>
    <near>1000</near>
    <leftFov>-60</leftFov>
    <rightFov>60</rightFov>
    <bottomFov>-45</bottomFov>
    <topFov>45</topFov>
  </ViewVolume>
  <!-- if no ImagePyramid only level 0 is shown,
       fine for a non-pyramidal image -->
  <Point>
    <coordinates>1,1</coordinates>
  </Point>
  <!-- default: <shape> -->
</PhotoOverlay>

擴充

包含

<Placemark>

語法

<Placemark id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 -->
<!-- specific to Placemark element --> <Geometry>...</Geometry> </Placemark>

說明

地標是與相關幾何圖形相關的功能。在「Google 地球」中,「地標」會以清單項目的形式顯示在 [位置] 面板中。標有「點」的「地標」有一個圖示,會在 3D 檢視器中標示地球上的一個點。(在「Google 地球」3D 檢視器中,「點地標」是唯一可以點擊或將滑鼠遊標移到上的物件。其他幾何圖形物件在 3D 檢視器中沒有圖示。為了讓使用者在 3D 檢視器中點擊某個項目,您需要建立包含點和另一個幾何圖形物件的 MultiGeometry 物件)。

地標專用的元素

範例

<Placemark>
  <name>Google Earth - New Placemark</name>
  <description>Some Descriptive text.</description>
  <LookAt>
    <longitude>-90.86879847669974</longitude>
    <latitude>48.25330383601299</latitude>
    <range>440.8</range>
    <tilt>8.3</tilt>
    <heading>2.7</heading>
  </LookAt>
  <Point>
    <coordinates>-90.86948943473118,48.25450093195546,0</coordinates>
  </Point>
</Placemark>

擴充

包含

另請參閱

<Point>

語法

<Point id="ID">
  <!-- specific to Point -->
  <extrude>0</extrude>                        <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>              <!-- lon,lat[,alt] -->
</Point>

說明

由經度、緯度和 (選填) 高度定義的地理位置。當「點」包含「地標」時,該點本身會決定「地點」名稱和圖示的位置。當點點點已經中斷時,該線條會和地面連線;這個「網路共用」會使用目前的 LineStyle。

分數專用的元素

<extrude>
布林值。指定是否要以線條將點連接到地面。如要凸出某個點,<ElevationMode> 的值必須為 relativeToGroundrelativeToSeaFloor絕對。這個點會往地球球的中心延伸。
<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,在 <Coordinates> 標記中)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。這個模式的常見用途是放置電話桿或滑雪纜車。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。飛機通常用於這個模式。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor:將高度解讀為以公尺為單位的高度。如果海拔高度是陸上而非海上,系統會將這些高度解讀為高於地面。
  • clampToSeaFloor - 忽略高度規格,並將該點放置在海床上。如果該點位於陸上而非海上,則該點會置於地面上。
<座標> (必填)
包含由經度、緯度和高度 (依此順序) 組成的浮點值組成的單一元組。經度與緯度值以度為單位,其中
  • 經度 ≥ -180 且 <= 180
  • 緯度 ≥ -90 且 ≤ 90
  • Elevation 值 (選用) 高於海平面
請勿在說明座標的三個值之間加入空格。

範例

<Point>
  <coordinates>-90.86948943473118,48.25450093195546</coordinates>
</Point>

擴充

包含

<Polygon>

語法

<Polygon id="ID">
  <!-- specific to Polygon -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <outerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </outerBoundaryIs>
  <innerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </innerBoundaryIs>
</Polygon>

說明

多邊形是由外邊界和 0 個或更多的內部邊界所定義。邊界則由 LinearRings 定義。當多邊形被延伸時,其界線會連接至地面以形成額外的多邊形,從而提供建築物或方框的外觀。外型多邊形使用 <PolyStyle> 做為色彩、色彩模式和填滿色彩。

多邊形的 <座標> 必須按照逆時針順序指定。多邊形會遵循「右方規則」,指出如果將右手手指放在指定座標的方向,你的拇指會指向多邊形的幾何法線一般方向。(在 3D 圖形中,使用幾何圖形法進行照明,且遠離多邊形的正面)。由於 Google 地球只會填滿多邊形的正面,因此只有在以適當的順序指定座標時,才會達到您所需的效果。否則多邊形會呈現灰色。

注意:在「Google 地球」中,具有 <ElevationMode> 的 clampToGround 路徑的多邊形會跟隨常駐航線;但是,如果 <高度模式> 為 clampToGround 的 LinearRing 會跟隨大圓線。

多邊形專用的元素

<extrude>
布林值。指定是否要將多邊形連接至地面。要計算多邊形,海拔高度模式必須是 relativeToGroundrelativeToSeaFloor絕對。只有頂點會突破,而不是幾何圖形本身 (例如,矩形變成一個有五個面的方塊)。多邊形的頂點會往地球球中心延伸。
<tessellate>
多邊形不使用這個欄位。如要允許多邊形隨著地形移動 (也就是啟用銷售功能),請將 clampToGroundclampToSeaFloor 指定為海拔高度模式。
<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,在 <Coordinates> 標記中)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。這個模式的常見用途是放置電話桿或滑雪纜車。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。飛機通常用於這個模式。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果海拔高度是陸上而非海上,系統會將這些高度解讀為高於地面。
  • clampToSeaFloor - 忽略高度規格,並將該點放置在海床上。如果該點位於陸上而非海上,則該點會置於地面上。
<outerBoundaryIs>(必填)
包含 <LinearRing> 元素。
<innerBoundaryIs>
包含 <LinearRing> 元素。 多邊形可包含多個 <innerBoundaryIs> 元素,其會在多邊形內建立多個凹口。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Polygon.kml</name>
<open>0</open>
<Placemark>
<name>hollow box</name>
<Polygon>
<extrude>1</extrude>
<altitudeMode>relativeToGround</altitudeMode>
<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>

擴充

包含

<PolyStyle>

語法

<PolyStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to PolyStyle -->
  <fill>1</fill>                     <!-- boolean -->
  <outline>1</outline>               <!-- boolean -->
</PolyStyle>

說明

指定所有多邊形的繪圖樣式,包括多邊形延伸 (看起來像建築物的牆壁) 和線條擴展 (看起來像實心圍欄)。

PolyStyle 專用的元素

<fill>
布林值。指定是否要填滿多邊形。
<outline>
布林值。指定是否要繪製多邊形的外框。多邊形大綱使用目前的 LineStyle。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>PolygonStyle.kml</name>
<open>1</open>
<Style id="examplePolyStyle">
<PolyStyle>
<color>ff0000cc</color>
<colorMode>random</colorMode>
</PolyStyle>
</Style>
<Placemark>
<name>hollow box</name>
<styleUrl>#examplePolyStyle</styleUrl>
<Polygon>
<extrude>1</extrude>
<altitudeMode>relativeToGround</altitudeMode>
<outerBoundaryIs>
<LinearRing>
<coordinates>
-122.3662784465226,37.81884427772081,30 -122.3652480684771,37.81926777010555,30 -122.365640222455,37.81986126286519,30 -122.36666937925,37.81942987753481,30 -122.3662784465226,37.81884427772081,30 </coordinates>
</LinearRing>
</outerBoundaryIs>
<innerBoundaryIs>
<LinearRing>
<coordinates>
-122.366212593918,37.81897719083808,30 -122.3654241733188,37.81929450992014,30 -122.3657048517827,37.81973175302663,30 -122.3664882465854,37.81940249291773,30 -122.366212593918,37.81897719083808,30 </coordinates>
</LinearRing>
</innerBoundaryIs>
</Polygon>
</Placemark>
</Document>
</kml>

擴充

包含

<Region>

語法

<Region id="ID"> 
  <LatLonAltBox>
    <north></north>                            <!-- required; kml:angle90 -->
    <south></south>                            <!-- required; kml:angle90 -->
    <east></east>                              <!-- required; kml:angle180 -->
    <west></west>                              <!-- required; kml:angle180 -->
    <minAltitude>0</minAltitude>               <!-- float -->
    <maxAltitude>0</maxAltitude>               <!-- float -->
    <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  </LatLonAltBox>
  <Lod>
    <minLodPixels>0</minLodPixels>             <!-- float -->
    <maxLodPixels>-1</maxLodPixels>            <!-- float -->
    <minFadeExtent>0</minFadeExtent>           <!-- float -->
    <maxFadeExtent>0</maxFadeExtent>           <!-- float -->
  </Lod>
</Region> 

說明

區域包含一個定界框 (<LatLonAltBox>),可說明由地理座標和高度定義的搜尋區域。此外,「區域」包含 LOD (詳細程度) 範圍 (<Lod>),能根據預測的螢幕大小定義相關地區的有效範圍。當定界框位於使用者的畫面中,且符合 LOD 規定時,一個區域會被視為「有效」。與區域相關聯的物件只有在該區域啟用時才會繪製。當 <viewRefreshMode> 為 onRegion 時,系統只會在區域啟用時載入連結或圖示。如需詳細資訊,請參閱地區中的「KML 主題」頁面。在容器或 NetworkLink 階層中,此計算會使用階層中最接近的祖系地區。

各地區專屬的元素

<LatLonAltBox>(必要)
一個定界框,用於說明由地理座標和高度定義的搜尋區域。預設值和必填欄位如下:
<海拔高度模式> 或 <gx:海拔高度模式>
<heightMode> 的值可能為 clampToGroundrelativeToGround絕合。<gx:heightMode> 可能的值為 clampToSeaFloorrelativeToSeaFloor。另請參閱 <LatLonBox>
<minAltitude>
以公尺為單位指定 (會受到高度模式規格影響)。
<maxAltitude>
以公尺為單位指定 (會受到高度模式規格影響)。
<north> (必填)
指定定界框北端的緯度,以 0 到 ±90 的小數度數表示。
<south> (必填)
指定定界框南端的緯度,以 0 到 ±90 的小數度數表示。
<east> (必填)
指定定界框東側邊緣的經度,以 0 到 ±180 的小數度數表示。
<west> (必填)
指定定界框西側的經度,以 0 到 ±180 的小數度數表示。
<LatLonAltBox>
<north>43.374</north>
<south>42.983</south>
<east>-0.335</east>
<west>-1.423</west>
<minAltitude>0</minAltitude>
<maxAltitude>0</maxAltitude>
</LatLonAltBox>
<Lod>
Lod詳細程度的縮寫。<Lod> 說明將預計區域為「有效」時,螢幕上所需的投影區域大小。同時指定用於淡入 (從透明到不透明) 和淡出 (從不透明到透明) 淡出的像素坡道的大小。請查看下方的示意圖,瞭解這些參數的示意圖。
<Lod>
<minLodPixels>256</minLodPixels>
<maxLodPixels>-1</maxLodPixels>
<minFadeExtent>0</minFadeExtent>
<maxFadeExtent>0</maxFadeExtent>
</Lod>
<minLodPixels> (必填)

定義螢幕空間中的正方形,指定值的兩側以像素為單位。例如,128 定義的是 128 x 128 像素的正方形。區域的定界框必須大於這個正方形 (且小於 maxLodPixels 的方格),區域才會生效。

詳情請參閱《開發人員指南》的「使用地區」章節,以及 Google 地球推廣計畫說明文件的「避免使用地區超載」教學課程。

<maxLodPixels>
以像素為單位的測量結果,代表特定區域的顯示設定範圍上限。如果值為 -1,預設值為「有效到無限量」。
<minFadeExtent>
幾何圖形淡出的距離,從完全不透明到完全透明。此百分比值 (以螢幕像素表示) 會套用在 LOD (可見度) 限制的最低端。
<maxFadeExtent>
幾何圖形淡出的距離,從完全透明到完全不透明。此百分比值 (以螢幕像素表示) 會套用在 LOD (可見度) 上限的最高結尾。
在下圖中,如果 P= 計算的預測像素大小,圓圈上標示的數字表示:
if (P < minLodPixels)
  opacity=0                                 //#1 in diagram
else if(P < minLodPixels + minFadeExtent)
  opacity=(P - minLodPixels)/minFadeExtent  //#2 in diagram
else if (P < maxLodPixels - maxFadeExtent)
  opacity=1                                 //#3 in diagram
else if (P < maxLodPixels)
  opacity=(maxLodPixels-P)/maxFadeExtent    //#4 in diagram
else
  opacity=0                                 //#5 in diagram

<Region>範例

<Region>
  <LatLonAltBox>
    <north>50.625</north>
    <south>45</south>
    <east>28.125</east>
    <west>22.5</west>
    <minAltitude>10</minAltitude>
    <maxAltitude>50</maxAltitude>
  </LatLonAltBox>
  <Lod>
    <minLodPixels>128</minLodPixels>
    <maxLodPixels>1024</maxLodPixels>
    <minFadeExtent>128</minFadeExtent>
    <maxFadeExtent>128</maxFadeExtent>
  </Lod>
</Region> 

擴充

包含

<結構定義>

語法

<Schema name="string" id="ID">
  <SimpleField type="string" name="string">
    <displayName>...</displayName>            <!-- string -->
  </SimpleField>
</Schema>

說明

指定自訂的 KML 架構,可用於將自訂資料新增至 KML 功能。「id」為必要屬性,且 KML 檔案中不能重複。<Schema> 一律為 <Document> 的子項。

結構定義專屬的元素

結構定義元素包含一或多個 SimpleField 元素。在 SimpleField 中,結構定義會宣告自訂欄位的 typename。您可以視需要為這個自訂欄位指定 displayName (使用者容易使用的表單,以及空格和適當的標點符號,用於 Google 地球)。

<SimpleField type="string" name="string">
自訂欄位的宣告,且必須同時指定這個欄位的「類型」和「名稱」。如果省略 typename,系統會忽略這個欄位。type 可以是以下其中一種:
  • string
  • int
  • Uint
  • short
  • UShort
  • 浮動
  • 雙精度值
  • bool
<顯示名稱>
用於向 Google 地球使用者顯示欄位名稱時使用的名稱 (如果有的話)。請使用 [CDATA] 元素來逸出標準 HTML 標記。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Schema name="TrailHeadType" id="TrailHeadTypeId"> <SimpleField type="string" name="TrailHeadName"> <displayName><![CDATA[<b>Trail Head Name</b>]]></displayName> </SimpleField> <SimpleField type="double" name="TrailLength"> <displayName><![CDATA[<i>The length in miles</i>]]></displayName> </SimpleField> <SimpleField type="int" name="ElevationGain"> <displayName><![CDATA[<i>change in altitude</i>]]></displayName> </SimpleField> </Schema>
</Document>
</kml>

擴充

這是根元素。

包含

另請參閱

<ScreenOverlay>

語法

<ScreenOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon>...</Icon> <!-- specific to ScreenOverlay --> <overlayXY x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <!-- xunits and yunits can be one of: fraction, pixels, or insetPixels --> <screenXY x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <rotationXY x="double" y="double" xunits="fraction" yunits"fraction"/> <!-- vec2 --> <size x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <rotation>0</rotation> <!-- float --> </ScreenOverlay>

說明

這個元素會繪製固定在畫面中的圖片圖像。ScreenOverlays 的使用範例包括指南針、標誌和抬頭顯示器。ScreenOverlay 大小由 <size> 元素決定。將 <疊加層 X> 指定的影像上的點對應至 <畫面 XX> 所指定畫面上的點,即可處理疊加層的位置。接著,影像會相對於 <旋轉 XY> 所指定螢幕的特定點旋轉 <旋轉> 度。

<Icon> 的 <href> 子元素會指定要當做疊加層使用的圖片。這個檔案可存放在本機檔案系統或網路伺服器上。如果省略這個元素或不包含 <href>,系統會使用螢幕重疊的色彩和大小繪製矩形。

ScreenScreen 專屬的元素

<overlayXY>
指定要對應至螢幕座標 (<screenXY>) 的重疊影像上的 (或不在) 點。它需要 xy 值,以及這些值的單位。
xy 值可以透過三種不同方式指定:像素 ("pixels")、圖片的片段 ("fraction") 或插邊像素 ("insetPixels"),這是指圖片右上角以像素為單位的偏移值。xy 的位置可以用不同的方式指定,例如,x 可以是像素,y 可以是小部分。座標系統的來源位於圖片左下角。
  • x :像素數、圖片部分元件,或可指出重疊影像上某個點的 x 元件的像素插邊。
  • y :像素數、圖片部分元件,或可指出重疊影像上某個點「y」元件的像素插邊。
  • xunits - 指定 x 值的單位。"fraction" 值表示 x 值是圖片的一部分。"pixels" 值表示以像素表示的 x 值。"insetPixels" 值表示從圖片右側邊緣縮排。
  • yunits - 指定 y 值的單位。"fraction" 值表示 y 值是圖片的一小部分。"pixels" 值表示以 y 為像素的數值。"insetPixels" 值表示從圖片上方邊緣開始縮排。
<screenXY>
指定疊加層圖像所對應的畫面來源點。xy 值可用三種方式指定:像素 ("pixels")、螢幕片段 ("fraction")插邊像素 ("insetPixels"),這是指螢幕右上角偏移的像素偏移值 (以像素為單位)。 xy 的位置可以用不同的方式指定,例如,x 可以是像素,y 可以是小部分。 座標系統的來源位於畫面左下角。
  • x - 像素數、畫面中的小數元件或代表某個點的 x 元件的像素插邊。
  • y - 像素數、螢幕上的小數元件或代表點的 y 元件的像素插邊。
  • xunits - 指定 x 值的單位。"fraction" 值表示 x 值是畫面的一小部分。"pixels" 值表示以像素表示的 x 值。"insetPixels" 值表示從畫面右側邊緣縮排。
  • yunits - 指定 y 值的單位。fraction 的值表示 y 值佔畫面的一小部分。"pixels" 值表示以 y 為像素的數值。"insetPixels" 值表示從畫面頂端上方縮排。
舉例來說,<screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> 表示畫面中央的某個點。
以下舉例說明:

將圖片置中:

<ScreenOverlay>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

將圖片放置在左上角:

<ScreenOverlay>
  <overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="0" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay> 

將圖片放置在畫面右側:

<ScreenOverlay>
  <overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="1" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>  
<rotationXY>
相對於螢幕疊加層的旋轉螢幕方向。
<size>
指定螢幕重疊畫面的圖片大小,如下所示:
  • 如果值為 -1,表示要使用原生維度
  • 如果這個值為 0,表示維持長寬比
  • n 的值會設定維度的值
範例:

如要強制讓圖片保留原本的 xy 尺寸,請將值設為 -1:

<size x="-1" y="-1" xunits="fraction" yunits="fraction"/> 

強制圖片保留水平尺寸,但只佔據垂直畫面空間的 20%:

<size x="-1" y="0.2" xunits="fraction" yunits="fraction"/> 

如何強制圖片調整為 100x500px:

<size x="100" y="500" xunits="pixels" yunits="pixels"/> 
<rotation>
表示上層物件的旋轉角度。如果填入 0,表示不會旋轉。這個值是從正北方逆時針的角度 (以度為單位)。使用 ±180 表示父項物件的從 0 旋轉。在 <rotationXY> 中指定 <rotation> 的中心點 (如果不是 (.5,.5)。

範例

以下範例使用圖片的原始寬度、高度和長寬比,將圖片放置在畫面正中央。

<ScreenOverlay id="khScreenOverlay756">
  <name>Simple crosshairs</name>
  <description>This screen overlay uses fractional positioning
   to put the image in the exact center of the screen</description>
  <Icon>
    <href>http://myserver/myimage.jpg</href>
  </Icon>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <rotation>39.37878630116985</rotation>
  <size x="0" y="0" xunits="pixels" yunits="pixels"/>
</ScreenOverlay>

擴充

包含

<Style>

語法

<Style id="ID">
<!-- extends StyleSelector -->

<!-- specific to Style -->
  <IconStyle>...</IconStyle>
  <LabelStyle>...</LabelStyle>
  <LineStyle>...</LineStyle>
  <PolyStyle>...</PolyStyle>
  <BalloonStyle>...</BalloonStyle>
  <ListStyle>...</ListStyle>
</Style>

說明

「樣式」會定義可定址的樣式群組,可由 StyleMap 和 地圖項目參照。樣式會影響 3D 檢視器中幾何圖形的呈現方式,以及 [清單] 檢視在 [地點] 面板中的 [地圖項目] 面板的顯示方式。共用樣式是在 <Document> 中收集,而且必須為其定義 id,才能供使用這些樣式的個別特徵參照。

使用 id 表示 <styleUrl> 中的樣式。

範例

<Document>
  <!-- Begin Style Definitions -->
  <Style id="myDefaultStyles">
    <IconStyle>
      <color>a1ff00ff</color>
      <scale>1.399999976158142</scale>
      <Icon>
        <href>http://myserver.com/icon.jpg</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <color>7fffaaff</color>
      <scale>1.5</scale>
    </LabelStyle>
    <LineStyle>
      <color>ff0000ff</color>
      <width>15</width>
    </LineStyle>
    <PolyStyle>
      <color>7f7faaaa</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <!-- End Style Definitions -->
  <!-- Placemark #1 -->
  <Placemark>
    <name>Google Earth - New Polygon</name>
    <description>Here is some descriptive text</description>
    <styleUrl>#myDefaultStyles</styleUrl>
    . . .
  </Placemark>
  <!-- Placemark #2 -->
  <Placemark>
    <name>Google Earth - New Path</name>
    <styleUrl>#myDefaultStyles</styleUrl>
      . . . .
  </Placemark>
</Document>
</kml>

擴充

包含

特定樣式的元素

<StyleMap>

語法

<StyleMap id="ID">
  <!-- extends StyleSelector -->
  <!-- elements specific to StyleMap -->
  <Pair id="ID">
    <key>normal</key>              <!-- kml:styleStateEnum:  normal or highlight -->
    <styleUrl>...</styleUrl> or <Style>...</Style>
  </Pair>
</StyleMap>

說明

兩個不同樣式之間的 <StyleMap> 對應。通常,一個 <StyleMap> 元素可用來提供一個地標的正常樣式與醒目顯示的樣式,如此一來,當滑鼠遊標懸停在「Google 地球」的圖示上時,就會顯示該版本。

StyleMap 專用的元素

<配對>(必要)
定義鍵/值組合,將模式 (normalhighlight) 對應至預先定義的 <styleUrl>。<Pair> 包含兩個元素 (兩者皆是):
  • <key>,用於識別金鑰
  • <styleUrl><Style>,參照樣式。在 <styleUrl> 中,針對 KML 文件的本機參照樣式元素,會使用簡單的 # 參照。針對外部檔案中包含的樣式,請使用完整網址和 # 參照。例如:
<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair> 

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>StyleMap.kml</name>
<open>1</open>
<Style id="normalState">
<IconStyle>
<scale>1.0</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon55.png</href>
</Icon>
</IconStyle>
<LabelStyle>
<scale>1.0</scale>
</LabelStyle>
</Style>
<Style id="highlightState">
<IconStyle>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon60.png</href>
</Icon>
<scale>1.1</scale>
</IconStyle>
<LabelStyle>
<scale>1.1</scale>
<color>ff0000c0</color>
</LabelStyle>
</Style>
<StyleMap id="styleMapExample">
<Pair>
<key>normal</key>
<styleUrl>#normalState</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#highlightState</styleUrl>
</Pair>
</StyleMap>
<Placemark>
<name>StyleMap example</name>
<styleUrl>#styleMapExample</styleUrl>
<Point>
<coordinates>-122.368987,37.817634,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

擴充

包含

<StyleSelector>

語法

<!-- abstract element; do not create -->
<!-- StyleSelector id="ID" -->                 <!-- Style,StyleMap -->
<!-- /StyleSelector -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。這是 <Style> 與 <StyleMap> 元素的基礎類型。StyleMap 元素會根據地標目前的模式選取樣式。由 StyleSelector 衍生的元素會以其 id 和其 url 來識別。

StyleSelector 專用的元素

這個抽像元素不含任何子元素。

擴充

已擴充

<TimePrimitive>

語法

<!-- abstract element; do not create -->
<!-- TimePrimitive id="ID" -->            <!-- TimeSpan,TimeStamp -->
  <!-- extends Object -->
<!-- /TimePrimitive -->

說明

這是抽像元素,無法直接在 KML 檔案中使用。這個元素是由 <TimeSpan> 和 <TimeStamp> 元素延伸。

擴充

已擴充

<TimeSpan>

語法

<TimeSpan id="ID">
  <begin>...</begin>     <!-- kml:dateTime -->
  <end>...</end>         <!-- kml:dateTime -->
</TimeSpan>

說明

代表以開始和結束 dateTimes 為限的時間範圍。

如果缺少 <begin> 或 <end>,則尾段的結束時間將不受限制 (請參閱下方範例)。

根據 XML 架構時間定義 dateTime (請參閱 XML 結構定義第 2 部分:第二種資料類型)。這個值可以表示為 yyyy-mm-dd Thh:mm:ss.sss zzzzzz。 此外,這個值只能表示日期。如需範例,請參閱 <TimeStamp>

TimeSpan 專屬的元素

<begin>
說明時間範圍的開始時間。如未提供,時段的起始則不受限制。
<end>
說明特定時間範圍的結束時間。如果缺少這個時段,則代表經期結束。

範例

以下範例顯示科羅拉多州的營業時段。它只包含 <begin> 標記,因為科羅拉多是在 1876 年 8 月 1 日成為一個狀態,而且仍然是狀態:

<Placemark>
  <name>Colorado</name>
  .
  .
  .
  <TimeSpan>
    <begin>1876-08-01</begin>
  </TimeSpan>
</Placemark>

擴充

包含

<TimeStamp>

語法

<TimeStamp id="ID">
  <when>...</when>      <!-- kml:dateTime -->
</TimeStamp> 

說明

代表單一時間點。這是一個簡單的元素,不含任何子元素。其值為 dateTime,以 XML 時間指定 (請參閱 XML 架構第 2 部分:第二版資料類型)。TimeStamp 的精確度是由 <when> 元素中的 dateTime 值決定。

TimeStamp 專用的元素

<when>
指定單一時間點。這個值是 dateTime,可以是下列任一值:
  • dateTime 提供第二個解析度
  • date 提供日期解析
  • gYearMonth 可解析月份
  • gYear 提供年份解析

以下範例顯示 <when> 值的不同解析度:

  • gYear (YYYY)
<TimeStamp>
  <when>1997</when>
</TimeStamp>
  • gYearMonth (YYYY-MM)
<TimeStamp>
  <when>1997-07</when>
</TimeStamp> 
  • date (YYYY-MM-DD)
<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp> 
  • dateTime (YYYY-MM-DDThh:mm:ssZ)
    這裡的 T 是日曆與小時標記符號之間的分隔符,Z 代表世界標準時間。(必須提供秒數)。
<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>
  • dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
    這個範例顯示當地時間,並將 ± 轉換為 UTC。
<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

擴充

包含

<gx:TimeSpan> 與 <gx:TimeStamp>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

擴充功能命名空間中的 <TimeSpan><TimeStamp> 元素副本。這允許在 AbstractViews (<Camera><LookAt>) 中納入時間值。時間值可用來控制歷史圖像、日光,以及有時間戳記功能的特徵。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>Views with Time</name>
    <open>1</open>
    <description>
      In Google Earth, enable historical imagery and sunlight,
      then click on each placemark to fly to that point in time.
    </description>

    <Placemark>
      <name>Sutro Baths in 1946</name>
      <Camera>
        <gx:TimeStamp>
          <when>1946-07-29T05:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.518172</longitude>
        <latitude>37.778036</latitude>
        <altitude>221.0</altitude>
        <heading>70.0</heading>
        <tilt>75.0</tilt>
      </Camera>
    </Placemark>

    <Placemark>
      <name>Palace of Fine Arts in 2002</name>
      <Camera>
        <gx:TimeStamp>
          <when>2002-07-09T19:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.444633</longitude>
        <latitude>37.801899</latitude>
        <altitude>139.629438</altitude>
        <heading>-70.0</heading>
        <tilt>75</tilt>
      </Camera>
    </Placemark>

  </Document>
</kml>

<gx:導覽>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:Tour id="ID">
  <name>...</name>
  <description>...</description>
  <gx:Playlist>

    <!-- any number of gx:TourPrimitive elements -->

  </gx:Playlist>
</gx:Tour>

說明

<gx:Tour> 可包含單一 <gx:Playlist> 元素,而該元素中也包含 gx:TourPrimitive 元素的已排序清單,該清單定義了任何 KML 瀏覽器的導覽。進一步瞭解導覽

範例

KML 開發人員指南》的「巡迴演出」章節中也提供許多導覽範例。

包含

  • gx:Playlist - 包含任意數量的 gx:TourPrimitive 元素。<gx:Tour> 元素可以包含 0 或一 <gx:Playlist> 元素。
    <gx:Tour>
      <gx:Playlist>
        <!-- gx:TourPrimitive -->
          ...
        <!-- /gx:TourPrimitive -->
    
        <!--- Any number of gx:TourPrimitive elements can be included --->
      </gx:Playlist>
    </gx:Tour>

<gx:TourPrimitive>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

<gx:Tour>
  <gx:Playlist>

    <!-- abstract element; do not create -->
    <!-- gx:TourPrimitive -->    <!-- gx:AnimatedUpdate, gx:FlyTo, gx:TourControl, gx:SoundCue, gx:Wait -->
        <!-- extends Object -->
    <!-- /gx:TourPrimitive -->

  </gx:Playlist>
</gx:Tour>

說明

這是抽像元素,無法直接在 KML 檔案中使用。這個元素是由 <gx:FlyTo><gx:AnimatedUpdate><gx:TourControl><gx:Wait><gx:SoundCue> 元素延伸。

gx:TourPrimitive 延伸的元素會在 遊覽期間提供 KML 瀏覽器指示,包括飛行的飛行時間和飛行時間、暫停時間、KML 功能更新,以及要播放的音訊檔案。

這些元素必須包含在 <gx:Playlist> 元素中,而後者元素則包含 <gx:Tour> 元素。

範例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">

  <Document>
    <name>gx:AnimatedUpdate example</name>
    <open>1</open>

    <Style>
      <IconStyle id="iconstyle">
        <scale>1.0</scale>
      </IconStyle>
    </Style>

    <Placemark id="mountainpin1">
      <name>New Zealand's Southern Alps</name>
      <styleUrl>#style</styleUrl>
      <Point>
        <coordinates>170.144,-43.605,0</coordinates>
      </Point>
    </Placemark>

    <gx:Tour>
      <name>Play me!</name>
      <gx:Playlist>

        <!-- The order and duration of TourPrimitives is important;
             in this example, the AnimatedUpdate needs
             6.5 seconds to complete. The FlyTo provides 4.1,
             and the Wait 2.4, giving the update time to
             complete before the Tour ends. AnimatedUpdates
             don't hold Tours open, but FlyTos and Waits do.

             For more information, refer to:
             http://developers.google.com/kml/documentation/touring#tourtimelines
        -->

        <gx:AnimatedUpdate>
          <gx:duration>6.5</gx:duration>
          <Update>
            <targetHref></targetHref>
            <Change>
                <IconStyle targetId="iconstyle">
                  <scale>10.0</scale>
                </IconStyle>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>4.1</gx:duration>
          <Camera>
            <longitude>170.157</longitude>
            <latitude>-43.671</latitude>
            <altitude>9700</altitude>
            <heading>-6.333</heading>
            <tilt>33.5</tilt>
            <roll>0</roll>
          </Camera>
        </gx:FlyTo>

        <gx:Wait>
          <gx:duration>2.4</gx:duration>  <!-- waiting for the AnimatedUpdate to complete -->
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>
  </Document>
</kml>

包含

延伸

  • <gx:AnimatedUpdate>
  • <gx:FlyTo>
  • <gx:SoundCue>
    <gx:SoundCue id="ID">
      <href>http://www.example.com/audio/trumpets.mp3</href>   <!-- any URI -->
      <gx:delayedStart>0</gx:delayedStart>                     <!-- double -->
    </gx:SoundCue>
    包含 <href> 元素,以 MP3、M4A 或 AAC 格式指定要播放的音效檔案。不含時間長度。音效檔案會與導覽的其餘部分同時播放,這表示下一個導覽基本功能會在達到 <gx:SoundCue> 導覽原始版本後立即生效。如果其他音效檔案會在第一個播放完成前進行取音,則系統會混合檔案。<gx:delayedStart> 元素會指定在播放檔案前,讓音訊延遲一段特定秒數。
  • <gx:TourControl>
    <gx:TourControl id="ID">
      <gx:playMode>pause</gx:playMode>    <!-- gx:playModeEnum: pause -->
    </gx:TourControl>
    包含單一 <gx:playMode> 元素,允許使用者暫停導覽,直到使用者採取動作才能繼續。
  • <gx:Wait>
    <gx:Wait id="ID">
      <gx:duration>0.0</gx:duration>    <!-- double -->
    </gx:Wait>
    相機仍會處於最終定義的 gx:AbstractView 中,並在播放下一個 gx:TourPrimitive 前指定的秒數。請注意,等候時間不會暫停遊覽時間軸;相機等待期間,系統會播放目前播放的音效檔案和動畫更新。

擴充

<gx:曲目>

這項元素是 OGC KML 2.2 標準的擴充功能,可支援 Google 地球 5.2 以上版本。瞭解詳情

語法

<gx:Track id="ID">
  <!-- specific to Track -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <when>...</when>                         <!-- kml:dateTime -->
  <gx:coord>...</gx:coord>                 <!-- string -->
  <gx:angles>...</gx:angles>               <!-- string -->
  <Model>...</Model>
  <ExtendedData>
    <SchemaData schemaUrl="anyURI">
      <gx:SimpleArrayData kml:name="string">
        <gx:value>...</gx:value>            <!-- string -->
      </gx:SimpleArrayData>
    <SchemaData>
  </ExtendedData>
</gx:Track>

說明

軌道描述物件在某段時間內的移動軌跡。這項功能可讓您建立一個可見的物件 (「點」圖示或「模型」),在 Google 地球中多次對同一個物件進行多個編碼編碼。在 Google 地球中,時間滑桿可讓使用者移動檢視畫面,以動畫呈現物件的位置。

gx:MultiTrack 元素可用來將多個軌跡收集到一個概念單元,其中包含一個沿著播放軌移動的關聯圖示 (或模型)。如果同一個實際物件有多個音軌,這項功能就非常實用。<gx:MultiTrack> 的 <gx:interpolate> 布林元素會指定在多軌中插入兩個軌跡。如果這個值為 0,代表點或模型會在一個軌跡結束時停止,並跳到下一首曲目的起點。(舉例來說,如果您希望單一地標代表您的兩天來的旅遊行程,同時在這段期間內,您的 GPS 單位已關閉 4 小時,建議您關閉該地點的停靠點之間的中斷點,再重新開啟。)如果 <gx:interpolate> 的值為 1,系統就會對 1 首曲目結束和下一組曲目開頭的值進行插補,讓該路徑以一個連續路徑顯示。

如要瞭解如何將 GPS 資料匯入「Google 地球」,請參閱 Google 地球使用者指南

曲目為什麼實用?

舊版 KML (Google 地球 5.2 以下版本) 可讓您將時間元素與任何「地圖項目」(地標、區域疊加層等) 建立關聯。不過,您只能將 1 個時間元素與指定的功能建立關聯。{1}

此外,軌道元素比先前的機制更強大 (請參閱《KML 開發人員指南》的「時間和動畫」章節),因為 <Track> 提供了在任何路徑中對物件位置進行內插作業的機制。有了這項新功能,Google 地球就能顯示物件在一段時間內的海拔高度和速度設定檔 (以及自訂資料,如果有的話)。

「稀疏」資料

當軌道中的位置缺少部分資料值時,可以提供空白的 <coord/> (<coord></coord>) 或 <angles/> (<angles></angles>) 標記來平衡陣列。空白的 <coord/> 或 <angles/> 標記表示特定資料點沒有此類資料,且該值應由最接近兩個精確指定的資料點之間的內插值。這個行為也適用於播放軌的 ExtendedData。除了 <when> 之外的任何元素都可以留空,並插入最接近的兩個指定明確的元素之間。

要追蹤的特定元素

<altitudeMode>
指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括:
  • clampToGround - (預設) 表示忽略高度規格 (例如,在 <gx:coord> 標記中)。
  • relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如,如果一個位置的地面高度剛好落在海平面,而該點的海拔高度設定為 9 公尺,則使用此模式時,圖示地標海拔高度的高度為 9 公尺。但是,如果將相同座標設為地面高度為海拔 10 公尺的位置,則座標座標為 19 公尺。
  • 絕對 - 設定座標相對於海平面的高度,不論元素下方地形的實際海拔高度為何。舉例來說,如果您使用絕對的高度模式將座標設為 10 公尺,當下方的地形也高於海平面 10 公尺時,點地標圖示將顯示為地面。如果地形比海平面高 3 公尺,地標上方將比平地高 7 公尺。
<gx:heightMode>
Google 擴充功能命名空間中的 KML 擴充功能,可讓海拔高度相對高於海底。可能的值如下:
  • relativeToSeaFloor:將高度解讀為以公尺為單位的高度。如果海拔高度是陸上而非海上,系統會將這些高度解讀為高於地面。
  • clampToSeaFloor - 忽略高度規格,並將該點放置在海床上。如果該點位於陸上而非海上,則該點會置於地面上。
<when>
與某個位置對應的 <時間> 值 (在 <gx:coord> 元素中指定)。在 <Track> 中,<when> 元素的數量必須等於 <gx:coord> 元素數量 (如果包含的話,則使用 <gx:angles> 元素)。
<gx:coord>
座標值由經度、緯度和高度這三個值組成,不含半形逗號分隔符。例如:
<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

請注意,<gx:coord> 元素的語法與 <協調中心 s 元素的語法不同,因為該語法使用半形逗號分隔經度、緯度和高度元件。指定的 元素數量應等於時間 () 和位置 () 元素的次數。如有需要,您可以為遺漏值指定空白的 <gx:coord> 元素。

<gx:angles>
這個值用於為軌道中的每個時間/位置指定額外的標題、傾斜和擲骰子值。這三個浮點值不列出半形逗號,並代表旋轉度數。如果未指定 <gx:angles>,Google 地球就會推斷物件的標題、傾斜和擲回軌。指定的 <gx:angles> 元素數量應等於時間 (<when>) 和位置 (<gx:coord>) 元素的次數。如有需要,您可以為遺漏值指定空白的 <gx:angles> 元素。

目前圖示僅支援標題,但模型支援全部三個值。

設定這個值的範例如下:

<gx:angles>45.54676 66.2342 77.0</gx:angles>
<型號>
如有指定,「模型」會取代用來指示軌道上目前位置的「點」圖示。在 <gx:Track> 中指定 <Model> 時,<Model> 函式的子項元素如下:
  • 系統會忽略 <Location> 元素。
  • 系統會忽略 <ElevationMode> 元素。
  • <Orientation> 值會和音軌方向結合,如下所示。首先,套用 <方向> 旋轉,將模型從本機 (x, y, z) 座標系統,往右面朝上、朝向北方方向。接下來,系統會套用 <gx:angles> 值的內插值,而該變化會影響模型隨著軌道移動的方向、傾斜和投擲。如果未指定角度,則會從模型的移動推論標題和傾斜角度。

    提示: 如果您不確定如何指定螢幕方向,請省略 <Model> 中的 <Orientation> 元素,並觀察 Google 地球沿著歷程移動時,如何決定模型的位置。如果您發現模型正面朝向前方,請修改 <方向方向> 中的 <heading> 元素來旋轉模型,使其指向前方。如果模型有誤,請嘗試修改 <tilt> 或 <roll> 元素。

<ExtendedData>

先前在 KML 檔案 <Schema> 中定義的自訂資料元素。

通常新增與軌道上時間/位置相關的擴充資料。例如,騎單車可以包括心率、步調和動力的資料,如擴充的歷程資料範例所示。您在 <Schema> 中為每個自訂資料類型定義 <gx:SimpleArrayField>。然後在每種資料類型中加入 <gx:SimpleArrayData> 元素,其中包含 <gx:value> 元素,該元素會對應至播放軌上的每個時間/位置。請參閱 KML 開發人員指南的「新增自訂資料」章節,進一步瞭解如何新增資料欄位。在「Google 地球」中,自訂資料會顯示於該軌道的 海拔高度設定檔中 。

簡易範例

這個基本範例說明如何為 <when> 和 <gx:coord> 建立平行的「陣列」值。時間值和位置值必須相等。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">
<Folder>
  <Placemark>
    <gx:Track>
      <when>2010-05-28T02:02:09Z</when>
      <when>2010-05-28T02:02:35Z</when>
      <when>2010-05-28T02:02:44Z</when>
      <when>2010-05-28T02:02:53Z</when>
      <when>2010-05-28T02:02:54Z</when>
      <when>2010-05-28T02:02:55Z</when>
      <when>2010-05-28T02:02:56Z</when>
      <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
      <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
      <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
      <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
      <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
      <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
      <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
    </gx:Track>
  </Placemark>
</Folder>
</kml>

使用擴充資料進行追蹤的範例

這個範例中的粗體類型標示用於定義及指定單車騎乘自訂元素的元素。自訂資料欄位在內部稱為「堆積」、「步調」和「電力」。<Schema> 元素會定義每一組值 (心跳速率、頻率和功率) 的名稱,並指定每個新欄位的資料類型 (斜體和步調的類型為 int,電源類型為 float)。在「Google 地球」中,這項自訂資料會顯示該軌道的海拔高度資料。

本例採用更寫實的軌跡呈現方式,提供自訂圖示以及獨立的圖示和線條樣式,以強調醒目顯示和一般模式。但請注意,此範例僅包含 7 組資料值。實際範例包含數萬個值。(資料由 Sean Broeder 提供。這些資料是透過 Garmin Edge 705 收集,並具有關聯的心率監測器和功率計。)

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:gx="http://www.google.com/kml/ext/2.2">
  <Document>
    <name>GPS device</name>
    <Snippet>Created Wed Jun 2 15:33:39 2010</Snippet>

    <!-- Normal track style -->
    <LookAt>
      <gx:TimeSpan>
        <begin>2010-05-28T02:02:09Z</begin>
        <end>2010-05-28T02:02:56Z</end>
      </gx:TimeSpan>
      <longitude>-122.205544</longitude>
      <latitude>37.373386</latitude>
      <range>1300.000000</range>
    </LookAt>
    <Style id="track_n">
      <IconStyle>
        <scale>.5</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
      <LabelStyle>
        <scale>0</scale>
      </LabelStyle>

    </Style>
    <!-- Highlighted track style -->
    <Style id="track_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="track">
      <Pair>
        <key>normal</key>
        <styleUrl>#track_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#track_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal multiTrack style -->
    <Style id="multiTrack_n">
      <IconStyle>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>

    </Style>
    <!-- Highlighted multiTrack style -->
    <Style id="multiTrack_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>8</width>
      </LineStyle>
    </Style>
    <StyleMap id="multiTrack">
      <Pair>
        <key>normal</key>
        <styleUrl>#multiTrack_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#multiTrack_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal waypoint style -->
    <Style id="waypoint_n">
      <IconStyle>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <!-- Highlighted waypoint style -->
    <Style id="waypoint_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="waypoint">
      <Pair>
        <key>normal</key>
        <styleUrl>#waypoint_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#waypoint_h</styleUrl>
      </Pair>
    </StyleMap>
    <Style id="lineStyle">
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>
    </Style>
    <Schema id="schema">
      <gx:SimpleArrayField name="heartrate" type="int">
        <displayName>Heart Rate</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="cadence" type="int">
        <displayName>Cadence</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="power" type="float">
        <displayName>Power</displayName>
      </gx:SimpleArrayField>
    </Schema>
    <Folder>
      <name>Tracks</name>
      <Placemark>
        <name>2010-05-28T01:16:35.000Z</name>
        <styleUrl>#multiTrack</styleUrl>
        <gx:Track>
          <when>2010-05-28T02:02:09Z</when>
          <when>2010-05-28T02:02:35Z</when>
          <when>2010-05-28T02:02:44Z</when>
          <when>2010-05-28T02:02:53Z</when>
          <when>2010-05-28T02:02:54Z</when>
          <when>2010-05-28T02:02:55Z</when>
          <when>2010-05-28T02:02:56Z</when>
          <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
          <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
          <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
          <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
          <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
          <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
          <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
          <ExtendedData>
            <SchemaData schemaUrl="#schema">
              <gx:SimpleArrayData name="cadence">
                <gx:value>86</gx:value>
                <gx:value>103</gx:value>
                <gx:value>108</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="heartrate">
                <gx:value>181</gx:value>
                <gx:value>177</gx:value>
                <gx:value>175</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="power">
                <gx:value>327.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>179.0</gx:value>
                <gx:value>162.0</gx:value>
                <gx:value>166.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>183.0</gx:value>
              </gx:SimpleArrayData>
            </SchemaData>
          </ExtendedData>
        </gx:Track>
      </Placemark>
    </Folder>
  </Document>
</kml>

擴充

包含

<更新>

語法

<Update>
  <targetHref>...</targetHref>    <!-- URL -->
  <Change>...</Change>
  <Create>...</Create>
  <Delete>...</Delete>
</Update>

說明

針對使用指定網址載入的 KML 資料,指定新增、變更或刪除 KML 資料。<targetHref> 指定 .KML.kmz 檔案 (在「Google 地球」內) 需修改資料。<Update> 一律包含在 NetworkLinkControl 中。此外,包含 NetworkLinkControl 的檔案必須由 NetworkLink 載入。如需更新運作方式的詳細說明,請參閱「更新」中的「KML 主題」頁面。

要更新的元素

可包含任意數量的 <Change>、<Create> 和 <Delete> 元素,系統會按照順序處理。

<targetHref>(必填)
網址,用來指定 Google,在 Google 地球中修改資料 (在 Google 地球中) 需透過 <Update> 元素修改。這個 KML 檔案必須透過 <NetworkLink> 載入。在這個檔案中,要修改的元素必須具有明確定義的 id 屬性。
<Change>
修改已使用 <NetworkLink> 載入的元素中的值。在 Element 元素中,要修改的子項必須包含參照原始元素的 idtargetId 屬性。
此次更新可以視為「稀疏的更新」:在修改的元素中,只有 <Change> 中列出的值會被取代;所有其他值則保持不變。如果對一組座標套用 <Change>,則新的座標會取代目前的座標。
這個元素的子項為修改的元素,透過 targetId 屬性識別。
<Create>
將新的元素新增到已透過 <NetworkLink> 載入的資料夾或文件中。<Update> 中的 <targetHref> 元素會指定包含原始資料夾或文件的 .KML.kmz 檔案的網址。在該檔案中,要包含新資料的「資料夾」或「文件」必須具有明確的 id。這個 id 會參照 <Create> 中的資料夾或文件的 targetId 屬性,其中包含要新增的元素。
建立物件並載入 Google 地球後,該物件會取得原始上層文件文件的網址。如要對使用這項更新/建立機制新增的物件執行後續更新,請將 <targetHref> 設為原始文件或資料夾的網址 (而非載入乾預更新檔案的網址)。
<Delete>
刪除已透過 <NetworkLink> 載入的複雜元素中的特徵。<Update> 中的 <targetHref> 元素會指定含有待刪除資料的 .KML.kmz 檔案。在這個檔案中,要刪除的元素必須具有明確定義的 id。<Delete> 元素在 targetId 屬性中參照這個 id
<Delete> 的子元素是唯一可以刪除的元素,分別是文件、資料夾、區域疊加層、地標和 ScreenOverlay。

<Change> 範例

<NetworkLinkControl>
  <Update>
    <targetHref>http://www/~sam/January14Data/Point.kml</targetHref>
    <Change> 
      <Point targetId="point123">
        <coordinates>-95.48,40.43,0</coordinates>
      </Point>
    </Change>
  </Update>
</NetworkLinkControl> 

<Create> 範例

此範例在先前建立的文件中,建立一個具有 id 為「region24」的地標。請注意,如果您之後想更新「placemark891」,仍必須使用 http://myserver.com/Point.KML 做為 <targetHref>。

<Update>
  <targetHref>http://myserver.com/Point.kml</targetHref>
  <Create>
    <Document targetId="region24">
      <Placemark id="placemark891">
        <Point>
          <coordinates>-95.48,40.43,0</coordinates>
        </Point>
      </Placemark>
    </Document>
  </Create> 
</Update>

<Delete> 範例

此範例會刪除之前載入到「Google 地球」的地標。(這個「地標」可能是由具有指定網址的 NetworkLink 直接載入,或是由後續的「更新」在原始文件的更新中所載入)。

<Update>
  <targetHref>http://www.foo.com/Point.kml</targetHref>
  <Delete>
    <Placemark targetId="pa3556"></Placemark>
  </Delete>
</Update> 

包含

<Url>

注意:這個元素已在 KML 版本 2.1 中淘汰,並由 <Link> 取代,可提供 Region 的額外功能。<Url> 標記仍可在「Google 地球」中運作,不過我們鼓勵您改用新版 <Link> 標記。

這個元素可用於設定 KML 檔案的連結位置、定義伺服器與檢視者變更的重新整理選項,以及填入變數,以便傳回實用的用戶端資訊給伺服器。

返回頁首