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

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

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

בעת הצגה של משבצות תלת-ממדיות פוטוריאליות, ה-API של אריחי המפה מחזיר מזהי 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 של משבצות תלת ממד מספקת את שני הפרמטרים הבאים:

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

ייחוס ברשת המדיה

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