HERE Map Attributes APIのスタイル設定機能

 HERE Maps API for JavaScript version 3.2

HERE Map Attributes API v8は、カスタムスタイルルールを使用してレイヤーおよびスタイルとしてレンダリングできるマップデータを提供します。サービスから返されたフィーチャー属性を使用してフィーチャーを選択し、その外観を設定します。

定義済みのスタイル定義の値を調整できるHERE Style Editorとは異なり、Map Attributes API v8 に基づくカスタムスタイルを使用すると、どのデータレイヤーにもまったく新しいスタイルルールを定義できます。

たとえば、BUILDINGレイヤーにカスタムスタイルを適用して、各建物のポリゴンをCOLOR属性値で色付けし、特定の建物をそのNAME値で強調表示できます。

スタイル付き地図属性レイヤーを作成する

Map Attributes APIからカスタムスタイルを適用するには、H.map.render.harp.Styleクラスのインスタンスを作成して、Map Attributes API固有のフィーチャーのルールを含むカスタムスタイル定義を読み込みます。各ルールでは、whenを使用してフィーチャーを選択し、レンダリングtechniqueを選択して、attrでそのプロパティを設定します。

次の例では、BUILDINGレイヤーから建物のポリゴンをレンダリングします。COLOR属性によって各ポリゴンの塗りつぶし色が決まり、緑色のアウトラインはHERE Berlinという名前のフィーチャーを強調表示します。

📘

注

この例は、「HERE Maps API for Javascriptの使用を開始する」で説明されているベースマップを基盤としています。

const service = platform.getMapAttributesService();

const style = new H.map.render.harp.Style({
  clearColor: "#eef3f7",
  styles: [
    // Building fill
    {
      when: ["all", ["==", ["geometry-type"], "Polygon"]],
      technique: "polygon",
      attr: {
        color: ["get", "COLOR"]
      }
    },
    // Building outlines
    {
      when: ["all",
        ["==", ["geometry-type"], "LineString"],
        ["==", ["get", "NAME"], "HERE Berlin"]
      ],
      technique: "line",
      attr: {
        color: "#0F0",
        width: ["pixel-world-scale", 3]
      }
    }
  ]
});

const providerOptions = {
  layer: "BUILDING",
  level: 13,
  geometryTypes:
    H.service.mapAttributes.Provider.GeometryType.POLYGON |
    H.service.mapAttributes.Provider.GeometryType.LINE
};
const layerOptions = { min: 17, max: 22 };
const layer = service.createLayer(style, providerOptions, layerOptions);

map.addLayer(layer);
map.setZoom(19);
map.setCenter({ lat: 52.53082, lng: 13.38515 });

この例の内容は以下のとおりです。

  • providerOptions属性はリクエストする地図属性データを選択します。
  • layerおよびlevelはAPIでサポートされる値に設定されます。
  • スタイルルールが複数のジオメトリータイプをレンダリングする場合、|式はジオメトリータイプフラグを組み合わせます。
  • layerOptions属性は、地図が結果のレイヤーを表示するズーム範囲を制御します。

次の図は、前の例で設定したBUILDINGレイヤーを地図上にレンダリングしたものです。

カスタムスタイルが適用された建物レイヤーを示す地図

フィーチャー属性を含むスタイル

whenおよびattrで式を使用して、地図属性フィーチャーのプロパティを読み込みます。get式は現在のフィーチャーからプロパティを読み取るため、color: ["get", "COLOR"]は固定色の代わりに各フィーチャーのCOLOR値を使用します。

whenで属性チェックインを組み合わせて、フィーチャーのグループにさまざまなスタイルを割り当てることができます。たとえば、allとget式を使用して特定の地図属性プロパティ値を持つフィーチャーを選択し、そのジオメトリーに適した手法を選択します。

ルールではmatch、step、interpolateなどの式を使用して、フィーチャープロパティまたはマップズームレベルからテクニック属性を導出することもできます。

次のステップ

マップスタイルをカスタマイズする際は、次のドキュメントを参照してください。


このページは役に立ちましたか?