Cómo trabajar con tu propio procesador de tarjetas en 3D
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Desarrolladores del Espacio Económico Europeo (EEE)
Si no puedes incorporar un producto de renderización de terceros en tu solución, es posible que debas crear tu propio renderizador de 3D Tiles. Este enfoque requiere que tengas en cuenta los siguientes factores importantes:
Cuando se publican los Photorealistic 3D Tiles, la API de Map Tiles devuelve URIs para los conjuntos de mosaicos secundarios. Estos URI de conjunto de mosaicos no son URLs normales. Solo incluyen el componente de ruta de acceso y parámetros. No contienen tu clave de API, que es necesaria para autorizar tu solicitud. Para obtener más información, consulta la especificación de 3D Tiles.
Solicitudes y respuestas
Estos son algunos ejemplos de solicitudes y respuestas de mosaicos fotorrealistas en 3D. Puedes inspeccionarlos con las Herramientas para desarrolladores de Chrome.
Ejemplo de solicitud de conjunto de mosaicos raíz:
Debes adjuntar los parámetros que aparecen en el URI del conjunto de mosaicos, junto con tu clave de API, cuando construyas las solicitudes de mosaicos posteriores. La API de 3D Tiles proporciona los siguientes dos parámetros:
session
Es un identificador integrado para una sesión de carga en 3D. La API lo genera automáticamente. El renderizador debe adjuntarlo cuando cree las solicitudes de segmentación posteriores.
key
Es la clave de API que usaste para acceder al servicio de 3D Tiles. Debes adjuntarlo a todas las solicitudes de segmentación posteriores.
Cómo mostrar las atribuciones
La atribución significa reconocer la fuente de los mosaicos de mapas y es un requisito para usar esta API. Esto incluye la atribución de la marca de Google (logotipo) y la atribución de datos. El logotipo de Google está disponible en la página de Políticas de la API de Map Tiles. La información de atribución de datos se devuelve en cada respuesta de la tarjeta. Búscala en la tarjeta de glTF, en asset, copyright.
{"asset":{"version":"2.0","generator":"draco_decoder","copyright":"Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"}}
Debes agregar, ordenar y mostrar esta información en una línea de texto, por lo general, en la parte inferior de la renderización. Esto implica los siguientes pasos:
Extrae toda la información de derechos de autor de todos los mosaicos que se muestran.
Separa varias fuentes de derechos de autor con un punto y coma.
Ordenar la información según la cantidad de ocurrencias
Mostrar en pantalla las fuentes de derechos de autor, ordenadas de la mayor a la menor cantidad de ocurrencias, de manera similar a como lo hace Google Earth
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\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."]]
