独自の 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 のポリシーページで入手できます。データのアトリビューション情報は、すべてのタイル レスポンスで返されます。glTF タイルassetcopyright で探します。

{
  "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 と同様に、著作権のソースを画面に表示し、発生頻度の高い順に並べ替えます。