דגמים

ב-KML אפשר לייבא מודלים תלת-ממדיים – כמו מבנים, גשרים, מונומנטים ופסלים – בפורמט הקובץ של החלפת COLLADA. המודלים מוגדרים באופן בלתי תלוי ב-Google Earth במרחב הקואורדינטות שלהם, באמצעות אפליקציות כגון SketchUp , 3D Studio Max , Softimage XSI או Maya. כאשר מודל תלת-ממדי מיובא ל-Google Earth, הוא מתורגם, מסתובב וקנה המידה שלו מותאם למערכת הקואורדינטות של Earth. ניתן לטעון מחדש ולשנות את הגודל של מודלים שכבר נטענו ל-Google Earth באמצעות הרכיב <Update>.

מודל לדוגמה

מודל משמש ב-Google Earth בדיוק כמו כל אובייקט גיאומטרי אחר (נקודה, מחרוזת פוליגון). הנה דוגמה פשוטה של קובץ KML שמייבא מודל עם מרקם.

האזכור של <קישור> למודל יכול להיות מפרט קובץ מוחלט או יחסי, או כתובת אתר.

כדי להציג את המודל הזה יש לטעון את הקובץ MackyBldg.kmz, ארכיון שמכיל את כל קובצי המרקם והשכבות-על הדרושים, וכן את קובץ ה-doc.KML שמכיל את המודל.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>SketchUp Model of Macky Auditorium</name>
  <description>University of Colorado, Boulder; model created by Noël Nemcik.</description>
  <LookAt>
    <longitude>-105.2727379358738</longitude>
    <latitude>40.01000594412381</latitude>
    <altitude>0</altitude>
    <range>127.2393107680517</range>
    <tilt>65.74454495876547</tilt>
    <heading>-27.70337734057933</heading>
  </LookAt>
  <Model id="model_4">
    <altitudeMode>relativeToGround</altitudeMode>
    <Location>
      <longitude>-105.272774533734</longitude>
      <latitude>40.009993372683</latitude>
      <altitude>0</altitude>
    </Location>
    <Orientation>
      <heading>0</heading>
      <tilt>0</tilt>
      <roll>0</roll>
    </Orientation>
    <Scale>
      <x>1</x>
      <y>1</y>
      <z>1</z>
    </Scale>
  <Link>
    <href>MackyBldg.kmz/files/CU Macky.dae</href>
  </Link>
  <ResourceMap id="resourcemap_for_model_4">
    <Alias>
      <sourceHref>../files/CU-Macky---Center-StairsnoCulling.jpg</sourceHref>
      <targetHref>C:/DOCUME~1/josiew/LOCALS~1/Temp/MackyBldg.kmz/files/CU-Macky---Center-StairsnoCulling.jpg</targetHref>
    </Alias>
    <Alias>
      <sourceHref>../files/CU-Macky-4sideturretnoCulling.jpg</sourceHref>
      <targetHref>../files/CU-Macky-4sideturretnoCulling.jpg</targetHref>
    </Alias>
    <Alias>
      <sourceHref>../files/CU-Macky-Back-NorthnoCulling.jpg</sourceHref>
      <targetHref>../files/CU-Macky-Back-NorthnoCulling.jpg</targetHref>
    </Alias>
    <Alias>
      <sourceHref>../files/CU-Macky-BrickwallnoCulling.jpg</sourceHref>
      <targetHref>../files/CU-Macky-BrickwallnoCulling.jpg</targetHref>
    </Alias>
.
.
.
    </ResourceMap>
  </Model>
</Placemark>
</kml>

המודל ממוקם גיאוגרפית לפי מפרטי קווי הרוחב, קו האורך והגובה של רכיב המיקום. בדוגמה הזו נעשה שימוש בערכי ברירת המחדל לרכיבים מסוג 'כיוון' ו'שינוי קנה מידה', הכלולים כאן כדי להשלים את ההגדרה.

