Geliştirici Kılavuzu
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu bölümde, önemli KML öğeleri ve bunların nasıl kullanılacağı hakkında ek bilgiler içeren sayfalar yer alır.
- KMZ DosyalarıGüncellendi
KML dosyanızı ve ilgili tüm resimleri, yer paylaşımlarını, simgeleri ve ses dosyalarını tek bir varlık olarak yayınlanabilecek veya e-postayla gönderilebilecek tek bir birimde nasıl paketleyeceğinizi (ve sıkıştıracağınızı) öğrenin.
- Tur
- Google Earth 5.0'daki tur özelliği: Zaman ve mekan arasında KML tarafından kontrol edilen hareketler. Turla ilgili öğeler Google uzantısı ad alanında yer alır.
- Rakım Modları
- Google uzantısı ad alanındaki öğelerin sunulmasıyla birlikte Google Earth 5.0, yeni clampToSeaFloor ve göreliToSeaFloor rakım modları sayesinde izleyicileri suya sokabilir. Bu bölümde geleneksel, yer üstü modları da ele alınmaktadır.
- Zaman ve Animasyon
- KML'deki herhangi bir özelliğin ilişkilendirilebileceği zaman verileri olabilir. Bir KML dosyası TimeSpan veya TimeStamp öğelerine sahip bir özellik içerdiğinde, Google Earth bir zaman kaydırma çubuğu görüntüler. Kullanıcılar, kaydırma çubuğunu ve oynat düğmesini kullanarak dizinin tamamını "oynatabilir" veya görüntüleme için belirli zaman aralıkları seçebilir.
- Kameralar
- Kamera öğesi, bir özelliğin görüş noktasını belirtmek için ek yol sağlar. Kameralar, KML 2.2'de eklenen başka bir özellik olan PhotoOverlays ile kullanılır. <Kamera>, görünüm üzerinde altı serbestlik derecesi üzerinde tam kontrol sağlar. Böylece Kamerayı uzayda konumlandırabilir, ardından da x, y ve z eksenlerinde döndürebilirsiniz.
- Fotoğraf Bindirmeleri
- Fotoğraf Bindirme öğesi, Earth'teki bir fotoğrafı coğrafi olarak bulmanıza ve bu fotoğraf Bindirmesini görüntüleyen Kamera'nın yerleşimini ve yönünü belirtmenize olanak tanır. Fotoğraf Bindirme basit bir 2D dikdörtgen, bir kısmi veya tam silindir ya da bir küre (küresel panoramalar) olabilir. PhotoOverlay'in ImagePyramid alt öğesi, rastgele şekilde çekilen fotoğrafların Google Earth'te verimli bir şekilde işlenmesini sağlar.
- KML'deki Gökyüzü Verileri
- Artık gökyüzü verilerini Google Earth'te görüntüleyebilirsiniz. Bu sayfada, gökyüzünü görüntülemek için KML dosyanızı Google Earth, Gökyüzü modunda görüntülemek üzere dönüştürmeyle ilgili ipuçlarıyla birlikte nasıl oluşturacağınız açıklanmaktadır.
- Özel Veri Ekleme
- Özel verilerin türüne bağlı olarak KML Özelliklerine üç farklı şekilde özel veri ekleyebilirsiniz. Yeni Genişletilmiş Veri öğesi, bir KML Özelliğine kendi yazılmamış verilerinizi, yazılan verileri veya rastgele XML verilerini eklemenize olanak tanır. Google Earth bu dosyayı dosyayla birlikte korur. Yazılı olmayan veriler ve yazılan veriler, balonda stil şablonları ve öğe değişimi için kullanılabilecek görüntülü reklam öğeleri içerir.
- Modeller
- Üç boyutlu nesneler kendi koordinat alanlarında doğal olarak modellenebilir ve COLLADATM dosyaları olarak dışa aktarılabilir, ardından Google Earth'e aktarılabilir ve Dünya'nın yüzeyine yerleştirilebilir.
- Bölgeler
- Bölgeler, verilerinizin Google Earth'te sunulma şekliyle ilgili ince ayarlar yapmanıza olanak tanıyan seçmeli ve ayrıntılı düzeyde davranış sağlar. Bölgeler, NetworkLinks ile birlikte kullanıldığında çok büyük veri kümelerinin akışını sağlar ve verilerin birden çok çözünürlük düzeyinde "akıllı" olarak yüklenmesini sağlar (Süper Yer Paylaşımları bölümüne bakın). Bölgeler'i kullanarak Google Earth'ün katmanlarını da simüle edebilirsiniz.
- Güncellemeler
- NetworkLinks tarafından yüklenen verileri artımlı olarak güncelleyebilirsiniz. Böylece daha önce Google Earth'e yüklenen KML verilerini değiştirebilir, ekleyebilir ve silebilirsiniz.
- Geçerlilik süresi
- Bu sayfada, HTTP üstbilgilerinin ve KML geçerlilik sürelerinin kullanılmasıyla KML verilerinin eskimesini nasıl önleyeceğiniz açıklanmaktadır.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2022-12-20 UTC.
[null,null,["Son güncelleme tarihi: 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."]]