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

מפתחים באזור הכלכלי האירופי (EEA)

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

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

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

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

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

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

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

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

הצגת סרטונים קשורים

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