Maps

Map クラス

google.maps.Map クラス

このクラスは MVCObject を拡張します。

const {Map} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

Map
Map(mapDiv[, opts])
パラメータ: 
  • mapDivHTMLElement 地図は、この要素いっぱいにレンダリングされます。
  • optsMapOptions optional オプション
指定された HTML コンテナ(通常は DIV 要素)内に新しい地図を作成します。
DEMO_MAP_ID マップ ID を必要とするコードサンプルで使用できるマップ ID。このマップ ID は、本番環境アプリケーションでの使用は想定されていません。また、クラウドの設定が必要な機能(クラウドベースのスタイル機能など)には使用できません。
controls
地図に適用する追加のコントロール。地図にコントロールを追加するには、レンダリングされる ControlPosition に対応する MVCArray に、コントロールの <div> を追加します。
data
種類:  Data
地図にバインドされた Data のインスタンス。この Data オブジェクトに対象物を追加すると、地図上で簡単に表示できます。
mapTypes
種類:  MapTypeRegistry
MapType インスタンスのレジストリ(文字列 ID を使用)。
overlayMapTypes
種類:  MVCArray<MapType optional>
オーバーレイする追加のマップタイプ。オーバーレイのマップタイプは、関連付けられている基本地図の上に、overlayMapTypes 配列での記述順序で表示されます(インデックス値が高いオーバーレイが、インデックス値が低いオーバーレイの前に表示されます)。
fitBounds
fitBounds(bounds[, padding])
パラメータ: 
  • boundsLatLngBounds|LatLngBoundsLiteral 表示する境界。
  • paddingnumber|Padding optional ピクセル単位のパディング。境界は、パディングを削除した地図の残った部分に収まります。数値を指定すると、4 辺すべてに同じパディングが行われます。ここで 0 を指定すると、getBounds の結果に対して fitBounds をべき等にします。
戻り値: なし
指定された境界が含まれるようにビューポートを設定します。
注: 地図が display: none に設定されている場合、fitBounds 関数は地図のサイズを 0x0 として読み取るため、何も行いません。地図が非表示のときにビューポートを変更するには、地図を visibility: hidden に設定し、地図の div が実際のサイズになるようにします。ベクター地図の場合、このメソッドは地図の傾斜と方角をデフォルトの 0 値に設定します。このメソッドを呼び出すと、境界に合わせて地図のパンやズームが行われるため、アニメーションが滑らかに表示されることがあります。このメソッドがアニメーション化されるかどうかは、内部ヒューリスティックによって異なります。
getBounds
getBounds()
パラメータ: なし
戻り値:  LatLngBounds|undefined 現在のビューポートの緯度/経度の境界。
現在のビューポートの緯度/経度の境界を返します。地球の複数のコピーが表示される場合、境界の経度は -180 ~ 180 度の範囲になります。地図がまだ初期化されていない場合、または中央とズームが設定されていない場合、結果は undefined です。傾斜または方角が 0 以外のベクター地図の場合、返される緯度/経度の境界は、地図のビューポートの可視領域を含む最小の境界ボックスを表します。地図のビューポートの正確な表示領域を取得する方法については、MapCanvasProjection.getVisibleRegion をご覧ください。
getCenter
getCenter()
パラメータ: なし
戻り値:  LatLng|undefined
地図の中心に表示される位置を返します。この LatLng オブジェクトはラップされません。詳しくは、LatLng をご覧ください。中心または境界が設定されていない場合、結果は undefined になります。
getClickableIcons
getClickableIcons()
パラメータ: なし
戻り値:  boolean|undefined
地図アイコンのクリック可能性を返します。地図アイコンはスポット(スポット)を表します。戻り値が true の場合、アイコンは地図上でクリック可能です。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
パラメータ: 
  • datasetIdstring
