Utiliser votre propre moteur de rendu de tuiles 3D
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs de l'Espace économique européen (EEE)
Si vous ne parvenez pas à intégrer un produit de rendu tiers à votre solution, vous devrez peut-être créer votre propre moteur de rendu 3D Tiles. Cette approche nécessite que vous preniez en compte les facteurs importants suivants :
Lorsque vous diffusez des tuiles 3D photoréalistes, l'API Map Tiles renvoie des URI pour les ensembles de tuiles enfants. Ces URI de jeu de tuiles ne sont pas des URL classiques. Ils n'incluent que le composant de chemin d'accès et de paramètres. Elles ne contiennent pas votre clé API, qui est requise pour autoriser votre requête. Pour en savoir plus, consultez la spécification des cartes 3D.
Requêtes et réponses
Voici quelques exemples de requêtes et de réponses pour les tuiles 3D photoréalistes. Vous pouvez les inspecter à l'aide des outils pour les développeurs Chrome.
Vous devez joindre tous les paramètres qui apparaissent dans l'URI du tileset, ainsi que votre clé API, lorsque vous construisez les requêtes de tuiles suivantes. L'API 3D Tiles fournit les deux paramètres suivants :
session
Identifiant intégré pour une session de chargement 3D. Il est généré automatiquement par l'API. Il doit être associé par le moteur de rendu lors de la construction des requêtes de tuiles suivantes.
key
Clé API que vous avez utilisée pour accéder au service 3D Tiles. Vous devez l'associer à toutes les requêtes de tuiles ultérieures.
Afficher les attributions
L'attribution consiste à reconnaître la source des tuiles de carte. Elle est obligatoire pour utiliser cette API. Cela inclut l'attribution de la marque Google (logo) ainsi que l'attribution des données. Le logo Google est disponible sur la page Règles de l'API Map Tiles. Les informations sur l'attribution des données sont renvoyées dans chaque réponse de tuile. Recherchez-le dans la tuile glTF, sous asset, copyright.
{"asset":{"version":"2.0","generator":"draco_decoder","copyright":"Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"}}
Vous devez agréger, trier et afficher ces informations sur une ligne de texte, généralement en bas du rendu. Cela implique les étapes suivantes :
Extrayez toutes les informations sur les droits d'auteur de toutes les tuiles visibles.
Séparez les sources de droits d'auteur multiples par un point-virgule.
Triez les informations en fonction du nombre d'occurrences.
Afficher les sources des droits d'auteur à l'écran, de la plus fréquente à la moins fréquente, comme le fait Google Earth.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
