Trang này được dịch bởi Cloud Translation API.

Tham chiếu KML

Phần này chứa tham chiếu theo thứ tự bảng chữ cái cho tất cả các phần tử KML được xác định trong KML phiên bản 2.2, cũng như các phần tử trong không gian tên của phần mở rộng trên Google. Cây lớp cho các phần tử KML được hiển thị bên dưới. Trong sơ đồ này, các phần tử ở bên phải trên một nhánh cụ thể trong cây là các phần mở rộng của các phần tử ở bên trái. Ví dụ: dấu vị trí là một loại tính năng đặc biệt. Nó chứa tất cả các phần tử thuộc về tính năng và thêm một số phần tử dành riêng cho phần tử Dấu vị trí.

KML là một tiêu chuẩn mở được đặt tên chính thức là OpenGIS® KML Mã hóa tiêu chuẩn (OGC KML). Đường được duy trì bởi Open Geospatial Consortium, Inc. (OGC). Bạn có thể tìm thấy thông số kỹ thuật đầy đủ cho OGC KML tại http://www.opengeospatial.org/standards/SSH/.

Giản đồ XML hoàn chỉnh cho KML có tại http://schemas.opengis.net/SSH/.

Lưu ý: Hãy nhấp vào tên một phần tử trong sơ đồ này để chuyển đến mục của phần tử đó trong phần tham chiếu.

Hãy lưu ý rằng các phần tử trừu tượng (hiển thị trong các ô trong sơ đồ) không thực sự được sử dụng trong các tệp KML. Đây là cách hữu ích để một phần tử đóng vai trò là nền tảng có lập trình cho nhiều phần tử tương tự (nhưng khác nhau). Hiểu được hệ phân cấp hướng đối tượng này cũng là một cách tốt để tìm hiểu KML, vì bạn có thể dễ dàng xem các nhóm các phần tử có liên quan.

Tất cả các phần tử có nguồn gốc từ Đối tượng có thể được gán id. id này được cơ chế cập nhật KML sử dụng (xem <Update>) cho các tệp tải qua NetworkLink. Mã này cũng được các kiểu chia sẻ sử dụng (xem <Style>). id này là một mã XML chuẩn.

Vì KML là một ngữ pháp XML và định dạng tệp, nên tên thẻ có phân biệt chữ hoa chữ thường và phải xuất hiện chính xác như được trình bày tại đây. Nếu đã quen thuộc với XML, bạn cũng sẽ quan tâm đến Giản đồ KML 2.2. Khi chỉnh sửa tệp văn bản KML, bạn có thể tải Giản đồ này vào bất kỳ trình chỉnh sửa XML nào và xác thực mã KML bằng đó.

Mẹo: Xem KML cho các tính năng của Google Earth

Dưới đây là một tính năng hữu ích của Google Earth giúp bạn dễ dàng xem tệp KML cho bất kỳ Tính năng nào. Trong Google Earth, bạn có thể nhấp chuột phải vào một Tính năng trong bảng điều khiển Địa điểm và sao chép tính năng đó. Để xem KML tương ứng của đối tượng đã sao chép, hãy mở trình chỉnh sửa văn bản mà bạn yêu thích rồi dán lựa chọn đó vào.

Khả năng tương thích

Phiên bản KML có hệ thống đánh số kép: majorVersion.minorVersion. Tất cả các phiên bản có cùng majorVersion đều tương thích. Vì lý do này, nếu bạn thay đổi không gian tên thành "2.2" (tức là xmlns="http://www.opengis.net/kml/2.2"), thì tất cả các tệp KML 2.1 sẽ xác thực trong giản đồ KML 2.2.

Giới thiệu về tệp tham chiếu này

Mỗi mục tham chiếu bao gồm một phần Cú pháp liệt kê các phần tử có trong phần tử chính. Phần Cú pháp này là một trang thông tin không chính thức và sử dụng cách viết tắt đơn giản để tóm tắt các phần tử. Phần này cũng chứa các nội dung sau:

giá trị mặc định cho từng phần tử (hoặc dấu ba chấm nếu đó là phần tử phức tạp hoặc nếu không có giá trị mặc định)
loại giá trị (xem Trường KML)

Bạn có thể sao chép và sử dụng mục Cú pháp làm mẫu cho mọi phần tử không trừu tượng trong tệp KML.

Vùng tên tiện ích KML và tiền tố gx

Tiêu chuẩn KML OGC đưa ra cơ chế cho các phần mở rộng – các thành phần bổ sung chứa thông tin ngoài những gì có trong tiêu chuẩn (tìm hiểu thêm về vùng chứa tên XML tại w3.org). Với việc ra mắt Google Earth 5.0, Google đã cung cấp tiện ích cho KML để hỗ trợ một số tính năng mới. Các tiện ích này sử dụng tiền tố gx và URI không gian tên sau đây:

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

Bạn phải thêm URI không gian tên này vào phần tử <kml> trong mọi tệp KML bằng cách sử dụng các phần tử có tiền tố gx-:

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

Các tiện ích mở rộng đến KML có thể không được hỗ trợ trong tất cả các trình duyệt địa lý. Nếu trình duyệt của bạn không hỗ trợ các tiện ích cụ thể, thì dữ liệu trong các tiện ích đó sẽ tự động bị bỏ qua và phần còn lại của tệp KML sẽ tải mà không có lỗi.

Những phần tử hiện đang sử dụng tiền tố gx là:

gx:ElevationMode
gx:ElevationOffset
gx:góc
gx:AnimatedUpdate
gx:BubbleVisibility
gx:coord
gx:DelayedStart
gx:drawOrder
gx:duration
gx:Bay đến
gx:flyToMode
gx:giờ
gx:horizFov
gx:interpolate
gx:labelVisibility
gx:LatLonQuad
gx:MultiTrack
gx:vieweroptions
gx:outerColor
gx:outerWidth
gx:PhysicalWidth
gx:Danh sách phát
gx:playMode
gx:SoundCue
gx:TimeSpan
gx:TimeStamp
gx:Chuyến tham quan
gx:TourControl
gx:Mã khách tham quan
gx:Bản nhạc
gx:ViewerOptions
gx:tuần
gx:Chờ
gx:x
gx:y

Giản đồ XML hoàn chỉnh cho các phần tử trong vùng chứa tên tiện ích này nằm tại http://developers.google.com/SSH/schema/sftp22gx.xsd.

Các trường KML

KML sử dụng các loại XML phổ biến như boolean, chuỗi, double, float và int. Ngoài ra, KML còn xác định một số loại phần tử trường. Bảng sau đây liệt kê một số loại thường dùng nhất được xác định trong KML và liên kết đến các phần tử mẫu sử dụng các loại đó:

Loại trường	Giá trị	Ví dụ về cách sử dụng
elevationModeEnum	clampToGround, relativeToGround, tuyệt đối	Xem <LookAt> và <Region>
góc 90	giá trị ≥-90 và ≤90	Xem <latitude> trong <Model>
anglepos90	giá trị ≥0 và ≤90	Xem <tilt> trong <LookAt>
angle180	một giá trị ≥-180 và ≤180	Xem <longitude> trong <Model>
góc 360	giá trị ≥-360 và ≤360	Xem <heading> trong <Orientation>
màu sắc	Giá trị hexBinary: aabbggrr	Xem bất kỳ phần tử nào mở rộng <ColorStyle>
colorModeEnum	bình thường, ngẫu nhiên	Xem bất kỳ phần tử nào mở rộng <ColorStyle>
dateTime	dateTime, date, gYearMonth, gYear	Xem <TimeSpan> và <TimeStamp>
displayModeEnum	mặc định, ẩn	Xem <BalloonStyle>
gridOrigin	LowerLeft, UpperLeft	Xem <PhotoOverlay>
refreshModeEnum	onChange, onInterval, onExpire	Xem <Link>
shapeEnum	hình chữ nhật, hình trụ, hình cầu	Xem <PhotoOverlay>
styleStateEnum	thông thường, đánh dấu	Xem <StyleMap>
unitEnum	phân số, pixel, phần lồng ghép Pixel	Xem <hotSpot> trong <IconStyle>, <ScreenOverlay>
vec2	x=double xunits=:unitsEnum y=double yunits=sftp:unitsEnum	Xem <hotSpot> trong <IconStyle>, <ScreenOverlay>
viewRefreshEnum	không bao giờ, onRequest, onStop, onRegion	Xem <Link>

<AbstractView>

Cú pháp

<!-- 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 -->

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Phần tử này được mở rộng bởi các phần tử <Camera> và <LookAt>.

Kéo dài

<Đối tượng>

Các phần tử dành riêng cho AbstractView

<gx:ViewerOptions>: Phần tử này hỗ trợ các chế độ xem đặc biệt trong Google Earth 6.0 trở lên. Tệp này có một hoặc nhiều phần tử con <gx:option>. Phần tử <gx:option> có thuộc tính name và thuộc tính enabled. name chỉ định một trong số các hình ảnh sau: Hình ảnh trong Chế độ xem phố ("đường phố"), hình ảnh lịch sử ("hình ảnh lịch sử") và hiệu ứng ánh sáng mặt trời trong một khoảng thời gian nhất định trong ngày ("ánh sáng mặt trời"). Thuộc tính enabled dùng để bật hoặc tắt một chế độ xem cụ thể.
<gx:horizFov>: Xác định trường xem theo chiều ngang của AbstractView trong quá trình tham quan. Phần tử này không ảnh hưởng đến AbstractViews bên ngoài chuyến tham quan. Ứng dụng Google Earth (phiên bản 6.1 trở lên) tự động chèn <gx:horizFov> vào trong quá trình ghi chuyến tham quan. Chế độ xem AbstractView thông thường được gán giá trị là 60; chế độ xem trong Chế độ xem phố được gán giá trị 85 để phù hợp với trường chế độ xem Chế độ xem phố chuẩn trong Google Earth. Sau khi bạn đặt, giá trị sẽ được áp dụng cho các thành phần hiển thị tiếp theo, cho đến khi bạn chỉ định một giá trị mới.

<gx:ElevationMode>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

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

Mô tả

Có thể dùng thay cho phần tử <altitudeMode> tiêu chuẩn KML của OGC và chấp nhận các giá trị sau ngoài các giá trị elevationMode tiêu chuẩn:

RelativeToSeaFloor - Diễn giải độ cao dưới dạng một giá trị theo mét so với đáy biển. Nếu đối tượng KML nằm trên mặt đất thay vì trên biển, độ cao sẽ được hiểu là ở trên mặt đất.
clampToSeaFloor - Thông số kỹ thuật của độ cao bị bỏ qua và tính năng KML sẽ được đặt ở đáy biển. Nếu đối tượng KML nằm trên đất liền chứ không phải trên biển, clampToSeaFloor sẽ gắn với mặt đất.

Tương tự như <altitudeMode>, <gx:altitudeMode> ảnh hưởng đến:

toạ độ độ cao trong phần tử <coordinates>
<minAltitude> và <maxAltitude> trong phạm vi <LatLonAltBox>
<altitude> trong phạm vi <Location>, <GroundOverlay> và AbstractView (<LookAt> và <Camera>).

Có thêm thông tin về chế độ cao độ trong chương Chế độ độ cao của Hướng dẫn dành cho nhà phát triển KML.

Ví dụ:

elevationmode_reference.SSH

<?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>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

<gx:AnimatedUpdate> kiểm soát các thay đổi trong suốt chuyến tham quan các tính năng KML, sử dụng <Update>. Các thay đổi đối với tính năng KML sẽ không sửa đổi DOM - tức là mọi thay đổi sẽ được hoàn nguyên khi chuyến tham quan kết thúc và sẽ không được lưu trong KML bất cứ lúc nào.

<gx:AnimatedUpdate> cũng phải chứa giá trị <gx:duration> để chỉ định khoảng thời gian tính bằng giây mà bản cập nhật diễn ra. Các trường số nguyên, số thực dấu phẩy động và màu được tạo ảnh động mượt mà từ giá trị gốc đến giá trị mới trong toàn bộ thời lượng; boolean, chuỗi và các giá trị khác không cho phép nội suy được cập nhật ở cuối thời lượng.

Tham khảo Tiến trình tham quan trong chương Tham quan của Hướng dẫn dành cho nhà phát triển KML để biết thông tin về <gx:AnimatedUpdate> và tiến trình tham quan.

<gx:duration>: Chỉ định thời lượng tính bằng giây, thời gian diễn ra quá trình cập nhật.
<gx:DelayedStart>: Chỉ định số giây chờ (sau vị trí bắt đầu cùng dòng) trước khi bắt đầu cập nhật.

Ví dụ:

Ví dụ dưới đây minh hoạ sự thay đổi về kích thước biểu tượng. Thay đổi này sẽ có hiệu lực trong khoảng thời gian 5 giây.

animatedupdate_example.SSH

<?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>

Kéo dài

<gx:TourPrimitive>

Chứa

<gx:duration>
<Cập nhật>

<BalloonStyle>

Cú pháp

<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>

Mô tả

Chỉ định cách vẽ bóng chú thích cho các dấu vị trí. <bgColor>, nếu được chỉ định, được dùng làm màu nền của hộp chú giải. Xem <Feature> để biết sơ đồ minh hoạ cách bong bóng mô tả mặc định xuất hiện trong Google Earth.

Các phần tử dành riêng cho BalloonStyle

<bgColor>: Màu nền của hộp chú giải (không bắt buộc). Các giá trị màu và độ mờ (alpha) được biểu thị bằng ký hiệu thập lục phân. Phạm vi của các giá trị cho bất kỳ màu nào là từ 0 đến 255 (00 đến ff). Thứ tự của biểu thức là aabbggrr, trong đó aa=alpha (00 đến ff); bb=blue (00 đến ff); gg=green (00 đến ff); rr=red (00 đến ff). Đối với alpha, 00 hoàn toàn trong suốt và ff hoàn toàn không trong suốt. Ví dụ: nếu muốn áp dụng màu xanh dương có độ mờ 50% cho lớp phủ, bạn sẽ chỉ định như sau: <bgColor>7fff0000</bgColor>, trong đó alpha=0x7f, blue=0xff, green=0x00 và red=0x00. Tùy chọn mặc định là màu trắng mờ (ffffffff).
<văn bản màu>: Màu nền trước của văn bản. Tùy chọn mặc định là màu đen (ff000000).
<text>: Văn bản hiển thị trong hộp chú giải. Nếu không có văn bản nào được chỉ định, Google Earth sẽ vẽ hộp chú giải mặc định (với Tính năng <name> in đậm, Đối tượng <description>, các đường liên kết để xem đường lái xe, nền trắng và đuôi được đính kèm vào toạ độ điểm của Tính năng, nếu được chỉ định).; Bạn có thể thêm các thực thể vào thẻ <text> theo định dạng sau để tham chiếu đến một phần tử con của Tính năng: $[name], $[description], $[address], $[id], $[snippet]. Google Earth xem tính năng hiện tại cho thực thể chuỗi tương ứng và thay thế thông tin trong hộp chú giải. Để thêm đường liên kết Tới đây – Từ đây trong hộp chú giải, hãy dùng thẻ $[geDirections]. Để không cho đường liên kết đến đường lái xe xuất hiện trong hộp chú giải, hãy thêm phần tử <text> bằng một số nội dung hoặc bằng $[description] để thay thế Tính năng cơ bản <description>.; Ví dụ: Trong phần trích dẫn KML sau đây, các trường $[name] và $[description] sẽ được thay thế bằng các trường <name> và <description> có trong các phần tử Tính năng sử dụng bong bóng này
<displayMode>: Nếu <displayMode> là default, thì Google Earth sẽ sử dụng thông tin được cung cấp trong <text> để tạo hộp chú giải . Nếu <displayMode> là hide (ẩn), Google Earth sẽ không hiển thị hộp chú giải. Trong Google Earth, việc nhấp vào biểu tượng Chế độ xem danh sách cho một dấu vị trí có <displayMode> của bong bóng là hide khiến Google Earth di chuyển đến dấu vị trí.

Ví dụ:

<?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>

Kéo dài

<ColorStyle>

Bên trong

<Kiểu>

Quay lại đầu trang

<gx:BubbleVisibility>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

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

Mô tả

Chuyển đổi chế độ hiển thị của hộp chú giải mô tả. Bong bóng cần cập nhật phải được xác định bằng mã XML của đối tượng (ví dụ: <Placemark targetId="xxx">).

Ví dụ

Ví dụ đầu tiên cho thấy <gx:balloonVisibility> có Dấu vị trí. Khi dấu vị trí được tải, bong bóng mô tả sẽ được mở ra.
BubbleVisibility_example.SSH

<?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>

Ví dụ thứ hai minh họa việc sử dụng <gx:balloonVisibility> trong một chuyến tham quan. Một số quả bóng bay được mở và đóng trong suốt chuyến tham quan, cung cấp thông tin cho người xem.
BubbleVisibility_tourexample.SSH

<?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>

Kéo dài

<Tính năng>

<Máy ảnh>

Cú pháp

<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>

Mô tả

Xác định máy ảnh ảo xem cảnh. Phần tử này xác định vị trí của máy ảnh so với bề mặt Trái Đất cũng như hướng xem của máy ảnh. Vị trí máy ảnh được xác định theo <longitude>, <latitude>, <Elevation> và <ElevationMode> hoặc <gx:ElevationMode>. Hướng xem của máy ảnh được xác định theo <heading>, <tilt> và <roll>. <Camera> có thể là phần tử con của một Tính năng bất kỳ hoặc của <NetworkLinkControl>. Mỗi phần tử mẹ không được chứa cả <Thời gian máy ảnh>.

<Camera> cung cấp đầy đủ quyền kiểm soát 6 bậc tự do đối với chế độ xem, để bạn có thể định vị Camera trong không gian rồi xoay camera quanh các trục X, Y và Z. Quan trọng nhất, bạn có thể nghiêng chế độ xem của máy ảnh để nhìn lên trên đường chân trời về phía bầu trời.

<Camera> cũng có thể chứa TimePrimitive (<gx:TimeSpan> hoặc <gx:TimeStamp>). Các giá trị thời gian trong Camera ảnh hưởng đến hình ảnh trong quá khứ, ánh sáng mặt trời và việc hiển thị các tính năng có dấu thời gian. Để biết thêm thông tin, hãy đọc Thời gian có AbstractView trong chương Thời gian và ảnh động trong Hướng dẫn dành cho nhà phát triển.

Xác định chế độ xem

Trong một Tính năng hoặc <NetworkLinkControl>, hãy sử dụng <Camera> hoặc một đối tượng <LookAt> (nhưng không phải cả hai trong cùng một đối tượng). Đối tượng <Camera> xác định điểm nhìn theo vị trí và hướng của người xem. Đối tượng <Camera> cho phép bạn chỉ định chế độ xem không có trên bề mặt Trái Đất. Đối tượng <LookAt> xác định điểm nhìn theo nội dung đang được xem. Đối tượng <LookAt> có phạm vi hạn chế hơn <Camera> và thường yêu cầu hướng xem giao diện của Trái đất.

Sơ đồ dưới đây cho thấy các trục X, Y và Z được gắn với máy ảnh ảo.

