עבודה עם מעבדי המידע התלת-ממדיים שלך

אם אין לך אפשרות לשלב מוצר רינדור של צד שלישי לכן ייתכן שתצטרכו ליצור כלי משלכם לרינדור משבצות תלת-ממדיות. הגישה הזו מחייבת להביא בחשבון את הגורמים החשובים הבאים:

כתובות URL של תוכן

בעת הצגת משבצות תלת-ממדיות פוטוריאליסטיות, ה-API של אריחי המפה מחזיר מזהי URI עבור משבצות ילדים. מזהי ה-URI של מערכות האריחים האלה הם לא כתובות URL רגילות. הם כוללים רק את הנתיב ואת רכיב הפרמטרים. הם לא מכילים את מפתח ה-API שלכם, כלומר שנדרש כדי לאשר את הבקשה. למידע נוסף, ראו מפרט של משבצות 3D.

בקשות ותגובות

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

דוגמה לבקשת tileset ברמה הבסיסית:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

דוגמה ל-URI של תגובה של tileset:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

כתובות URL לדוגמה של בקשות לריבועים שמשמשות את הנגנים:

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

יש לצרף את כל הפרמטרים שמופיעים ב-URI של קבוצת המשבצות, יחד עם את מפתח ה-API, בזמן היצירה של בקשות המשבצת הבאות. ב-3D Tiles API יש שני פרמטרים:

session
מזהה מובנה לסשן טעינה בתלת-ממד. נוצר באופן אוטומטי על ידי ה-API. ה-renderer צריך לצרף אותו כשיוצר את הבקשות הבאות ל-tile.
key
מפתח ה-API שבו השתמשתם כדי לגשת לשירות 3D Tiles. צריך לצרף אותו אל את כל הבקשות הבאות למשבצת הווידאו.

שיוך מודעות לרשת המדיה

שיוך (Attribution) פירושו אישור על המקור של קטעי המפה לשימוש ב-API הזה - כולל הייחוס של מותג Google (לוגו) וגם לשיוך נתונים. הלוגו של Google זמין לכם המדיניות בנושא 'כרטיסי מידע במפה'. פרטי השיוך של הנתונים מוחזרים בכל תגובה של משבצת. מחפשים אותו במשבצת glTF, בקטע asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

צריך לצבור, למיין ולהציג את המידע הזה בשורה של טקסט, בדרך כלל בתחתית העיבוד. במסגרת התהליך הזה:

  1. מחלצים את כל המידע על זכויות היוצרים מכל המשבצות בתצוגה.

  2. אם יש כמה מקורות של זכויות יוצרים, צריך להפריד ביניהם באמצעות נקודה-פסיק.

  3. ממיינים את המידע לפי מספר המופעים.

  4. הצגת מקורות זכויות היוצרים במסך, לפי סדר מהכי הרבה מקרים להכי פחות, בדומה לאופן שבו זה נעשה ב-Google Earth.