Polygon
Polygonクラスはポリゴンを表示するためのクラスです。ポリゴンは、任意の数だけ指定した位置座標を結んで出来る多角形のことです。
構文
パラメータ
opts
ポリゴンのオプションとなるオブジェクト。ポリゴンの各角となる位置座標、有効な操作など指定できる。パスを一次元配列で指定した場合は1つの多角形を設置できる。二次元配列で指定した場合、1つのインスタンスで任意の数だけ多角形を設置できる。この特徴を覚えておかないと、混乱するかもしれません。
// 一次元配列の場合 (1つのポリゴンを作る)
var Paths = [
位置座標 ,
位置座標 ,
... ,
] ;
// 二次元配列の場合 (複数のポリゴンを作る)
var Paths = [
// 1つ目のポリゴン
[
位置座標 ,
位置座標 ,
... ,
] ,
// 2つ目のポリゴン
[
位置座標 ,
位置座標 ,
... ,
] ,
... ,
] ;
返り値
Polygon
Polygonクラスのインスタンス。このインスタンスにメソッドを実行したりイベントを設定してポリゴンを操作できる。
デモ
ポリゴンを作成するデモです。このデモでは、一次元配列でパスを指定しているため、1つの多角形をレンダリングしています。その他の設定項目については、PolygonOptionsオブジェクトをご参考下さい。
var polygon = new google.maps.Polygon( {
map: map ,
paths: [
new google.maps.LatLng( 32.3738, 131.1350 ) ,
new google.maps.LatLng( 35.7406, 139.9241 ) ,
new google.maps.LatLng( 43.0475, 141.9016 ) ,
new google.maps.LatLng( 35.4547, 133.3762 ) ,
] ,
} ) ;
サンプルコード
インスタンスの作成
var polygon = new google.maps.Polygon( {
map: map ,
paths: [
new google.maps.LatLng( 32.3738, 131.1350 ) ,
new google.maps.LatLng( 35.7406, 139.9241 ) ,
new google.maps.LatLng( 43.0475, 141.9016 ) ,
new google.maps.LatLng( 35.4547, 133.3762 ) ,
] ,
} ) ;
HTML
<!DOCTYPE html>
<html>
<head>
<style>
#map-canvas {
width: 600px ;
height: 600px ;
}
</style>
</head>
<body>
<div id="map-canvas"></div>
<script src="//maps.googleapis.com/maps/api/js?key={APIキー}"></script>
<script>
var mapDiv = document.getElementById( "map-canvas" ) ;
// Map
var map = new google.maps.Map( mapDiv, {
center: new google.maps.LatLng( 35.71, 139.8107 ) ,
zoom: 11 ,
} ) ;
// Polygon
var polygon = new google.maps.Polygon( {
map: map ,
paths: [
new google.maps.LatLng( 32.3738, 131.1350 ) ,
new google.maps.LatLng( 35.7406, 139.9241 ) ,
new google.maps.LatLng( 43.0475, 141.9016 ) ,
new google.maps.LatLng( 35.4547, 133.3762 ) ,
] ,
} ) ;
// fit bounds
var latLngBounds = new google.maps.LatLngBounds() ;
polygon.getPaths().forEach( function ( latLngs ) {
latLngs.forEach( function ( latLng ) {
latLngBounds.extend( latLng ) ;
} ) ;
} ) ;
map.fitBounds( latLngBounds ) ;
</script>
</body>
</html>
オプション
PolygonOptionsに指定できるプロパティの一覧です。
名前 | 説明 |
---|---|
clickable | ポリゴンをクリックできるか否かを調整する。 |
draggable | ポリゴンをドラッグ操作できるか否かを調整する。 |
editable | ポリゴンを編集できるか否かを調整する。 |
fillColor | ポリゴンの塗りつぶしの色を調整する。 |
fillOpacity | ポリゴンの塗りつぶしの色を調整する。 |
geodesic | ポリゴンを測地線に対応させるか否かを調整する。 |
map | ポリゴンを設置する地図を指定する。 |
paths | ポリゴンの各角となる位置座標を指定する。 |
strokeColor | ポリゴンの線の色を調整する。 |
strokeOpacity | ポリゴンの線の不透明度を調整する。 |
strokePosition | ポリゴンの線の位置を調整する。 |
strokeWeight | ポリゴンの線の太さを調整する。 |
visible | ポリゴンの表示状態を調整する。 |
zIndex | ポリゴンのz-orderを調整する。 |
メソッド
名前 | 説明 |
---|---|
getDraggable() | ポリゴンがドラッグ操作できるか否かを取得する。 |
getEditable() | ポリゴンが編集できるか否かを取得する。 |
getMap() | ポリゴンが設置されている地図を取得する。 |
getPath() | ポリゴンの一次元配列のパスを取得する。 |
getPaths() | ポリゴンの二次元配列のパスを取得する。 |
getVisible() | ポリゴンの表示状態を取得する。 |
setDraggable() | ポリゴンのドラッグ操作の有効、無効をセットする。 |
setEditable() | ポリゴンの編集の有効、無効をセットする。 |
setMap() | ポリゴンを地図に設置する。または地図から取り除く。 |
setOptions() | ポリゴンの各種設定をセットする。 |
setPath() | ポリゴンに一次元配列のパスをセットする。 |
setPaths() | ポリゴンに二次元配列のパスをセットする。 |
setVisible() | ポリゴンの表示状態をセットする。 |
イベント
名前 | 説明 |
---|---|
click | ポリゴン上でクリックした時に発火するイベント。 |
dblclick | ポリゴン上でダブルクリックした時に発火するイベント。 |
drag | ポリゴンをドラッグ操作で動かしている時に発火するイベント。 |
dragend | ポリゴンのドラッグ操作を完了した時に発火するイベント。 |
dragstart | ポリゴンのドラッグ操作を開始した時に発火するイベント。 |
mousedown | ポリゴン上でマウスボタンを押した時に発火するイベント。 |
mousemove | ポリゴン上でマウスポインタを動かしている時に発火するイベント。 |
mouseout | ポリゴン上からマウスポインタを出した時に発火するイベント。 |
mouseover | ポリゴン上にマウスポインタを乗せた時に発火するイベント。 |
mouseup | ポリゴン上でマウスボタンを離した時に発火するイベント。 |
rightclick | ポリゴン上で右クリックした時に発火するイベント。 |
参考
- Google Maps JavaScript API: Polygon
- Googleの公式リファレンス。