אם אין לכם אפשרות לשלב מוצר רינדור של צד שלישי בפתרון שלכם, ייתכן שתצטרכו ליצור כלי משלכם לרינדור אריחי תלת-ממד. כדי לעשות את זה, אתם צריכים להביא בחשבון את הגורמים החשובים הבאים:
כתובות URL של תוכן
כשמציגים משבצות תלת-ממדיות פוטוריאליסטיות, ה-API של מפות Google מחזיר מזהי URI לערכות של משבצות ילדים. מזהי ה-URI של קבוצות המשבצות האלה הם לא כתובות URL רגילות, אלא רק את רכיב הנתיב והפרמטרים. הם לא מכילים את מפתח ה-API, שנדרש כדי לאשר את הבקשה. למידע נוסף, ראו מפרט של משבצות תלת-ממדיות.
בקשות ותגובות
הנה כמה דוגמאות לבקשות ותגובות של משבצות תלת-ממדיות פוטוריאליסטיות. כדי לבדוק אותם, אפשר להשתמש בכלים למפתחים ב-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. ה-API של משבצות 3D מספק את שני הפרמטרים הבאים:
session
- מזהה מובנה לסשן טעינה בתלת-ממד. הוא נוצר באופן אוטומטי על ידי ה-API. צריך לצרף אותו לכלי הרינדור כשבונים את הבקשות הבאות ליצירת משבצות.
key
- מפתח ה-API שבו השתמשת כדי לגשת לשירות כרטיסי מידע תלת-ממדיים. תצטרכו לצרף אותו לכל הבקשות הבאות למשבצות.
ייחוס ברשת המדיה
שיוך (Attribution) פירושו אישור המקור של קטעי המפה וחובה להשתמש בו ב-API הזה. הדרישה הזו כוללת את השיוך למותג של Google (לוגו) וגם את שיוך הנתונים. הלוגו של Google זמין בדף מדיניות ה-API של משבצות המפה. פרטי שיוך הנתונים מוחזרים בכל תשובה של משבצת. מחפשים אותו בגוף התשובה, ב-JSON בקטע asset.copyright
.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
צריך לצבור, למיין ולהציג את המידע הזה בשורת טקסט, בדרך כלל בחלק התחתון של הרינדור. במסגרת התהליך הזה:
מחלצים את כל המידע על זכויות היוצרים מכל המשבצות בתצוגה.
יש להפריד בין מקורות שונים של זכויות יוצרים באמצעות נקודה ופסיק.
מסדרים את המידע לפי מספר החזרות.
מציגים את מקורות זכויות היוצרים במסך, בסדר יורד, מהגבוה לנמוך, בדומה לאופן שבו Google Earth עושה זאת.