با پردازنده «کاشی‌های سه‌بعدی» خودتان کار کنید

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

اگر نمی‌توانید محصول پردازنده طرف سومی را در راهکارتان بگنجانید، ممکن است مجبور شوید پردازنده «کاشی‌های سه‌بعدی» خودتان را ایجاد کنید. این رویکرد مستلزم آن است که عوامل مهم زیر را درنظر بگیرید:

نشانی‌های وب محتوا

هنگام ارائه «کاشی‌های سه‌بعدی واقع‌نما»، Map Tiles API شناسه‌های منبع یکسان (URI) را برای مجموعه کاشی‌های فرزند برمی‌گرداند. این شناسه منابع یکسان مجموعه کاشی‌ها نشانی وب معمولی نیستند. آن‌ها فقط شامل مؤلفه مسیر و پارامترها هستند. آن‌ها حاوی کلید میانای برنامه‌سازی کاربردی شما نیستند، که برای صدور مجوز درخواست شما لازم است. برای اطلاعات بیشتر، به مشخصات کاشی‌های سه‌بعدی مراجعه کنید.

درخواست‌ها و پاسخ‌ها

در اینجا چند نمونه از درخواست‌ها و پاسخ‌های «کاشی‌های سه‌بعدی واقع‌نما» آورده شده است. بااستفاده از «ابزارهای توسعه‌دهنده Chrome» آن‌ها را بازرسی می‌کنید.

درخواست نمونه مجموعه کاشی ریشه:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

URI پاسخ مجموعه کاشی نمونه:

 /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 خود پیوست کنید. ‫3D Tiles API دو پارامتر زیر را ارائه می‌دهد:

session
شناسه داخلی برای جلسه بارگیری سه‌بعدی. این شناسه به‌طور خودکار توسط میانای برنامه‌سازی کاربردی تولید می‌شود. این شناسه باید توسط پردازنده هنگام ساخت درخواست‌های کاشی بعدی پیوست شود.
key
کلید میانای برنامه‌سازی کاربردی که برای دسترسی به سرویس «کاشی‌های سه‌بعدی» استفاده کردید. باید آن را به همه درخواست‌های کاشی بعدی پیوست کنید.

نمایش اسنادها

ذکر منبع به‌معنای تأیید منبع کاشی‌های نقشه است و برای استفاده از این 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 انجام می‌دهد.