戻り値:  FeatureLayer
指定された datasetIdFeatureLayer を返します。データセット ID は Google Cloud コンソールで構成する必要があります。データセット ID が地図の地図スタイルに関連付けられていない場合、またはデータドリブン スタイルが使用できない場合(マップ ID、ベクタータイル、データドリブン スタイリング対象物レイヤ、または地図スタイルで設定されたデータセットがない場合)、エラーとしてログに記録され、結果として FeatureLayer.isAvailable は false になります。
getDiv
getDiv()
パラメータ: なし
戻り値:  HTMLElement地図の mapDiv。
getFeatureLayer
getFeatureLayer(featureType)
パラメータ: 
戻り値:  FeatureLayer
特定の FeatureTypeFeatureLayer を返します。Google Cloud コンソールで FeatureLayer を有効にする必要があります。指定された FeatureTypeFeatureLayer がこの地図に存在しない場合、またはデータドリブン スタイリングが利用できない場合(マップ ID、ベクタータイル、地図スタイルで FeatureLayer が有効になっていない)、エラーがログに記録され、結果として FeatureLayer.isAvailable は false になります。
getHeading
getHeading()
パラメータ: なし
戻り値:  number|undefined
地図のコンパスの向きを返します。方角の値は、北基本方角からの度数(時計回り)で測定されます。地図がまだ初期化されていない場合、結果は undefined です。
getMapCapabilities
getMapCapabilities()
パラメータ: なし
戻り値:  MapCapabilities
指定されたマップ ID に基づいて、地図で利用可能な現在の機能を呼び出し元に通知します。
getMapTypeId
getMapTypeId()
パラメータ: なし
戻り値:  MapTypeId|string|undefined
getProjection
getProjection()
パラメータ: なし
戻り値:  Projection|undefined
現在の Projection を返します。地図がまだ初期化されていない場合、結果は undefined です。projection_changed イベントをリッスンし、その値が undefined でないことを確認します。
getRenderingType
getRenderingType()
パラメータ: なし
戻り値:  RenderingType
地図の現在の RenderingType を返します。
getStreetView
getStreetView()
パラメータ: なし
戻り値:  StreetViewPanorama 地図にバインドされたパノラマ。
地図にバインドされたデフォルトの StreetViewPanorama を返します。地図内に埋め込まれたデフォルトのパノラマか、setStreetView() を使用して設定されたパノラマになります。地図の streetViewControl への変更は、このようにバインドされたパノラマの表示に反映されます。
getTilt
getTilt()
パラメータ: なし
戻り値:  number|undefined
地図の現在の表示角度を、ビューポートの平面から地図の平面までの角度で返します。ラスター地図の場合、真上から直接撮影された画像の場合は 0、45° 画像の場合は 45 になります。このメソッドは、setTilt で設定された値を返しません。詳しくは、setTilt をご覧ください。
getZoom
getZoom()
パラメータ: なし
戻り値:  number|undefined
地図のズームを返します。ズームが設定されていない場合、結果は undefined になります。
moveCamera
moveCamera(cameraOptions)
パラメータ: 
戻り値: なし
アニメーションなしで、直ちに地図のカメラをターゲット カメラ オプションに設定します。
panBy
panBy(x, y)
パラメータ: 
  • xnumber x 方向に地図を移動するピクセル数。
  • ynumber 地図を y 方向に移動するピクセル数。
戻り値: なし
ピクセル単位で指定された距離だけ地図の中心を変更します。この距離が地図の幅と高さの両方より小さい場合、遷移は滑らかにアニメーション化されます。地図の座標系は、西から東(x 値)と北から南(y 値)に増分します。
panTo
panTo(latLng)
パラメータ: 
戻り値: なし
地図の中心を指定された LatLng に変更します。変更範囲が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション表示されます。
panToBounds
panToBounds(latLngBounds[, padding])
パラメータ: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral 地図のパン先となる境界。
  • paddingnumber|Padding optional ピクセル単位のパディング。数値を指定すると、4 辺すべてに同じパディングが行われます。デフォルト値は 0 です。
戻り値: なし
指定された LatLngBounds を表示するために必要な最小量だけ地図をパンします。境界が地図上のどこに位置するかは保証されませんが、{currentMapSizeInPx} - {padding} 内で可能な限り多くの境界が表示されるよう地図がパンされます。ラスター地図とベクター地図のいずれについても、地図のズーム、傾斜、方角は変更されません。
setCenter
setCenter(latlng)
パラメータ: 
戻り値: なし
setClickableIcons
setClickableIcons(value)
パラメータ: 
  • valueboolean
戻り値: なし
地図アイコンがクリック可能かどうかを制御します。地図アイコンはスポット(スポット)を表します。地図アイコンのクリックを無効にするには、このメソッドに false の値を渡します。
setHeading
setHeading(heading)
パラメータ: 
  • headingnumber
