اگر نمی‌توانید یک محصول رندر شخص ثالث را در راهکار خود بگنجانید، ممکن است مجبور شوید رندرکننده‌ی کاشی‌های سه‌بعدی خودتان را بسازید. این رویکرد مستلزم در نظر گرفتن عوامل مهم زیر است:
آدرس‌های اینترنتی محتوا
هنگام ارائه کاشی‌های سه‌بعدی واقع‌گرایانه، API کاشی‌های نقشه، URIهایی را برای مجموعه کاشی‌های فرزند برمی‌گرداند. این URIهای مجموعه کاشی، URLهای معمولی نیستند. آنها فقط شامل مسیر و مؤلفه پارامترها هستند. آنها حاوی کلید API شما نیستند که برای تأیید درخواست شما لازم است. برای اطلاعات بیشتر، به مشخصات کاشی‌های سه‌بعدی مراجعه کنید.
درخواست‌ها و پاسخ‌ها
در اینجا چند نمونه از درخواست‌ها و پاسخ‌های کاشی‌های سه‌بعدی واقع‌گرایانه آورده شده است. شما می‌توانید آنها را با استفاده از ابزارهای توسعه‌دهنده کروم بررسی کنید.
نمونه درخواست مجموعه کاشی ریشه:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
نمونه آدرس اینترنتی پاسخ tileset:
/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg
نمونه آدرس‌های اینترنتی درخواست کاشی که توسط رندرکننده‌ها استفاده می‌شود:
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 کاشی‌های سه‌بعدی دو پارامتر زیر را ارائه می‌دهد:
-
session - یک شناسه داخلی برای یک جلسه بارگذاری سه‌بعدی. این شناسه به طور خودکار توسط API تولید می‌شود. هنگام ساخت درخواست‌های بعدی کاشی، باید توسط رندرکننده پیوست شود.
-
key - کلید API که برای دسترسی به سرویس کاشی‌های سه‌بعدی استفاده کرده‌اید. باید آن را به تمام درخواست‌های بعدی کاشی پیوست کنید.
نمایش انتساب‌ها
انتساب به معنای تأیید منبع کاشی‌های نقشه است و برای استفاده از این API الزامی است - این شامل انتساب برند گوگل (لوگو) و همچنین انتساب داده‌ها می‌شود. لوگوی گوگل در صفحه سیاست‌های API کاشی‌های نقشه در دسترس شماست. اطلاعات انتساب داده‌ها در هر پاسخ کاشی برگردانده می‌شود. آن را در کاشی glTF ، در زیر asset ، copyright جستجو کنید.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
شما باید این اطلاعات را جمع‌آوری، مرتب‌سازی و در یک خط متن، معمولاً در پایین رندر، نمایش دهید. این کار شامل مراحل زیر است:
تمام اطلاعات کپی‌رایت را از تمام کاشی‌های موجود در نما استخراج کنید.
منابع کپی‌رایت متعدد را با نقطه ویرگول از هم جدا کنید.
اطلاعات را بر اساس تعداد تکرار مرتب کنید.
منابع حق نشر را روی صفحه نمایش دهید، به ترتیب از بیشترین تکرار به کمترین تکرار، مشابه روشی که گوگل ارث انجام می‌دهد.