Map
Mapクラスは地図を表示するためのクラスです。Google Maps JavaScript APIにおいて、最も基本となるクラスです。
構文
パラメータ
mapDiv
Element
地図を表示するHTML要素を指定する。この要素にはスタイルシートなどを利用して横幅と高さを設定しておくこと。
opts
地図のオプションとなるオブジェクト。最低限、centerとzoomは指定しなければいけない。
返り値
Map
Mapクラスのインスタンス。このインスタンスにメソッドを実行したりイベントを設定して地図を操作できる。
デモ
地図を出力する例です。centerとzoom以外は省略できます。
// <div id="map-canvas"></div>
var mapDiv = document.getElementById( "map-canvas" ) ;
var opts = {
center: new google.maps.LatLng( 35.7100, 139.8107 ) ,
zoom: 11 ,
} ;
var map = new google.maps.Map( mapDiv, opts ) ;
サンプルコード
<!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" ) ;
var map = new google.maps.Map( mapDiv, {
center: new google.maps.LatLng( 35.7100, 139.8107 ) ,
zoom: 11 ,
} ) ;
</script>
</body>
</html>
オプション
MapOptionsに指定できるプロパティの一覧です。
名前 | 説明 |
---|---|
backgroundColor | キャンパスの背景色を指定する。 |
center | 初期の位置座標を指定する。 |
clickableIcons | POIアイコンのクリックを調整する。 |
disableDefaultUI | デフォルトのコントローラの表示を調整する。 |
disableDoubleClickZoom | ダブルクリックによるズーム値変更を調整する。 |
draggable | ドラッグ操作での地図の移動を調整する。 |
draggableCursor | ドラッグ可能な場所にホバーした時のマウスカーソルの形状を指定する。 |
draggingCursor | ドラッグ操作中のマウスカーソルの形状を指定する。 |
fullscreenControl | フルスクリーン・コントローラの表示を調整する。 |
fullscreenControlOptions | フルスクリーン・コントローラのスタイルを調整する。 |
gestureHandling | タッチ操作の挙動を調整する。 |
heading | 航空写真にした時の東西南北の角度を指定する。 |
keyboardShortcuts | キーボード操作を調整する。 |
mapTypeControl | マップタイプ・コントローラの表示を調整する。 |
mapTypeControlOptions | マップタイプ・コントローラのスタイルを調整する。 |
mapTypeId | 初期の地図の種類を指定する。 |
maxZoom | ズームで、拡大の最大値を指定する。 |
minZoom | ズームで、縮小の最小値を指定する。 |
noClear | 地図キャンパスに指定したHTML要素の、子孫要素を削除するか否かを指定する。 |
panControl | パン・コントローラの表示を調整する。 |
panControlOptions | パン・コントローラのスタイルを調整する。 |
rotateControl | 回転コントローラの表示を調整する。 |
rotateControlOptions | 回転コントローラのスタイルを調整する。 |
scaleControl | スケール・コントローラの表示を調整する。 |
scaleControlOptions | スケール・コントローラのスタイルを調整する。 |
scrollwheel | ホイール操作によるズーム値の変更を調整する。 |
signInControl | サインイン・ボタンの表示を調整する。 |
streetView | 独自のストリートビューを関連付ける。 |
streetViewControl | ストリートビュー・コントローラ(ペグマン人形)の表示を調整する。 |
streetViewControlOptions | ストリートビュー・コントローラ(ペグマン人形)の表示をスタイルする。 |
styles | 地図のスタイルをカスタマイズする。 |
tilt | 航空写真にした時の傾きの角度を指定する。 |
zoom | 初期のズーム値を指定する。 |
zoomControl | ズーム・コントローラの表示を調整する。 |
zoomControlOptions | ズーム・コントローラのスタイルを調整する。 |
メソッド
名前 | 説明 |
---|---|
fitBounds() | 指定した境界がちょうどよく見える位置座標とズーム値に変更する。 |
getBounds() | 地図の現在のビューポートの境界を取得する。 |
getCenter() | 地図の現在の中心の位置座標を取得する。 |
getClickableIcons() | POIアイコンをクリックできるか否かを確認する。 |
getDiv() | キャンパスとして利用しているHTML要素を取得する。 |
getHeading() | 東西南北の角度を取得する。 |
getMapTypeId() | 現在の地図の種類を取得する。 |
getStreetView() | ストリートビューを取得する。 |
getTilt() | 傾きの角度を取得する。 |
getZoom() | ズーム値を取得する。 |
panBy() | 地図の位置座標を相対的に移動する。 |
panTo() | 地図の位置座標を絶対的に移動する。 |
panToBounds() | ビューポートを指定した境界に移動する。 |
setCenter() | 位置座標をセットする。 |
setClickableIcons() | POIアイコンのクリック設定を変更する。 |
setHeading() | 東西南北の角度をセットする。 |
setMapTypeId() | 地図の種類をセットする。 |
setOptions() | 地図のオプションをセットする。 |
setStreetView() | ストリートビューをセットする。 |
setTilt() | 傾きの角度をセットする。 |
setZoom() | ズーム値をセットする。 |
イベント
名前 | 説明 |
---|---|
bounds_changed | ビューポートに変化があった時に発火するイベント。 |
center_changed | 地図の位置座標に変化があった時に発火するイベント。 |
click | 地図をクリックした時に発火するイベント。 |
dblclick | 地図をダブルクリックした時に発火するイベント。 |
drag | 地図をドラッグ操作した時に発火するイベント。 |
dragend | 地図のドラッグ操作を終了した時に発火するイベント。 |
dragstart | 地図のドラッグ操作を開始した時に発火するイベント。 |
heading_changed | 地図の東西南北の角度を変更した時に発火するイベント。 |
idle | 地図がアイドル状態になった時に発火するイベント。 |
maptypeid_changed | 地図の種類を変更した時に発火するイベント。 |
mousemove | 地図上でマウスカーソルを動かした時に発火するイベント。 |
mouseout | 地図の外にマウスカーソルを出した時に発火するイベント。 |
mouseover | 地図の上にマウスカーソルを乗せた時に発火するイベント。 |
projection_changed | プロジェクションが変化した時に発火するイベント。 |
resize | トリガーで、リサイズによるリフレッシュを行なった時に発火するイベント。 |
rightclick | 地図を右クリックした時に発火するイベント。 |
tilesloaded | 地図のタイルの読み込みが完了した時に発火するイベント。 |
tilt_changed | 地図の傾きの角度を変更した時に発火するイベント。 |
zoom_changed | ズーム値を変更した時に発火するイベント。 |
参考
- Google Maps JavaScript API: Map
- Googleの公式リファレンス。