戻り値: なし
地図のコンパス方位を、北基本方角からの度数で設定します。ラスター地図の場合、この方法は航空画像にのみ適用されます。
setMapTypeId
setMapTypeId(mapTypeId)
パラメータ: 
戻り値: なし
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setStreetView
setStreetView(panorama)
パラメータ: 
戻り値: なし
StreetViewPanorama を地図にバインドします。このパノラマは、デフォルトの StreetViewPanorama をオーバーライドして、地図を地図外の外部パノラマにバインドできるようにします。パノラマを null に設定すると、デフォルトで埋め込まれたパノラマが地図にバインドされます。
setTilt
setTilt(tilt)
パラメータ: 
  • tiltnumber
戻り値: なし
ベクター地図の場合、地図の表示角度を設定します。地図のズームレベルに応じて、使用できる値が制限されます。ラスター地図の場合、地図の表示角度の自動切り替え動作を制御します。指定できる値は 045 のみです。setTilt(0) を指定すると、ズームレベルやビューポートに関係なく、地図では常に 0° 上空ビューが使用されます。setTilt(45) を使用すると、現在のズームレベルとビューポートで 45° 画像が利用できる場合は自動的に傾斜角が 45 度に切り替えられ、45° 画像を使用できない場合は 0 に戻ります(デフォルトの動作)。45° 画像は、satellite および hybrid のマップタイプ、一部の場所、一部のズームレベルでのみご利用いただけます。注: getTilt は、setTilt で設定された値ではなく、現在の傾斜角度を返します。getTiltsetTilt は異なるものを参照しているため、tilt プロパティを bind() しないでください。予期しない結果が生じる可能性があります。
setZoom
setZoom(zoom)
パラメータ: 
  • zoomnumberズーム値が大きいほど解像度は高くなります。
戻り値: なし
地図のズームを設定します。
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
bounds_changed
function()
引数: なし
このイベントは、ビューポートの境界が変更されると発生します。
center_changed
function()
引数: なし
このイベントは、地図の中心プロパティが変更されると発生します。
click
function(event)
引数: 
このイベントは、ユーザーが地図をクリックすると発生します。場所アイコンがクリックされない限り、クリックされた場所のプロパティを含む MapMouseEvent が返されます。場所アイコンがクリックされた場合は、プレイス ID が指定された IconMouseEvent が返されます。IconMouseEvent と MapMouseEvent は同じです。ただし、IconMouseEvent にはプレイス ID フィールドがあります。プレイス ID が重要でない場合、イベントは常に MapMouseEvent として処理できます。マーカーや情報ウィンドウがクリックされた場合、クリック イベントは発生しません。
contextmenu
function(event)
引数: 
このイベントは、地図のコンテナで DOM コンテキスト メニュー イベントが発生すると発生します。
dblclick
function(event)
引数: 
このイベントは、ユーザーが地図上でダブルクリックすると発生します。クリック イベントは、この直前に 1 回発生することもあれば、2 回発生することもあります。
drag
function()
引数: なし
このイベントは、ユーザーが地図をドラッグしている間に繰り返し発生します。
dragend
function()
引数: なし
このイベントは、ユーザーが地図のドラッグを停止すると発生します。
dragstart
function()
引数: なし
このイベントは、ユーザーが地図のドラッグを開始すると発生します。
heading_changed
function()
引数: なし
このイベントは、地図の方位プロパティが変更されると発生します。
idle
function()
引数: なし
このイベントは、移動またはズームの後に地図がアイドルになると発生します。
isfractionalzoomenabled_changed
function()
引数: なし
このイベントは、isFractionalZoomEnabled プロパティが変更されると発生します。
mapcapabilities_changed
function()
引数: なし
このイベントは、地図の機能が変更されると発生します。
maptypeid_changed
function()
引数: なし
このイベントは、map TypeId プロパティが変更されると発生します。
mousemove
function(event)
引数: 
このイベントは、ユーザーが地図コンテナ上にマウスオーバーすると発生します。
mouseout
function(event)
引数: 
このイベントは、マウスが地図コンテナから離れると発生します。
mouseover
function(event)
引数: 
このイベントは、マウスが地図コンテナ内に入ると発生します。
projection_changed
function()
引数: なし
このイベントは、投影が変更されると発生します。
renderingtype_changed
function()
引数: なし
このイベントは、RenderType が変更されると発生します。
tilesloaded
function()
引数: なし
このイベントは、表示可能なタイルの読み込みが完了すると発生します。
tilt_changed
function()
引数: なし
このイベントは、地図の傾斜プロパティが変更されると発生します。
zoom_changed
function()
引数: なし
このイベントは、地図のズーム プロパティが変更されると発生します。
rightclick
function(event)
引数: 
このイベントは、ユーザーが地図上で右クリックされると発生します。