Trục X trỏ về bên phải của máy ảnh và được gọi là vectơ phải.
Trục Y xác định hướng "up" tương ứng với màn hình và được gọi là vectơ lên.
Trục Z hướng từ tâm màn hình về phía điểm mắt. Máy ảnh nhìn xuống trục -Z, được gọi là vectơ xem.

Thứ tự chuyển đổi

Thứ tự xoay vòng rất quan trọng. Theo mặc định, máy ảnh đang nhìn thẳng xuống trục -Z về phía Trái đất. Trước khi xoay, máy ảnh được dịch theo trục Z đến <elevation>. Thứ tự chuyển đổi như sau:

<altitude> - dịch dọc theo trục Z sang <elevation>
<heading> – xoay quanh trục Z.
<tilt> – xoay quanh trục X.
<roll> – xoay quanh trục Z (lần nữa).

Lưu ý rằng mỗi khi áp dụng chế độ xoay, hai trong số các trục của máy ảnh sẽ thay đổi hướng của chúng.

Các thành phần dành riêng cho máy ảnh

<kinh độ>

Kinh độ của máy ảnh ảo (điểm mắt). Khoảng cách góc theo độ, so với kinh tuyến gốc. Giá trị ở phía tây của kinh tuyến dài nằm trong khoảng từ -180 đến 0 độ. Giá trị nằm ở phía đông của kinh tuyến Mer trải rộng từ 0 đến 180 độ.

<vĩ độ>

Vĩ độ của máy ảnh ảo. Độ Bắc hoặc nam của Đường xích đạo (0 độ). Giá trị nằm trong khoảng từ -90 độ đến 90 độ.

<elevation>

Khoảng cách của máy ảnh từ bề mặt trái đất, tính bằng mét. Được diễn giải theo <elevationMode> hoặc <gx:ElevationMode> trong ứng dụng Máy ảnh.

<tiêu đề>

Hướng (góc phương vị) của máy ảnh, tính bằng độ. Default=0 (đúng Bắc). (Xem sơ đồ.) Chỉ số này nằm trong khoảng từ 0 đến 360 độ.

<nghiêng>

Xoay, theo độ, của máy ảnh xung quanh trục X. Giá trị 0 cho biết chế độ xem nhắm thẳng xuống trái đất (trường hợp phổ biến nhất). Giá trị 90 cho <tilt> cho biết chế độ xem là hướng về đường chân trời. Các giá trị lớn hơn 90 cho biết chế độ xem đang hướng lên bầu trời. Các giá trị của <tilt> được kẹp ở mức +180 độ.

<roll>

Xoay, theo độ, của máy ảnh xung quanh trục Z. Giá trị nằm trong khoảng từ -180 đến +180 độ.

<ElevationMode>

Chỉ định cách diễn giải <Height> được chỉ định cho Máy ảnh. Các giá trị có thể có như sau:

RelativeToGround – (mặc định) Diễn giải <elevation> là một giá trị tính bằng mét so với mặt đất. Nếu điểm nằm trên mặt nước, <elevation> sẽ được hiểu là một giá trị tính bằng mét so với mực nước biển. Xem <gx:ElevationMode> ở bên dưới để chỉ định các điểm tương đối so với đáy biển.
clampToGround – Đối với một máy ảnh, chế độ cài đặt này cũng đặt máy ảnh RelativeToGround vì việc đặt máy ảnh ở độ cao địa hình chính xác có nghĩa là mắt sẽ giao cắt với địa hình (và chế độ xem sẽ bị chặn).
tuyệt đối - Diễn giải <elevation> là một giá trị tính theo mét so với mực nước biển.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <Elevation> bị bỏ qua và Máy ảnh sẽ được đặt ở đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, Máy ảnh sẽ được đặt trên mặt đất.

Kéo dài

<AbstractView>

Bên trong

Mọi phần tử bắt nguồn từ <Feature>
<NetworkLinkControl>

Quay lại đầu trang

<ColorStyle>

Cú pháp

<!-- 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 -->

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Lớp này cung cấp các phần tử để chỉ định chế độ màu và chế độ màu của các kiểu kiểu mở rộng.

Các phần tử dành riêng cho ColorStyle

<màu>: Giá trị màu và độ mờ (alpha) được thể hiện bằng ký hiệu thập lục phân. Phạm vi giá trị cho bất kỳ màu nào là từ 0 đến 255 (00 đến ff). Đối với alpha, 00 hoàn toàn trong suốt và ff hoàn toàn không trong suốt. Thứ tự biểu thức là aabbggrr, trong đó aa=alpha (00 đến ff); bb=blue (00 đến ff); gg=green (00 đến ff); rr=red (00 đến ff). Ví dụ: nếu muốn áp dụng màu xanh dương có độ mờ 50% cho một lớp phủ, bạn sẽ chỉ định như sau: <color>7fff0000</color>, trong đó alpha=0x7f, blue=0xff, green=0x00 và red=0x00.
<colorMode>: Giá trị của <colorMode> là thông thường (không có hiệu ứng) và là giá trị ngẫu nhiên. Giá trị Random áp dụng tỷ lệ tuyến tính ngẫu nhiên cho <color> cơ sở như sau.

Để đạt được lựa chọn thực sự ngẫu nhiên về màu sắc, hãy chỉ định <color> cơ sở là màu trắng (ffffffff).
Nếu bạn chỉ định một thành phần màu duy nhất (ví dụ: giá trị ff0000ff cho màu đỏ), thì các giá trị màu ngẫu nhiên cho một thành phần đó (màu đỏ) sẽ được chọn. Trong trường hợp này, giá trị sẽ nằm trong khoảng từ 00 (màu đen) đến ff (màu đỏ hoàn toàn).
Nếu bạn chỉ định giá trị cho hai hoặc cả ba thành phần màu, thì một tỷ lệ tuyến tính ngẫu nhiên được áp dụng cho mỗi thành phần màu, với kết quả từ màu đen đến giá trị tối đa được chỉ định cho từng thành phần.
Độ mờ của màu sắc xuất phát từ thành phần alpha của <color> và không bao giờ được chọn ngẫu nhiên.

Kéo dài

<Đối tượng>

Mở rộng bởi

<IconStyle>
<LabelStyle>
<LineStyle>
<PolyStyle>

Quay lại đầu trang

<Vùng chứa>

Cú pháp

<!-- 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 -->

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Phần tử Vùng chứa có một hoặc nhiều Tính năng và cho phép tạo phân cấp lồng nhau.

Kéo dài

<Tính năng>

Mở rộng bởi

<Tài liệu>
<Thư mục>

Quay lại đầu trang

<Tài liệu>

Cú pháp

<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>

Mô tả

Tài liệu là vùng chứa các tính năng và kiểu. Phần tử này là bắt buộc nếu tệp KML của bạn sử dụng kiểu được chia sẻ. Bạn nên sử dụng kiểu dùng chung cần thực hiện các bước sau:

Định nghĩa tất cả Kiểu trong Tài liệu. Gán một mã nhận dạng duy nhất cho mỗi Kiểu.

Trong một Tính năng hoặc Kiểu bản đồ nhất định, hãy tham chiếu ID của kiểu bằng cách sử dụng phần tử <styleUrl>.

Lưu ý rằng các kiểu được chia sẻ không được kế thừa bởi các Tính năng trong Tài liệu.

Mỗi tính năng phải tham chiếu rõ ràng các kiểu mà đối tượng đó sử dụng trong phần tử <styleUrl>. Đối với Kiểu áp dụng cho Tài liệu (chẳng hạn như ListStyle), Tài liệu phải tham chiếu rõ ràng đến <styleUrl>. Ví dụ:

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

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

Đừng đặt kiểu được chia sẻ trong một Thư mục.

Ví dụ sau minh hoạ việc sử dụng một kiểu được chia sẻ.

Ví dụ:

<?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>

Kéo dài

<Vùng chứa>

Chứa

0 hoặc nhiều phần tử bắt nguồn từ <Feature>
0 hoặc nhiều phần tử có nguồn gốc từ <StyleSelector>
0 hoặc nhiều phần tử bắt nguồn từ <Schema>

Quay lại đầu trang

<gx:duration>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

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

Mô tả

<gx:duration> mở rộng gx:TourPrimitive bằng cách chỉ định một khoảng thời gian cho các sự kiện. Thời gian được viết dưới dạng giây bằng cách sử dụng loại dữ liệu double của XML.

Thời lượng và <gx:FlyTo>

Khi một khoảng thời gian được bao gồm trong một phần tử <gx:FlyTo>, thì thời lượng đó sẽ được chỉ định trong khoảng thời gian trình duyệt di chuyển từ điểm trước đến điểm được chỉ định.

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

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

Thời lượng và <gx:AnimatedUpdate>

Chỉ định khoảng thời gian diễn ra quá trình cập nhật. Các trường số nguyên, số thực dấu phẩy động và màu được tạo ảnh động mượt mà từ giá trị gốc đến giá trị mới trong toàn bộ thời lượng; boolean, chuỗi và các giá trị khác không cho phép nội suy được cập nhật ở cuối thời lượng.

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

    ....

  </Update>
</gx:AnimatedUpdate>

<ExtendedData>

Cú pháp

<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>

Mô tả

Phần tử ExtendedData cung cấp ba kỹ thuật để thêm dữ liệu tuỳ chỉnh vào một Tính năng KML (NetworkLink, Timestamp, GroundOverlay, PhotoOverlay, ScreenOverlay, Docs, Folder). Những kỹ thuật này

Thêm cặp dữ liệu/giá trị chưa nhập bằng cách sử dụng phần tử <Data> (cơ bản)
Khai báo các trường mới được nhập bằng phần tử <Schema> rồi áp dụng phần tử đó bằng phần tử <SchemaData> (nâng cao)
Tham chiếu đến các phần tử XML được xác định trong các vùng chứa tên khác bằng cách tham chiếu không gian tên bên ngoài trong tệp KML (cơ bản)

Những kỹ thuật này có thể được kết hợp trong một tệp KML hoặc Tính năng cho các phần dữ liệu khác nhau.

Để biết thêm thông tin, hãy xem bài viết Thêm dữ liệu tuỳ chỉnh trong phần "Chủ đề trong KML".

Các phần tử dành riêng cho ExtendedData

<Tên dữ liệu ="string">

Tạo một cặp tên/giá trị chưa được nhập. Tên này có thể có 2 phiên bản: name và displayName. Thuộc tính name được dùng để xác định cặp dữ liệu trong tệp KML. Phần tử displayName được dùng khi một tên có định dạng đúng, có dấu cách và định dạng HTML, xuất hiện trong Google Earth. Trong phần tử <text> của <BalloonStyle>, ký hiệu $[name/displayName] sẽ được thay thế bằng <displayName>. Nếu bạn thay thế giá trị của thuộc tính name của phần tử <Data> theo định dạng này, chẳng hạn như khinh khí cầu của userId bị lỗi, giá trị này sẽ được thay thế bằng các cặp tên/giá trị được liên kết với nó.

<displayName>

Phiên bản định dạng của name (không bắt buộc) dùng để hiển thị.

<giá trị>

Giá trị của cặp dữ liệu.

<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">

Phần tử này được dùng kết hợp với <Schema> để thêm dữ liệu tùy chỉnh đã nhập vào Tính năng KML. Phần tử Giản đồ (được xác định bằng thuộc tính schemaUrl) khai báo loại dữ liệu tùy chỉnh. Đối tượng dữ liệu thực tế ("bản sao" của dữ liệu tuỳ chỉnh) được xác định bằng cách sử dụng phần tử SchemaData.

<schemaURL> có thể là một URL đầy đủ, tham chiếu đến mã giản đồ được xác định trong tệp KML bên ngoài hoặc tham chiếu đến mã giản đồ được xác định trong cùng tệp KML. Tất cả các thông số kỹ thuật sau đây đều được chấp nhận:

schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"

schemaUrl="AnotherFile.kml#my-schema-id"

schemaUrl="#schema-id"   <!-- same file -->

Thành phần giản đồ luôn là phần tử con của Tài liệu. Phần tử ExtendedData là một phần tử con của Tính năng chứa dữ liệu tùy chỉnh.

<SimpleData name="string">: Phần tử này gán giá trị cho trường dữ liệu tuỳ chỉnh được xác định bằng thuộc tính name. Loại và tên của trường dữ liệu tuỳ chỉnh này được khai báo trong phần tử <Schema>.; Sau đây là ví dụ về cách xác định hai phần tử dữ liệu tuỳ chỉnh:

<namespace_prefix:other>: Phần tử này cho phép bạn thêm dữ liệu tuỳ chỉnh chưa nhập. Hãy nhớ tham chiếu tiền tố không gian tên trong phần tử <{8/}> của tệp hoặc dưới dạng thuộc tính của phần tử <ExtendedData> và thêm tiền tố vào tên của từng phần tử dữ liệu bằng tiền tố không gian tên. Dữ liệu tuỳ chỉnh được thêm theo cách này được giữ nguyên trong tệp KML nhưng không được Google Earth sử dụng theo bất kỳ cách nào. Trạng thái này luôn được lưu cùng với tệp.; Ví dụ sau đây cho thấy việc sử dụng tiền tố không gian tên "camp":

Bên trong

Mọi phần tử bắt nguồn từ <Feature>

Xem thêm

Giản đồ

<Tính năng>

Cú pháp

<!-- 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 -->

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Sơ đồ dưới đây cho thấy cách một số phần tử của một Tính năng xuất hiện trong Google Earth.

Các thành phần dành riêng cho tính năng

<tên>

Văn bản do người dùng xác định trong trình xem 3D làm nhãn cho đối tượng (ví dụ: cho Dấu vị trí, Thư mục hoặc Liên kết mạng).

<chế độ hiển thị>

Giá trị Boolean. Chỉ định xem tính năng này có được vẽ trong trình xem 3D khi tải lúc đầu hay không. Để một tính năng hiển thị, bạn phải đặt thẻ <Visibility> cho tất cả các đối tượng cấp trên thành 1. Trong Chế độ xem danh sách Google Earth, mỗi Tính năng có một hộp kiểm cho phép người dùng kiểm soát chế độ hiển thị của Tính năng.

<mở>

Giá trị Boolean. Chỉ định xem Tài liệu hoặc Thư mục có bị đóng hoặc mở khi được tải lần đầu vào bảng điều khiển Địa điểm hay không. 0=thu gọn (mặc định), 1=mở rộng. Xem thêm <ListStyle>. Phần tử này chỉ áp dụng cho Tài liệu, Thư mục và NetworkLink.

<atom:author>

KML 2.2 hỗ trợ các phần tử mới để đưa dữ liệu về tác giả và trang web liên quan vào tệp KML của bạn. Thông tin này được hiển thị trong các kết quả tìm kiếm địa lý, cả trong các trình duyệt Earth như Google Earth và trong các ứng dụng khác như Google Maps. Sau đây là các phần tử chữ viết dùng trong KML:

Phần tử atom:author – phần tử mẹ cho atom:tên
atom:name – tên của tác giả
Phần tử atom:link – chứa thuộc tính href
Thuộc tính href - URL của trang web chứa tệp KML/KMZ

Các phần tử này được xác định ở Định dạng phân phối của Atom. Bạn có thể xem quy cách đầy đủ tại http://atompub.org. (xem mẫu sau đó).

Phần tử <atom:author> là phần tử mẹ cho <atom:name>. Phần tử này chỉ định tác giả của tính năng KML.

<atom:link href="..." >

Chỉ định URL của trang web chứa tệp KML hoặc MRSS này. Hãy nhớ thêm vùng chứa tên cho phần tử này vào mọi tệp KML sử dụng phần tử này: xmlns:atom="http://www.w3.org/2005/Atom" (xem mẫu sau đây).

<địa chỉ>

Một giá trị chuỗi thể hiện địa chỉ không có cấu trúc, được viết dưới dạng đường phố, thành phố, địa chỉ tiểu bang và/hoặc mã bưu chính tiêu chuẩn. Bạn có thể sử dụng thẻ <address> để chỉ định vị trí của một điểm thay vì sử dụng toạ độ theo vĩ độ và kinh độ. (Tuy nhiên, nếu bạn cung cấp <Point>, thì <Point> sẽ được ưu tiên hơn <address>.) Để tìm hiểu xem ngôn ngữ nào được hỗ trợ cho thẻ này trong Google Earth, hãy truy cập vào trang Trợ giúp của Google Maps.

<xal:AddressDetails>

Địa chỉ có cấu trúc được định dạng là xAL hoặc Ngôn ngữ địa chỉ eXtensible, một tiêu chuẩn quốc tế về định dạng địa chỉ. <xal:AddressDetails> chỉ được dùng KML để mã hoá địa lý trong Google Maps. Để biết thông tin chi tiết, vui lòng xem tài liệu về API Google Maps. Google Earth hiện không sử dụng phần tử này; thay vào đó hãy sử dụng <address>. Nhớ đưa không gian tên cho phần tử này vào bất kỳ tệp KML nào sử dụng phần tử này: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<số điện thoại>

Giá trị chuỗi đại diện cho số điện thoại. Phần tử này chỉ được Google Maps Mobile sử dụng. Tiêu chuẩn ngành đối với điện thoại di động hỗ trợ Java là RFC2806.
Để biết thêm thông tin, hãy xem http://www.ietf.org/KMZ /rfc2806.txt.

<Đoạn maxLines="2" >

Mô tả ngắn gọn về tính năng này. Trong Google Earth, mô tả này được hiển thị trong bảng điều khiển Địa điểm dưới tên của đối tượng địa lý. Nếu bạn không cung cấp Đoạn mã, thì hai dòng đầu tiên của <description> sẽ được sử dụng. Trong Google Earth, nếu Dấu vị trí chứa cả nội dung mô tả và Đoạn trích thì <snippet> sẽ xuất hiện bên dưới Dấu vị trí trong bảng điều khiển Địa điểm, còn <description> sẽ xuất hiện trong bong bóng mô tả của Dấu vị trí. Thẻ này không hỗ trợ mã đánh dấu HTML. <Đoạn trích> có thuộc tính maxLines, một số nguyên chỉ định số lượng dòng tối đa sẽ hiển thị.

<mô tả>

Nội dung do người dùng cung cấp xuất hiện trong hộp chú giải mô tả.

Nội dung được hỗ trợ cho phần tử <description> đã thay đổi từ Google Earth 4.3 thành 5.0. Thông tin cụ thể cho từng phiên bản được liệt kê dưới đây, tiếp theo là thông tin chung cho cả hai phiên bản.

Google Earth 5.0

Google Earth 5.0 (trở lên) hỗ trợ nội dung văn bản thuần tuý cũng như HTML và JavaScript đầy đủ trong hộp chú giải mô tả. Nội dung của thẻ mô tả được hiển thị bằng công cụ trình duyệt web nguồn mở Iframe và được hiển thị như trong bất kỳ trình duyệt nào dựa trên Iframe.

Quy định hạn chế chung

Liên kết đến các tệp cục bộ thường không được phép. Điều này giúp mã độc hại không thể làm hỏng hệ thống hoặc truy cập vào dữ liệu của bạn. Nếu bạn muốn cho phép truy cập vào hệ thống tệp cục bộ, hãy chọn Lựa chọn ưu tiên > Cho phép truy cập vào các tệp cục bộ và dữ liệu cá nhân. Liên kết đến tệp hình ảnh trên hệ thống tệp cục bộ luôn được phép, nếu được chứa trong thẻ <img>.

