マップに描画ツールバーを追加する

[アーティクル]
06/30/2023

この記事では、描画ツールモジュールを使用する方法、およびマップ上に描画ツールバーを表示する方法について説明します。 Drawing ツールバーコントロールでは、マップ上に描画ツールバーが追加されます。描画ツールを 1 つのみ、およびすべて使用してマップを作成する方法と、描画マネージャーで描画図形のレンダリングをカスタマイズする方法について説明します。

次のコードでは、描画マネージャーのインスタンスが作成され、ツールバーがマップ上に表示されます。

//Create an instance of the drawing manager and display the drawing toolbar.
drawingManager = new atlas.drawing.DrawingManager(map, {
        toolbar: new atlas.control.DrawingToolbar({
            position: 'top-right',
            style: 'dark'
        })
    });

描画ツールバーをマップに追加する方法を示す完全な作業サンプルについては、「Azure Maps サンプル」の「描画ツールバーをマップに追加する」を参照してください。このサンプルのソースコードについては、マップへの描画ツールバーの追加のソースコードを参照してください。

マップ上の描画ツールバーを示すスクリーンショット。

次のコードでは、描画マネージャーのインスタンスが作成され、多角形描画ツールだけを含むツールバーがマップ上に表示されます。

//Create an instance of the drawing manager and display the drawing toolbar with polygon drawing tool.
drawingManager = new atlas.drawing.DrawingManager(map, {
        toolbar: new atlas.control.DrawingToolbar({
            position: 'top-right',
            style: 'light',
            buttons: ["draw-polygon"]
        })
    });

次のスクリーンショットは、マップ上に 1 つの描画ツールのみを含むツールバーを表示する描画マネージャーのインスタンスのサンプルを示しています。

多角形描画ツールだけを含むツールバーをマップ上に表示している描画マネージャーのインスタンスを示しスクリーンショット。

描画のレンダリングスタイルの変更

描画される図形のスタイルは、drawingManager.getLayers() および drawingManager.getPreviewLayers() 関数を使用し、個々のレイヤーのオプションを設定することによって、描画マネージャーの基になるレイヤーを取得することによりカスタマイズできます。図形の編集時に座標に表示されるドラッグハンドルは HTML マーカーです。ドラッグハンドルのスタイルは、描画マネージャーの dragHandleStyle オプションおよび secondaryDragHandleStyle オプションに HTML マーカーオプションを渡すことによってカスタマイズできます。

次のコードでは、描画マネージャーからレンダリングレイヤーを取得し、それらのオプションを変更することで、描画のレンダリングスタイルを変更します。この場合、ポイントは青いマーカーアイコンで描画されます。線は、赤色の 4 ピクセル幅になります。多角形は、緑色で塗りつぶされ、枠線がオレンジ色になります。次に、ドラッグハンドルのスタイルが四角形のアイコンに変更されます。

//Get rendering layers of drawing manager.
var layers = drawingManager.getLayers();

//Change the icon rendered for points.
layers.pointLayer.setOptions({
    iconOptions: {
        image: 'marker-blue'
    }
});

//Change the color and width of lines.
layers.lineLayer.setOptions({
    strokeColor: 'red',
    strokeWidth: 4
});

//Change fill color of polygons.
layers.polygonLayer.setOptions({
    fillColor: 'green'
});

//Change the color of polygon outlines.
layers.polygonOutlineLayer.setOptions({
    strokeColor: 'orange'
});


//Get preview rendering layers from the drawing manager and modify line styles to be dashed.
var previewLayers = drawingManager.getPreviewLayers();
previewLayers.lineLayer.setOptions({ strokeColor: 'red', strokeWidth: 4, strokeDashArray: [3,3] });
previewLayers.polygonOutlineLayer.setOptions({ strokeColor: 'orange', strokeDashArray: [3, 3] });

//Update the style of the drag handles that appear when editing.
drawingManager.setOptions({
    //Primary drag handle that represents coordinates in the shape.
    dragHandleStyle: {
        anchor: 'center',
        htmlContent: '<svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" style="cursor:pointer"><rect x="0" y="0" width="15" height="15" style="stroke:black;fill:white;stroke-width:4px;"/></svg>',
        draggable: true
    },

    //Secondary drag handle that represents mid-point coordinates that users can grab to add new coordinates in the middle of segments.
    secondaryDragHandleStyle: {
        anchor: 'center',
        htmlContent: '<svg width="10" height="10" viewBox="0 0 10 10" xmlns="http://www.w3.org/2000/svg" style="cursor:pointer"><rect x="0" y="0" width="10" height="10" style="stroke:white;fill:black;stroke-width:4px;"/></svg>',
        draggable: true
    }
});

レンダリングレイヤーにアクセスして描画マネージャーの描画図形のレンダリングをカスタマイズする方法を示す完全な作業サンプルについては、「Azure Maps サンプル」の「描画レンダリングスタイルを変更する」を参照してください。このサンプルのソースコードについては、描画のレンダリングスタイルの変更のソースコードを参照してください。

マップ上にレンダリングされたさまざまな描画図形を示すスクリーンショット。