ガイドAPIリファレンス
ガイド

陰影起伏

陰影起伏レイヤーは、光が地形をどのように照らすかをシミュレートして、地域の地形を表示します。光の強度に基づいて領域を個別のグループに分類し、各グループはポリゴン フィーチャーとして表されます。

陰影起伏レイヤーは、地形特性を美しく表現し、地域の地形を理解しやすくします。たとえば、陰影起伏は、ハイカー、サイクリスト、バックパッカーなどのアウトドア愛好家が標高の変化や起伏のある地形を表示してルートを計画するのに役立つため、観光関連のユースケースで役立ちます。

クエリに content=default,hillshade パラメーターを追加することで、陰影起伏レイヤーをリクエストできます。詳細については、「任意のコンテンツ」を参照してください。

📘

contentパラメーターの属性の順序は重要です。特に、default属性は最初に指定するようにしてください。

次の図は、陰影起伏レイヤーの有無によるベクターマップの比較を示しています。

ヒルシェイドなしの地図とヒルシェイドありの地図の比較

レイヤーのコンテンツの定義は次のとおりです。

  • レイヤー名:hillshade
  • ジオメトリータイプ:polygon

陰影起伏プロパティ

陰影起伏フィーチャーにはそれぞれ次のプロパティがあります。

  • kind - 強度レベルはシャドウとハイライトの 2 つのグループに分割されます。
  • level - kind に分類される強度レベルは、さらにさまざまなカテゴリーに分割されます。これは、kind プロパティを通じて強度レベルに関するより詳細な情報を提供します。
  • sort_rank - 地図上のさまざまなタイプの landuse フィーチャーの表示順序を優先させるために使用される値。sort_rank 値が大きいフィーチャーが、sort_rank 値が小さいフィーチャーの上に表示されます。すべての陰影起伏フィーチャーの値は 199 です。

陰影起伏 kind

kind プロパティは、強度レベルに応じて、陰影起伏フィーチャー タイプを指定します。

  • shadow - 地形の陰影部分を表すポリゴン。レンダリング時にマップ エリアが暗く表示されます。
  • highlight - 地形のハイライト部分を示すポリゴン。レンダリング時にマップ エリアが明るく表示されます。

陰影起伏 level

次の値は、シャドウとハイライトの強度の程度を示します。

  • -3 - 強いシャドウ。
  • -2 - 中程度のシャドウ。
  • -1 - 明るいシャドウ。
  • 1 - 弱いハイライト。
  • 2 - 強いハイライト。

異なるシャドウのレベルを持つポリゴンが重なり合い、より強いシャドウのポリゴンはより明るいシャドウのポリゴン内に含まれます。ハイライト ポリゴンでも同じパターンが見られます。このアプローチでは、陰影起伏ジオメトリーを互いに重ねられた半透明のポリゴンとして表示することで、さまざまな程度のシャドウとハイライトをレンダリングできます。

次のステップ

  • HERE Vector Tile APIで使用できる他のレイヤーフィーチャータイプの詳細については、「タイルレイヤー」を参照してください。