רכיב הכיוון מציין סיבובים של המודל סביב הצירים x (tilt), y (roll) ו-z (headline). ציר y מפנה לצפון ומקביל לקווים של קווי אורך, וציר ה-x פונה מזרחה ומקביל לקווי רוחב. הסיבובים מצוינים במעלות, עם סיבובים חיוביים כפי שמתואר בתרשים הבא.

הרכיב ResourceMaps ממפה את קובצי המרקם מהמיקום שצוין בקובץ Collada המקורי (<sourceHref>) למיקום בקובץ ה-KML או ה-KMZ (<targetHref>) שמכיל את המודל.

הערה: בגרסאות שקדמו ל-Google Earth גרסה 4.2, פונקציית מיפוי זו בוצעה על ידי קובץ textures.txt (קובץ חיצוני הכלול בארכיון KMZ). מערכת Google Earth 4.2 מקבלת קובצי KML ו-KMZ שמפנים לקובץ textures.txt ומעבדת אותם כראוי. כשקבצים כאלה נכתבים על ידי לקוחות Google Earth 4.2 ואילך, המידע בקובץ textures.txt מתורגם לרכיבים <ResourceMaps> ו-<Alias>, שהם צאצאים של <Model>.

יצירת ארכיון .kmz

ארכיון KMZ הוא אוסף של קבצים ששימשו ליצירת מצגת KML אחת. הארכיון הזה כולל את כל הקבצים המקומיים שיש אליהם הפניה בקובץ .xlsx, כמו תמונות, מרקמים ודגמים. ארכיון KMZ הוא חבילה עצמאית שאינה חייבת להתארח בשרת רשת, וניתן לשלוח אותה בקלות לארכיון ולאחסן אותה כיחידה אחת. Google Earth יכול לקרוא קובצי .KML ו-.kmz ישירות.

הקובץ doc.KML והקבצים המקומיים שהוא מפנה אליהם נדחסים לארכיון באמצעות פורמט קובץ ה-ZIP. אפליקציות רבות יכולות להפיק את הפורמט הזה. WinZip במערכות Windows , Stuffit במערכות Macintosh ו-Zip במערכות Linux או Macintosh הן אפליקציות פופולריות שניתן לקרוא ולכתוב בפורמט ה-ZIP. אפשר גם להשתמש בארכיונים דחוסים באמצעות Windows Explorer או Mac Finder ישירות.

לאחר יצירת קובץ ה-.zip משנים את סיומת הקובץ ל- .kmz.

ארכיון ה-KMZ המכיל את המודל עם המרקם המלא של בניין מאקי כולל את הקבצים הבאים:

• doc.KML – קובץ ה-KML שמוצג למעלה, שמייבא את מודל ה-COLLADA (.dae) ומציב אותו ב-Google Earth. מציבים את הקובץ הזה בספריית הבסיס של קובץ ה-KMZ.

• קבצים/ספרייה – מכילה את קובצי ה-COLLADA שמגדירים את הגיאומטריה, המרקמים והחומר של המודל. בדוגמה של ה-Macky Build, ספרייה זו מכילה את קובץ ה-COLLADA (CU Macky.dae) וכן את הקבצים הרבים המכילים את תמונות ה-JPEG המשמשות ליצירת מרקם של המבנה (CU-Macky-BrickwallnoCulling.jpg, CU-Macky-Center

דוגמה זו ממחישה דרך אחת לבניית הקבצים בארכיון KMZ. למעשה, תוכלו לארגן את הקבצים בכל מבנה שנראה לכם הגיוני, בדיוק כפי שאתם מארגנים את הקבצים בתיקיות או בספריות במחשב. לדוגמה, ייתכן שתרצו להציב את כל התמונות בספרייה תמונות/. הפניות יחסיות (כגון הקבצים ברכיב <href> שנעשה בהם שימוש ב-NetworkLink, קישור, שכבת-על/סמל ומודל) יצוינו באופן יחסי לקובץ doc.KML. אם כוללים ספריית תמונות, מפרט ה-<href> של התמונות יהיה: images/myBrickTexture.jpg, images/myMountainLayer.png, וכן הלאה).

חזרה למעלה