Geospatial Creator は、緯度と経度の座標を使用してフォトリアリスティックな 3D タイルをプレビューします。Google Places API を使用すると、テキスト検索で実際の場所を検索し、プレビュー内でその位置を使用できます。
このドキュメントは、Unity 用 Geospatial Creator に精通していることを前提としています。Geospatial Creator を初めて使用する場合は、先に進む前にスタートガイドをご覧ください。
Places API キーを設定する
Geospatial Creator Search は Google Places API を利用しています。このサービスでは、東京やサンフランシスコなどの場所の名前や、住所（10 ダウニング ストリート、SW1A 2AA など）を地理緯度と経度の座標に変換できます。これらの座標を使用して、オブジェクトを配置したり、AR シーンの原点を特定の場所に移動したりできます。
Places API を使用するには、API キーを設定する必要があります。API キーは、Map Tiles API に使用したものと同じである必要があります。このキーは、Geospatial Creator Origin の [Inspector] パネルで確認できます。
検索用の API キーをセットアップする手順は次のとおりです。
- Places API を有効にするには、Google Cloud コンソールの Places API のページをご覧ください。
- Places API を使用するように既存の API キーを設定するには、Google Cloud コンソールの [認証情報] ページにアクセスします。
既存の Map Tiles API キーが表示されない場合は、正しい Google Cloud プロジェクトを表示していることを確認します。
検索を使用して出発地の場所を変更する
API キーを構成すると、検索を使用して Geospatial Creator オリジンを変更できます。Scene Hierarchy で Geospatial Creator Origin をハイライト表示し、Inspector パネルの [Search for Location] ボタンをクリックします。
シーンに既存の起点がない場合は、[GameObjects] > [XR] メニューから追加できます。
[検索] ダイアログが開いたら、[Search Place] ボックスに検索キーワードを入力して、Enter キーを押します。[場所] プルダウンに、関連する結果が表示されます。たとえば、「Google Mountain View」と入力すると、カリフォルニア州マウンテンビューにある Google 本社の住所がリストに表示されます。
最も関連性の高い結果を選択します。シーンビュー カメラが、選択した場所の上に移動します。[オブジェクトに適用] をクリックして、この検索結果の緯度と経度をオリジンに割り当てます。
原点は、Unity ワールド座標での地理空間クリエイター アンカーの位置を決定する基準点です。オリジンを移動すると、そのオリジンに関連付けられているすべてのアンカーの緯度と経度が更新され、Unity ワールド座標でのオリジンに対する相対位置が維持されます。これは、オリジンの付近にアンカーを特定の配置で配置する場合に便利です。
検索機能を使ってアンカーの場所を変更する
検索機能を使用して、オリジンとは無関係に地理空間アンカーの場所を変更することもできます。[オリジンを検索] を使用する場合と同様に、Scene Hierarchy でアンカーを選択し、[Search for Location] ボタンをクリックします。このダイアログはオリジンの検索とほぼ同じです。[場所を検索] ボックスに検索キーワードを入力して、Enter キーを押します。[Places] プルダウン リストの結果を使用して、アンカーの緯度と経度を再割り当てできるようになりました。アンカーの高度を手動で調整する必要がある場合があります。
また、シーン階層内のアンカーを複数選択し、検索機能を使用して複数のアンカーを検索結果に同時に割り当てることもできます。検索ダイアログの [Selected Objects] リストには、移動するすべてのアンカーの名前が表示されます。
既知の問題 / 問題
- Places API と Map Tiles API で個別のキーは現時点でサポートされていないため、それぞれに同じキーを使用する必要があります。
- 検索を機能させるには、Geospatial Creator Origin に Cesium Georeference コンポーネントが必要です。