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

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

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

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

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

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

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

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

הצגת מקורות התמונות

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