با رندر کاشی های سه بعدی خود کار کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). اگر نمی توانید یک محصول رندر شخص ثالث را در راه حل خود بگنجانید، ممکن است مجبور شوید رندر کاشی های سه بعدی خود را ایجاد کنید. این رویکرد مستلزم این است که عوامل مهم زیر را در نظر بگیرید:
آدرس های اینترنتی محتوا
هنگام ارائه کاشی‌های سه‌بعدی Photorealistic، Map Tiles API URIها را برای مجموعه‌های کاشی کودکان برمی‌گرداند. این URI های مجموعه tileset URL های معمولی نیستند. آنها فقط شامل مسیر و جزء پارامترها هستند. آنها حاوی کلید API شما نیستند که برای تأیید درخواست شما لازم است. برای اطلاعات بیشتر، مشخصات کاشی های سه بعدی را ببینید.
درخواست ها و پاسخ ها
در اینجا چند نمونه از درخواست ها و پاسخ های Photorealistic 3D Tiles آورده شده است. شما آنها را با استفاده از ابزار برنامه‌نویس Chrome بازرسی می‌کنید.
نمونه درخواست root 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 خود پیوست کنید. API 3D Tiles دو پارامتر زیر را ارائه می دهد:
-
session - یک شناسه داخلی برای یک جلسه بارگذاری سه بعدی. به طور خودکار توسط API تولید می شود. هنگام ساخت درخواست‌های کاشی بعدی باید توسط رندر پیوست شود.
-
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"
}
}
شما باید این اطلاعات را جمع آوری، مرتب کنید و در یک خط متن، معمولاً در پایین رندر، نمایش دهید. این شامل مراحل زیر است:
تمام اطلاعات کپی رایت را از تمام کاشی های مشاهده شده استخراج کنید.
چندین منبع حق چاپ را با نقطه ویرگول جدا کنید.
اطلاعات را بر اساس تعداد وقوع مرتب کنید.
منابع حق نسخه‌برداری را روی صفحه نمایش دهید، به ترتیب از اکثر موارد به کمترین، شبیه به روشی که Google Earth آن را انجام می‌دهد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خط‌مشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eWhen building your own renderer for Photorealistic 3D Tiles, you need to handle content URLs, requests, and responses, and display attributions correctly.\u003c/p\u003e\n"],["\u003cp\u003eContent URLs for tilesets returned by the API are relative and require your API key to be added for subsequent requests.\u003c/p\u003e\n"],["\u003cp\u003eRequests for tiles must include both your API key and a session parameter provided in the initial tileset response.\u003c/p\u003e\n"],["\u003cp\u003eData attribution information is included in each tile's \u003ccode\u003easset.copyright\u003c/code\u003e property within the glTF and must be aggregated, sorted, and displayed appropriately in your application.\u003c/p\u003e\n"],["\u003cp\u003eYou are required to display both the Google logo and aggregated data attributions, similar to how Google Earth displays them, for compliance with API usage policies.\u003c/p\u003e\n"]]],[],null,["# Work with your own 3D Tiles renderer\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Map Tiles API will no longer be returned. [Learn more](/maps/comms/eea/map-tiles).\n\nIf you're not able to incorporate a third-party rendering product into your\nsolution, then you might have to create your own 3D Tiles renderer. This\napproach requires that you consider the following important factors:\n\n- [Content URLs](#content_urls)\n- [Requests and responses](#requests-and-responses)\n- [Display data attributions](#display-attributions)\n\nContent URLs\n------------\n\nWhen serving Photorealistic 3D Tiles, the Map Tiles API returns URIs for\nchildren tilesets. These tileset URIs are not regular URLs. They include only\nthe path and parameters component. They don't contain your API key, which is\nrequired to authorize your request. For more information, see the\n[3D Tiles Specification](https://docs.opengeospatial.org/cs/18-053r2/18-053r2.html#23).\n\nRequests and responses\n----------------------\n\nHere are some examples of Photorealistic 3D Tiles requests and responses. You\ninspect them by using the Chrome Developer Tools.\n\nSample root tileset request: \n\n https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY\n\nSample tileset response URI: \n\n /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg\n\nSample tile request URLs used by renderers: \n\n https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY\n\n https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY\n\nYou should attach any parameters that appear in the tileset URI, together with\nyour API key, when you construct the subsequent tile requests. The 3D Tiles API\nprovides the following two parameters:\n\n`session`\n: A built-in identifier for a 3D loading session. It's automatically generated\n by the API. It must be attached by the renderer when constructing the subsequent\n tile requests.\n\n`key`\n: The API key that you used to access 3D Tiles service. You must attach it to\n all subsequent tile requests.\n\nDisplay attributions\n--------------------\n\nAttribution means acknowledging the source of map tiles and is a requirement for\nuse of this API - this includes the Google brand attribution (logo) as well as\ndata attribution. The Google logo is available to you on the\n[Map Tiles API Policies](/maps/documentation/tile/policies) page. Data\nattribution information is returned in every tile response. Look for it in the\n[glTF tile](https://github.com/KhronosGroup/glTF), under\n`asset`, `copyright`. \n\n {\n \"asset\": {\n \"version\": \"2.0\",\n \"generator\": \"draco_decoder\",\n \"copyright\": \"Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus\"\n }\n }\n\nYou must aggregate, sort, and display this information on a line of text,\nusually at the bottom of the rendering. This entails the following steps:\n\n1. Extract all of the copyright information from all of the tiles in view.\n\n2. Separate multiple copyright sources with a semicolon.\n\n3. Sort the information based on the number of occurrences.\n\n4. Display the copyright sources on-screen, ordered from most occurrences to the\n least, similar to the way\n [Google Earth](https://earth.google.com)\n does it."]]
