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

אם אתם לא מצליחים לשלב במוצר שלכם תוכנת עיבוד של צד שלישי, יכול להיות שתצטרכו ליצור תוכנת עיבוד משלכם של משבצות 3D. הגישה הזו מחייבת להביא בחשבון את הגורמים החשובים הבאים:

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

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

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

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

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

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

URI של תגובת קבוצת משבצות לדוגמה:

 /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. ה-API של משבצות 3D מספק את שני הפרמטרים הבאים:

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

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

שיוך (Attribution) פירושו אישור המקור של קטעי המפה ודרישה לשימוש ב-API הזה. הדרישה הזו כוללת את השיוך למותג של Google (לוגו) וגם את שיוך הנתונים. הלוגו של Google זמין בדף מדיניות ה-API של משבצות המפה. פרטי שיוך הנתונים מוחזרים בכל תשובה של משבצת. מחפשים אותו במשבצת 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.