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

サードパーティのレンダリング プロダクトをソリューションに組み込めない場合は、独自の 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 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. 表示されているすべてのタイルから著作権情報をすべて抽出します。

  2. 著作権で保護されているコンテンツが複数ある場合は、セミコロンで区切ります。

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

  4. Google Earth と同様に、著作権の出典元が画面上に出現回数の少ないものから順に表示されます。