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

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