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

Tệp AdX

Tệp AdX là gì?

Tệp AdX bao gồm một tệp KML chính và không có hoặc nhiều tệp hỗ trợ được đóng gói bằng tiện ích Zip thành một đơn vị, được gọi là bản lưu trữ. Sau đó, hệ thống có thể lưu trữ và tải tệp SAML dưới dạng một thực thể duy nhất. NetworkLink có thể tìm nạp tệp AdX từ máy chủ web. Khi tệp AdX được giải nén, tệp .sftp chính và các tệp hỗ trợ sẽ được phân tách thành các định dạng và cấu trúc thư mục gốc, cùng với tên tệp và đuôi tệp gốc. Ngoài định dạng lưu trữ, định dạng Zip cũng được nén, vì vậy, lưu trữ chỉ có thể bao gồm một tệp KML lớn. Tuỳ thuộc vào nội dung của tệp KML, quá trình này thường dẫn đến việc nén 10:1. Tệp KML 10 Kbyte của bạn có thể được phân phát bằng tệp AdX 1 Kbyte.

Google Earth và Google Maps có thể đọc tệp KML và MRSS trực tiếp, đồng thời có thể lưu tệp dưới dạng tệp AdX. Theo mặc định, tệp KML chính có tên là doc.SSH.

Lưu ý: Để rõ ràng hơn, trang này đề cập đến tệp KML chính trong tệp lưu trữ AdX dưới dạng doc.SSH. Tệp KML chính này có thể có tên bất kỳ, miễn là tệp kết thúc bằng .SSH và miễn là chỉ có một tệp .SSH.

Bạn nên tạo tệp AdX nếu tệp doc.SSH lớn hơn 10 Kbyte hoặc nếu tệp doc.SSH tham chiếu đến các tệp khác (hình ảnh, tệp âm thanh, mô hình, kết cấu).

Cấu trúc thư mục được đề xuất

Phần này đưa ra một số đề xuất đơn giản cho người sáng tạo tệp KML/KMZ. Ví dụ được sử dụng trong phần này là từ trang web củaJimmy Buffett, sử dụng định dạng KML để hiển thị các chuyến lưu diễn dự kiến và những điểm nổi bật có liên quan trên Google Earth.

Tải tệp ONIX chứa chuyến tham quan này xuống. (Được sử dụng theo quyền.)

Lưu ý: Google Earth 6.0 thực thi nghiêm ngặt bộ nguyên tắc sau khi giải quyết các tham chiếu tương đối trong tệp AdX (đặc biệt xem mục 4 trong danh sách sau). Các phiên bản trước của Google Earth ít nghiêm ngặt hơn trong cách họ giải quyết các tệp tham chiếu tương đối. Do đó, một số tệp tham chiếu tương đối hoạt động trong Google Earth 5.2 trở xuống hiện có thể cần được chỉnh sửa để phù hợp với phiên bản 6.0 trở lên.

Hãy tuân thủ các nguyên tắc sau khi tạo tệp AdX:

