אם אתם לא מצליחים לשלב במוצר שלכם תוכנת עיבוד גרפי של צד שלישי, יכול להיות שתצטרכו ליצור תוכנת עיבוד גרפי משלכם ל-3D Tiles. הגישה הזו מחייבת להביא בחשבון את הגורמים החשובים הבאים:
כתובות URL של תוכן
כשמציגים קטעי מפה ריאליסטיים בתלת-ממד, ממשק Map Tiles API מחזיר מזהי URI של ערכות של קטעי מפה צאצאים. מזהי ה-URI של מערכות האריחים האלה הם לא כתובות URL רגילות. הם כוללים רק את הנתיב ואת רכיב הפרמטרים. הן לא מכילות את מפתח ה-API שנדרש כדי לאשר את הבקשה. למידע נוסף, ראו מפרט של משבצות 3D.
בקשות ותשובות
ריכזנו כאן כמה דוגמאות לבקשות ולתשובות של קטעי מפה ריאליסטיים בתלת-ממד. אפשר לבדוק אותם באמצעות הכלים למפתחים ב-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
- מזהה מובנה של סשן טעינה 3D. הוא נוצר באופן אוטומטי על ידי ה-API. ה-renderer צריך לצרף אותו כשהוא יוצר את הבקשות הבאות ל-tile.
key
- מפתח ה-API שבו השתמשתם כדי לגשת לשירות 3D Tiles. צריך לצרף אותו לכל הבקשות הבאות של משבצות.
שיוך מודעות לרשת המדיה
שיוך (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"
}
}
צריך לצבור, למיין ולהציג את המידע הזה בשורה של טקסט, בדרך כלל בתחתית העיבוד. לשם כך, מבצעים את השלבים הבאים:
חילוץ כל פרטי זכויות היוצרים מכל האריחים שמוצגים.
אם יש כמה מקורות של זכויות יוצרים, צריך להפריד ביניהם באמצעות נקודה-פסיק.
ממיינים את המידע לפי מספר המופעים.
הצגת מקורות זכויות היוצרים במסך, לפי סדר מהכי הרבה מקרים להכי פחות, בדומה לאופן שבו זה נעשה ב-Google Earth.