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

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

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

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

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

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

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

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

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

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

שיוך (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 עשינו את זה.