HERE Map Attributes APIのスタイル設定機能
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などの式を使用して、フィーチャープロパティまたはマップズームレベルからテクニック属性を導出することもできます。
次のステップ
マップスタイルをカスタマイズする際は、次のドキュメントを参照してください。
先月の更新