MapOptions インターフェース

google.maps.MapOptions インターフェース

Map で設定できるプロパティを定義するために使用される MapOptions オブジェクト。

backgroundColor optional
種類:  string optional
地図の div の背景に使用される色。この色は、ユーザーが移動するときにタイルがまだ読み込まれていない場合に表示されます。このオプションは、地図が初期化されたときのみ設定できます。
center optional
種類:  LatLng|LatLngLiteral optional
地図の最初の中心。
clickableIcons optional
種類:  boolean optional
デフォルト: true
false の場合、地図アイコンはクリックできません。地図アイコンはスポット(スポット)を表します。
controlSize optional
種類:  number optional
地図上に表示されるコントロールのサイズ(ピクセル単位)。この値は、マップの作成時に直接指定する必要があります。後でこの値を更新すると、コントロールが undefined 状態になる可能性があります。Maps API 自体によるコントロールのみを制御します。デベロッパーが作成したカスタム コントロールは拡張されません。
disableDefaultUI optional
種類:  boolean optional
デフォルトの UI ボタンをすべて有効または無効にします。個別にオーバーライドできます。キーボード コントロールは無効にはなりません(これらは MapOptions.keyboardShortcuts オプションで個別に制御されます)。MapOptions.gestureHandling オプションで個別に制御されるジェスチャー コントロールは無効になりません。
disableDoubleClickZoom optional
種類:  boolean optional
ダブルクリックによるズームと中央合わせを有効または無効にします。デフォルトで有効。

: このプロパティは推奨されません。ダブルクリックによるズームを無効にするには、gestureHandling プロパティを使用して "none" に設定します。

draggable optional
種類:  boolean optional
false の場合、地図はドラッグされません。ドラッグ操作はデフォルトで有効になっています。
draggableCursor optional
種類:  string optional
ドラッグ可能な地図にカーソルを合わせたときに表示されるカーソルの名前または URL。このプロパティは、CSS の cursor 属性を使用してアイコンを変更します。CSS プロパティと同様に、URL ではない代替カーソルを 1 つ以上指定する必要があります。例: draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional
種類:  string optional
地図をドラッグしているときに表示されるカーソルの名前または URL。このプロパティは、CSS の cursor 属性を使用してアイコンを変更します。CSS プロパティと同様に、URL ではない代替カーソルを 1 つ以上指定する必要があります。例: draggingCursor: 'url(http://www.example.com/icon.png), auto;'
fullscreenControl optional
種類:  boolean optional
全画面コントロールの有効/無効状態。
fullscreenControlOptions optional
種類:  FullscreenControlOptions optional
全画面コントロールの表示オプション。
gestureHandling optional
種類:  string optional
この設定により、API による地図上の操作の処理方法が決まります。使用できる値:
  • "cooperative": スクロール イベントと 1 本指のタッチ操作でページをスクロールします。地図のズームとパンは行いません。2 本の指でのタッチ操作で地図のパンとズームを行います。Ctrl キーまたは ⌘ キーでスクロール イベントを使用すると、地図がズームされます。
    このモードでは、地図とページが連携します。
  • "greedy": すべてのタッチ操作とスクロール イベントで、地図のパンまたはズームが行われます。
  • "none": ユーザーの操作で地図のパンやズームを行うことはできません。
  • "auto": (デフォルト)ジェスチャー処理は、ページがスクロール可能か iframe 内かに応じて、協調的または欲張ります。
