서드 파티 렌더링 제품을 솔루션에 통합할 수 없는 경우 자체 3D 카드 렌더러를 만들어야 할 수 있습니다. 이 접근 방식을 사용하려면 다음과 같은 중요한 요소를 고려해야 합니다.
콘텐츠 URL
포토리얼리스틱 3D 타일을 제공할 때 Map Tiles API는 하위 tileset의 URI를 반환합니다. 이러한 tileset URI는 일반 URL이 아닙니다. 경로 및 매개변수 구성요소만 포함합니다. 요청을 승인하는 데 필요한 API 키가 포함되어 있지 않습니다. 자세한 내용은 3D 카드 사양을 참고하세요.
요청 및 응답
다음은 사실적인 3D 카드 요청 및 응답의 예입니다. Chrome 개발자 도구를 사용하여 검사합니다.
샘플 루트 tileset 요청:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
샘플 tileset 응답 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 Tiles 서비스에 액세스하는 데 사용한 API 키입니다. 후속 카드 요청에 모두 첨부해야 합니다.
저작자 표시
저작자 표시는 지도 타일의 출처를 표시하는 것을 의미하며 이 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 어스에서와 같이 저작권 소스를 화면에 표시합니다(가장 많이 발생한 순서대로).