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

水域レイヤー

HERE Vector Tile APIのwaterレイヤーには、川、湖、海、その他の水域など、さまざまな水域のフィーチャーに関する情報が含まれています。waterレイヤーのフィーチャーにはフィーチャーの分類と属性に関するデータが含まれており、地図上に表示できます。

次の図は、データからレンダリングされた water レイヤーのフィーチャーのサンプルを示しています。

メキシコ湾のビュー

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

  • レイヤー名:water
  • ジオメトリー タイプ:pointlinepolygon

water レイヤーは、海、河岸、湖を描画する polygon ジオメトリーで構成されています。さらに、川や小川の中心線を表すlineジオメトリーや、ポリゴンのラベル付けに最適な位置を示すpointジオメトリーが組み込まれているため、タイルの境界をまたいだ重複を回避できます。

共有プロパティ

waterレイヤーのすべてのフィーチャーには、そのフィーチャーが表す特定のタイプの場所に関わらず、そのフィーチャーを定義する一連のプロパティが含まれています。

📘

これらのプロパティは、Tilezen スキーマでは common プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

次のプロパティを使用して水域のフィーチャーを定義します。

  • name - 水域の名前。使用可能なデータによっては、名前が複数の言語で提供される場合もあります。
  • id - water フィーチャーの一意の識別子。
  • kind - water フィーチャーの一般的なタイプ。詳細については、「kindの定義と並べ替え順」を参照してください。係争中の水域のフィーチャーラベルについては、kind:xxを参照してください。
  • sort_rank - 地図上のさまざまなタイプのwaterフィーチャーの表示順序を優先させるために使用される値。sort_rank 値が大きい water フィーチャーが、sort_rank 値が小さい water フィーチャーの上に表示されます。
  • min_zoom - water フィーチャーを表示するための推奨最小ズーム レベル。

条件プロパティ

一部のwaterフィーチャーには、対応するkindにのみ固有のプロパティが含まれています。

📘

これらのプロパティは、Tilezen スキーマでは common-optional プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

  • intermittent: true - このプロパティは、季節によって乾燥したり消えたりすることがあるフィーチャーを示します。stream kind にのみ使用できます。
  • display_class - このプロパティは対応する water フィーチャーの重要度を示します。値は 1 (重要度が高い) ~ 8 (重要度が低い) の整数です。line および point ジオメトリーで使用できます。
  • depth - 海面から海底までの距離。bathymetrykindでのみ使用できます。
  • is_label: true - このプロパティは、ポリゴンジオメトリーから生成された線形フィーチャーを示します。このプロパティは、lineジオメトリーにのみ使用できます。
  • kind:xx - pointジオメトリーで使用できます。kindの代替手段で、ある国の地政学的な見解を反映しています。利用可能な地政学的見解の完全なリストは、サービスから取得できます。

特定の政治的見解xxに基づいてマップフィーチャーを表示するには、レンダラーは利用可能な場合はkind:xxを使用し、利用できない場合は既定のkindを使用します。例:

インターナショナルビュー:

kind: bay
kind:us=unrecognized_bay

米国の見解:

kind:us=bay

次の図は、地図にレンダリングされたwaterフィーチャーのサンプルと、関連付けられているメタデータを示しています。

水の例

Kind の定義と並べ替え順

water レイヤーの kind パラメーターは、water フィーチャーの特定の分類またはカテゴリーを示します。たとえば、kind パラメーターは、フィーチャーが川、湖、海、運河、入り江、プールなどかどうかを示している場合があります。kind プロパティを使用すると、地図上のさまざまなタイプの水域や水関連の要素を分類して区別できます。

  • water (sort_rank:200) - ポリゴン
  • fjord (sort_rank:200) - ポイント
  • sea (sort_rank:200) - ポイント
  • strait (sort_rank:200) - ポイント
  • river (sort_rank:201) - ラインまたはポイント
  • stream (sort_rank:201) - ライン
  • canal (sort_rank:201) - ライン
  • lake (sort_rank:204) - ライン
  • bay (sort_rank:205) - ポイント
  • ocean (sort_rank:205) - ポイント
  • bathymetry (sort_rank:206) - ポリゴン
  • swimming_pool (sort_rank:415) - ポリゴン

水域kind:xx

  • fjord
  • sea
  • strait
  • river
  • bay
  • ocean
  • unrecognized_fjord
  • unrecognized_sea
  • unrecognized_strait
  • unrecognized_river
  • unrecognized_bay
  • unrecognized_ocean
📘

ポリゴンはすべてwaterに関連し、ポイントとラインはラベル付けに使用されます。

次のステップ

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