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

欧州経済領域（EEA）のデベロッパー

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

コンテンツの URL

Photorealistic 3D Tiles を配信する場合、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 には次の 2 つのパラメータがあります。

session
3D ローディング セッションの組み込み識別子。これは API によって自動的に生成されます。後続のタイル リクエストを構築する際に、レンダラによって付加される必要があります。
key
3D タイル サービスへのアクセスに使用した API キー。この ID は、後続のすべてのタイル リクエストに付加する必要があります。

帰属を表示する

帰属表示とは、地図タイルのソースを明示することです。この API を使用するには、帰属表示が必要です。これには、Google ブランドの帰属表示（ロゴ）とデータの帰属表示が含まれます。Google ロゴは、Map Tiles API のポリシーのページで入手できます。データ帰属情報はすべてのタイル レスポンスで返されます。asset、copyright の glTF タイルで探します。

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

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

  1. 表示されているすべてのタイルの著作権情報を抽出します。

  2. 複数の著作権所有者を指定する場合は、セミコロンで区切ります。

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

  4. Google Earth と同様に、著作権の出典を画面に表示します。表示順は、出現頻度の高い順から低い順にします。