العمل مع عارض شاشة المعلومات الثلاثية الأبعاد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
إذا لم تتمكّن من دمج منتج عرض تابع لجهة خارجية في الحلّ الذي تستخدمه، قد تحتاج إلى إنشاء أداة عرض خاصة بك لـ 3D Tiles. يتطلّب هذا النهج مراعاة العوامل المهمة التالية:
عناوين URL للمحتوى
عند عرض مربّعات ثلاثية الأبعاد لصور واقعية، تعرض Map Tiles API معرّفات موارد منتظمة (URI) لمجموعات مربّعات فرعية. إنّ معرّفات URI لمجموعات التجانب ليست عناوين URL عادية، بل تتضمّن فقط مكوّنَي المسار والمَعلمات. ولا تحتوي على مفتاح واجهة برمجة التطبيقات، وهو أمر ضروري لمنح الإذن بطلبك. لمزيد من المعلومات، يُرجى الاطّلاع على
مواصفات مربّعات 3D Tiles.
الطلبات والردود
في ما يلي بعض الأمثلة على طلبات وردود مربّعات ثلاثية الأبعاد لصور واقعية. يمكنك فحصها باستخدام "أدوات مطوّري برامج 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) لمجموعة المربّعات، بالإضافة إلى مفتاح واجهة برمجة التطبيقات، عند إنشاء طلبات المربّعات اللاحقة. توفّر واجهة برمجة التطبيقات 3D Tiles API المَعلمتَين التاليتَين:
session- معرّف مدمج لجلسة تحميل ثلاثية الأبعاد. يتم إنشاؤه تلقائيًا
من خلال واجهة برمجة التطبيقات. يجب أن يرفقها برنامج العرض عند إنشاء طلبات المربّعات اللاحقة.
key- مفتاح واجهة برمجة التطبيقات الذي استخدمته للوصول إلى خدمة "خرائط ثلاثية الأبعاد" يجب إرفاقها بجميع طلبات المربّعات اللاحقة.
سمات العرض
تحديد المصدر يعني الإشارة إلى مصدر مربّعات الخرائط، وهو شرط لاستخدام واجهة برمجة التطبيقات هذه، ويشمل ذلك الإشارة إلى العلامة التجارية (الشعار) من 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
