자체 3D 타일 렌더기 사용

타사 렌더링 제품을 솔루션에 통합할 수 없는 경우 자체 3D 카드 렌더기를 만들어야 할 수 있습니다. 이 접근 방식을 사용하려면 다음과 같은 중요한 요소를 고려해야 합니다.

콘텐츠 URL

실사 3D 타일을 제공할 때 Map Tiles API는 하위 타일 세트의 URI를 반환합니다. 이러한 타일 집합 URI는 일반 URL이 아니며, 경로와 매개변수 구성요소만 포함합니다. 여기에는 요청을 승인하는 데 필요한 API 키가 포함되지 않습니다. 자세한 내용은 3D 카드 사양을 참고하세요.

요청 및 응답

다음은 Photorealistic 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에 표시되는 매개변수를 API 키와 함께 연결해야 합니다. 3D Tiles API는 다음 두 매개변수를 제공합니다.

session
3D 로드 세션의 내장 식별자입니다. API에서 자동으로 생성됩니다. 후속 카드 요청을 생성할 때 렌더러에서 연결해야 합니다.
key
3D Tiles 서비스에 액세스하는 데 사용한 API 키입니다. 이후의 모든 타일 요청에 연결해야 합니다.

디스플레이 기여 분석

저작자 표시는 지도 타일의 출처를 확인하는 것을 의미하며 이 API를 사용하려면 Google 브랜드 저작자 표시 (로고)와 데이터 저작자 표시를 포함합니다. Google 로고는 Map Tiles API 정책 페이지에서 확인할 수 있습니다. 데이터 저작자 표시 정보는 모든 카드 응답에서 반환됩니다. 응답 본문의 asset.copyright 아래 JSON에서 찾아보세요.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

이 정보를 집계, 정렬, 텍스트 행에 표시해야 합니다(대개 렌더링 하단에 표시). 이를 위해 다음 단계를 따라야 합니다.

  1. 표시된 모든 타일에서 저작권 정보를 모두 추출합니다.

  2. 저작권 소스가 여러 개인 경우 세미콜론으로 구분합니다.

  3. 발생 횟수를 기준으로 정보를 정렬합니다.

  4. Google 어스와 비슷한 방식으로 저작권 소스를 화면에 가장 많이 나타나는 순서대로 표시합니다.