Unity

出典：ArcGIS Maps SDK for Unity - Tutorials - Display a map(UI)

マップを表示する (UI)

Unity の Map Creator UI と High Definition Render Pipeline を使用して、ベースマップ、標高ソースの設定、データ レイヤーの追加、特定エリアの表示方法をご紹介します。

このチュートリアルでは、ベースマップ レイヤー サービスとデータ レイヤーを含むローカル シーンを Unity で作成します。

前提条件

このチュートリアルを実施するには、以下が必要です。

1. ArcGIS サービスにアクセスするには、ArcGIS Location Platform アカウントまたは ArcGIS Online アカウントと API キーが必要です。アカウントをお持ちでない場合は、サインアップ (無料) してください。アカウントの作成方法は「開発者アカウントの作成」をご覧ください。

   API キー ページが開発者ダッシュボードに表示されない場合は、アカウントを ArcGIS Location Platform アカウントにアップグレードする必要があります。

2. 開発環境がシステム要件を満たしていることを確認してください。

3. インストールとセットアップの手順に従って、プラグインをインストールしてください。必ずサンプル アセットをインポートしてください。

4. まだ作成されていない場合は、新しい HDRP プロジェクトを作成してください。

Unity のインターフェイスに慣れていない場合は、最も一般的なエディター ウィンドウとそれらを活用するための情報を Unity マニュアル で参照してください。

ステップ

新しいシーンを作成する

1. 上部メニューで、[ファイル] > [新しいシーン (File > New Scene)] をクリックし、ポップアップ ウィンドウを開きます。

2. [Basic Outdoors (HDRP)] テンプレートを選択し、[作成 (Create)] ボタンをクリックします。

Map Creator UI を開く

上部メニューで、[ArcGIS Maps SDK] > [Map Creator] をクリックします。必要に応じて、Map Creator UI を開いた後にウィンドウ サイズを調整します。

マップを作成する

このチュートリアルでは、ローカル シーンを作成し、円形の範囲を設定します。

1. [Map] タブをクリックし、パネルの内容を表示します。

2. [Map Type] セクションで [Local] をクリックします。

3. [Origin Position] セクションでは、GIS シーンの中心を座標とSpatial Reference Well-Known ID (WKID) で設定できます。チュートリアルでは、パラメーターを以下の値に設定します :

   • Longitude : 139.745723
   • Latitude : 35.659041
   • Altitude : 0
   • Spatial Reference WKID : 4326

   spatial reference に関する情報は、spatial references のページを参照してください。

4. [Enable Map Extent] チェック ボックスをオンにして、[Map Extent] セクションを表示し、マップの範囲をこれらの値に設定します :

   • Longitude : 139.745723
   • Latitude : 35.659041
   • Shape : Circle
   • Spatial Reference WKID : 4326
   • Shape Dimensions : (Radius) 5000 メートル

5. ArcGIS Map ゲーム オブジェクトをシーンに追加するには、[Create Map] をクリックします。

以下が、[Map] パネルに入力した画像です。

[ヒエラルキー (Hierarchy)] ウィンドウで、作成された ArcGISMap ゲーム オブジェクトを確認できます。

[ヒエラルキー (Hierarchy)] ウィンドウで ArcGISMap ゲーム オブジェクトをクリックすると、ゲーム オブジェクトに ArcGIS Map コンポーネントがアタッチされていることがわかります。

ArcGIS Map の作成の詳細については、Maps のページを参照してください。

カメラの作成と設定

ArcGIS Maps SDK for Unity は、カメラに近いエリアにはより高い解像度の LOD を表示し、カメラから遠いエリアにはより低い解像度の LOD を表示します。

1. [Camera] タブをクリックする。

2. [Camera Position] はカメラの初期視点を定義します。パラメーターをこれらの値に設定します :

   • Longitude : 139.745723
   • Latitude : 35.659041
   • Altitude : 290
   • Spatial Reference WKID : 4326

3. [Camera Rotation] はカメラの角度を定義します。パラメーターをこれらの値に設定します :

   • Heading : 270
   • Pitch : 93
   • Roll : 0

4. [Create Camera] ボタンをクリックします。

以下が、[Camera] パネルに入力した画像です。

[ヒエラルキー (Hierarchy)] ウィンドウで、Main Camera ゲーム オブジェクトが ArcGISCamera ゲーム オブジェクトに変換され、ArcGISMap ゲーム オブジェクトの下に移動していることがわかります。

この時点で、追加するベースマップとデータ レイヤーを見るために、[Sky and Fog Volume] の [フォグ (Fog)] を無効にするとよいでしょう。このチュートリアルの最後では、ライティングを調整します。

カメラについての詳細は、Camera のページを参照してください。

ベースマップの設定

このチュートリアルでは、プリセット オプションからベースマップを選択します。

1. [Basemap] タブをクリックし、パネルの内容を表示します。

2. プリセットのベースマップ ギャラリーから [Imagery] ベースマップを選択します。

以下が、プリセットからベースマップを [Imagery] に設定した画像です。

API キーの設定