Tạo thư mục chứa nội dung của tệp AdX. Đặt tên cho phần này (ví dụ: buffetthawaiitour).
Đặt tệp KML mặc định (doc.SSH hoặc bất kỳ tên nào bạn muốn đặt ở cấp cao nhất trong thư mục này. Chỉ bao gồm một tệp .SSH. (Khi Google Earth mở tệp AdX, nó sẽ quét tệp, tìm tệp .SSH đầu tiên trong danh sách này. Hàm này sẽ bỏ qua tất cả các tệp .SSH tiếp theo, nếu có, trong tệp lưu trữ. Nếu bản lưu trữ chứa nhiều tệp .SSH, bạn không thể chắc chắn tệp nào sẽ được tìm thấy trước tiên, vì vậy bạn chỉ cần bao gồm một tệp.)
Đưa một hoặc nhiều thư mục con vào thư mục chính để thu thập hình ảnh, mô hình, hoạ tiết, tệp âm thanh hoặc các tài nguyên khác được tham chiếu trong tệp doc.SSH. Cấu trúc thư mục này rất phức tạp, tuỳ thuộc vào số lượng tệp hỗ trợ và lựa chọn ưu tiên của bạn đối với tổ chức.
Sử dụng tệp đối chiếu tương đối. Xem phần Tham chiếu đến các tệp bên ngoài để biết thêm thông tin chi tiết. Tất cả đường dẫn tương đối đều bắt đầu bên trong thư mục cơ sở như mô tả ở trên trong mục 1. Ví dụ: nếu tệp AdX travelJournal.SRC đang ở trên máy tính, và tệp doc.SSH đề cập đến một tệp myfavoritePlace.jpg, cũng ở trên máy tính, thì <href> trong tệp doc.sftp là ../myFavoritePlace.jpg.
Không sử dụng phần mở rộng .SRC cho mọi thư mục con trong tệp MRSS. Phần mở rộng .SRC chỉ dành riêng cho tên của bản lưu trữ.

Ví dụ: dưới đây là cấu trúc tệp của tệp AdX cho chuyến tham quan Jimmy Buffett:

Vì chỉ có năm tệp hỗ trợ, tất cả chúng đều được thu thập vào một thư mục con tệp trong thư mục chính. Nếu tải tệp vào Google Earth, sau đó sao chép và dán tệp vào một trình duyệt văn bản, bạn sẽ thấy tất cả phần tử <href> sử dụng tệp tham chiếu tương đối đến các tệp hỗ trợ này (đại diện cho biểu tượng, lớp phủ màn hình và tệp âm thanh cho chuyến tham quan).

Sau đây là mã KML cho một trong các tham chiếu biểu tượng:

<IconStyle>
  <scale>1.1</scale>
  <Icon>
    <href>files/icon_surfing.png</href>
  </Icon>
</IconStyle>

Dưới đây là mã KML để tham chiếu đến tệp âm thanh:

<gx:SoundCue>
  <href>files/Margaritaville.mp3</href>
</gx:SoundCue>

Tệp tham chiếu đến tệp bên ngoài

Tệp doc.SSH thường chứa một số đường liên kết đến các tệp khác — hình ảnh, biểu tượng, mô hình, kết cấu và tệp âm thanh. Các tham chiếu đến những tệp này được chứa trong thuộc tính href (hoặc đôi khi là phần tử <href>). Bạn có thể tìm thấy các thuộc tính này trong các phần tử KML sau:

phần tử <a href> của <description> (và cũng <img src> trong <description>)
<Icon> (với tư cách là con của <IconStyle>, <GroundOverlay>, <ScreenOverlay>, <PhotoOverlay>)
<Biểu tượng mặt hàng>
<Đường liên kết>
<gx:SoundCue>
<targetHref> và <sourceHref> trong <Alias>

Các đường liên kết ngoài này có thể là tệp tham chiếu tuyệt đối hoặc tương đối, như mô tả trong phần sau. Chúng có thể tham chiếu đến các tệp trong cùng một tệp ⌘, hoặc những tệp có trong các tệp MRSS khác hoặc được lưu trữ ở nơi khác trên web. Ngoại trừ phần tử <sourceHref> trong <Model>, các tệp tham chiếu tương đối luôn được giải quyết liên quan đến tệp doc.SSH, như được giải thích trong phần Giải quyết các tệp đối chiếu tương đối.

Tham chiếu tuyệt đối so với tham chiếu tương đối

Tệp tham chiếu tuyệt đối chứa URL đầy đủ của tệp được liên kết. Các tệp này hữu ích cho tệp được đăng trên máy chủ trung tâm và không rõ ràng. Tuy nhiên, nếu bạn sử dụng các tệp tham chiếu tuyệt đối đến các tệp cục bộ, thì các đường liên kết này sẽ bị hỏng khi các tệp đó được chuyển sang hệ thống mới. Nội dung tham chiếu tương đối có thể giúp bạn tránh vấn đề này.

Sau đây là ví dụ về tệp tham chiếu tuyệt đối đến tệp được lưu trữ trên máy chủ trung tâm:

<Icon>
  <href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href>
</Icon>

Giải quyết các tệp đối chiếu tương đối

Nói chung, các tham chiếu tương đối được giải quyết liên quan đến tệp doc.SSH. Mọi URL tương đối đều được phân giải dựa trên thư mục chứa tệp này, thư mục này được coi là thư mục gốc của tệp AdX. Trong ví dụ về chuyến tham quan Hawaii, URL cơ sở tương tự như sau (tuỳ thuộc vào nơi bạn tải tệp MRSS xuống):

buffetthawaiitour.kmz

Nếu muốn tham chiếu đến một tệp nằm trong một tệp ⌘ khác (ví dụ: đến images/jimmyphoto.jpg có trong margaritavillealbum.SRC, bạn sẽ sử dụng ký hiệu ".." để đi lên một cấp trong cấu trúc thư mục. Tệp này sẽ đưa bạn ra khỏi tệp MRSS hiện tại (buffetthawaiitour.SRC):

<href>../margaritavillealbum.kmz/images/jimmyphoto.jpg"</href>

Lưu ý: Các quy tắc phân giải tệp đối chiếu tương đối trong bản lưu trữ MRSS dựa trên tiêu chuẩn RFC 3986 Mục 5 để phân giải URL của trang web. URL cơ sở được xác định theo vị trí của tệp doc. và tất cả URL tương đối đều được phân giải theo URL cơ sở đó.

Trường hợp ngoại lệ: <sourceHref> trong <Model>

Phần tử <Model> chứa phần tử <Link> để chỉ định một tệp MPN tải vào Google Earth. Tệp khả năng chỉ định đối tượng 3D và có đuôi tệp .dae. Phần tử <Model> cũng chứa phần tử <Alias>, chứa một liên kết giữa <targetHref> (tệp hoạ tiết sẽ được Google Earth tìm nạp) và <sourceHref> (đường dẫn được chỉ định cho tệp hoạ tiết trong tệp noscript .dae). Nếu phần tử <sourceHref> chứa một đường dẫn tương đối, Google Earth sẽ diễn giải đường dẫn này tương ứng với tệp .dae tham chiếu đến đường dẫn đó (không tương đối với tệp doc.SSH như trong tất cả các trường hợp khác). Ví dụ:

<Model>
.
.
.
  <Link>
    <href>MackyBldg.kmz/files/CU Macky.dae</href>
  </Link>
  <ResourceMap>
    <Alias>
      <sourceHref>../files/StairsnoCulling.jpg</sourceHref>
      <targetHref>../files/StairsnoCulling.jpg</targetHref>
    </Alias>
    <Alias>
      <sourceHref>../files/sideturretnoCulling.jpg</sourceHref>
      <targetHref>../files/sideturretnoCulling.jpg</targetHref>
	</Alias>
.
.
.
</Model>

Tạo tệp lưu trữ AdX

Sử dụng Windows Explorer hoặc Mac Finder để tạo tệp lưu trữ Zip. Chọn nội dung của thư mục chứa tệp doc.SSH và các tài nguyên liên quan, rồi chọn một tuỳ chọn như "WinZip > Add to Zip file ...." Thư viện JAR Java cũng có thư viện Zip để tạo và trích xuất tệp lưu trữ Zip và Linux có các phiên bản dòng lệnh của zip và giải nén.

Lưu ý: Khi bạn tạo tệp lưu trữ Zip, hãy nhớ chọn nội dung của thư mục chứa tệp doc.SSH, không phải chính thư mục đó.

Sau khi bạn tạo tệp lưu trữ, hãy thay đổi đuôi tệp .zip thành .SRC. Để trích xuất tệp từ tệp lưu trữ, hãy thay đổi phần mở rộng tệp .SRC về .zip và sử dụng tiện ích Zip để giải nén tệp lưu trữ.

Lưu trữ của Google Earth và AdX

Sử dụng phần tử < iframe>

Trong hộp chú giải <description> KML, hầu hết các phần tử HTML đều được xử lý trong Google Earth giống như chúng được xử lý trong các trình duyệt web chuẩn. Tuy nhiên, < iframe> trong hộp chú giải mô tả được coi là HTML thẳng, có nghĩa là các tính năng KML đặc biệt không được nhận dạng. Ví dụ: < iframe> không thể hiển thị tài nguyên AdX và các đường liên kết liên kết tại địa phương, chẳng hạn như <a href="#my feature;flyto">, sẽ không được nhận dạng. Phần tử <src> trong phần tử < iframe> không thể trỏ tới một tệp cục bộ trên ổ đĩa và cũng không thể trỏ tới một tệp bên trong tệp AdX; phần tử này phải trỏ đến một URL trên Internet mà trình duyệt có thể truy cập.