ウェブサイトのmapbox.comには、色々なフォーマットで地図データをブラウズしてダウンロードするメソッドが用意されています。 このSOPにはmapbox.com APIのラッパーが用意されているので、ロケーションをブラウズし、OSMデータだけでなく高さデータとカラーデータも使ってHeightFieldを簡単にセットアップして処理の準備をすることができます。
パラメータ ¶
Refresh
現行座標を使って地図を再ダウンロードします。
API Key ¶
Mapbox API Key
mapboxで必須となるAPIキー。以下の手順でAPIキーを取得します:
1. MapBox でアカウントを登録します。
2. あなたのmapbox.comアカウントでログインして、Accountページで表示されたAPIキーをコピーします。
3. そのキーをMapbox API Keyパラメータにペーストします。
4. オプションで、MAPBOX_API環境変数にこのキーを設定することで、これらの手順を繰り返す必要がなくなります。
Base Settings ¶
Lat Lon Zoom
ダウンロードする地図領域の座標。手動で設定したり、'Look Up'ボタンから起動されるGUIブラウザを使って自動的に設定することもできます。
Look Up
ダウンロードする地図領域を選択するためのGUIを起動します。
Offsets
緯度経度のオフセット量(タイル単位)。 これは、ダウンロードしたタイルのセットアップに役立ちます。 例えば、MapBox SOPを3つコピーして、それら3つのSOPでそれぞれOffsetsを(1,0), (0,1), (1,1)に設定すると4×4の領域を作成することができます。
Style ¶
Style
このパラメータでは、MapBoxからダウンロードしたい地図の形式を指定することができます。 用意されたデフォルトのスタイルまたはカスタムのスタイルを選択することができます。
Mapbox Style
このパラメータは、Mapbox Studioであなたや誰かが作成したMabBoxスタイルを指定することができます。 スタイルを作成したいのであれば、公式のMapbox Studioドキュメントを参照してください。 一度スタイルを作成すれば、“それを出荷”することで、このパラメータにその“Style URL”を指定することができます。
Attribution
ダウンロードしたカラーマップの帰属ウォーターマークを有効または無効にします。 これを無効にする場合、ここで説明されているとおり他の場所からでもMapBoxを参照できるようにする必要があります。
Data Processing ¶
Terrain Mode
地形をHeightFieldまたはポリゴンのどちらにするのか設定します。ポリゴンの方が一般的ですが、計算が非常に遅いです。
Resolution Scale
HeightField解像度の乗数。 デフォルトの解像度が2048×2048なら、Resolution Scaleを0.25に設定すると、HeightField解像度は512×512に下がります。 Resolution Scaleを2に設定すると、HeightField解像度は4096×4096に上がります。 これは、ダウンロードした地図の品質を上げ下げするわけではなくて、ベースのHeightFieldの解像度のみを上げ下げすることに注意してください。
Height Scale
高さ乗数。これは、MapBoxデータから読み込まれた地形の高さを人為的に上げ下げすることができます。
Height Blur Strength
細かな細部を軽減するために高さマップに適用するブラー量。
OSM Settings ¶
Download OSM Data
このチェックボックスは、OSMデータをダウンロードするかどうかを制御します。 これを無効にすると、MapBox地形データのダウンロード速度が大幅に高速化されますが、2つ目の出力でOSMカーブデータが用意されなくなります。
Offset
OSMデータに適用する垂直オフセット。
Snap To Terrain
OSMデータをHeightField上に投影します。 このトグルを無効にすると、OSMデータは平坦になります。
Building Height From Terrain
OSMデータ内に高さアトリビュートが存在すれば、その高さアトリビュートを設定します(存在しなければ、地形上に投影して高さが計算されます)。
Color From Terrain
ダウンロードしたカラーマップを使用して、ビルのプリミティブのカラーを設定します。
Resample OSM Curves
有効にすると、ビルのカーブに追加でポイントが挿入されます。
Segment Length
ビルに対して追加でカーブポイントを生成する際に使用する長さ。
Local Download Paths ¶
Download Path Color
ダウンロードしたカラーマップの場所と名前。
Download Path Height
ダウンロードした高さマップの場所と名前。
Download Path OSM
ダウンロードしたOSMパスデータの場所と名前。
Retry on Download Fail
ツールがOSMデータのダウンロードに失敗した場合にそのダウンロードを続行するかどうかを制御します。 これを無効にする理由は、サーバーによってダウンロードレートの制限がされている時にノードが失敗しないようにするためです。 とはいえ、これはクックが非常に遅くなってしまうことも意味します。