heading optional
種類:  number optional
航空画像の角度。北基本方角から時計回りに測定した角度で示されます。方位は、画像を表示できる最も近い角度に合わせられます。
isFractionalZoomEnabled optional
種類:  boolean optional
デフォルト: ベクター地図の場合は true、ラスター地図の場合は false です。
地図で小数ズームレベルを許可するかどうかを指定します。デフォルトが設定されるかどうかは、isfractionalzoomenabled_changed で確認します。
keyboardShortcuts optional
種類:  boolean optional
false の場合、地図をキーボードで操作できなくなります。キーボード ショートカットはデフォルトで有効になっています。
mapId optional
種類:  string optional
地図のマップ ID。地図をインスタンス化した後に、このパラメータを設定または変更することはできません。
mapTypeControl optional
種類:  boolean optional
地図タイプのコントロールの有効/無効の初期状態。
mapTypeControlOptions optional
種類:  MapTypeControlOptions optional
地図タイプのコントロールの初期表示オプション。
mapTypeId optional
種類:  MapTypeId|string optional
最初の Map MapTypeId。デフォルトは ROADMAP です。
maxZoom optional
種類:  number optional
地図上に表示される最大ズームレベル。省略するか null に設定した場合は、代わりに現在のマップタイプの最大ズームが使用されます。有効なズーム値は、0 からサポートされる最大ズームレベルまでの数値です。
minZoom optional
種類:  number optional
地図上に表示される最小ズームレベル。省略するか null に設定した場合は、現在のマップタイプの最小ズームが代わりに使用されます。有効なズーム値は、0 からサポートされる最大ズームレベルまでの数値です。
noClear optional
種類:  boolean optional
true の場合、Map div のコンテンツを消去しないでください。
panControl optional
種類:  boolean optional
パン コントロールの有効/無効状態。

panControlOptions optional
種類:  PanControlOptions optional
パン コントロールの表示オプション。

restriction optional
種類:  MapRestriction optional
ユーザーがアクセスできる地図の領域を制限する境界線を定義します。設定すると、ユーザーはカメラビューが境界内に収まる場合にのみパンとズームを行うことができます。
rotateControl optional
種類:  boolean optional
回転コントロールの有効/無効状態。
rotateControlOptions optional
種類:  RotateControlOptions optional
回転コントロールの表示オプション。
scaleControl optional
種類:  boolean optional
スケール コントロールの最初の有効/無効状態。
scaleControlOptions optional
種類:  ScaleControlOptions optional
スケール コントロールの最初の表示オプション。
scrollwheel optional
種類:  boolean optional
false の場合、マウスのスクロール ホイールを使用した地図のズームを無効にします。スクロールホイールはデフォルトで有効になっています。

: このプロパティは推奨されません。スクロールホイールを使用したズームを無効にするには、gestureHandling プロパティを使用して、"cooperative" または "none" に設定します。

streetView optional
種類:  StreetViewPanorama optional
ストリートビューのペグマンが地図上にドロップされたときに表示される StreetViewPanorama。パノラマが指定されていない場合、ペグマンがドロップされると、デフォルトの StreetViewPanorama が地図の div に表示されます。
streetViewControl optional
種類:  boolean optional
ストリートビューのペグマン コントロールの有効/無効の初期状態。このコントロールはデフォルト UI の一部であり、ストリートビューの道路オーバーレイを表示すべきでない地図タイプ(Earth 以外のマップタイプなど)を表示する場合は false に設定する必要があります。
streetViewControlOptions optional
種類:  StreetViewControlOptions optional
ストリートビューでペグマン コントロールの最初の表示オプション。
styles optional
種類:  Array<MapTypeStyle> optional
デフォルトのマップタイプごとに適用するスタイル。なお、satellite/hybrid モードと terrain モードの場合、これらのスタイルはラベルとジオメトリにのみ適用されます。
tilt optional
種類:  number optional
ベクター地図の場合、地図の表示角度を設定します。地図のズームレベルに応じて、使用できる値が制限されます。ラスター地図の場合、地図の表示角度の自動切り替え動作を制御します。指定できる値は 045 のみです。値 0 を指定すると、ズームレベルやビューポートに関係なく、地図では常に 0° 上空ビューが使用されます。値 45 を指定すると、現在のズームレベルとビューポートで 45° 画像が利用できる場合は自動的に傾斜角が 45 度に切り替えられ、45° 画像を使用できない場合は 0 に戻ります(デフォルトの動作)。45° 画像は、satellite および hybrid のマップタイプ、一部の場所、一部のズームレベルでのみご利用いただけます。注: getTilt は、このオプションで指定された値ではなく、現在の傾斜角度を返します。getTilt とこのオプションは異なるものを参照しているため、tilt プロパティを bind() しないでください。予期しない結果が生じる可能性があります。
zoom optional
種類:  number optional
地図の初期ズームレベル。有効なズーム値は、0 からサポートされる最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度は高くなります。
zoomControl optional
種類:  boolean optional
ズーム コントロールの有効/無効状態。
zoomControlOptions optional
種類:  ZoomControlOptions optional
ズーム コントロールの表示オプション。

