Hướng dẫn dành cho nhà phát triển
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Phần này bao gồm các trang có thông tin bổ sung về các phần tử KML chính và cách sử dụng các phần tử đó.
- Tệp ONIXđã cập nhật
Tìm hiểu cách đóng gói (và nén) tệp KML và tất cả hình ảnh, lớp phủ, biểu tượng và tệp âm thanh có liên quan vào một đơn vị gọn gàng có thể đăng hoặc gửi email dưới dạng một thực thể duy nhất.
- Tham quan
- Google Earth 5.0 giới thiệu hoạt động tham quan: chuyển động do KML kiểm soát qua không gian và thời gian. Các phần tử liên quan đến chuyến tham quan nằm trong không gian tên của phần mở rộng trên Google.
- Chế độ cao độ
- Với việc giới thiệu các thành phần trong không gian tên của phần mở rộng trên Google, Google Earth 5.0 có thể đưa người xem xuống dưới nước nhờ các chế độ độ cao clampToSeaFloor và relativeToSeaFloor mới. Chương này cũng thảo luận về các chế độ truyền thống trên cao.
- Thời gian và ảnh động
- Mọi tính năng trong KML đều có thể có liên kết với dữ liệu thời gian. Khi tệp KML chứa một Tính năng có các phần tử TimeSpan hoặc TimeStamp, Google Earth sẽ hiển thị thanh trượt thời gian. Sử dụng thanh trượt và nút phát, người dùng có thể "phát" toàn bộ trình tự hoặc có thể chọn từng khoảng thời gian hiển thị.
- Máy ảnh
- Phần tử Máy ảnh cung cấp một cách khác để chỉ định điểm nhìn cho một Tính năng. Máy ảnh được sử dụng với PhotoOverlays, một tính năng khác được thêm vào KML 2.2. <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.
- Lớp phủ ảnh
- Phần tử PhotoOverlay cho phép bạn xác định vị trí địa lý một bức ảnh trên Earth và chỉ định vị trí cũng như hướng của Máy ảnh xem 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). Phần tử con ImagePyramid của PhotoOverlay giúp xử lý hiệu quả các bức ảnh lớn tùy ý trong Google Earth.
- Dữ liệu bầu trời trong KML
- Giờ đây, bạn có thể hiển thị dữ liệu về thiên thể trong Google Earth. Trang này mô tả cách thiết lập tệp KML để xem bầu trời, kèm theo các mẹo về cách chuyển đổi toạ độ bầu trời tiêu chuẩn để hiển thị trong Google Earth, Chế độ bầu trời.
- Thêm dữ liệu tuỳ chỉnh
- Bạn có thể thêm dữ liệu tuỳ chỉnh vào Tính năng KML theo 3 cách, tuỳ thuộc vào loại dữ liệu tuỳ chỉnh. Phần tử ExtendedData mới cho phép bạn thêm dữ liệu chưa nhập, dữ liệu đã nhập hoặc dữ liệu XML tuỳ ý vào Tính năng KML. Google Earth lưu giữ thông tin này cùng với tệp. Dữ liệu chưa nhập và dữ liệu đã nhập chứa các phần tử hiển thị có thể dùng cho mẫu kiểu và thay thế thực thể trong hộp chú giải.
- Mô hình
- Đối tượng ba chiều có thể được mô hình hóa tự nhiên trong không gian toạ độ của riêng họ và được xuất dưới dạng tệp noindexTM, sau đó được nhập vào Google Earth và đặt trên bề mặt Trái Đất.
- Khu vực
- Khu vực cung cấp hành vi chọn lọc và cấp độ chi tiết để bạn có thể điều chỉnh cách trình bày dữ liệu trong Google Earth. Khi được sử dụng với Networklinks, các khu vực cho phép truyền trực tuyến các tập dữ liệu rất lớn, với tính năng tải dữ liệu "thông minh" ở nhiều cấp độ phân giải (xem phần trên Lớp phủ siêu). Bạn cũng có thể mô phỏng các lớp của Google Earth bằng cách sử dụng Khu vực.
- Bản cập nhật
- Bạn có thể cập nhật dần dữ liệu được tải bằng Networklinks — thay đổi, thêm và xóa dữ liệu KML đã được tải trước đây vào Google Earth.
- Thời hạn
- Trang này thảo luận về cách ngăn dữ liệu KML trở nên lỗi thời, thông qua việc sử dụng các tiêu đề HTTP và thời gian hết hạn KML.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2022-12-20 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2022-12-20 UTC."],[[["\u003cp\u003eThis section provides further detail on key KML elements and their usage.\u003c/p\u003e\n"],["\u003cp\u003eKML files can incorporate touring, altitude modes, time, animation, and camera viewpoints for features.\u003c/p\u003e\n"],["\u003cp\u003eFeatures can include photo overlays, sky data, custom data, 3D models, and regions for enhanced visualization.\u003c/p\u003e\n"],["\u003cp\u003eNetworkLinks support data updates and can leverage regions for efficient streaming and level-of-detail management.\u003c/p\u003e\n"],["\u003cp\u003eKML data freshness can be controlled using HTTP headers and expiration times to prevent staleness.\u003c/p\u003e\n"]]],[],null,["# Developer's Guide\n\nThis section includes pages with additional information on key KML elements and how to use them.\n\n[KMZ Files](/kml/documentation/kmzarchives)^Updated^\n: Learn how to package up (and compress) your KML file and all its related images, overlays, icons, and sound files into one tidy unit that can be posted or emailed as a single entity.\n\n[Touring](/kml/documentation/touring)\n: Google Earth 5.0 introduces touring: KML-controlled movement through space and time. Touring-related elements are contained in the Google extension namespace.\n\n[Altitude Modes](/kml/documentation/altitudemode)\n: With the introduction of elements in the Google extension namespace, Google Earth 5.0 can take viewers underwater with new clampToSeaFloor and relativeToSeaFloor altitude modes. This chapter also discusses the traditional, above-ground modes.\n\n[Time and Animation](/kml/documentation/time)\n: Any Feature in KML can have time data associated with it. When a KML file contains a Feature with TimeSpan or TimeStamp elements, Google Earth displays a time slider. Using the slider and play button, the user can \"play\" the entire sequence or can select individual time periods for display.\n\n[Cameras](/kml/documentation/cameras)\n: The Camera element provides an additional way to specify the viewpoint for a Feature. Cameras are used with PhotoOverlays, another feature added in KML 2.2. \\\u003cCamera\\\u003e provides full six-degrees-of-freedom control over the view, so you can position the Camera in space and then rotate it around the *x* , *y* , and *z* axes.\n\n[PhotoOverlays](/kml/documentation/photos)\n: The PhotoOverlay element allows you to geographically locate a photograph on the Earth and to specify the placement and orientation of the Camera that views this PhotoOverlay. The PhotoOverlay can be a simple 2D rectangle, a partial or full cylinder, or a sphere (for spherical panoramas). The ImagePyramid child element of PhotoOverlay provides for efficient handling of arbitrarily large photographs in Google Earth.\n\n[Sky Data in KML](/kml/documentation/kmlsky)\n: Now you can display celestial data in Google Earth. This page describes how to set up your KML file to view the sky, with tips on converting standard celestial coordinates to display in Google Earth, Sky mode.\n\n[Adding Custom Data](/kml/documentation/extendeddata)\n: You can add custom data to KML Features in three different ways, depending on the kind of custom data. The new ExtendedData element allows you to add your own untyped data, typed data, or arbitrary XML data to a KML Feature. Google Earth preserves this information along with the file. Untyped data and typed data contain display elements that can be used for style templates and entity replacement in the balloon.\n\n[Models](/kml/documentation/models)\n: Three-dimensional objects can be modeled naturally in their own coordinate space and exported as COLLADA™ files, then imported into Google Earth and placed on the Earth's surface.\n\n[Regions](/kml/documentation/regions)\n: Regions provide culling and level-of-detail behavior that allow you to fine-tune how your data is presented in Google Earth. When used with NetworkLinks, Regions enable streaming of very large datasets, with \"smart\" loading of data at multiple levels of resolution (see the section on [Super-Overlays](/kml/documentation/regions#superoverlays)). You can also simulate Google Earth's layers using Regions.\n\n[Updates](/kml/documentation/updates)\n: You can incrementally update data loaded by NetworkLinks---changing, adding, and deleting KML data that was previously loaded into Google Earth.\n\n[Expiration](/kml/documentation/expiration)\n: This page discusses how to prevent KML data from becoming stale, through the use of HTTP headers and KML expiration times."]]