자체 3D 타일 렌더기 사용
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
서드 파티 렌더링 제품을 솔루션에 통합할 수 없는 경우 자체 3D 타일 렌더러를 만들어야 할 수 있습니다. 이 접근 방식을 사용하려면 다음 중요한 요소를 고려해야 합니다.
콘텐츠 URL
실사 3D 타일을 제공할 때 Map Tiles API는 하위 타일 세트의 URI를 반환합니다. 이러한 타일 세트 URI는 일반 URL이 아닙니다. 경로 및 매개변수 구성요소만 포함합니다. 요청을 승인하는 데 필요한 API 키가 포함되어 있지 않습니다. 자세한 내용은 3D 타일 사양을 참고하세요.
요청 및 응답
다음은 사실적인 3D 타일 요청 및 응답의 예입니다. 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에 표시되는 매개변수를 API 키와 함께 첨부해야 합니다. 3D Tiles API는 다음 두 매개변수를 제공합니다.
session- 3D 로드 세션의 내장 식별자입니다. API에 의해 자동으로 생성됩니다. 후속 타일 요청을 구성할 때 렌더러가 연결해야 합니다.
key- 3D 타일 서비스에 액세스하는 데 사용한 API 키입니다. 모든 후속 타일 요청에 이를 첨부해야 합니다.
저작자 표시
저작자 표시는 지도 타일의 출처를 인정하는 것으로, 이 API를 사용하려면 저작자 표시가 필요합니다. 여기에는 Google 브랜드 저작자 표시 (로고)와 데이터 저작자 표시가 포함됩니다. Google 로고는 지도 타일 API 정책 페이지에서 확인할 수 있습니다. 데이터 출처 정보는 모든 타일 응답에서 반환됩니다. asset, copyright 아래의 glTF 타일에서 확인할 수 있습니다.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
이 정보를 집계하고 정렬하여 텍스트 줄에 표시해야 합니다(일반적으로 렌더링 하단). 이 작업에는 다음 단계가 포함됩니다.
표시된 모든 타일에서 저작권 정보를 추출합니다.
저작권 출처가 여러 개인 경우 세미콜론으로 구분합니다.
발생 횟수를 기준으로 정보를 정렬합니다.
Google 어스에서와 같이 화면에 저작권 소스를 가장 많이 발생하는 순서부터 가장 적게 발생하는 순서로 표시합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(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."]]