MapElement クラス

google.maps.MapElement クラス

MapElement は、地図をレンダリングするための HTMLElement サブクラスです。maps ライブラリを読み込むと、HTML で地図を作成できます。例:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

内部的には、innerMap プロパティでアクセスできる Map を使用します。

カスタム要素:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

このクラスは HTMLElement を拡張します。

このクラスは MapElementOptions を実装します。

const {MapElement} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

MapElement
MapElement([options])
パラメータ: 
center
種類:  LatLng|LatLngLiteral optional
地図の中心の緯度と経度。
HTML 属性:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
種類:  Map
MapElement が内部的に使用する Map への参照。
mapId
種類:  string optional
地図のマップ ID。詳しくは、マップ ID のドキュメントをご覧ください。
HTML 属性:
  • <gmp-map map-id="string"></gmp-map>
zoom
種類:  number optional
地図のズームレベル。
HTML 属性:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
スロット要素を ControlPosition.BLOCK_END_INLINE_CENTER の位置に配置します。
control-block-end-inline-end
スロット要素を ControlPosition.BLOCK_END_INLINE_END の位置に配置します。
control-block-end-inline-start
スロット要素を ControlPosition.BLOCK_END_INLINE_START の位置に配置します。
control-block-start-inline-center
スロット要素を ControlPosition.BLOCK_START_INLINE_CENTER の位置に配置します。
control-block-start-inline-end
スロット要素を ControlPosition.BLOCK_START_INLINE_END の位置に配置します。
control-block-start-inline-start
スロット要素を ControlPosition.BLOCK_START_INLINE_START の位置に配置します。
control-inline-end-block-center
スロット要素を ControlPosition.INLINE_END_BLOCK_CENTER の位置に配置します。
control-inline-end-block-end
スロット要素を ControlPosition.INLINE_END_BLOCK_END の位置に配置します。
control-inline-end-block-start
スロット要素を ControlPosition.INLINE_END_BLOCK_START の位置に配置します。
control-inline-start-block-center
スロット要素を ControlPosition.INLINE_START_BLOCK_CENTER の位置に配置します。
control-inline-start-block-end
スロット要素を ControlPosition.INLINE_START_BLOCK_END の位置に配置します。
control-inline-start-block-start
スロット要素を ControlPosition.INLINE_START_BLOCK_START の位置に配置します。
BetaaddEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • typestring リッスンするイベントのタイプを表す文字列(大文字と小文字を区別)。
  • listenerEventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • optionsboolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでは、capturepassive のみがサポートされます。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
BetaremoveEventListener
removeEventListener(type, listener[, options])
パラメータ: 
戻り値:  void
以前に addEventListener で登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-zoomchange
function(event)
引数: 
このイベントは、地図のズーム プロパティが変更されると発生します。

MapElementOptions インターフェース

google.maps.MapElementOptions インターフェース

MapElement で設定できるプロパティを定義するために使用される MapElementOptions オブジェクト。

center optional
種類:  LatLng|LatLngLiteral optional
地図の最初の中心。
mapId optional
種類:  string optional
地図のマップ ID。地図をインスタンス化した後に、このパラメータを設定または変更することはできません。
zoom optional
種類:  number optional
地図の初期ズームレベル。有効なズーム値は、0 からサポートされる最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度は高くなります。

ZoomChangeEvent クラス

google.maps.ZoomChangeEvent クラス

このイベントは、ズーム変更のモニタリングから作成されます。

このクラスは Event を拡張します。

const {ZoomChangeEvent} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

MapTypeStyle インターフェース

google.maps.MapTypeStyle インターフェース

MapTypeStyle は、地図のスタイルを定義するセレクタとスタイラのコレクションです。セレクタで、影響を受ける地図対象物や要素を指定し、スタイラでそうした対象物と要素の変更方法を指定します。詳しくは、スタイル リファレンスをご覧ください。