前のセクションで選択したプリセット ベースマップには API キーが必要です。

1. 開発者ダッシュボードにアクセスして API キーを取得してください。

2. [Auth] タブをクリックしてパネルの内容を表示します。

3. [API Key] セクションで API キーを設定します。

このスクリーンショットで Paste your API key here と表示されているフィールドに API キーが入力されていることを確認してください。API キーの取得方法については、UI の [API キーの取得] をクリックしてください。

Unity プロジェクト内の複数のシーンに対してグローバル API キーを設定するもう 1 つの方法は、プロジェクト設定です。API キーの詳細については、API キーのセクションを参照してください。

[Basemap] タブに戻ると、以前はグレーアウトしていたベースマップ アイコンが有効になり、API キーが正常に登録されたことがわかります。

この時点で、ローカル エクステントを持つマップデータが表示されるはずです。[シーン (Scene)] ビューに何も表示されない場合は、[ヒエラルキー (Hierarchy)] ウィンドウを開き、[ArcGIS Camera] をダブル クリックしてエディター カメラの位置を移動し、角度を調整してマップを表示します。

標高の設定

このチュートリアルでは、デフォルトの標高を使って地形を定義します。

1. [Elevation] タブをクリックし、パネルの内容を表示します。

2. [Terrain 3D] が選択され、[Enable All] のチェックボックスがチェックされていることを確認します。

以下が、設定した [Elevation] パネルの画像です。

データ レイヤーの追加

ArcGIS Online から使用できるデータを追加します。

• ArcGIS Online Item : 東京都23区・八王子市南大沢 3D 都市モデル（Project PLATEAU）
  • Layer name : Tokyo Model
  • Type : ArcGIS 3DObject Scene Layer
  • ArcGIS Online サービスの URL（ Source ）:

  https://tiles.arcgis.com/tiles/wlVTGRSYTzAbjjiC/arcgis/rest/services/13100_13201_Tokyo-23ku_Minamiosawa_Building/SceneServer

  • Opacity : 1.0

以下の手順でレイヤーを追加します。

1. [Layers] タブをクリックします。

2. 右下の [Add New] ボタンを押して、[Add New Layer] ポップアップ ウィンドウを開きます。

3. [Type] のドロップダウン リストから適切なレイヤー タイプを選択します。

4. 3D オブジェクト シーン レイヤーを追加するには、サービスの URL を [Source] フィールドに入力します。

5. [Name] フィールドにレイヤー名を入力します。

6. [Add] ボタンをクリックして、レイヤーをマップに追加します。レイヤーが追加されると、[Layers] セクションに表示されます。

7. [Opacity] スライダーを動かすか、[Opacity] フィールドに正確な値を入力して、レイヤーの不透明度を設定します。

以下が、[Layers] パネルの画像です。

空とライティングの調整

Unity には空とライティングのシステムがあります。詳しくは Sky and lighting のページを参照してください。このチュートリアルでは、テンプレートによって追加されたゲーム オブジェクトの設定を調整します。

太陽の調整

1. [ヒエラルキー (Hierarchy)] ウィンドウで、Sun ゲーム オブジェクトをクリックします。

2. [ヒエラルキー (Hierarchy)] ウィンドウの [トランスフォーム (Transform)] セクションで、回転を以下の値に設定します。

   • X : 36
   • Y : 110
   • Z : 85

3. [放出 (Emission)] セクションを開き、[強さ (Intensity)] の値を 10000 に設定します。

以下が、設定した Sun ゲーム オブジェクトの画像です。

空と霧のボリュームの調整

1. [ヒエラルキー (Hierarchy)] ウィンドウの [Sky and Fog Volume] をクリックします。

2. ArcGIS Maps SDK for Unity には、HDRP 用の Sky and Fog Volume のサンプル プロファイルが用意されています。[インスペクター (Inspector)] ウィンドウの [Volume] セクションで、プロファイル名の横にあるアイコンをクリックします。

3. ポップアップ ウィンドウで [Sky and Fog Settings SampleScenes Profile] を選択します。

カメラ コントローラーのアタッチ

エディター モードが有効になっている間、ビューポート内をナビゲートするために、シーン (Scene) ビューカメラがあります。プレイ モードでは、シーンを探索するためにカメラ コントローラーをアタッチする必要があります。このチュートリアルでは、ArcGIS Maps SDK for Unity のサンプル アセットからコントローラーをアタッチします。

1. [ヒエラルキー (Hierarchy)] ウィンドウで [ArcGISCamera] をクリックします。

2. [インスペクター (Inspector)] ウィンドウで、[コンポーネントを追加 (Add Component)] ボタンをクリックします。

3. [ArcGIS Camera Controller] を検索し、[ArcGISCamera] ゲーム オブジェクトにアタッチします。

Map Creator UI でマップの設定が完了しました。[Toolbar] の [Play] アイコンをクリックすると、[ゲーム (Game)] ビューにマップが表示されます。

WASD キーで左右前後に移動します。マウスの左ボタンでシーンをパン、右ボタンでオービット、スクロール ホイールで拡大・縮小します。