独自の 3D タイル レンダラを使用する

サードパーティのレンダリング プロダクトをソリューションに組み込むことができない場合は、独自の 3D Tiles レンダラの作成が必要になることがあります。このアプローチでは、次の重要な要素を考慮する必要があります。

コンテンツの URL

Photorealistic 3D Tiles を提供するときに、Map Tiles API は子タイルの URI を返します。これらのタイルセット URI は通常の URL ではありません。パスとパラメータのコンポーネントのみが含まれています。リクエストの承認に必要な API キーが含まれていません。詳しくは、3D Tiles の仕様をご覧ください。

リクエストとレスポンス

以下に、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 には次の 2 つのパラメータがあります。

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"
  }
}

この情報を 1 行のテキスト（通常はレンダリングの下部）に集計、並べ替え、表示する必要があります。これには次の手順が含まれます。

  1. ビュー内のすべてのタイルから著作権情報をすべて抽出します。

  2. 著作権ソースが複数ある場合は、セミコロンで区切ります。

  3. 発生回数に基づいて情報を並べ替えます。

  4. Google Earth と同様に、著作権の提供元を画面上に表示回数の多い順に表示します。