stylers
種類:  Array<Object>
選択した地図対象物と要素に適用するスタイル規則。ルールは、この配列で指定した順序で適用されます。使用方法と指定できる値のガイドラインについては、スタイル リファレンスをご覧ください。
elementType optional
種類:  string optional
スタイラを適用する要素。要素は、地図上の対象物を視覚的に表した要素です。(例: ラベル、アイコン、ジオメトリに適用されるストロークや塗りつぶしなど)。(省略可)elementType が指定されていない場合、値は 'all' とみなされます。用途と指定できる値について詳しくは、スタイル リファレンスをご覧ください。
featureType optional
種類:  string optional
スタイラを適用する対象物、または対象物のグループ。(省略可)featureType が指定されていない場合、値は 'all' とみなされます。用途と指定できる値について詳しくは、スタイル リファレンスをご覧ください。

MapMouseEvent インターフェース

google.maps.MapMouseEvent インターフェース

このオブジェクトは、地図とオーバーレイに対するさまざまなマウスイベントから返され、以下に示すすべてのフィールドを含みます。

domEvent
対応するネイティブ DOM イベントです。デベロッパーは、targetcurrentTargetrelatedTargetpath の各プロパティの定義と整合性に頼ってはいけません。Maps API の内部実装の DOM 構造にも依存するべきではありません。内部イベント マッピングにより、domEvent のセマンティクスは MapMouseEvent とは異なる場合があります(たとえば、MapMouseEvent の「クリック」の domEvent 型は KeyboardEvent である場合があります)。
latLng optional
種類:  LatLng optional
イベントが発生したときにカーソルの下にあった緯度と経度。
stop
stop()
パラメータ: なし
戻り値:  void
このイベントがそれ以上伝播しないようにします。

IconMouseEvent インターフェース

google.maps.IconMouseEvent インターフェース

このオブジェクトは、ユーザーが地図上のアイコンをクリックしたときにイベントで送信されます。この場所のプレイス ID は placeId メンバーに保存されます。デフォルトの情報ウィンドウが表示されないようにするには、このイベントで stop() メソッドを呼び出して、情報が反映されないようにします。詳しくは、Places API デベロッパー ガイドのプレイス ID をご覧ください。

このインターフェースは MapMouseEvent を拡張します。

placeId optional
種類:  string optional
クリックされた場所のプレイス ID。このプレイス ID を使用して、クリックされた対象物に関する詳細情報を照会できます。

詳しくは、Places API デベロッパー ガイドのプレイス ID をご覧ください。

継承: domEventlatLng
継承: stop

MapTypeId 定数

google.maps.MapTypeId 定数

一般的な MapType の識別子です。値または定数名を使用して指定します。('satellite'google.maps.MapTypeId.SATELLITE など)が使用されます。

const {MapTypeId} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

HYBRID このマップ タイプは、航空写真上に主要な道路の透明なレイヤを表示します。
ROADMAP このマップ タイプは通常の市街地図を表示します。
SATELLITE このマップ タイプは航空写真を表示します。
TERRAIN このマップ タイプは地形や樹木などの地形的特徴を持つ地図を表示します。

MapTypeRegistry クラス

google.maps.MapTypeRegistry クラス

MapType ID をキーとする MapType インスタンスのレジストリ。

このクラスは MVCObject を拡張します。

const {MapTypeRegistry} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

MapTypeRegistry
MapTypeRegistry()
パラメータ: なし
MapTypeRegistry は、地図で使用できるカスタムのマップタイプのコレクションを保持します。API は、たとえばコントロール内で使用可能なマップタイプのリストを提供する際に、このレジストリを参照します。
set
set(id, mapType)
パラメータ: 
  • idstring レジストリに追加する MapType の ID。
  • mapType:  レジストリに追加する MapType|* MapType オブジェクト。
戻り値: なし
渡された文字列 ID を渡された MapType と関連付けるように、レジストリを設定します。
継承: addListenerbindTogetnotifysetValuesunbindunbindAll

MapRestriction インターフェース

google.maps.MapRestriction インターフェース

地図に適用できる制限。地図のビューポートは、これらの制限を超えることはありません。

