独自の 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 のポリシーページで確認できます。データ アトリビューション情報は、すべてのタイル レスポンスで返されます。これは、レスポンス本文の JSON の 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 と同様に、著作権の提供元を画面上に表示回数の多い順に表示します。