Drawing Library

DrawingManager クラス

google.maps.drawing.DrawingManager class
extends MVCObject
library "drawing"

非推奨: Maps JavaScript API の描画ライブラリ機能は非推奨になりました。この API は 2025 年 8 月に非推奨となり、2026 年 5 月にリリースされる Maps JavaScript API の今後のバージョンでは利用できなくなります。詳しくは、https://developers.google.com/maps/deprecations をご覧ください。

ユーザーが地図上にマーカー、ポリゴン、ポリライン、矩形、円を描画できるようにします。DrawingManager の描画モードは、ユーザーが作成するオーバーレイの種類を定義します。地図にコントロールを追加して、ユーザーが描画モードを切り替えられるようにします。

const {DrawingManager} = await google.maps.importLibrary("drawing");

コンストラクタ
DrawingManager	DrawingManager([options]) パラメータ: options: DrawingManagerOptions optional ユーザーが地図上にオーバーレイを描画し、描画コントロールで描画するオーバーレイのタイプを切り替えることができる DrawingManager を作成します。

メソッド
getDrawingMode	getDrawingMode() パラメータ: なし 戻り値: OverlayType|null DrawingManager の描画モードを返します。
getMap	getMap() パラメータ: なし 戻り値: Map|null DrawingManager がアタッチされている Map を返します。これは、作成されたオーバーレイが配置される Map です。
setDrawingMode	setDrawingMode(drawingMode) パラメータ: drawingMode: OverlayType optional 戻り値: なし DrawingManager の描画モードを変更します。描画モードは、地図に追加するオーバーレイの種類を定義します。指定できる値は 'marker'、'polygon'、'polyline'、'rectangle'、'circle'、null です。描画モードが null の場合、ユーザーは通常どおり地図を操作でき、クリックしても何も描画されません。
setMap	setMap(map) パラメータ: map: Map optional 戻り値: なし DrawingManager オブジェクトを指定された Map にアタッチします。
setOptions	setOptions(options) パラメータ: options: DrawingManagerOptions optional 戻り値: なし DrawingManager のオプションを設定します。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

イベント
circlecomplete	function(circle) 引数: circle: Circle optional ユーザーが描いた円。 このイベントは、ユーザーが円の描画を終了したときに発生します。
markercomplete	function(marker) 引数: marker: Marker ユーザーが描画したマーカー。 このイベントは、ユーザーがマーカーの描画を終了したときに発生します。
overlaycomplete	function(event) 引数: event: OverlayCompleteEvent optional ユーザーが描画したオーバーレイと、そのオーバーレイのタイプ。 このイベントは、ユーザーが任意のタイプのオーバーレイの描画を完了したときに発生します。
polygoncomplete	function(polygon) 引数: polygon: Polygon ユーザーが描画したポリゴン。 このイベントは、ユーザーが多角形の描画を終了したときに発生します。
polylinecomplete	function(polyline) 引数: polyline: Polyline optional ユーザーが描画したポリライン。 このイベントは、ユーザーがポリラインの描画を終了したときに発生します。
rectanglecomplete	function(rectangle) 引数: rectangle: Rectangle optional ユーザーが描画した長方形。 このイベントは、ユーザーが長方形の描画を終了したときに発生します。

DrawingManagerOptions インターフェース

google.maps.drawing.DrawingManagerOptions インターフェース

描画マネージャーのオプション。

プロパティ
circleOptions 省略可	タイプ: CircleOptions optional この DrawingManager で作成された新しい円に適用するオプション。center プロパティと radius プロパティは無視され、新しい円の map プロパティは常に DrawingManager の地図に設定されます。
drawingControl 省略可	タイプ: boolean optional デフォルト: true 描画コントロールの有効 / 無効の状態。
drawingControlOptions 省略可	タイプ: DrawingControlOptions optional 描画コントロールの表示オプション。
drawingMode 省略可	タイプ: OverlayType optional DrawingManager の描画モード。地図に追加するオーバーレイのタイプを定義します。指定できる値は 'marker'、'polygon'、'polyline'、'rectangle'、'circle'、null です。描画モードが null の場合、ユーザーは通常どおり地図を操作でき、クリックしても何も描画されません。
map 省略可	タイプ: Map optional DrawingManager がアタッチされている Map。これは、作成されたオーバーレイが配置される Map です。
markerOptions 省略可	タイプ: MarkerOptions optional この DrawingManager で作成された新しいマーカーに適用するオプション。position プロパティは無視され、新しいマーカーの map プロパティは常に DrawingManager の地図に設定されます。
polygonOptions 省略可	タイプ: PolygonOptions optional この DrawingManager で作成された新しいポリゴンに適用するオプション。paths プロパティは無視され、新しいポリゴンの map プロパティは常に DrawingManager の地図に設定されます。
polylineOptions 省略可	タイプ: PolylineOptions optional この DrawingManager で作成された新しいポリラインに適用するオプション。path プロパティは無視され、新しいポリラインの map プロパティは常に DrawingManager の地図に設定されます。
rectangleOptions 省略可	タイプ: RectangleOptions optional この DrawingManager で作成された新しい長方形に適用するオプション。bounds プロパティは無視され、新しい長方形の map プロパティは常に DrawingManager の地図に設定されます。

DrawingControlOptions インターフェース

google.maps.drawing.DrawingControlOptions インターフェース

描画コントロールのレンダリングのオプション。

プロパティ
drawingModes 省略可	タイプ: Array<OverlayType> optional デフォルト: [OverlayType.MARKER, OverlayType.POLYLINE, OverlayType.RECTANGLE, OverlayType.CIRCLE, OverlayType.POLYGON] 描画コントロールに表示する描画モードを、表示する順序で指定します。手のアイコン（null 描画モードに対応）は常に使用可能であり、この配列で指定する必要はありません。
position 省略可	タイプ: ControlPosition optional デフォルト: ControlPosition.TOP_LEFT ポジション ID。地図上のコントロールの位置を指定するために使用されます。

OverlayCompleteEvent インターフェース

google.maps.drawing.OverlayCompleteEvent インターフェース

DrawingManager の overlaycomplete イベントのプロパティ。

プロパティ
overlay	タイプ: Marker|Polygon|Polyline|Rectangle|Circle 完成したオーバーレイ。
type	タイプ: OverlayType 完了したオーバーレイのタイプ。

OverlayType 定数

google.maps.drawing.OverlayType constants
library "drawing"

DrawingManager によって作成されるオーバーレイのタイプ。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'polygon' や google.maps.drawing.OverlayType.POLYGON です。

これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは OverlayTypeString 型で定義されます。

const {OverlayType} = await google.maps.importLibrary("drawing");

定数
CIRCLE	DrawingManager が円を作成すること、および overlaycomplete イベントで指定されたオーバーレイが円であることを指定します。
MARKER	DrawingManager がマーカーを作成すること、および overlaycomplete イベントで指定されたオーバーレイがマーカーであることを指定します。
POLYGON	DrawingManager がポリゴンを作成すること、および overlaycomplete イベントで指定されたオーバーレイがポリゴンであることを指定します。
POLYLINE	DrawingManager がポリラインを作成すること、および overlaycomplete イベントで指定されたオーバーレイがポリラインであることを指定します。
RECTANGLE	DrawingManager が長方形を作成すること、および overlaycomplete イベントで指定されたオーバーレイが長方形であることを指定します。