Người dùng có thể truy cập nội dung đã nén vào một tệp MRSS, ngay cả trên hệ thống tệp cục bộ.

Bật cookie, nhưng theo mục đích của chính sách cùng nguồn gốc, nội dung cục bộ không chia sẻ miền với bất kỳ nội dung nào khác (bao gồm cả nội dung khác của địa phương).

HTML

HTML chủ yếu được hiển thị như trong bất kỳ trình duyệt Iframe nào.

Mục tiêu bị bỏ qua khi được đưa trực tiếp vào HTML được ghi vào KML; tất cả các liên kết như vậy được mở như thể mục tiêu được đặt thành _blank. Mọi mục tiêu đã chỉ định sẽ bị bỏ qua.

Tuy nhiên, HTML chứa trong iFrame hoặc được tạo động bằng JavaScript hoặc DHTML sẽ sử dụng target="_self" làm mặc định. Bạn có thể chỉ định và hỗ trợ các mục tiêu khác.

Không thể nhắm mục tiêu nội dung của các tệp MRSS, đường liên kết cố định cục bộ và phương thức ;flyto từ HTML chứa trong iFrame.

Nếu người dùng chỉ định width="100%" cho chiều rộng của iFrame, thì chiều rộng của iFrame sẽ phụ thuộc vào tất cả nội dung khác trong hộp chú giải. Về cơ bản, chiều rộng này sẽ bị bỏ qua khi tính toán kích thước bố cục. Quy tắc này cũng áp dụng cho bất kỳ phần tử khối nào khác bên trong hộp chú giải.

JavaScript

Hầu hết JavaScript đều được hỗ trợ. Không thể tạo hộp thoại – các hàm như Alert() vàPrompt() sẽ không hiển thị. Tuy nhiên, chúng sẽ được ghi vào bảng điều khiển hệ thống, cũng như các lỗi và ngoại lệ khác.

Dịch vụ so sánh giá (CSS)

Bạn được phép sử dụng CSS. Giống như CSS trong trình duyệt web thông thường, CSS có thể được dùng để tạo kiểu cho văn bản, phần tử trang và để kiểm soát kích thước và giao diện của hộp chú giải mô tả.

Google Earth 4.3

Phần tử <description> hỗ trợ văn bản thuần túy cũng như một tập hợp con các phần tử định dạng HTML, bao gồm cả bảng (xem ví dụ KML bên dưới). Tính năng này không hỗ trợ công nghệ dựa trên nền tảng web khác, chẳng hạn như mã đánh dấu trang động (PHP, GAMS, ASP), các ngôn ngữ kịch bản (VBScript, JavaScript), ngôn ngữ ứng dụng (Java, Python). Trong bản phát hành Google Earth 4.2, video được hỗ trợ. (Xem Ví dụ bên dưới.)

Thông tin phổ biến