latLngBounds
設定すると、ユーザーは指定された境界内でのみパンとズームを行うことができます。境界では、経度と緯度の両方を制限することも、緯度のみを制限することもできます。緯度のみの境界の場合は、西経と東経をそれぞれ -180 と 180 にします(例: latLngBounds: {north: northLat, south: southLat, west: -180, east: 180})。
strictBounds optional
種類:  boolean optional
strictBounds フラグを true に設定すると、境界をより限定的にすることができます。これにより、ユーザーがズームアウトできる範囲が狭くなり、制限された境界の外はすべて非表示になります。デフォルト値は false です。つまり、ユーザーは境界領域全体がビュー内に収まるまでズームアウトできます。境界外の領域もズームアウトできます。

TrafficLayer クラス

google.maps.TrafficLayer クラス

交通レイヤ。

このクラスは MVCObject を拡張します。

const {TrafficLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

TrafficLayer
TrafficLayer([opts])
パラメータ: 
現在の道路渋滞状況を表示するレイヤ。
getMap
getMap()
パラメータ: なし
戻り値:  Map
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll

TrafficLayerOptions インターフェース

google.maps.TrafficLayerOptions インターフェース

TrafficLayerOptions オブジェクトは、TrafficLayer で設定できるプロパティを定義する際に使用されます。

autoRefresh optional
種類:  boolean optional
デフォルト: true
交通状況レイヤが、更新された情報で自動的に更新されるかどうかを指定します。
map optional
種類:  Map optional
交通状況レイヤを表示する地図。

TransitLayer クラス

google.maps.TransitLayer クラス

交通機関のレイヤ。

このクラスは MVCObject を拡張します。

const {TransitLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

TransitLayer
TransitLayer()
パラメータ: なし
路線を表示するレイヤ。
getMap
getMap()
パラメータ: なし
戻り値:  Map
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll

BicyclingLayer クラス

google.maps.BicyclingLayer クラス

自動車レーンとパスを表示するレイヤ。

このクラスは MVCObject を拡張します。

const {BicyclingLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

BicyclingLayer
BicyclingLayer()
パラメータ: なし
自動車レーンとパスを表示し、幹線道路を目立たなくするレイヤ。
getMap
getMap()
パラメータ: なし
戻り値:  Map
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll

CameraOptions インターフェース

google.maps.CameraOptions インターフェース

地図のカメラ オプションの設定に使用します。

center optional
種類:  LatLngLiteral|LatLng optional
heading optional
種類:  number optional
tilt optional
種類:  number optional
zoom optional
種類:  number optional

VisibleRegion インターフェース

google.maps.VisibleRegion インターフェース

地図の表示領域である 4 辺のポリゴンを定義する 4 つのポイントを含みます。ベクターマップが傾斜している場合、このポリゴンは長方形ではなく台形になります。

farLeft
種類:  LatLng
farRight
種類:  LatLng
latLngBounds
種類:  LatLngBounds
表示される領域を含む最小の境界ボックス。
nearLeft
種類:  LatLng
nearRight
種類:  LatLng

RenderingType 定数

google.maps.RenderingType 定数

const {RenderingType} = await google.maps.importLibrary("maps") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。

RASTER 地図がラスター地図であることを示します。
UNINITIALIZED 地図の初期化がまだ完了していないため、地図がベクター地図かラスター地図か不明なことを示します。
VECTOR 地図がベクターマップであることを示します。

MapCapabilities インターフェース

google.maps.MapCapabilities インターフェース

地図で現在利用可能な機能のスナップショットを含むオブジェクト。なお、これは必ずしも関連するモジュールがロードまたは初期化されたということではなく、現在の地図がそれらの API を使用する権限を持っていることを意味します。使用可能な機能のリストについては、プロパティをご覧ください。

isAdvancedMarkersAvailable optional
種類:  boolean optional
true の場合、高度なマーカーを使用できるように、この地図が適切に設定されます。なお、高度なマーカーを使用するためには、marker ライブラリをインポートする必要があります。詳しくは、https://goo.gle/gmp-isAdvancedMarkersAvailable をご覧ください。
isDataDrivenStylingAvailable optional
種類:  boolean optional
true の場合、この地図は、少なくとも 1 つの FeatureLayer でデータドリブン スタイルを使用できるように適切に設定されます。詳しくは、https://goo.gle/gmp-data-driven-stylinghttps://goo.gle/gmp-FeatureLayerIsAvailable をご覧ください。