Nếu mô tả của bạn không có đánh dấu HTML, Google Earth sẽ cố gắng định dạng nó, thay thế các dòng mới bằng <br> và gói các URL bằng thẻ ký tự liên kết. Một chuỗi URL hợp lệ cho World Wide Web được tự động chuyển đổi thành siêu liên kết đến URL đó (ví dụ: http://www.google.com). Do đó, bạn không cần bao quanh URL bằng thẻ <a href="http://.."></a> để nhận được một đường liên kết đơn giản.

Khi sử dụng HTML để tạo siêu liên kết xung quanh một từ cụ thể hoặc khi đưa các hình ảnh vào HTML, bạn phải sử dụng các tham chiếu thực thể HTML hoặc phần tử FILES để thoát khỏi dấu ngoặc nhọn, dấu nháy đơn và các ký tự đặc biệt khác. Phần tử đề nghị trình phân tích cú pháp XML bỏ qua các ký tự đặc biệt dùng trong dấu ngoặc. Phần tử này có dạng như sau:

<![CDATA[
  special characters here
]]>

Nếu không muốn sử dụng phần tử WebM, bạn có thể sử dụng các tham chiếu thực thể để thay thế tất cả các ký tự đặc biệt.

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

Hành vi khác được chỉ định thông qua việc sử dụng phần tử <a>

KML hỗ trợ sử dụng hai thuộc tính trong phần tử <a>: href và type.

Phần tử liên kết <a> chứa thuộc tính href chỉ định một URL.

Nếu href là một tệp KML và có đuôi tệp .SSH hoặc .SRC, thì Google Earth sẽ tải trực tiếp tệp đó khi người dùng nhấp vào tệp. Nếu URL kết thúc bằng tiện ích mà Google Earth không biết (ví dụ: .html), URL sẽ được gửi đến trình duyệt.

href có thể là một URL phân đoạn (tức là một URL có ký hiệu # theo sau là giá trị nhận dạng KML). Khi người dùng nhấp vào đường liên kết có chứa URL mảnh, theo mặc định, trình duyệt sẽ chuyển đến Tính năng có mã nhận dạng khớp với mảnh. Nếu Đối tượng có phần tử LookAt hoặc Camera, Tính năng này sẽ được xem từ góc nhìn đã chỉ định.

Bạn có thể chỉ định thêm hành vi này bằng cách thêm một trong ba chuỗi sau vào URL mảnh:

;flyto (mặc định) – di chuyển đến Tính năng
;Bubble – mở hộp chú giải của Tính năng nhưng không di chuyển đến Tính năng
;TechSoup – mở hộp chú giải của tính năng và chuyển đến tính năng

Ví dụ: mã sau đây chỉ ra để mở tệp Crafts Fairs.SSH, đến Dấu vị trí có ID là "Albuquerque" và mở hộp chú giải:

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

Thuộc tính type được sử dụng trong phần tử <a> khi href không kết thúc bằng .SSH hoặc .SRC, nhưng cần được diễn giải trong ngữ cảnh KML. Hãy chỉ định những thông tin sau:

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

Ví dụ: URL sau sử dụng thuộc tính type để thông báo cho Google Earth rằng URL này sẽ cố gắng tải tệp, mặc dù đuôi tệp là .php:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">

<AbstractView>

Xác định quan điểm liên kết với bất kỳ phần tử nào bắt nguồn từ Tính năng. Xem <Camera> và <LookAt>.

<TimePrimitive>

Liên kết Tính năng này với một khoảng thời gian (<TimeSpan>) hoặc một thời điểm (<TimeStamp>).

<styleUrl>

URL của một <Style> hoặc <StyleMap> được xác định trong một Tài liệu. Nếu kiểu nằm trong cùng một tệp, hãy sử dụng tệp tham chiếu #. Nếu kiểu được xác định trong tệp bên ngoài, hãy sử dụng URL đầy đủ cùng với # tham chiếu. Ví dụ như

<styleUrl>#myIconStyleID</styleUrl>

<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>

<styleUrl>eateries.kml#my-lunch-spot</styleUrl>

<StyleSelector>

Bạn có thể xác định một hoặc nhiều Kiểu và Kiểu bản đồ để tùy chỉnh giao diện của bất kỳ phần tử nào có được từ Tính năng hoặc Hình học trong một dấu vị trí. (Xem <BalloonStyle>, <ListStyle>, <StyleSelector>, và các kiểu xuất phát từ <ColorStyle>.) Kiểu được xác định trong một Tính năng được gọi là "kiểu nội tuyến" và chỉ áp dụng cho Tính năng có chứa kiểu đó. Kiểu được xác định là con của <Tài liệu> được gọi là "kiểu dùng chung". Kiểu chung phải có id được xác định cho kiểu đó. Id này được tham chiếu bởi một hoặc nhiều Tính năng trong <Tài liệu>. Trong trường hợp phần tử kiểu được xác định cả trong kiểu chung và kiểu nội tuyến cho một Tính năng—tức là Thư mục, GroundOverlay, NetworkLink, Timestamp hoặc ScreenOverlay—giá trị cho kiểu cùng dòng của Tính năng sẽ được ưu tiên so với giá trị của kiểu được chia sẻ.

<Khu vực>

Các tính năng và hình học liên kết với một Khu vực chỉ được vẽ khi Khu vực đó đang hoạt động. Hãy xem <Region>.

<Siêu dữ liệu>

<ExtendedData>

Cho phép bạn thêm dữ liệu tuỳ chỉnh vào tệp KML. Dữ liệu này có thể là (1) dữ liệu tham chiếu đến giản đồ XML bên ngoài, (2) cặp dữ liệu/giá trị chưa nhập hoặc (3) dữ liệu đã nhập. Một Tính năng KML nhất định có thể chứa kết hợp các loại dữ liệu tùy chỉnh này.

Ví dụ về cách sử dụng các phần tử HTML trong phần Mô tả

Ví dụ này minh họa tập hợp đầy đủ các phần tử HTML được phần tử <description> hỗ trợ trong Google Earth 4.3. Google Earth 5.0 trở lên hỗ trợ HTML và JavaScript đầy đủ.

<?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>

Sử dụng mẫu phần tử chữ viết

Ví dụ này cho thấy việc sử dụng các phần tử <atom:author>, <atom:name> và <atom:link> trong vùng chứa tên Atom. Lưu ý rằng bạn cần phải tham chiếu vùng chứa tên này trong phần tử <{8/}>.

<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>

Video mẫu

Ví dụ này cho thấy cách nhúng một video Flash vào Bong bóng.

<?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>

Kéo dài

<Đối tượng>

Mở rộng bởi

<Vùng chứa>
<Lớp phủ>
<Dấu vị trí>
<NetworkLink>
<gx:Tham quan>

<gx:FlyTo>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

<gx:FlyTo> xác định một điểm trong không gian mà trình duyệt sẽ di chuyển trong chuyến tham quan. Nó phải chứa một AbstractView và phải chứa các phần tử <gx:duration> và <gx:flyToMode>. Các phần tử này chỉ định thời gian cần thiết để bay đến điểm đã xác định từ điểm hiện tại và phương thức bay.

<gx:flyToMode>

Có hai giá trị được phép cho <gx:flyToMode>: mịn và thoát.

FlyTos mượt cho phép một chuyến bay không gián đoạn từ điểm này đến điểm khác (và tiếp tục). Một chuỗi FlyTo mượt mà không bị gián đoạn sẽ bắt đầu và kết thúc ở tốc độ bằng 0 và sẽ không chậm tại mỗi điểm. Một chuỗi FlyTo mượt mà bị hỏng do bất kỳ phần tử nào sau đây:
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
Điều này có nghĩa là tốc độ sẽ bằng 0 đối với FlyTo mượt mà ngay trước một trong hai phần tử ở trên. Một loạt FlyTos mượt mà không bị hỏng bởi các phần tử <gx:AnimatedUpdate>.

FlyTo FlyTo mỗi lần bắt đầu và kết thúc với tốc độ bằng 0.

Ví dụ

<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>

Kéo dài

<gx:TourPrimitive>

Chứa

<gx:duration>
<gx:flyToMode>
<AbstractView>

<Thư mục>

Cú pháp

<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>

Mô tả

Thư mục được sử dụng để sắp xếp các Tính năng khác theo thứ bậc (Thư mục, Dấu vị trí, Liên kết mạng hoặc Lớp phủ). Một Tính năng chỉ hiển thị nếu tính năng này và tất cả đối tượng cấp trên của nó hiển thị.

Ví dụ:

<?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>

Kéo dài

<Vùng chứa>

Chứa

Mọi phần tử bắt nguồn từ <Feature>

<Hình học>

Cú pháp

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

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Lớp này cung cấp một đối tượng giữ chỗ cho tất cả các đối tượng Hình học được dẫn xuất.

Kéo dài

<Đối tượng>

Mở rộng bởi

<Điểm>
<LineString>
<Tuyến tính tuyến tính>
<Đa giác>
<MultiGeometry>
<gx:MultiTrack>
<Kiểu máy>
<gx:Track>

<Lớp phủ mặt đất>

Cú pháp

<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>

Mô tả

Phần tử này vẽ một lớp phủ hình ảnh lên địa hình. Phần tử con <href> của <Icon> chỉ định hình ảnh được dùng làm lớp phủ. Tệp này có thể trên hệ thống tệp cục bộ hoặc trên máy chủ web. Nếu phần tử này bị bỏ qua hoặc không chứa <href>, một hình chữ nhật sẽ được vẽ bằng cách sử dụng màu và ranh giới LatLonBox do lớp phủ mặt đất xác định.

Các phần tử dành riêng cho GroundOverlay

<elevation>

Chỉ định khoảng cách trên bề mặt trái đất, tính bằng mét và được diễn giải theo chế độ cao độ.

<ElevationMode>

Chỉ định cách diễn giải <elevation>. Các giá trị có thể sử dụng là

clampToGround – (mặc định) Cho biết bỏ qua thông số kỹ thuật về độ cao và che phủ lớp địa hình.
tuyệt đối - Đặt độ cao của lớp phủ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao của lớp phủ thành 10 mét với chế độ độ cao tuyệt đối, lớp phủ sẽ xuất hiện ở độ cao mặt đất nếu địa hình bên dưới cũng cao hơn 10 mét so với mực nước biển. Nếu địa hình cao hơn 3 mét so với mực nước biển, lớp phủ sẽ xuất hiện trên cao của địa hình thêm 7 mét.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <elevation> bị bỏ qua và lớp phủ sẽ được phủ trên đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, lớp phủ sẽ được đặt trên mặt đất.

<LatLonBox>

Chỉ định vị trí căn chỉnh trên cùng, dưới cùng, bên phải và bên trái của hộp giới hạn cho lớp phủ mặt đất.

<north> Chỉ định vĩ độ của cạnh bắc của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±90.
<south> Chỉ định vĩ độ của cạnh nam của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±90.
<east> Chỉ định kinh độ ở cạnh đông của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±180. (Đối với các lớp phủ chồng lên kinh tuyến 180°, các giá trị có thể mở rộng ra ngoài phạm vi đó.)
<west> Chỉ định kinh độ ở cạnh tây của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±180. (Đối với các lớp phủ chồng lên kinh tuyến 180°, các giá trị có thể mở rộng ra ngoài phạm vi đó.)
<rotation> Chỉ định chế độ xoay lớp phủ về tâm của nó, theo độ. Giá trị có thể là ±180. Giá trị mặc định là 0 (phía bắc). Các lượt xoay được chỉ định theo hướng ngược chiều kim đồng hồ.

<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox>

<gx:LatLonQuad>

Được sử dụng cho lớp phủ hình tứ giác không phải hình tam giác.

Ví dụ:

<?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>

Kéo dài

<Tính năng>
<Lớp phủ>

Bên trong

<Tài liệu>
<Thư mục>

<Biểu tượng>

Cú pháp

<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>

Mô tả

Xác định hình ảnh liên kết với kiểu hoặc lớp phủ Biểu tượng. Phần tử con <href> bắt buộc xác định vị trí của hình ảnh dùng để làm lớp phủ hoặc làm biểu tượng cho dấu vị trí. Vị trí này có thể nằm trên hệ thống tệp cục bộ hoặc máy chủ web từ xa. Các phần tử <gx:x>, <gx:y>, <gx:w> và <gx:h> được dùng để chọn một biểu tượng từ một hình ảnh có nhiều biểu tượng (thường được gọi là bảng biểu tượng.

<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>

Các thành phần dành riêng cho biểu tượng

<href>: Địa chỉ HTTP hoặc thông số tệp cục bộ dùng để tải biểu tượng.
<gx:x>
<gx:y>: Nếu <href> chỉ định bảng màu biểu tượng, các phần tử này sẽ xác định độ lệch (tính bằng pixel) từ góc dưới bên trái của bảng biểu tượng.Nếu không có giá trị nào được chỉ định cho x và y, thì góc dưới bên trái của bảng biểu tượng sẽ được giả định là góc dưới bên trái của biểu tượng để sử dụng.
<gx:w>
<gx:giờ>: Nếu <href> chỉ định bảng màu biểu tượng, các phần tử này sẽ chỉ định chiều rộng (<gx:w>) và chiều cao (<gx:h>), tính bằng pixel, của biểu tượng sẽ sử dụng.
<refreshMode>: Để xem nội dung mô tả về <refreshMode> và các thành phần khác được liệt kê bên dưới, hãy xem <Link>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

Bên trong

<GroundOverlay>
<ScreenOverlay>
<IconStyle>

<IconStyle>

Cú pháp

<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>

Mô tả

Chỉ định cách vẽ biểu tượng cho Dấu vị trí điểm, cả trong bảng điều khiển Địa điểm và trong trình xem 3D của Google Earth. Phần tử <Icon> chỉ định hình ảnh biểu tượng. Phần tử <scale> chỉ định tỷ lệ x, y của biểu tượng. Màu sắc được chỉ định trong phần tử <color> của <IconStyle> kết hợp với màu của <Icon>.

Các phần tử dành riêng cho IconStyle

<tỷ lệ>

Đổi kích thước biểu tượng.

Lưu ý: Thẻ <geomScale> không còn được dùng nữa. Thay vào đó, hãy dùng <scale>.

<tiêu đề>

Hướng (tức là Bắc, Nam, Đông, Tây), tính bằng độ. Default=0 (Bắc). (Xem sơ đồ.) Chỉ số này nằm trong khoảng từ 0 đến 360 độ.

<Biểu tượng>

Biểu tượng tùy chỉnh. Trong <IconStyle>, phần tử con duy nhất của <Icon> là <href>:

<href>: Địa chỉ HTTP hoặc thông số tệp cục bộ được dùng để tải biểu tượng.

<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">

Chỉ định vị trí trong Biểu tượng được "neo" vào <Point> đã chỉ định trong Dấu vị trí. Bạn có thể chỉ định giá trị x và y theo ba cách khác nhau: dưới dạng pixel ("pixels"), dưới dạng phân đoạn của biểu tượng ("fraction") hoặc dưới dạng pixel lồng ghép ("insetPixels"), là phần bù trừ tính bằng pixel từ góc trên bên phải của biểu tượng. Bạn có thể chỉ định vị trí x và y theo các cách khác nhau – ví dụ: x có thể tính bằng pixel và y có thể là một phân số. Điểm gốc của hệ toạ độ nằm ở góc dưới bên trái biểu tượng.

x – Số lượng pixel, một thành phần phân số của biểu tượng hoặc một phần lồng ghép pixel cho biết thành phần x của một điểm trên biểu tượng.
y – Số pixel, thành phần phân số của biểu tượng hoặc phần lồng ghép pixel cho biết thành phần y của một điểm trên biểu tượng.
đơn vị – Đơn vị trong đó giá trị x được chỉ định. Giá trị của phân số cho biết giá trị x là một phân số của biểu tượng. Giá trị của pixel cho biết giá trị x tính bằng pixel. Giá trị của insetPixels cho biết thụt lề từ cạnh phải của biểu tượng.
đơn vị yunit – Đơn vị trong đó giá trị y được chỉ định. Giá trị của phân số cho biết giá trị y là một phân số của biểu tượng. Giá trị của pixel cho biết giá trị y tính bằng pixel. Giá trị của insetPixels cho biết thụt lề từ cạnh trên của biểu tượng.

Ví dụ:

<?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>

Kéo dài

<ColorStyle>

Bên trong

<Kiểu>

Chứa

<href> là con của <Icon>

< hiển thị>

Cú pháp

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

Mô tả

Phần tử gốc của một tệp KML. Đây là phần tử bắt buộc. Nó tuân theo khai báo xml ở đầu tệp. Thuộc tính hint (hint) được dùng làm tín hiệu cho Google Earth để hiện tệp dưới dạng dữ liệu thiên thể.

Phần tử <SSH> cũng có thể bao gồm vùng chứa tên cho bất kỳ lược đồ XML bên ngoài nào được tham chiếu trong tệp.

Phần tử <{8/}> cơ bản chứa 0 hoặc 1 Tính năng và 0 hoặc 1 NetworkLinkControl:

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

<LabelStyle>

Cú pháp

<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>

Mô tả

Chỉ định cách <name> vẽ một Tính năng trong trình xem 3D. Bạn có thể chỉ định màu, chế độ màu và tỷ lệ tuỳ chỉnh cho nhãn (tên).

Lưu ý: Thẻ <labelColor> không còn được dùng nữa. Thay vào đó, hãy sử dụng <LabelStyle>.

Chỉ đối với <LabelStyle>

<tỷ lệ>: Đổi kích thước nhãn.

Ví dụ:

<?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>

Kéo dài

<ColorStyle>

Bên trong

<Kiểu>

<gx:LatLonQuad>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

Cho phép lớp phủ hình tứ giác không phải hình tam giác.

Chỉ định toạ độ của 4 điểm ở góc trong tứ giác xác định khu vực lớp phủ. Phải cung cấp chính xác 4 chữ số toạ độ, mỗi bộ gồm các giá trị dấu phẩy động cho kinh độ và vĩ độ. Chèn một khoảng trống giữa các bộ sưu tập. Không sử dụng dấu cách trong bộ dữ liệu. Toạ độ phải được chỉ định theo thứ tự ngược chiều kim đồng hồ với toạ độ đầu tiên tương ứng với góc dưới bên trái của hình ảnh lớp phủ. Hình dạng được mô tả bởi các góc này phải lồi lên.

Nếu một giá trị thứ ba được chèn vào bất kỳ bộ dữ liệu nào (đại diện cho độ cao), thì giá trị đó sẽ bị bỏ qua. Độ cao được đặt bằng cách sử dụng <altitude> và <altitudeMode> (hoặc <gx:altitudeMode>) mở rộng <GroundOverlay>. Các chế độ cao độ cho phép là tuyệt đối, clampToGround và clampToSeaFloor.

Ví dụ:

<?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>

Kéo dài

<Đối tượng>

Chứa bởi

<GroundOverlay>

<Đổ chuông tuyến tính>

Cú pháp

<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>

Mô tả

Xác định một chuỗi đường đóng, thường là ranh giới bên ngoài của một Đa giác. Tùy chọn, một Linear Ring cũng có thể được dùng làm ranh giới bên trong của một Đa giác để tạo lỗ trong Đa giác. Đa giác có thể chứa nhiều phần tử <Linear Ring> dùng làm ranh giới bên trong.

Lưu ý: Trong Google Earth, một Đa giác có <elevationMode> là clampToGround tuân theo các dòng chịu lực liên tục; tuy nhiên, một Linear Ring (tự thân) có <ElevationMode> là clampToGround tuân theo các đường vòng tròn lớn.

Các phần tử dành riêng cho Linear Ring

<gx:ElevationOffset>

Một tiện ích KML, trong không gian tên của tiện ích Google, sửa đổi cách hiển thị các giá trị độ cao. Độ lệch này cho phép bạn di chuyển toàn bộ Linear Ring lên hoặc xuống dưới dạng một đơn vị mà không cần sửa đổi tất cả các giá trị toạ độ riêng lẻ tạo nên Linear Ring. (Mặc dù Linear Ring được hiển thị bằng cách sử dụng giá trị chênh lệch độ cao, nhưng các giá trị độ cao ban đầu vẫn được giữ nguyên trong tệp KML.) Đơn vị được tính bằng mét.

<thô>

Giá trị Boolean. Chỉ định xem có kết nối Linear Ring với mặt đất hay không. Để chèn hình dạng này, chế độ độ cao phải là RelativeToGround, RelativeToSeaFloor hoặc Absolute. Chỉ có các đỉnh của Linear Ring được ép chứ không phải là tâm của hình học. Các đỉnh được đẩy về phía tâm của hình cầu Trái đất.

<tessellate>

Giá trị Boolean. Chỉ định xem có cho phép Linear Ring theo dõi địa hình hay không. Để bật tính năng tessellation, giá trị cho <ElevationMode> phải là clampToGround hoặc clampToSeaFloor. Linear Ring rất lớn nên cho phép đăng bán để chúng tuân theo độ cong của trái đất (nếu không, chúng có thể đi ngầm và bị ẩn đi).

<ElevationMode>

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround - (mặc định) Cho biết việc bỏ qua một thông số độ cao (ví dụ: trong thẻ <Coordinates>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét. Thông thường, chế độ này được sử dụng để đặt cột điện thoại hoặc cáp treo trượt tuyết.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét. Thông thường, chế độ này được sử dụng để đặt máy bay.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <Elevation> bị bỏ qua và điểm này sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<toạ độ>(bắt buộc)

Bốn bộ trở lên, mỗi bộ gồm giá trị dấu phẩy động cho kinh độ, vĩ độ và độ cao. Thành phần elevation là không bắt buộc. Không sử dụng dấu cách trong bộ dữ liệu. Toạ độ cuối cùng phải giống với toạ độ đầu tiên. Toạ độ chỉ được biểu thị bằng độ thập phân.

Ví dụ:

<?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>

Kéo dài

<Hình học>

Bên trong

<MultiGeometry>
<Dấu vị trí>
<innerBoundaryIs>
<outerBoundaryIs>

<LineString>

Cú pháp

<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>

Mô tả

Xác định tập hợp các phân đoạn đường đã kết nối. Sử dụng <LineStyle> để chỉ định màu sắc, chế độ màu và chiều rộng của đường kẻ. Khi một chuỗi ký tự được đẩy ra, đường kẻ được kéo dài xuống mặt đất, tạo thành một đa giác trông giống như một bức tường hoặc hàng rào. Đối với LineStrings được đẩy ra, dòng này sẽ sử dụng LineStyle hiện tại và kết quả đẩy ra của PolyStyle hiện tại. Hãy xem Hướng dẫn KML để biết ví dụ về LineString (hoặc đường dẫn).

Các phần tử dành riêng cho LineString

<gx:ElevationOffset>

Một tiện ích KML, trong không gian tên của tiện ích Google, sửa đổi cách hiển thị các giá trị độ cao. Độ lệch này cho phép bạn di chuyển toàn bộ LineString lên hoặc xuống dưới dạng một đơn vị mà không cần sửa đổi tất cả giá trị toạ độ riêng lẻ tạo nên LineString. (Mặc dù LineString được hiển thị bằng cách sử dụng giá trị chênh lệch độ cao, nhưng giá trị độ cao ban đầu được giữ nguyên trong tệp KML.) Đơn vị được tính bằng mét.

<thô>

Giá trị Boolean. Chỉ định xem có kết nối LineString với mặt đất hay không. Để ép buộc một LineString, chế độ độ cao phải là RelativeToGround, RelativeToSeaFloor hoặc Absolute. Các đỉnh trong LineString được đẩy về phía tâm của hình cầu Trái Đất.

<tessellate>

Giá trị Boolean. Chỉ định xem có cho phép LineString theo dõi địa hình hay không. Để bật tính năng bán, chế độ độ cao phải là clampToGround hoặc clampToSeaFloor. LineString rất lớn nên cho phép sử dụng các đường cong để các đường cong đó tuân theo độ cong của trái đất (nếu không, chúng có thể đi ngầm và bị ẩn đi).

<ElevationMode>

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround – (mặc định) Cho biết sẽ bỏ qua một thông số độ cao (ví dụ: trong thẻ <Coordinates>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét. Thông thường, chế độ này được sử dụng để đặt cột điện thoại hoặc cáp treo trượt tuyết.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét. Thông thường, chế độ này được sử dụng để đặt máy bay.

<gx:ElevationMode>

Phần mở rộng KML, trong không gian tên của phần mở rộng về Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <Elevation> bị bỏ qua và điểm này sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<gx:drawOrder>

Giá trị số nguyên chỉ định thứ tự vẽ nhiều chuỗi đường. LineStrings được vẽ trước tiên có thể bị LineStrings che khuất một phần hoặc hoàn toàn với thứ tự bản vẽ sau đó. Bạn có thể bắt buộc phải sử dụng phần tử này cùng với các phần tử <gx:outerColor> và <gx:outerWidth> trong <LineStyle> khi các đường màu kép giao nhau.

<toạ độ>(bắt buộc)

Hai hoặc nhiều tọa độ toạ độ, mỗi nhóm gồm các giá trị dấu phẩy động cho kinh độ, vĩ độ và độ cao. Thành phần elevation là không bắt buộc. Chèn một khoảng trống giữa các bộ sưu tập. Không sử dụng dấu cách trong bộ dữ liệu.

Ví dụ:

<?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>

Kéo dài

<Hình học>

Bên trong

<MultiGeometry>
<Dấu vị trí>

<LineStyle>

Cú pháp

<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>

Mô tả

Chỉ định kiểu vẽ (màu, chế độ màu và chiều rộng đường) cho tất cả hình học đường. Hình học đường kẻ bao gồm đường viền của các đa giác có đường viền và phần "chia sẻ" được đẩy lên của các biểu tượng Dấu vị trí (nếu tính năng đũa được bật).

Các phần tử dành riêng cho LineStyle

<chiều rộng>

Chiều rộng của đường kẻ, tính bằng pixel.

<gx:outerColor>

Màu của phần đường xác định bởi <gx:outerWidth>. Lưu ý rằng các phần tử <gx:outerColor> và <gx:outerWidth> sẽ bị bỏ qua khi bạn áp dụng <LineStyle> cho <Multi> và <Linear Ring>.

<gx:outerWidth>

Giá trị nằm trong khoảng từ 0,0 đến 1,0 cho biết tỷ lệ của dòng sử dụng <gx:outerColor>. Chỉ áp dụng cho các dòng đặt chiều rộng bằng <gx:physicalWidth>; không áp dụng cho các dòng sử dụng <width>. Xem thêm <gx:drawOrder> trong <LineString>. Bạn có thể cần phải có giá trị thứ tự vẽ nếu các đường màu kép giao nhau với nhau – ví dụ: để hiển thị các nút giao cắt giữa các đường cao tốc.

<gx:PhysicalWidth>

Chiều rộng vật lý của đường kẻ, tính bằng mét.

<gx:labelVisibility>

Một boolean xác định xem có hiển thị một nhãn văn bản trên một Chuỗi văn bản hay không. Nhãn của LineString chứa trong phần tử <name> là anh chị em của <LineString> (tức là được chứa trong cùng phần tử <Placemark>).

Theo mặc định, Google Earth phiên bản 6.1 trở lên không hiển thị nhãn. Bạn phải bật nhãn này cho từng LineString bằng cách đặt <gx:labelVisibility> thành 1.

Vấn đề đã biết về Google Earth 6.1: Chuỗi dòng không có phần tử <gx:physicalWidth> sẽ chỉ hiển thị nhãn nếu độ dài dòng lớn hơn 100m * số ký tự trong nhãn. Ví dụ: nhãn có 7 ký tự ("ví dụ") sẽ chỉ xuất hiện nếu dòng lớn hơn 700m. Điều này không ảnh hưởng đến LineStrings với giá trị <gx:physicalWidth>.

Ví dụ:

Ví dụ sau đây cho thấy một đường màu đỏ mờ 50% có chiều rộng là 4 pixel.

<?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>

Kéo dài

<ColorStyle>

Bên trong

<Kiểu>

<Đường liên kết>

Cú pháp

<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>

Mô tả

<Link> chỉ định vị trí của bất kỳ vị trí nào sau đây:

Tệp KML được tìm nạp theo đường liên kết mạng
Các tệp hình ảnh được dùng trong mọi Lớp phủ (phần tử <Icon> chỉ định hình ảnh trong Lớp phủ; <Icon> có các trường giống như <Link>)
Các tệp mô hình được sử dụng trong phần tử <Model>

Tệp được tải có điều kiện và được làm mới, tùy thuộc vào thông số làm mới được cung cấp ở đây.

Khi tìm nạp một tệp, URL được gửi đến máy chủ bao gồm ba thông tin:

href (Mã tham chiếu siêu văn bản) chỉ định tệp cần tải.
Một chuỗi định dạng tuỳ ý được tạo từ các thông số (a) mà bạn chỉ định trong phần tử <viewFormat> hoặc (b) các thông số hộp giới hạn (đây là giá trị mặc định và được dùng nếu không có phần tử <viewFormat> trong tệp).
chuỗi định dạng thứ hai được chỉ định trong phần tử <httpQuery>.

Nếu tệp chỉ định trong <href> là một tệp cục bộ, thì phần tử <viewFormat> và <httpQuery> không được sử dụng.

Phần tử <Link> thay thế phần tử <Url> của <NetworkLink> có trong các bản phát hành KML trước đó và thêm chức năng cho phần tử <Region> (được giới thiệu trong KML 2.1). Trong Google Earth phát hành phiên bản 3.0 trở về trước, phần tử <Link> bị bỏ qua.

Phần tử cụ thể để liên kết

<href>

URL (địa chỉ HTTP hoặc thông số tệp cục bộ). Khi thư mục mẹ của <Link> là NetworkLink, <href> là một tệp KML. Khi thành phần mẹ của <Link> là một Mô hình, <href> là một tệp noindex. Khi thành phần mẹ của <Icon> (cùng trường với <Link>) là một Lớp phủ, <href> là một hình ảnh. Bạn có thể sử dụng URL tương đối trong thẻ này và đánh giá chúng so với tệp KML đính kèm. Xem Tệp MRSS để biết thông tin chi tiết về cách tạo tham chiếu tương đối trong tệp KML và MRSS.

<refreshMode>

Chỉ định chế độ làm mới theo thời gian, có thể là một trong những chế độ sau:

onChange - làm mới khi tệp được tải và mỗi khi các thông số Liên kết thay đổi (mặc định).
onInterval – làm mới mỗi n giây (được chỉ định trong <refreshInterval>).
onExpire – làm mới tệp khi đến thời gian hết hạn. Nếu tệp được tìm nạp có NetworkLinkControl, thì thời gian <expires> sẽ được ưu tiên hơn thời gian hết hạn được chỉ định trong tiêu đề HTTP. Nếu bạn không chỉ định thời gian <expires>, thì tiêu đề max-age của HTTP sẽ được sử dụng (nếu có). Nếu không có max-age, thì tiêu đề HTTP Hết hạn sẽ được sử dụng (nếu có). (Xem Mục RFC261b của Giao thức truyền siêu văn bản – HTTP 1.1 để biết thông tin chi tiết về các trường tiêu đề HTTP.)

<refreshInterval>

Cho biết làm mới tệp n giây một lần.

<viewRefreshMode>

Chỉ định cách làm mới đường liên kết khi "máy ảnh" thay đổi.

Có thể là một trong những trạng thái sau đây:

never (mặc định) – Bỏ qua các thay đổi trong thành phần hiển thị. Đồng thời, bỏ qua các thông số <viewFormat> nếu có.
onStop – Làm mới tệp n giây sau khi dừng chuyển động, trong đó n được chỉ định trong <viewRefreshTime>.
onRequest – Chỉ làm mới tệp khi người dùng yêu cầu rõ ràng. (Ví dụ: trong Google Earth, người dùng nhấp chuột phải và chọn Làm mới trong trình đơn Ngữ cảnh.)
onRegion – Làm mới tệp khi Khu vực đó bắt đầu hoạt động. Xem <Region>.

<viewRefreshTime>

Sau khi chế độ chuyển động của máy ảnh dừng lại, hãy chỉ định số giây chờ trước khi làm mới chế độ xem. (Xem <viewRefreshMode> và onStop ở trên.)

<viewBoundScale>

Điều chỉnh tỷ lệ thông số BBOX trước khi gửi chúng đến máy chủ. Giá trị nhỏ hơn 1 có nghĩa là sử dụng ít hơn chế độ xem toàn màn hình (màn hình). Giá trị lớn hơn 1 có nghĩa là tìm nạp một vùng mở rộng ra ngoài các cạnh của chế độ xem hiện tại.

<viewFormat>

Chỉ định định dạng của chuỗi truy vấn được nối vào <href> của đường liên kết trước khi tìm nạp tệp.(Nếu <href> chỉ định một tệp cục bộ, thì phần tử này sẽ bị bỏ qua.)

Nếu bạn chỉ định <viewRefreshMode> onStop và không đưa thẻ <viewFormat> vào tệp, thì những thông tin sau sẽ tự động được thêm vào chuỗi truy vấn:

BBOX=[bboxwest],[bboxSouth],[bboxEastern],[bboxBắc]

Thông tin này khớp với quy cách hộp giới hạn của Dịch vụ bản đồ web (WMS).

Nếu bạn chỉ định một thẻ <viewFormat> trống, thì chuỗi thông tin sẽ không có thông tin nào được thêm vào.

Bạn cũng có thể chỉ định một nhóm tham số xem tuỳ chỉnh để thêm vào chuỗi truy vấn. Nếu bạn cung cấp một chuỗi định dạng thì chuỗi này sẽ được sử dụng thay cho thông tin BBOX. Nếu muốn biết thông tin BBOX, bạn cần thêm các thông số đó cùng với thông số tuỳ chỉnh.

Bạn có thể sử dụng bất kỳ tham số nào sau đây trong chuỗi định dạng của mình (và Google Earth sẽ thay thế giá trị hiện tại thích hợp tại thời điểm tạo chuỗi truy vấn):

[lookatLon], [lookatLat] - kinh độ và vĩ độ của điểm mà <LookAt> đang xem
[lookatRange], [lookatLean], [lookatheading] - giá trị được sử dụng bởi phần tử <LookAt> (xem mô tả của <range>, <tilt> và <heading> trong <LookAt>)
[lookatPlaceLon], [lookatPlaceLat], [lookatPlaceAlt] - trỏ đến địa hình theo độ/mét mà <LookAt> đang xem
[cameraLon], [cameraLat], [cameraAlt] - độ/mét mắt
[horizFov], [vertFov] – trường nhìn ngang, dọc của máy ảnh
[horizPixels], [vertPixels] – kích thước tính bằng pixel của trình xem 3D
[Địa hình được bật] - cho biết liệu trình xem 3D có đang hiển thị địa hình hay không

<httpQuery>

Thêm thông tin vào chuỗi truy vấn, dựa trên các tham số được chỉ định. (Google Earth thay thế giá trị hiện tại thích hợp tại thời điểm tạo chuỗi truy vấn.) Các tham số sau được hỗ trợ:

[Phiên bản ứng dụng]
[SSHVersion]
[Tên khách hàng]
[ngôn ngữ]

Ví dụ:

<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>

Cú pháp

<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>

Mô tả

Chỉ định cách hiển thị một Tính năng trong chế độ xem danh sách. Chế độ xem danh sách là hệ thống cấp bậc của các vùng chứa và phần tử con; trong Google Earth, đây là bảng điều khiển Địa điểm.

Các phần tử dành riêng cho ListStyle

<listItemType>

Chỉ định cách hiển thị một Tính năng trong chế độ xem danh sách. Các giá trị có thể sử dụng là:

check (mặc định) – Chế độ hiển thị của Tính năng được liên kết với hộp đánh dấu của mục.
RadioFolder - Khi được chỉ định cho một Vùng chứa, chỉ một trong các mục của Vùng chứa đó hiển thị tại một thời điểm
CheckOffOnly - Khi được chỉ định cho Vùng chứa hoặc Liên kết mạng, sẽ ngăn tất cả các mục hiển thị cùng một lúc—nghĩa là người dùng có thể tắt mọi thứ trong Vùng chứa hoặc Liên kết mạng nhưng không thể bật mọi thứ cùng một lúc. Chế độ cài đặt này sẽ hữu ích cho những Vùng chứa hoặc Đường liên kết mạng chứa nhiều dữ liệu.
checkẨnChildren – Sử dụng hộp đánh dấu thông thường để hiển thị quảng cáo nhưng không hiển thị thành phần con cháu của Vùng chứa hay Liên kết mạng trong chế độ xem danh sách. Hộp đánh dấu cho phép người dùng bật/tắt chế độ hiển thị của các đối tượng con trong trình xem.

<bgColor>

Màu nền cho Đoạn trích. Giá trị màu và độ mờ được biểu thị bằng ký hiệu thập lục phân. Phạm vi giá trị cho bất kỳ màu nào là từ 0 đến 255 (00 đến ff). Đối với alpha, 00 hoàn toàn trong suốt và ff hoàn toàn không trong suốt. Thứ tự biểu thức là aabbggrr, trong đó aa=alpha (00 đến ff); bb=blue (00 đến ff); gg=green (00 đến ff); rr=red (00 đến ff). Ví dụ: nếu muốn áp dụng màu xanh dương có độ mờ 50% cho lớp phủ, bạn sẽ chỉ định như sau: <color>7fff0000</color>, trong đó alpha=0x7f, blue=0xff, green=0x00 và red=0x00.

<Biểu tượng mục>

Biểu tượng dùng trong chế độ xem List liệt kê trạng thái của quá trình tìm nạp Thư mục hoặc Đường liên kết. Các biểu tượng liên kết với chế độ mở và đóng được sử dụng cho Thư mục và Đường liên kết mạng. Các biểu tượng liên kết với chế độ lỗi và tìm nạp0, tìm nạp1 và tìm nạp 2 được dùng cho Đường liên kết mạng. Ảnh chụp màn hình sau đây minh hoạ biểu tượng Google Earth cho các trạng thái sau:

<trạng thái>: Chỉ định trạng thái hiện tại của NetworkLink hoặc Folder. Các giá trị có thể là mở, đóng, lỗi, tìm nạp0, tìm nạp1 và tìm nạp2. Bạn có thể kết hợp các giá trị này bằng cách chèn dấu cách giữa hai giá trị (không phải dấu phẩy).
<href>: Chỉ định URI của hình ảnh dùng trong List View (Chế độ xem danh sách) cho tính năng.

Ví dụ:

<?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>

Kéo dài

<Đối tượng>

Bên trong

<Kiểu>

<Xem xét>

Cú pháp

<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>

Mô tả

Xác định máy ảnh ảo được liên kết với bất kỳ phần tử nào bắt nguồn từ Tính năng. Phần tử LookAt xác định vị trí của "máy ảnh" tương ứng với đối tượng đang được xem. Trong Google Earth, chế độ xem "di chuyển đến" điểm quan sát LookAt này khi người dùng nhấp đúp vào một mục trong bảng điều khiển Địa điểm hoặc nhấp đúp vào một biểu tượng trong trình xem 3D.

Các thành phần cụ thể cho LookAt

<kinh độ>

Kinh độ của điểm mà máy ảnh đang xem. Khoảng cách góc theo độ, so với kinh tuyến gốc. Giá trị ở phía tây của kinh tuyến dài nằm trong khoảng từ -180 đến 0 độ. Giá trị nằm ở phía đông của kinh tuyến Mer trải rộng từ 0 đến 180 độ.

<vĩ độ>

Vĩ độ của điểm mà máy ảnh đang xem. Độ Bắc hoặc nam của Đường xích đạo (0 độ). Giá trị nằm trong khoảng từ -90 độ đến 90 độ.

<elevation>

Khoảng cách tính từ bề mặt trái đất, tính bằng mét. Được diễn giải theo chế độ độ cao của LookAt.

<tiêu đề>

Hướng (tức là Bắc, Nam, Đông, Tây), tính bằng độ. Default=0 (Bắc). (Xem sơ đồ bên dưới.) Chỉ số này nằm trong khoảng từ 0 đến 360 độ.

<nghiêng>

Góc giữa hướng của vị trí LookAt và hướng bình thường so với bề mặt trái đất. (Xem sơ đồ bên dưới.) Chỉ số này nằm trong khoảng từ 0 đến 90 độ. Các giá trị cho <tilt> không được là số âm. Giá trị <tilt> bằng 0 độ cho biết chế độ xem trực tiếp ở trên. Giá trị <tilt> là 90 độ cho biết chế độ xem dọc theo đường chân trời.

<dải_ô>(bắt buộc)

Khoảng cách tính bằng mét từ điểm được chỉ định bởi <longitude>, <latitude> và <elevation> đến vị trí LookAt. (Xem sơ đồ bên dưới.)

<ElevationMode>

Chỉ định cách diễn giải <elevation> được chỉ định cho điểm LookAt. Các giá trị có thể có như sau:

clampToGround – (mặc định) Cho biết sẽ bỏ qua thông số kỹ thuật <Elevation> và đặt vị trí LookAt trên mặt đất.
RelativeToGround – diễn giải <Elevation> là một giá trị tính theo mét so với mặt đất.
tuyệt đối - Diễn giải <elevation> là một giá trị tính theo mét so với mực nước biển.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <Elevation> bị bỏ qua và LookAt sẽ được đặt ở đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, LookAt sẽ được đặt trên mặt đất.

Sơ đồ này minh họa các phần tử <range>, <tilt> và <elevation>:

Sơ đồ này minh họa phần tử <heading>:

<?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>

Kéo dài

<AbstractView>

Bên trong

Mọi phần tử bắt nguồn từ <Feature>
<NetworkLinkControl>

<Mô hình>

Cú pháp

<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>

Mô tả

Đối tượng 3D được mô tả trong tệp noindex (được tham chiếu trong thẻ <Link>). Tệp noindex có đuôi tệp .dae. Mô hình được tạo trong không gian toạ độ riêng, sau đó được định vị, định vị và điều chỉnh theo tỷ lệ trong Google Earth. Hãy xem trang "Chủ đề trong KML" trên trang Mô hình để biết thêm chi tiết.

Google Earth hỗ trợ cấu hình phổ biến DIFM, với các ngoại lệ sau:

Google Earth chỉ hỗ trợ tam giác và đường kẻ dưới dạng các kiểu nguyên tố. Số lượng tam giác tối đa được phép là 21845.
Google Earth không hỗ trợ ảnh động hoặc giao diện.
Google Earth không hỗ trợ các tham chiếu hình học bên ngoài.

Các phần tử dành riêng cho mô hình

<ElevationMode>

Chỉ định cách diễn giải <Elevation> được chỉ định trong <Location>. Các giá trị có thể có như sau:

clampToGround – (mặc định) Cho biết việc bỏ qua thông số kỹ thuật <elevation> và đặt Mô hình trên mặt đất.
RelativeToGround – diễn giải <Elevation> là một giá trị tính theo mét so với mặt đất.
tuyệt đối - Diễn giải <elevation> là một giá trị tính theo mét so với mực nước biển.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên đất liền chứ không phải trên biển, thì <elevation> sẽ được diễn giải là nằm trên mặt đất.
clampToSeaFloor - Thông số <Elevation> bị bỏ qua và Mô hình sẽ được đặt ở đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, Mô hình sẽ được định vị trên mặt đất.

<Vị trí>

Chỉ định toạ độ chính xác của điểm khởi hành của Mô hình theo vĩ độ, kinh độ và độ cao. Các phép đo vĩ độ và kinh độ là phép chiếu vĩ độ chuẩn với vĩ độ WGS84. Độ cao là khoảng cách tính từ bề mặt trái đất, tính bằng mét và được diễn giải theo <ElevationMode> hoặc <gx:ElevationMode>.

<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location>

<Hướng>

Mô tả việc xoay hệ thống toạ độ của mô hình 3D để định vị đối tượng trong Google Earth. Xem sơ đồ dưới đây.

<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation>

Các chế độ xoay được áp dụng cho một Mô hình theo thứ tự sau:

<roll>
<nghiêng>
<tiêu đề>

<tiêu đề>: Xoay theo trục z (bình thường với bề mặt Trái đất). Giá trị 0 (mặc định) bằng Bắc. Một vòng xoay dương được xoay theo chiều kim đồng hồ quanh trục z và được chỉ định bằng độ từ 0 đến 360.
<nghiêng>: Xoay theo trục x. Một vòng xoay dương được xoay theo chiều kim đồng hồ quanh trục x và được chỉ định bằng độ từ 0 đến 180.
<roll>: Xoay theo trục y. Một chuyển động quay theo chiều kim đồng hồ quanh trục y và được chỉ định bằng độ từ 0 đến 180.; Biểu đồ này minh họa hướng điển hình của trục của mô hình:

<Tỷ lệ>

Điều chỉnh tỷ lệ một mô hình dọc theo các trục x, y và z trong không gian toạ độ của mô hình.

<Scale>
  <x>2.5</x>
  <y>2.5</y>
  <z>3.5</z>
</Scale>

<Đường liên kết>

Chỉ định tệp cần tải và các tham số làm mới tuỳ chọn. Xem <Link>.

<ResourceMap>

Chỉ định 0 hoặc nhiều phần tử <Alias>, mỗi phần tử trong số đó là bản đồ ánh xạ cho đường dẫn tệp hoạ tiết từ tệp Collada gốc đến tệp KML hoặc AdX chứa Mô hình. Phần tử này cho phép bạn di chuyển và đổi tên các tệp kết cấu mà không cần phải cập nhật tệp Collada gốc tham chiếu đến các kết cấu đó. Một phần tử <ResourceMap> có thể chứa nhiều bản đồ từ các tệp Collada (nguồn) khác nhau vào cùng một tệp AdX (mục tiêu).

<Alias>
  <targetHref>../images/foo.jpg</targetHref>
  <sourceHref>c:\mytextures\foo.jpg</sourceHref>
</Alias>

<Alias> chứa một liên kết từ <sourceHref> đến <targetHref>:

<targetHref>: Chỉ định tệp kết cấu để Google Earth tìm nạp. Tệp tham chiếu này có thể là tệp tham chiếu tương đối đến một tệp hình ảnh trong kho lưu trữ .HFSS, hoặc có thể là tệp tham chiếu tuyệt đối đến tệp (ví dụ: URL).
<sourceHref>: Là đường dẫn được chỉ định cho tệp hoạ tiết trong tệp Collada .dae.

Trong Google Earth, nếu mối liên kết này không được cung cấp, thì các quy tắc sau sẽ được dùng để xác định hoạ tiết được tham chiếu trong tệp Collada (.dae):

Không có đường dẫn: Nếu tên hoạ tiết không chứa đường dẫn, Google Earth sẽ tìm hoạ tiết trong cùng thư mục với tệp .dae tham chiếu đến đường dẫn đó.
Đường dẫn tương đối: Nếu tên hoạ tiết có chứa một đường dẫn tương đối (ví dụ: ../images/mytexture.jpg), thì Google Earth sẽ diễn giải đường dẫn đó là tương đối so với tệp .dae tham chiếu đến đường dẫn đó.
Đường dẫn tuyệt đối: Nếu tên hoạ tiết là đường dẫn tuyệt đối (c:\mytexture.jpg) hoặc đường dẫn mạng (ví dụ: http://myserver.com/mytexture.jpg), thì Google Earth sẽ tìm tệp ở vị trí đã chỉ định, bất kể tệp .dae nằm ở đâu.

Ví dụ:

<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>

Kéo dài

<Địa lý>

Bên trong

<MultiGeometry>
<Dấu vị trí>

<MultiGeometry>

Cú pháp

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

Mô tả

Vùng chứa không có hoặc nhiều dữ liệu gốc được liên kết với cùng một đối tượng.

Lưu ý: Thẻ <GeometryCollection> không còn được dùng nữa. Thay vào đó, hãy dùng <MultiGeometry>.

Các phần tử dành riêng cho MultiGeometry

0 hoặc nhiều phần tử <Geometry>

Ví dụ:

<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>

Kéo dài

<Địa lý>

Bên trong

<MultiGeometry>
<Dấu vị trí>

<gx:MultiTrack>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.2 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

Phần tử nhiều bản nhạc được dùng để kết hợp nhiều phần tử bản nhạc thành một đơn vị khái niệm duy nhất. Ví dụ: giả sử bạn thu thập dữ liệu GPS cho một chuyến đi xe đạp trong ngày bao gồm một số điểm dừng chân và một địa điểm ngừng ăn trưa. Do gián đoạn thời gian, một chuyến đi xe đạp có thể xuất hiện dưới dạng bốn đường đua khác nhau khi thời gian và vị trí được vẽ. Việc nhóm các phần tử <gx:Track> này vào một vùng chứa <gx:MultiTrack> khiến các phần tử đó có thể hiển thị trong Google Earth dưới dạng các phần của một đường dẫn. Khi đến cuối một phân khúc, biểu tượng sẽ di chuyển đến đầu phân khúc tiếp theo. Phần tử <gx:interpolate> chỉ định liệu nên dừng ở cuối một bản nhạc và chuyển ngay đến phần đầu của bản nhạc tiếp theo hay là nội suy các giá trị còn thiếu giữa hai bản nhạc.

Các phần tử dành riêng cho gx:MultiTrack

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround – (mặc định) Cho biết sẽ bỏ qua một thông số độ cao (ví dụ: trong phần tử <gx:coord>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải độ cao dưới dạng một giá trị theo mét so với đáy biển. Nếu điểm nằm trên mặt đất thay vì trên biển, độ cao sẽ được hiểu là ở trên mặt đất.
clampToSeaFloor - Thông số kỹ thuật của độ cao bị bỏ qua và điểm sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<gx:interpolate>

Giá trị Boolean. Nếu bản đa đa kênh chứa nhiều phần tử <gx:Track>, hãy chỉ định việc nội suy giá trị bị thiếu giữa phần đầu của bản nhạc đầu tiên và phần đầu của bản nhạc tiếp theo. Khi bạn sử dụng giá trị mặc định (0), biểu tượng hoặc mô hình sẽ dừng ở cuối một bản nhạc rồi chuyển sang bắt đầu của bản nhạc tiếp theo.

Chứa

<gx:Track>

<NetworkLink>

Cú pháp

<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>

Mô tả

Tham chiếu tệp KML hoặc tệp lưu trữ MRSS trên mạng cục bộ hoặc từ xa. Sử dụng phần tử <Link> để chỉ định vị trí của tệp KML. Trong phần tử đó, bạn có thể xác định các tuỳ chọn làm mới để cập nhật tệp, dựa trên thời gian và sự thay đổi máy ảnh. Bạn có thể sử dụng Kết nối mạng kết hợp với Khu vực để xử lý hiệu quả các tập dữ liệu rất lớn.

Các phần tử dành riêng cho NetworkLink

<refreshVisibility>: Giá trị Boolean. Giá trị 0 sẽ hiển thị các tính năng trong tầm kiểm soát của người dùng Google Earth. Đặt giá trị thành 1 để đặt lại chế độ hiển thị của tính năng mỗi khi NetworkLink được làm mới. Ví dụ: giả sử một Dấu vị trí trong tệp KML được liên kết có <Visibility> được đặt thành 1 và NetworkLink đã đặt <refreshVisibility> thành 1. Khi tệp được tải lần đầu vào Google Earth, người dùng có thể bỏ chọn hộp kiểm bên cạnh mục đó để tắt màn hình trong trình xem 3D. Tuy nhiên, khi NetworkLink được làm mới, Dấu vị trí sẽ hiển thị lại, vì trạng thái hiển thị ban đầu là TRUE.
<flyToView>: Giá trị Boolean. Giá trị 1 khiến Google Earth di chuyển đến chế độ xem của LookAt hoặc Camera trong NetworkLinkControl (nếu có). Nếu NetworkLinkControl không chứa phần tử AbstractView, Google Earth sẽ di chuyển đến phần tử LookAt hoặc Camera trong phần tử con Tính năng trong phần tử <{8/}> trong tệp được làm mới. Nếu phần tử <{8/}> không chỉ định LookAt hoặc Camera, thì chế độ xem sẽ không thay đổi. Ví dụ: Google Earth sẽ di chuyển đến chế độ xem <LookAt> của tài liệu mẹ, chứ không phải là <LookAt> dấu vị trí nằm trong tài liệu.
<Link>(bắt buộc)

Ví dụ:

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

Kéo dài

<Tính năng>

Bên trong

bất kỳ phần tử nào có được từ <Container>

<NetworkLinkControl>

Cú pháp

<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>

Mô tả

Kiểm soát hành vi của các tệp được <NetworkLink> tìm nạp.

Các phần tử dành riêng cho NetworkLinkControl

<minRefreshPeriod>: Chỉ định trong vài giây, <minRefreshPeriod> là thời gian tối thiểu cho phép giữa các lần tìm nạp tệp. Thông số này cho phép máy chủ điều tiết việc tìm nạp một tệp cụ thể và điều chỉnh tốc độ làm mới cho tốc độ thay đổi dữ liệu dự kiến. Ví dụ: người dùng có thể đặt thời gian làm mới liên kết là 5 giây, nhưng bạn có thể đặt thời gian làm mới tối thiểu là 3600 để giới hạn làm mới bản cập nhật một lần mỗi giờ.
<maxSessionLength>: Chỉ định trong vài giây, <maxSessionLength> là khoảng thời gian tối đa mà mạng liên kết mạng (client) có thể duy trì. Giá trị mặc định -1 cho biết không chấm dứt phiên một cách rõ ràng.
<cookie>: Sử dụng phần tử này để nối một chuỗi với truy vấn URL vào lần làm mới tiếp theo cho đường liên kết mạng. Bạn có thể sử dụng dữ liệu này trong tập lệnh của mình để xử lý thông minh hơn ở phía máy chủ, bao gồm truy vấn phiên bản và phân phối tệp có điều kiện.
<message>: Bạn có thể gửi một thông báo bật lên, chẳng hạn như nguyên tắc sử dụng cho đường liên kết mạng. Thông báo này xuất hiện khi lần đầu tiên liên kết mạng được tải vào Google Earth hoặc khi thay đổi trong kiểm soát liên kết mạng.
<tên đường liên kết>: Bạn có thể kiểm soát tên của đường liên kết mạng từ máy chủ để máy chủ ghi đè các thay đổi đối với tên ở phía máy khách.
<linkDescription>: Bạn có thể kiểm soát thông tin mô tả về đường liên kết mạng từ máy chủ để các thay đổi đối với nội dung mô tả ở phía máy khách sẽ bị máy chủ ghi đè.
<linksnippet maxLines="2" >: Bạn có thể kiểm soát đoạn mã cho đường liên kết mạng từ máy chủ để máy chủ ghi đè các thay đổi đã thực hiện cho đoạn mã phía máy khách. <linksnippet> có thuộc tính maxLines, một số nguyên chỉ định số lượng dòng tối đa cần hiển thị.
<hết hạn>: Bạn có thể chỉ định ngày/giờ mà đường liên kết sẽ được làm mới. Thông số kỹ thuật này chỉ có hiệu lực nếu <refreshMode> trong <Link> có giá trị là onExpire. Xem <refreshMode>
<Cập nhật>: Với <Update>, bạn có thể chỉ định bất kỳ số lượng thẻ Thay đổi, Tạo và Xoá nào cho tệp .SSH hoặc tệp lưu trữ .SRC mà trước đây đã được tải bằng một đường liên kết mạng. Xem <Update>.
<AbstractView>

Ví dụ:

<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>

Kéo dài

Đây là phần tử con trực tiếp của phần tử <{8/}>.

Bên trong

< hiển thị>

Xem thêm

<Cập nhật>
<NetworkLink>

<Đối tượng>

Cú pháp

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

Mô tả

Đây là lớp cơ sở trừu tượng và không thể dùng trực tiếp trong tệp KML. Thuộc tính này cung cấp thuộc tính id để cho phép nhận dạng duy nhất một phần tử KML và thuộc tính targetId dùng để tham chiếu các đối tượng đã được tải vào Google Earth. Bạn phải chỉ định thuộc tính id nếu dùng cơ chế <Update>.

<Lớp phủ>

Cú pháp

<!-- 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 -->

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. <Overlay> là loại cơ sở cho lớp phủ hình ảnh được vẽ trên bề mặt hành tinh hoặc trên màn hình. <Icon> chỉ định hình ảnh để sử dụng và có thể được định cấu hình để tải lại hình ảnh dựa trên bộ tính giờ hoặc do máy ảnh thay đổi. Phần tử này cũng bao gồm thông số kỹ thuật cho thứ tự xếp chồng của nhiều lớp phủ, cũng như thêm các giá trị màu và độ trong suốt vào hình ảnh cơ sở.

Các phần tử cụ thể cho lớp phủ

<màu>

Giá trị màu được biểu thị bằng ký hiệu thập lục phân, bao gồm cả giá trị độ mờ (alpha). Thứ tự biểu thức là alpha, xanh dương, xanh lục, đỏ (aabbggrr). Phạm vi giá trị cho bất kỳ màu nào là từ 0 đến 255 (00 đến ff). đối với độ mờ, 00 là hoàn toàn trong suốt và ff là hoàn toàn không trong suốt. Ví dụ: Nếu muốn áp dụng màu xanh dương có độ mờ 50% cho một lớp phủ, bạn sẽ chỉ định thuộc tính sau: <color>7fff0000</color>

Lưu ý: Phần tử <geomColor> không còn được dùng nữa. Thay vào đó, hãy sử dụng <color>.

<Đơn đặt hàng vẽ>

Phần tử này xác định thứ tự xếp chồng cho các hình ảnh trong các lớp phủ chồng chéo. Lớp phủ có giá trị <drawOrder> cao hơn được vẽ ở đầu lớp phủ có giá trị <drawOrder> thấp hơn.

<Biểu tượng>

Xác định hình ảnh liên kết với Lớp phủ. Phần tử <href> xác định vị trí của hình ảnh sẽ được dùng làm Lớp phủ. Vị trí này có thể nằm trên hệ thống tệp cục bộ hoặc trên máy chủ web. Nếu phần tử này bị bỏ qua hoặc không chứa <href>, một hình chữ nhật sẽ được vẽ bằng màu sắc và kích thước do lớp phủ mặt đất hoặc lớp phủ màn hình xác định.

<Icon>
   <href>icon.jpg</href>
</Icon>

Kéo dài

<Tính năng>

Mở rộng bởi

<GroundOverlay>
<PhotoOverlay>
<ScreenOverlay>

<PhotoOverlay>

Cú pháp

<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>

Mô tả

Phần tử <PhotoOverlay> cho phép bạn xác định vị trí địa lý một ảnh chụp trên Trái đất và chỉ định thông số xem cho PhotoOverlay này. PhotoOverlay có thể là hình chữ nhật 2D đơn giản, hình trụ một phần hoặc toàn bộ hoặc hình cầu (đối với ảnh toàn cảnh hình cầu). Lớp phủ được đặt tại vị trí đã chỉ định và hướng về phía điểm quan sát.

Vì <PhotoOverlay> có nguồn gốc từ <Feature>, nên nó có thể chứa một trong hai phần tử bắt nguồn từ <AbstractView>—<<Camera> hoặc <LookAt>. Camera (hoặc LookAt) chỉ định một viewpoint và hướng xem (còn gọi là view vector). PhotoOverlay nằm ở vị trí tương quan với điểm quan sát. Cụ thể, mặt phẳng của hình ảnh hình chữ nhật 2D là trực giao (ở góc phải) vectơ xem. pháp tuyến của mặt phẳng này (tức là mặt trước của nó, tức là phần của ảnh) được định hướng về phía điểm quan sát.

URL cho hình ảnh PhotoOverlay được chỉ định trong thẻ <Icon>, được kế thừa từ <Overlay>. Thẻ <Icon> phải chứa phần tử <href> chỉ định tệp hình ảnh để sử dụng cho PhotoOverlay. Trong trường hợp hình ảnh rất lớn, <href> là một URL đặc biệt lập chỉ mục thành một kim tự tháp gồm các hình ảnh có độ phân giải khác nhau (xem ImagePyramid).

Để biết thêm thông tin, hãy xem trang "Chủ đề trong KML" trên PhotoOverlay.

Các phần tử dành riêng cho PhotoOverlay

<xoay

Điều chỉnh cách đặt ảnh vào trường nhìn. Phần tử này hữu ích nếu ảnh của bạn đã được xoay và hơi lệch khỏi một chế độ xem ngang mong muốn.

<ViewVolume>

Xác định mức độ hiển thị của cảnh hiện tại. Việc chỉ định trường nhìn cũng tương tự như chỉ định việc mở ống kính trong máy ảnh thực. Một trường nhìn nhỏ, giống như ống kính tiêu cự dài, tập trung vào một phần nhỏ của cảnh. Một trường nhìn lớn, giống như ống kính góc rộng, tập trung vào một phần lớn cảnh.

<tráiFov>: Góc, theo độ, giữa hướng xem của camera và phía bên trái âm lượng xem.
<bên phải F>: Góc, theo độ, giữa hướng xem của máy ảnh và phía bên phải của âm lượng xem.
<Dưới cùng: Góc, theo độ, giữa hướng xem của camera và cạnh dưới cùng của âm lượng xem.
<topFov>: Góc, theo độ, giữa hướng xem của camera và cạnh trên cùng của âm lượng xem.
<gần>: Đo bằng mét dọc theo hướng xem từ điểm quan sát của máy ảnh đến hình dạng PhotoOverlay.

Trường nhìn cho PhotoOverlay được xác định bởi 4 mặt phẳng, mỗi mặt phẳng được xác định bởi một góc so với vectơ xem. Bốn mặt phẳng này xác định cạnh trên, dưới cùng, bên trái và bên phải của trường xem có hình kim tự tháp bị cắt bớt, như minh họa dưới đây:

Biểu đồ sau đây cho thấy bốn góc của trường xem trong kim tự tháp này:

<Hình ảnh Pyramid>

Đối với hình ảnh có kích thước rất lớn, bạn sẽ phải xây dựng một kim tự tháp hình ảnh, là một tập hợp hình ảnh phân cấp, mỗi hình ảnh là một phiên bản có độ phân giải thấp hơn so với hình ảnh gốc. Mỗi hình ảnh trong kim tự tháp được chia nhỏ thành các ô, vì vậy, bạn chỉ cần tải các phần trong chế độ xem. Google Earth tính toán điểm quan sát hiện tại và tải các ô phù hợp với khoảng cách của người dùng từ hình ảnh. Khi điểm quan sát di chuyển đến gần lớp phủ PhotoOverlay, Google Earth sẽ tải các ô có độ phân giải cao hơn. Vì không thể xem tất cả các pixel trong hình ảnh gốc trên màn hình cùng một lúc, nên quá trình xử lý trước này cho phép Google Earth đạt được hiệu suất tối đa vì Google Earth chỉ tải các phần của hình ảnh đang xem và chỉ các chi tiết pixel mà người dùng có thể nhận biết được tại điểm quan sát hiện tại.

Khi chỉ định hình kim tự tháp, bạn cũng sửa đổi <href> trong phần tử <Icon> để thêm thông số kỹ thuật cho các thẻ thông tin cần tải.

<tileSize>: Kích thước của ô, tính bằng pixel. Thẻ thông tin phải là hình vuông và <tileSize> phải là luỹ thừa của 2. Bạn nên sử dụng kích thước ô 256 (mặc định) hoặc 512. Hình ảnh gốc được chia thành các ô có kích thước này, ở độ phân giải khác nhau.
<maxWidth>: Chiều rộng tính bằng pixel của hình ảnh gốc.
<maxHeight>: Chiều cao tính bằng pixel của hình ảnh gốc.
<gridOrigin>: Chỉ định nơi bắt đầu đánh số ô trong mỗi lớp của kim tự tháp. Giá trị của lowerLeft chỉ định rằng hàng 1, cột 1 của mỗi lớp nằm ở góc dưới cùng bên trái của lưới.

<Điểm>

Phần tử <Point> hoạt động như một <Point> bên trong phần tử <Timestamp>. Nó vẽ một biểu tượng để đánh dấu vị trí của PhotoOverlay. Biểu tượng vẽ được chỉ định bởi các trường <styleUrl> và <StyleSelector>, giống như biểu tượng dành cho <Dấu vị trí>.

<hình dạng>

Ảnh lớp phủ được chiếu lên <shape>. <shape> có thể là một trong những dạng sau:

hình chữ nhật (mặc định) – đối với ảnh thông thường

xi-lanh – đối với ảnh toàn cảnh, có thể là một phần hoặc toàn bộ hình trụ

miễn phí - cho ảnh toàn cảnh hình cầu

Ví dụ:

<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>

Kéo dài

<Lớp phủ>

Bên trong

<Thư mục>, <Document>, hoặc <SSH>

<Dấu vị trí>

Cú pháp

<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>

Mô tả

Dấu vị trí là một tính năng có Hình học được liên kết. Trong Google Earth, Dấu vị trí xuất hiện dưới dạng một mục danh sách trong bảng điều khiển Địa điểm. Dấu vị trí có điểm trỏ có biểu tượng liên kết với một điểm đánh dấu một điểm trên Earth trong trình xem 3D. (Trong trình xem 3D của Google Earth, Dấu vị trí của điểm là đối tượng duy nhất bạn có thể nhấp hoặc cuộn qua. Các đối tượng Hình học khác không có biểu tượng trong trình xem 3D. Để cung cấp cho người dùng thứ gì đó để nhấp vào trong trình xem 3D, bạn cần tạo một đối tượng MultiGeometry chứa cả Điểm và đối tượng Hình học khác.)

Các thành phần cụ thể cho dấu vị trí

0 hoặc một phần tử <Geometry>

Ví dụ:

<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>

Kéo dài

<Tính năng>

Bên trong

<Tài liệu>
<Thư mục>

Xem thêm

<Biểu tượng>

<Điểm>

Cú pháp

<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>

Mô tả

Vị trí địa lý được xác định theo kinh độ, vĩ độ và độ cao (không bắt buộc). Khi một Điểm được chứa trong Dấu vị trí, chính điểm đó sẽ xác định vị trí của tên và biểu tượng của Dấu vị trí. Khi một điểm được đẩy lên, Điểm sẽ được nối với mặt đất bằng một đường kẻ. "Chia sẻ kết nối" này sử dụng LineStyle hiện tại.

Các thành phần dành riêng cho điểm

<thô>

Giá trị Boolean. Chỉ định xem có nối điểm với mặt đất bằng một đường thẳng hay không. Để chèn một Điểm, giá trị của <ElevationMode> phải là RelativeToGround, RelativeToSeaFloor hoặc Absolute. Điểm được đẩy ra về phía tâm cầu của Trái Đất.

<ElevationMode>

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround – (mặc định) Cho biết sẽ bỏ qua một thông số độ cao (ví dụ: trong thẻ <Coordinates>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét. Thông thường, chế độ này được sử dụng để đặt cột điện thoại hoặc cáp treo trượt tuyết.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét. Thông thường, chế độ này được sử dụng để đặt máy bay.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải độ cao dưới dạng một giá trị theo mét so với đáy biển. Nếu điểm nằm trên mặt đất thay vì trên biển, độ cao sẽ được hiểu là ở trên mặt đất.
clampToSeaFloor - Thông số kỹ thuật của độ cao bị bỏ qua và điểm sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<toạ độ>(bắt buộc)

Một bộ dữ liệu gồm có các giá trị dấu phẩy động cho kinh độ, vĩ độ và độ cao (theo thứ tự đó). Giá trị kinh độ và vĩ độ được tính bằng độ, trong đó

kinh độ ≥ -180 và <= 180
vĩ độ ≥ ‐90 và ≤ 90
giá trị elevation (không bắt buộc) tính bằng mét trên mực nước biển

Không thêm dấu cách giữa ba giá trị mô tả một toạ độ.

Ví dụ:

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

Kéo dài

<Hình học>

Bên trong

<MultiGeometry>
<Dấu vị trí>

<Đa giác>

Cú pháp

<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>

Mô tả

Đa giác được xác định bởi một ranh giới ngoài và 0 hoặc nhiều ranh giới bên trong hơn. Đổi lại, các ranh giới này được xác định bằng Linear Rings. Khi một Đa giác được đẩy ra, ranh giới của nó được kết nối với mặt đất để tạo thành các đa giác bổ sung, giúp tạo ra hình dạng của một tòa nhà hoặc một hộp. Đa giác thô sử dụng <PolyStyle> cho màu sắc, chế độ màu và tô màu.

< Toạ độ> cho đa giác phải được chỉ định theo thứ tự ngược chiều kim đồng hồ. Đa giác tuân theo "quy tắc bên phải", trong đó nêu rõ rằng nếu bạn đặt ngón tay phải theo hướng mà toạ độ được chỉ định, ngón tay cái của bạn sẽ trỏ theo hướng chung của pháp tuyến hình học cho đa giác. (Trong đồ hoạ 3D, pháp tuyến hình học dùng để chiếu sáng và hướng ra phía trước mặt đa giác.) Vì Google Earth chỉ lấp đầy mặt trước của đa giác, nên bạn sẽ chỉ đạt được hiệu ứng mong muốn khi toạ độ được chỉ định theo đúng thứ tự. Nếu không, đa giác sẽ có màu xám.

Các phần tử dành riêng cho đa giác

<thô>

Giá trị Boolean. Chỉ định xem có kết nối Đa giác với mặt đất hay không. Để đẩy lên một Đa giác, chế độ độ cao phải là RelativeToGround, RelativeToSeaFloor hoặc tuyệt đối. Chỉ các đỉnh được đẩy lên chứ không phải hình dạng (ví dụ: hình chữ nhật biến thành hộp có năm mặt. Các đỉnh của Đa giác được đẩy về phía tâm của hình cầu Trái đất.

<tessellate>

Đa giác không sử dụng trường này. Để cho phép Đa giác theo dõi địa hình (nghĩa là bật chế độ tessellation), hãy chỉ định chế độ độ cao của clampToGround hoặc clampToSeaFloor.

<ElevationMode>

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround – (mặc định) Cho biết sẽ bỏ qua một thông số độ cao (ví dụ: trong thẻ <Coordinates>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét. Thông thường, chế độ này được sử dụng để đặt cột điện thoại hoặc cáp treo trượt tuyết.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét. Thông thường, chế độ này được sử dụng để đặt máy bay.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải <Elevation> là một giá trị tính theo mét trên đáy biển. Nếu điểm nằm trên mặt đất thay vì trên biển, độ cao sẽ được hiểu là ở trên mặt đất.
clampToSeaFloor - Thông số kỹ thuật của độ cao bị bỏ qua và điểm sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<outerBoundaryIs>(bắt buộc)

Chứa phần tử <Linear Ring>.

<innerBoundaryIs>

Chứa phần tử <Linear Ring>. Đa giác có thể chứa nhiều phần tử <innerBoundaryIs>, trong đó tạo ra nhiều vết cắt bên trong Đa giác.

Ví dụ:

<?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>

Kéo dài

<Hình học>

Bên trong

<MultiGeometry>
<Dấu vị trí>

<PolyStyle>

Cú pháp

<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>

Mô tả

Chỉ định kiểu vẽ cho tất cả các hình đa giác, bao gồm cả đũa đa giác (trông giống như bức tường của các toà nhà) và đũa đường kẻ (trông giống như hàng rào đặc).

Các phần tử dành riêng cho PolyStyle

<điền>: Giá trị Boolean. Chỉ định xem có điền vào đa giác hay không.
<outline>: Giá trị Boolean. Chỉ định xem có nên phác thảo đa giác hay không. Đường viền đa giác sử dụng LineStyle hiện tại.

Ví dụ:

<?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>

Kéo dài

<ColorStyle>

Bên trong

<Kiểu>

<Khu vực>

Cú pháp

<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>

Mô tả

Khu vực chứa hộp giới hạn (<LatLonAltBox>) mô tả khu vực quan tâm được xác định bằng các toạ độ địa lý và cao độ. Ngoài ra, một Vùng có chứa mức LOD (cấp chi tiết) (<Lod>) xác định phạm vi hiệu lực của Vùng được liên kết về kích thước màn hình dự kiến. Vùng được cho là "đang hoạt động" khi hộp giới hạn nằm trong chế độ xem của người dùng và đáp ứng các yêu cầu LOD. Các đối tượng liên kết với một Khu vực chỉ được vẽ khi Khu vực đó đang hoạt động. Khi <viewRefreshMode> là onRegion, Đường liên kết hoặc Biểu tượng chỉ được tải khi Khu vực đó đang hoạt động. Hãy xem trang "Chủ đề trong KML" trên trang Khu vực để biết thêm thông tin chi tiết. Trong hệ thống phân cấp của Vùng chứa hoặc NetworkLink, phép tính này sử dụng Khu vực là đối tượng cấp trên gần nhất trong hệ thống phân cấp.

Các thành phần dành riêng cho khu vực

<LatLonAltBox>(bắt buộc)

Hộp giới hạn mô tả một khu vực quan tâm được xác định bằng toạ độ địa lý và độ cao. Sau đây là các giá trị mặc định và trường bắt buộc:

<ElevationMode> hoặc <gx:ElevationMode>: Các giá trị có thể của <elevationMode> là clampToGround, RelativeToGround và giá trị tuyệt đối. Các giá trị có thể có cho <gx:ElevationMode> là clampToSeaFloor và RelativeToSeaFloor. Ngoài ra, hãy xem <LatLonBox>.
<minElevation>: Được chỉ định theo mét (và chịu ảnh hưởng của quy cách chế độ cao độ).
<maxElevation>: Được chỉ định theo mét (và chịu ảnh hưởng của quy cách chế độ cao độ).
<north> (bắt buộc): Chỉ định vĩ độ của cạnh bắc của hộp giới hạn, theo độ thập phân từ 0 đến ±90.
<south> (bắt buộc): Chỉ định vĩ độ của cạnh nam của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±90.
<east> (bắt buộc)
: Chỉ định kinh độ ở cạnh đông của hộp giới hạn, theo độ thập phân từ 0 đến ±180.
<west> (bắt buộc): Chỉ định kinh độ ở cạnh tây của hộp giới hạn, tính bằng độ thập phân từ 0 đến ±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 là tên viết tắt cho Level of Detail (Cấp độ chi tiết). <Lod> mô tả kích thước của khu vực dự kiến trên màn hình cần thiết để khu vực đó được coi là "đang hoạt động". Đồng thời chỉ định kích thước của đường dốc pixel được sử dụng để làm mờ (từ mờ sang mờ trong suốt) và mờ dần (từ mờ sang trong suốt). Hãy xem sơ đồ dưới đây để minh hoạ trực quan các thông số này.

<Lod>
  <minLodPixels>256</minLodPixels>
  <maxLodPixels>-1</maxLodPixels>
  <minFadeExtent>0</minFadeExtent>
  <maxFadeExtent>0</maxFadeExtent>
</Lod>

<minLodPixels> (bắt buộc)

Xác định một hình vuông trong không gian màn hình, với các cạnh của giá trị được chỉ định bằng pixel. Ví dụ: 128 xác định một hình vuông có kích thước 128 x 128 pixel. Hộp giới hạn của khu vực phải lớn hơn hình vuông này (và nhỏ hơn hình vuông maxLodPixels) để Khu vực hoạt động.

Bạn có thể xem thêm thông tin chi tiết trong chương Làm việc với các khu vực trong Hướng dẫn dành cho nhà phát triển cũng như hướng dẫn Tránh tình trạng quá tải với các khu vực của tài liệu Google Earth Outreach.

<maxLodPixels>

Đo lường bằng pixel màn hình đại diện cho giới hạn tối đa của phạm vi hiển thị cho một Khu vực nhất định. Giá trị -1, giá trị mặc định, cho biết "đang hoạt động ở kích thước vô hạn".

<minFadeExtent>

Khoảng cách mà hình bị mờ, từ mờ hoàn toàn đến hoàn toàn trong suốt. Giá trị đường dốc này, được biểu thị bằng pixel màn hình, được áp dụng ở cuối giới hạn LOD (chế độ hiển thị).

<maxFadeExtent>

Khoảng cách mà hình bị mờ, từ trong suốt đến mờ hoàn toàn. Giá trị đường dốc này, được biểu thị bằng pixel màn hình, được áp dụng ở cuối giới hạn LOD (chế độ hiển thị).

Trong sơ đồ sau, nếu P=kích thước pixel dự kiến được tính toán, các số được khoanh tròn cho biết điều sau:

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

Ví dụ về <Khu vực>

<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>

Kéo dài

<Đối tượng>

Bên trong

bất kỳ phần tử nào có được từ <Feature>

<Giản đồ>

Cú pháp

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

Mô tả

Chỉ định một giản đồ KML tùy chỉnh dùng để thêm dữ liệu tùy chỉnh vào các Tính năng KML. Thuộc tính "id" là thuộc tính bắt buộc và phải là duy nhất trong tệp KML. <Schema> luôn là phần tử con của <Document>.

Các phần tử dành riêng cho giản đồ

Mỗi phần tử của giản đồ chứa một hoặc nhiều phần tử SimpleField. Trong SimpleField, Giản đồ khai báo type và name của trường tuỳ chỉnh. Trường này tùy ý chỉ định một displayName (biểu mẫu thân thiện với người dùng, có dấu cách và dấu câu thích hợp để hiển thị trong Google Earth) cho trường tùy chỉnh này.

<SimpleField type="string" name="string">

Khai báo của trường tùy chỉnh, phải chỉ định cả loại và tên của trường này. Nếu bạn bỏ qua type hoặc name, thì trường này sẽ bị bỏ qua. Loại có thể là một trong những loại sau:

chuỗi
int
gợi ý
ngắn
ngắn
số thực dấu phẩy động
gấp đôi
bool

<displayName>: Tên (nếu có) sẽ được sử dụng khi tên trường đó hiển thị với người dùng Google Earth. Sử dụng phần tử [CDATA] để thoát mã đánh dấu HTML chuẩn.

Ví dụ:

<?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>

Kéo dài

Đây là một phần tử gốc.

Bên trong

<Tài liệu>

Xem thêm

<SchemaData>

<ScreenOverlay>

Cú pháp

<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>

Mô tả

Phần tử này vẽ một lớp phủ hình ảnh cố định cho màn hình. Ví dụ về việc sử dụng Lớp phủ màn hình là la bàn, biểu trưng và màn hình hiển thị ngang tầm mắt. Kích thước Lớp phủ màn hình được xác định bằng phần tử <size>. Vị trí của lớp phủ được xử lý bằng cách ánh xạ một điểm trong hình ảnh do <OverlayXY> chỉ định tới một điểm trên màn hình do <screenXY> chỉ định. Sau đó, hình ảnh sẽ được xoay <rotation> độ khoảng một điểm so với màn hình được chỉ định bởi <rotationXY>.

Phần tử con <href> của <Icon> chỉ định hình ảnh được dùng làm lớp phủ. Tệp này có thể trên hệ thống tệp cục bộ hoặc trên máy chủ web. Nếu phần tử này bị bỏ qua hoặc không chứa <href>, một hình chữ nhật sẽ được vẽ bằng màu sắc và kích thước do lớp phủ màn hình xác định.

Các phần tử dành riêng cho ScreenOverlay

<lớp phủXY>

Chỉ định một điểm trên (hoặc bên ngoài) hình ảnh lớp phủ được liên kết với toạ độ màn hình (<screenXY>). Phương thức này yêu cầu giá trị x và y cũng như đơn vị cho các giá trị đó.

Các giá trị x và y có thể được chỉ định theo ba cách khác nhau: dưới dạng pixel ("pixels"), dưới dạng phân đoạn của hình ảnh ("fraction") hoặc dưới dạng pixel lồng ghép ("insetPixels"), là độ lệch tính bằng pixel từ góc trên bên phải của hình ảnh. Bạn có thể chỉ định vị trí x và y theo các cách khác nhau – ví dụ: x có thể tính bằng pixel và y có thể là một phân số. Điểm gốc của hệ toạ độ nằm ở góc dưới bên trái của hình ảnh.

x – Số pixel, thành phần phân số của hình ảnh hoặc phần lồng ghép pixel cho biết thành phần x của một điểm trên hình ảnh lớp phủ.
y – Số lượng pixel, thành phần phân số của hình ảnh hoặc phần lồng ghép pixel cho biết thành phần y của một điểm trên hình ảnh lớp phủ.
đơn vị – Đơn vị trong đó giá trị x được chỉ định. Giá trị của "fraction" cho biết giá trị x là một phần nhỏ của hình ảnh. Giá trị của "pixels" cho biết giá trị x tính bằng pixel. Giá trị "insetPixels" cho biết thụt lề từ cạnh phải của hình ảnh.
đơn vị yunit – Đơn vị trong đó giá trị y được chỉ định. Giá trị của "fraction" cho biết giá trị y là một phần nhỏ của hình ảnh. Giá trị của "pixels" cho biết giá trị y tính bằng pixel. Giá trị "insetPixels" cho biết thụt lề từ cạnh trên của hình ảnh.

<màn hìnhXY>

Chỉ định một điểm tương ứng với điểm gốc của màn hình nơi hình ảnh lớp phủ được liên kết. Giá trị x và y có thể được chỉ định theo ba cách khác nhau: dưới dạng pixel ("pixels"), dưới dạng phân đoạn của màn hình ("fraction") hoặc dưới dạng pixel lồng ghép ("insetPixels"), là độ lệch tính bằng pixel từ góc trên bên phải màn hình. Bạn có thể chỉ định vị trí x và y theo các cách khác nhau – ví dụ: x có thể tính bằng pixel và y có thể là một phân số. Điểm gốc của hệ toạ độ nằm ở góc dưới bên trái màn hình.

x – Số pixel, thành phần phân số của màn hình hoặc phần lồng ghép pixel cho biết thành phần x của một điểm trên màn hình.
y – Số lượng pixel, một thành phần phân số của màn hình, hoặc phần lồng ghép pixel cho biết thành phần y của một điểm trên màn hình.
đơn vị – Đơn vị trong đó giá trị x được chỉ định. Giá trị của "fraction" cho biết giá trị x là một phần của màn hình. Giá trị của "pixels" cho biết giá trị x tính bằng pixel. Giá trị "insetPixels" cho biết thụt lề từ cạnh phải màn hình.
đơn vị yunit – Đơn vị trong đó giá trị y được chỉ định. Giá trị của phân số cho biết giá trị y là một phân số của màn hình. Giá trị của "pixels" cho biết giá trị y tính bằng pixel. Giá trị "insetPixels" cho biết thụt lề từ cạnh trên của màn hình.

Ví dụ: <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> cho biết một điểm ở giữa màn hình.

Sau đây là một số ví dụ:

Căn giữa hình ảnh:

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

Đặt hình ảnh ở trên cùng bên trái:

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

Đặt hình ảnh ở bên phải màn hình:

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

<rotationXY>

Trỏ tương ứng với màn hình mà lớp phủ màn hình xoay.

<kích thước>

Chỉ định kích thước của hình ảnh cho lớp phủ màn hình như sau:

Giá trị -1 cho biết sử dụng phương diện gốc
Giá trị 0 cho biết duy trì tỷ lệ khung hình
Giá trị n đặt giá trị của phương diện

Ví dụ:

Để buộc hình ảnh giữ lại kích thước x và y ban đầu, hãy đặt giá trị thành -1:

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

Cách buộc hình ảnh giữ lại kích thước theo chiều ngang, nhưng chiếm 20% không gian màn hình dọc:

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

Cách buộc hình ảnh đổi kích thước thành 100 px x 500 px:

<size x="100" y="500" xunits="pixels" yunits="pixels"/>

<xoay

Cho biết góc xoay của đối tượng mẹ. Giá trị 0 có nghĩa là không có xoay vòng. Giá trị là một góc tính theo độ ngược chiều kim đồng hồ bắt đầu từ hướng bắc. Sử dụng ±180 để cho biết chế độ xoay của đối tượng mẹ từ 0. Tâm của <rotation>, nếu không (.5,.5), được chỉ định trong <rotationXY>.

Ví dụ:

Ví dụ sau đây đặt một hình ảnh ở chính giữa màn hình, sử dụng chiều rộng, chiều cao và tỷ lệ khung hình gốc của hình ảnh.

<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>

Kéo dài

<Tính năng>
<Lớp phủ>

Bên trong

<Tài liệu>
<Thư mục>

<Kiểu>

Cú pháp

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

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

Mô tả

Kiểu xác định một nhóm kiểu có thể định địa chỉ có thể được tham chiếu bằng StyleMaps và Các tính năng. Kiểu ảnh hưởng đến cách Hình học được hiển thị trong trình xem 3D và cách Tính năng xuất hiện trong bảng điều khiển Địa điểm của chế độ xem Danh sách. Kiểu chung sẽ được thu thập trong một <Tài liệu> và phải có một mã nhận dạng cho các Thuộc tính đó để có thể tham chiếu bằng các Tính năng riêng lẻ sử dụng kiểu đó.

Sử dụng id để tham chiếu đến kiểu từ <styleUrl>.

Ví dụ:

<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>

Kéo dài

<StyleSelector>

Bên trong

bất kỳ <Feature> nào

Thành phần dành riêng cho phong cách

<BalloonStyle>
<IconStyle>
<LabelStyle>
<LineStyle>
<ListStyle>
<PolyStyle>

<StyleMap>

Cú pháp

<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>

Mô tả

Một <StyleMap> ánh xạ giữa hai Kiểu khác nhau. Thông thường, phần tử <StyleMap> được dùng để cung cấp các kiểu thông thường và được đánh dấu riêng biệt cho một dấu vị trí, để phiên bản được đánh dấu xuất hiện khi người dùng di chuột qua biểu tượng trong Google Earth.

Các phần tử dành riêng cho StyleMap

<Pair>(bắt buộc)

Xác định một cặp giá trị/khoá liên kết một chế độ (thông thường hoặc đánh dấu) đến <styleUrl> đã xác định trước. <Pair> chứa hai phần tử (cả hai đều bắt buộc):

<key>, giúp xác định khoá
<styleUrl> hoặc <Style>, tham chiếu đến kiểu. Trong <styleUrl>, đối với các phần tử kiểu được tham chiếu cục bộ cho tài liệu KML, # tham chiếu đơn giản được sử dụng. Đối với các kiểu có trong tệp bên ngoài, hãy sử dụng URL đầy đủ cùng với # tham chiếu. Ví dụ:

<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair>

Ví dụ:

<?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>

Kéo dài

<StyleSelector>

Bên trong

bất kỳ <Feature> nào

<StyleSelector>

Cú pháp

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

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Đây là kiểu cơ sở cho các phần tử <Style> và <StyleMap>. Phần tử StyleMap chọn một kiểu dựa trên chế độ hiện tại của Dấu vị trí. Một phần tử bắt nguồn từ StyleSelector sẽ được xác định riêng bằng id và url của phần tử đó.

Các phần tử dành riêng cho StyleSelector

Phần tử trừu tượng này không chứa bất kỳ phần tử con nào.

Kéo dài

<Đối tượng>

Mở rộng bởi

<Kiểu>
<Bản đồ>

<Thời gian chính thức>

Cú pháp

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

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Phần tử này được mở rộng bằng các phần tử <TimeSpan> và <TimeStamp>.

Kéo dài

<Đối tượng>

Mở rộng bởi

<TimeSpan>
<TimeStamp>

<TimeSpan>

Cú pháp

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

Mô tả

Biểu thị một phạm vi thời gian bị giới hạn bởi ngày bắt đầu và ngày kết thúc dateTimes.

Nếu <begin> hoặc <end> bị thiếu, thì giai đoạn kết thúc của giai đoạn đó sẽ không được liên kết (xem Ví dụ bên dưới).

dateTime được xác định theo thời gian trong giản đồ XML (xem phần Giản đồ XML phần 2: Phiên bản dữ liệu thứ hai). Giá trị này có thể được biểu thị bằng yyyy-mm-ddThh:mm:ss.ssszzzz, trong đó T là dấu phân cách giữa ngày và giờ, và múi giờ là Z (đối với múi giờ UTC) hoặc zzzzzz, đại diện cho ±hh:mm tương ứng với UTC. Ngoài ra, giá trị này chỉ có thể được thể hiện dưới dạng một ngày. Xem <TimeStamp> để biết ví dụ.

Các phần tử dành riêng cho TimeSpan

<bắt đầu>: Mô tả nội dung bắt đầu của một khoảng thời gian. Nếu không có cột mốc này, thì giai đoạn đầu sẽ không bị ràng buộc.
<end>: Mô tả thời điểm kết thúc của một khoảng thời gian. Nếu không có thẻ này, bạn sẽ không bị ràng buộc vào cuối kỳ.

Ví dụ:

Ví dụ sau đây thể hiện khoảng thời gian thể hiện trạng thái tiểu bang Colorado. Thẻ này chỉ chứa thẻ <begin> vì Colorado trở thành một trạng thái vào ngày 1 tháng 8 năm 1876 và tiếp tục là một trạng thái:

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

Kéo dài

<Thời gian chính>

Bên trong

bất kỳ phần tử nào có được từ <Feature>

< TimeStamp>

Cú pháp

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

Mô tả

Thể hiện một khoảnh khắc duy nhất. Đây là một phần tử đơn giản và không chứa phần tử con nào. Giá trị của lớp là dateTime, được chỉ định trong thời gian XML (xem Giản đồ XML Phần 2: Phiên bản dữ liệu loại thứ hai). Độ chính xác của TimeStamp được quyết định bởi giá trị dateTime trong phần tử <when>.

Các phần tử dành riêng cho TimeStamp

<khi>

Chỉ định một khoảnh khắc duy nhất. Giá trị là dateTime, có thể là một trong những giá trị sau:

dateTime cung cấp độ phân giải thứ hai
date đưa ra ngày phân giải
gYearMonth cung cấp độ phân giải theo tháng
gYear đưa ra độ phân giải trong năm

Các ví dụ sau đây minh họa các độ phân giải khác nhau cho giá trị <when>:

gYear (YYYY)

<TimeStamp>
  <when>1997</when>
</TimeStamp>

gYearTháng (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)
Ở đây, T là dòng phân cách giữa lịch và ký hiệu giờ theo giờ và Z cho biết múi giờ UTC. (Bạn cần nhập giây.)

<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>

dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
Ví dụ này đưa ra giờ địa phương và sau đó là ± lượt chuyển đổi sang giờ UTC.

<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

Kéo dài

<Thời gian chính>

Bên trong

bất kỳ phần tử nào mở rộng <Feature>

<gx:TimeSpan> và <gx:TimeStamp>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Bản sao của các phần tử <TimeSpan> và <TimeStamp>, trong vùng chứa tên của phần mở rộng. Điều này cho phép đưa các giá trị thời gian vào AbstractView (<Camera> và <LookAt>). Giá trị thời gian được dùng để kiểm soát hình ảnh lịch sử, ánh sáng mặt trời và chế độ hiển thị của các tính năng được đánh dấu thời gian.

Ví dụ:

<?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:Tham quan>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

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

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

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

Mô tả

<gx:Tour> có thể chứa một phần tử <gx:Playlist>, trong đó chứa một danh sách gx:TourPrimitive phần tử theo thứ tự giúp xác định chuyến tham quan trong bất kỳ trình duyệt KML nào. Tìm hiểu thêm về chuyến tham quan.

Ví dụ:

Một số ví dụ về chuyến tham quan có trong chương Tham quan trong Hướng dẫn dành cho nhà phát triển KML.

Chứa

gx:Danh sách phát – Chứa số phần tử gx:TourPrimitive bất kỳ. Có thể có 0 hoặc 1 phần tử <gx:Playlist> chứa trong phần tử <gx:Tour>.

<gx:Tour>
  <gx:Playlist>
    <!-- gx:TourPrimitive -->
      ...
    <!-- /gx:TourPrimitive -->

    <!--- Any number of gx:TourPrimitive elements can be included --->
  </gx:Playlist>
</gx:Tour>

<gx:tourPrimitive>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.0 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

Đây là phần tử trừu tượng và không thể dùng trực tiếp trong tệp KML. Phần tử này được mở rộng bởi các phần tử <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait> và <gx:SoundCue>.

Các phần tử được mở rộng từ gx:TourPrimitive cung cấp hướng dẫn cho các trình duyệt KML trong các chuyến tham quan, bao gồm các điểm cần di chuyển đến và thời lượng của các chuyến bay đó, tạm dừng, cập nhật các tính năng KML và tệp âm thanh để phát.

Những phần tử này phải nằm trong phần tử <gx:Playlist> và chứa lại phần tử <gx:Tour>.

Ví dụ:

<?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>

Chứa bởi

<gx:Danh sách phát>

Mở rộng bởi

<gx:AnimatedUpdate>
<gx:FlyTo>
<gx:SoundCue>
```
<gx:SoundCue id="ID">
  <href>http://www.example.com/audio/trumpets.mp3</href>   
  <gx:delayedStart>0</gx:delayedStart>                     
</gx:SoundCue>
```
Chứa phần tử <href> chỉ định tệp âm thanh để phát, ở định dạng MP3, M4A hoặc AAC. Tệp này không chứa thời lượng. Tệp âm thanh phát song song với phần còn lại của chuyến tham quan, tức là chuyến tham quan gốc tiếp theo diễn ra ngay sau khi chuyến tham quan gốc sơ bộ đạt đến <gx:SoundCue>. Nếu một tệp âm thanh khác được báo hiệu trước khi phát xong tệp đầu tiên, thì các tệp đó sẽ được kết hợp. Phần tử <gx:delayedStart> chỉ định độ trễ của phần âm thanh bắt đầu trong một số giây nhất định trước khi phát tệp.
<gx:tourControl>
```
<gx:TourControl id="ID">
  <gx:playMode>pause</gx:playMode>    
</gx:TourControl>
```
Chứa một phần tử <gx:playMode>, cho phép tạm dừng chuyến tham quan cho đến khi người dùng thực hiện hành động để tiếp tục tham quan.
<gx:Wait>
```
<gx:Wait id="ID">
  <gx:duration>0.0</gx:duration>    
</gx:Wait>
```
Camera vẫn ở trạng thái gx:AbstractView được xác định gần đây nhất trong số giây được chỉ định trước khi phát gx:TourPrimitive tiếp theo. Lưu ý rằng thời gian chờ không tạm dừng tiến trình tham quan - tệp âm thanh hiện đang phát và bản cập nhật động sẽ tiếp tục phát trong khi máy ảnh đang chờ.

Kéo dài

<Đối tượng>

<gx:Bản nhạc>

Phần tử này là phần mở rộng của tiêu chuẩn OGC KML 2.2 và được hỗ trợ trong Google Earth 5.2 trở lên. Tìm hiểu thêm

Cú pháp

<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>

Mô tả

Đường đi mô tả cách vật di chuyển qua thế giới trong một khoảng thời gian nhất định. Tính năng này cho phép bạn tạo một đối tượng hiển thị trong Google Earth (biểu tượng Điểm hoặc Mô hình) để mã hoá nhiều vị trí cho cùng một đối tượng nhiều lần. Trong Google Earth, thanh trượt thời gian cho phép người dùng di chuyển chế độ xem qua thời gian, ảnh động này hiển thị vị trí của đối tượng.

Phần tử gx:MultiTrack dùng để thu thập nhiều bản nhạc thành một đơn vị khái niệm có một biểu tượng (hoặc Mô hình) liên kết di chuyển dọc theo bản nhạc đó. Tính năng này hữu ích nếu bạn có nhiều bản nhạc cho cùng một đối tượng trong thế giới thực. Phần tử <gx:interpolate> Boolean của một <gx:MultiTrack> chỉ định việc nội suy giữa các bản nhạc trong một bản nhạc đa kênh hay không. Nếu giá trị này bằng 0, điểm hoặc Mô hình sẽ dừng ở cuối một tuyến đường và chuyển đến điểm bắt đầu của tuyến đường tiếp theo. (Ví dụ: nếu bạn muốn một dấu vị trí thể hiện chuyến đi của bạn trong hai ngày và thiết bị GPS của bạn bị tắt trong bốn giờ trong khoảng thời gian này, bạn sẽ muốn hiển thị một gián đoạn giữa các điểm mà thiết bị bị tắt và sau đó bật lại.) Nếu giá trị của <gx:interpolate> là 1, thì các giá trị giữa bản nhạc đầu tiên và bản nhạc đầu tiên của bản nhạc sẽ được nội suy để bản nhạc đó xuất hiện dưới dạng một đường dẫn liên tục.

Xem Hướng dẫn sử dụng Google Earth để biết thông tin về cách nhập dữ liệu GPS vào Google Earth.

Tại sao bản nhạc lại hữu ích?

Các phiên bản KML cũ hơn (trước Google Earth 5.2) cho phép bạn liên kết phần tử thời gian với bất kỳ Tính năng nào (dấu vị trí, lớp phủ mặt đất, v.v.). Tuy nhiên, bạn chỉ có thể liên kết một phần tử thời gian với một Tính năng nhất định. Đường đi là cơ chế hiệu quả hơn để liên kết dữ liệu thời gian với Các tính năng hiển thị, vì bạn chỉ tạo một Tính năng có thể được liên kết với nhiều yếu tố thời gian khi đối tượng di chuyển qua không gian.

Ngoài ra, phần tử theo dõi này mạnh hơn cơ chế trước đó (được mô tả trong chương Thời gian và ảnh động của Hướng dẫn dành cho nhà phát triển KML) vì <Track> cung cấp cơ chế nội suy vị trí của đối tượng bất cứ lúc nào dọc theo đường dẫn của nó. Với tính năng mới này, Google Earth sẽ hiển thị biểu đồ độ cao và cấu hình tốc độ (cùng với dữ liệu tuỳ chỉnh, nếu có) cho đối tượng theo thời gian.

Dữ liệu "thư giãn"

Khi thiếu một số giá trị dữ liệu cho các vị trí trên đường đi, bạn có thể cung cấp các thẻ trống <coord/> (<coord></coord>) hoặc <angles/> (<angles></angles>) để cân bằng các mảng. Thẻ <coord/> hoặc <angles/> trống cho biết rằng không có dữ liệu nào như vậy tồn tại cho một điểm dữ liệu nhất định và giá trị phải được nội suy giữa hai điểm dữ liệu gần nhất được chỉ định rõ. Hành vi này cũng áp dụng cho ExtendedData cho một kênh. Bất kỳ phần tử nào ngoại trừ <when> đều có thể để trống và sẽ được nội suy giữa hai phần tử gần nhất được chỉ định.

Các thành phần cụ thể cần theo dõi

<ElevationMode>

Chỉ định cách diễn giải các thành phần elevation trong phần tử < Toạ độ>. Các giá trị có thể sử dụng là

clampToGround - (mặc định) Cho biết sẽ bỏ qua một thông số độ cao (ví dụ: trong thẻ <gx:coord>).
RelativeToGround – Đặt độ cao của phần tử so với độ cao thực tế của mặt đất tại một vị trí cụ thể. Ví dụ: nếu độ cao mặt đất của một vị trí chính xác ở mực nước biển và độ cao của một điểm được đặt thành 9 mét, thì độ cao của biểu tượng độ cao của dấu vị trí điểm là 9 mét với chế độ này. Tuy nhiên, nếu cùng một toạ độ được đặt trên vị trí có độ cao mặt đất là 10 mét so với mực nước biển, thì độ cao của toạ độ là 19 mét.
tuyệt đối - Đặt độ cao của tọa độ so với mực nước biển, bất kể độ cao thực tế của địa hình bên dưới phần tử. Ví dụ: nếu bạn đặt độ cao thành 10 mét với chế độ độ cao tuyệt đối, biểu tượng của dấu vị trí điểm sẽ xuất hiện ở vị trí mặt đất nếu địa hình bên dưới cũng cao hơn mực nước biển 10 mét. Nếu địa hình cao hơn 3 mét so với mực nước biển, dấu vị trí sẽ xuất hiện trên cao của địa hình thêm 7 mét.

<gx:ElevationMode>

Phần mở rộng KML trong không gian tên của phần mở rộng trên Google, cho phép cao độ so với đáy biển. Các giá trị là:

RelativeToSeaFloor - Diễn giải độ cao dưới dạng một giá trị theo mét so với đáy biển. Nếu điểm nằm trên mặt đất thay vì trên biển, độ cao sẽ được hiểu là ở trên mặt đất.
clampToSeaFloor - Thông số kỹ thuật của độ cao bị bỏ qua và điểm sẽ được đặt dưới đáy biển. Nếu điểm nằm trên mặt đất chứ không phải trên biển, điểm này sẽ được đặt trên mặt đất.

<thời điểm>

Giá trị thời gian tương ứng với một vị trí (được chỉ định trong phần tử <gx:coord>). Số lượng phần tử <when> trong một <Track> phải bằng số phần tử <gx:coord> (và các phần tử <gx:angles> nếu được đưa vào).

<gx:coord>

Giá trị tọa độ bao gồm ba giá trị cho kinh độ, vĩ độ và độ cao không có dấu phân tách dấu phẩy. Ví dụ:

<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

Lưu ý rằng cú pháp cho phần tử <gx:coord> khác với cú pháp cho phần tử <Coordinates>. Bộ lọc này sử dụng dấu phẩy để phân tách các thành phần kinh độ, vĩ độ và cao độ. Số lượng phần tử được chỉ định phải bằng số phần tử () và vị trí (). Bạn có thể chỉ định một phần tử <gx:coord> trống cho một giá trị bị thiếu nếu cần.

<gx:angles>

Giá trị này được dùng để xác định một tiêu đề, độ nghiêng và giá trị cuộn bổ sung cho biểu tượng hoặc mô hình cho từng thời điểm/vị trí trong kênh. Ba giá trị dấu phẩy động được liệt kê mà không có dấu phân tách dấu phẩy và thể hiện mức độ xoay. Nếu không chỉ định <gx:angles> thì Google Earth sẽ dự đoán tiêu đề, độ nghiêng và độ cuộn của đối tượng từ đường đi của đối tượng. Số lượng phần tử <gx:angles> được chỉ định phải bằng số lượng phần tử (<when>) và vị trí (<gx:coord>). Bạn có thể chỉ định một phần tử <gx:angles> trống cho một giá trị bị thiếu nếu cần.

Hiện tại, các biểu tượng chỉ hỗ trợ tiêu đề, nhưng các mô hình hỗ trợ cả 3 giá trị.

Dưới đây là ví dụ về cách đặt giá trị này:

<gx:angles>45.54676 66.2342 77.0</gx:angles>

<Mô hình>

Nếu được chỉ định, Mô hình sẽ thay thế biểu tượng Điểm dùng để biểu thị vị trí hiện tại trên kênh. Khi <Model> được chỉ định trong một <gx:Track>, sau đây là cách các phần tử con của hàm <Model>:

Phần tử <Location> bị bỏ qua.
Phần tử <ElevationMode> bị bỏ qua.
Giá trị <Orientation> được kết hợp với hướng của bản nhạc như sau. Đầu tiên, chế độ xoay <Orientation> được áp dụng để đưa mô hình từ hệ toạ độ (x, y, z) cục bộ sang hướng bên phải, hướng về phía bắc. Tiếp theo, chế độ xoay được áp dụng tương ứng với phép nội suy của giá trị <gx:angles ảnh hưởng đến tiêu đề, độ nghiêng và độ cuộn của mô hình khi nó di chuyển theo đường đi. Nếu không có góc nào được chỉ định, tiêu đề và độ nghiêng sẽ được dự đoán từ chuyển động của mô hình.
Mẹo: Nếu bạn không chắc chắn về cách chỉ định hướng, hãy bỏ qua phần tử <Orientation> khỏi <Model> và xem cách Google Earth định vị mô hình khi nó di chuyển dọc theo đường đi. Nếu bạn nhận thấy phía trước của mô hình nằm đối diện với nhau, hãy sửa đổi phần tử <heading> trong <Orientation> để xoay mô hình sao cho mô hình hướng về phía trước. Nếu mô hình không thẳng đứng, hãy thử sửa đổi các phần tử <tilt> hoặc <roll>.

<ExtendedData>

Các phần tử dữ liệu tùy chỉnh được xác định trong <Schema> trước đó trong tệp KML.

Việc thêm dữ liệu mở rộng được liên kết với từng thời điểm/vị trí trên một kênh sẽ giúp ích cho bạn. Ví dụ: Chuyến đi xe đạp có thể bao gồm dữ liệu về nhịp tim, nhịp bước chân và sức mạnh, như được hiển thị trong Ví dụ về Theo dõi bằng dữ liệu mở rộng. Trong <Schema>, bạn xác định một <gx:SimpleArrayField> cho từng loại dữ liệu tuỳ chỉnh. Sau đó, đối với mỗi loại dữ liệu, hãy cung cấp phần tử <gx:SimpleArrayData> chứa các phần tử <gx:value> tương ứng với từng thời điểm/vị trí trên kênh. Xem chương Thêm dữ liệu tùy chỉnh trong Hướng dẫn dành cho nhà phát triển KML để biết thêm thông tin về cách thêm trường dữ liệu mới. Trong Google Earth, dữ liệu tuỳ chỉnh được hiển thị trong Cấu hình độ cao cho đường đi.

Ví dụ đơn giản

Ví dụ rất cơ bản này cho thấy cách tạo "mảng" giá trị song song cho <when> và <gx:coord>. Số lượng thời gian và giá trị vị trí phải bằng nhau.

<?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>

Ví dụ về kênh theo dõi có dữ liệu mở rộng

Kiểu chữ in đậm trong ví dụ này làm nổi bật các thành phần dùng để xác định và chỉ định dữ liệu tuỳ chỉnh cho chuyến đi xe đạp. Các trường dữ liệu tuỳ chỉnh được đặt tên nội bộ là "Nhịp tim", "nhịp" và "nguồn". Phần tử <Schema> xác định tên hiển thị cho từng tập hợp giá trị (Nhịp tim, nhịp và sức mạnh) và chỉ định loại dữ liệu cho từng trường mới (Nhịp tim và nhịp là int và sức mạnh thuộc loại float). Trong Google Earth, dữ liệu tùy chỉnh này được hiển thị với cấu hình độ cao cho bản nhạc.

Ví dụ này là một bản trình bày thực tế hơn về một bản nhạc, với các biểu tượng tùy chỉnh cũng như các biểu tượng và kiểu đường kẻ riêng biệt để làm nổi bật và sử dụng các chế độ thông thường. Tuy nhiên, xin lưu ý rằng ví dụ này chỉ bao gồm 7 tập hợp giá trị dữ liệu. Ví dụ thực tế này chứa hàng chục nghìn giá trị. (Được phép của Sean Broeder. Dữ liệu này được thu thập bằng Garmin Edge 705 với tính năng theo dõi nhịp tim và đồng hồ đo điện năng.)

<?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>

Kéo dài

<Địa lý>

Bên trong

<MultiGeometry>
<gx:MultiTrack>
<Dấu vị trí>

<Cập nhật>

Cú pháp

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

Mô tả

Chỉ định một thao tác thêm, thay đổi hoặc xoá vào dữ liệu KML đã được tải bằng URL chỉ định. <targetHref> chỉ định tệp .SSH hoặc .SRC có dữ liệu (trong Google Earth) cần sửa đổi. <Update> luôn nằm trong NetworkLinkControl. Hơn nữa, tệp chứa NetworkLinkControl phải do NetworkLink tải. Hãy xem trang "Chủ đề trong KML" trên trang Cập nhật để biết ví dụ chi tiết về cách hoạt động của ứng dụng Cập nhật.

Các thành phần cụ thể cần cập nhật

Có thể chứa số lượng phần tử <Change>, <Create> và <Delete> bất kỳ sẽ được xử lý theo thứ tự.

<targetHref>(bắt buộc): URL chỉ định tệp . hoặc .SRC có dữ liệu (trong Google Earth) cần được sửa đổi bằng phần tử <Update>. Tệp KML này đã được tải qua một <NetworkLink>. Trong tệp đó, phần tử cần sửa đổi phải có thuộc tính id rõ ràng được xác định.
<Thay đổi>: Sửa đổi các giá trị trong phần tử đã được tải bằng <NetworkLink>. Trong phần tử Change, thành phần con cần sửa đổi phải bao gồm thuộc tính targetId tham chiếu đến id của phần tử gốc.; Bản cập nhật này có thể được coi là một "bản cập nhật thưa thớt": trong phần tử được sửa đổi, chỉ những giá trị được liệt kê trong <Change> mới được thay thế; tất cả các giá trị khác vẫn không thay đổi. Khi <Change> được áp dụng cho một tập hợp các toạ độ, các toạ độ mới sẽ thay thế các toạ độ hiện tại.; Phần tử con của phần tử này là(các) phần tử cần sửa đổi, được xác định bằng thuộc tính targetId.
<Tạo>: Thêm các phần tử mới vào một Thư mục hoặc Tài liệu đã được tải qua <NetworkLink>. Phần tử <targetHref> trong <Update> chỉ định URL của tệp . hoặc .SRC chứa Thư mục hoặc Tài liệu gốc. Trong tệp đó, thư mục hoặc tài liệu chứa dữ liệu mới phải có id rõ ràng được xác định cho thư mục hoặc tài liệu đó. id này được tham chiếu dưới dạng thuộc tính targetId của Thư mục hoặc Tài liệu trong <Create> chứa phần tử sẽ được thêm.; Sau khi tạo và tải một đối tượng vào Google Earth, đối tượng này sẽ lấy URL của Tài liệu gốc về Thư mục gốc. Để thực hiện cập nhật tiếp theo cho các đối tượng được thêm bằng cơ chế Cập nhật/Tạo này, hãy đặt <targetHref> thành URL của Tài liệu hoặc Thư mục gốc (không phải URL của tệp đã tải bản cập nhật can thiệp).
<Xoá>: Xoá các tính năng khỏi phần tử phức tạp đã được tải qua một <NetworkLink>. Phần tử <targetHref> trong <Update> chỉ định tệp . hoặc .SRC chứa dữ liệu cần xoá. Trong tệp đó, phần tử cần xóa phải có id rõ ràng được xác định cho phần tử. Phần tử <Delete> tham chiếu id này trong thuộc tính targetId.; Các phần tử con của <Delete> là các phần tử duy nhất có thể xóa được, chẳng hạn như Tài liệu, Thư mục, GroundOverlay, Timestamp và ScreenOverlay.

Ví dụ về <Thay đổi>

<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>

Ví dụ về <Create>

Ví dụ này tạo một Dấu vị trí mới trong Tài liệu được tạo trước đó có id là "region24". Xin lưu ý rằng nếu muốn cập nhật tiếp theo cho "placemark891", bạn vẫn sẽ sử dụng http://myserver.com/Point.SSH làm <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>

Ví dụ về <Delete>

Ví dụ này xoá Dấu vị trí đã tải trước đó vào Google Earth. (Dấu vị trí này có thể đã được tải trực tiếp bởi NetworkLink với URL được chỉ định hoặc có thể đã được tải bởi Nội dung cập nhật tiếp theo cho Tài liệu gốc.)

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

Bên trong

<NetworkLinkControl>

<URL>

Lưu ý: Phần tử này không còn được dùng trong Bản phát hành KML 2.1 nữa mà được thay thế bằng <Link>, một phần tử cung cấp chức năng bổ sung của Khu vực. Thẻ <Url> sẽ vẫn hoạt động trong Google Earth, nhưng bạn nên sử dụng thẻ <Link> mới hơn.

Hãy sử dụng phần tử này để đặt vị trí của đường liên kết cho tệp KML, dùng để xác định các lựa chọn làm mới cho máy chủ và các thay đổi của người xem, cũng như để điền một biến nhằm trả lại thông tin hữu ích cho máy chủ.

Quay lại đầu trang