Maps

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>
内部的には Map を使用します。これは MapElement.innerMap プロパティでアクセスできます。

カスタム要素:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled 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>
headingInteractionDisabled
タイプ:  boolean optional
デフォルト: false
地図でカメラの向き（回転）をユーザーが制御できるようにするかどうか。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
HTML 属性:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
タイプ:  Map
MapElement が内部で使用する Map への参照。
internalUsageAttributionIds
タイプ:  Iterable<string> optional
デフォルト: null
使用状況の帰属 ID を初期化子に追加します。これにより、マーカー クラスタリング ライブラリの使用状況など、デベロッパーに役立つライブラリとサンプルを Google が把握できるようになります。使用状況アトリビューション ID の送信をオプトアウトするには、このプロパティを削除するか、値を空の文字列に置き換えても安全です。一意の値のみが送信されます。インスタンス化後にこの値を変更しても、無視されることがあります。
HTML 属性:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
タイプ:  string optional
地図のマップ ID。このパラメータは、マップのインスタンス化後に設定または変更することはできません。Map.DEMO_MAP_ID を使用すると、マップ ID が必要だがクラウドの有効化は必要ない機能を試すことができます。
HTML 属性:
  • <gmp-map map-id="string"></gmp-map>
renderingType
タイプ:  RenderingType optional
デフォルト: RenderingType.VECTOR
地図をラスター地図にするかベクター地図にするか。このパラメータは、マップのインスタンス化後に設定または変更することはできません。設定されていない場合、地図 ID のクラウド構成によってレンダリング タイプが決定されます（利用可能な場合）。ベクター地図は、一部のデバイスやブラウザではご利用いただけない場合があります。その場合、地図は必要に応じてラスター地図にフォールバックします。
HTML 属性:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
タイプ:  boolean optional
デフォルト: false
地図でユーザーがカメラの傾きを制御できるようにするかどうか。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
HTML 属性:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
タイプ:  number optional
地図のズームレベル。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度が高くなります。
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 の位置に配置します。
default
カスタム要素を使用すると、AdvancedMarkerElement などの Maps JavaScript Web Components の周りに再利用可能なコンポーネントを作成できます。デフォルトでは、MapElement に直接追加されたカスタム要素はスロットに挿入され、MapPanes.overlayMouseTarget でレンダリングされます。ただし、Maps JavaScript API の Web Components は MapElement の内部スロットに再スロット化されることがあります。
BetaaddEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
BetaremoveEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-zoomchange
function(event)
引数: 
このイベントは、地図のズーム プロパティが変更されると発生します。

MapElementOptions インターフェース

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

MapElement に設定できるプロパティを定義するために使用される MapElementOptions オブジェクト。
center optional
タイプ:  LatLng|LatLngLiteral optional
MapElement.center をご覧ください。
headingInteractionDisabled optional
タイプ:  boolean optional
MapElement.headingInteractionDisabled をご覧ください。
internalUsageAttributionIds optional
タイプ:  Iterable<string> optional
MapElement.internalUsageAttributionIds をご覧ください。
mapId optional
タイプ:  string optional
MapElement.mapId をご覧ください。
renderingType optional
タイプ:  RenderingType optional
MapElement.renderingType をご覧ください。
tiltInteractionDisabled optional
タイプ:  boolean optional
MapElement.tiltInteractionDisabled をご覧ください。
zoom optional
タイプ:  number optional
MapElement.zoom をご覧ください。

ZoomChangeEvent クラス

google.maps.ZoomChangeEvent クラス

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

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

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

Map クラス

google.maps.Map クラス

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

const {Map} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
Map
Map(mapDiv[, opts])
パラメータ: 
  • mapDiv:  HTMLElement この要素を埋めるように地図がレンダリングされます。
  • opts:  MapOptions optional オプション
指定された HTML コンテナ（通常は DIV 要素）内に新しい地図を作成します。
DEMO_MAP_ID マップ ID が必要なコードサンプルで使用できるマップ ID。このマップ ID は本番環境用アプリでの使用を想定しておらず、クラウド構成が必要な機能（クラウド スタイリングなど）には使用できません。
controls
タイプ:  Array<MVCArray<HTMLElement>>
地図に添付する追加のコントロール。地図にコントロールを追加するには、コントロールの <div> を、レンダリングする ControlPosition に対応する MVCArray に追加します。
data
タイプ:  Data
地図にバインドされた Data のインスタンス。この Data オブジェクトにフィーチャーを追加して、この地図に簡単に表示します。
mapTypes
タイプ:  MapTypeRegistry
文字列 ID による MapType インスタンスのレジストリ。
overlayMapTypes
タイプ:  MVCArray<MapType optional>
オーバーレイする追加の地図タイプ。オーバーレイのマップタイプは、関連付けられている任意の基本地図の上に表示され、その順序は overlayMapTypes 配列での記述順序です（より高いインデックス値を持つオーバーレイが、低いインデックス値を持つオーバーレイの前に表示されます）。
fitBounds
fitBounds(bounds[, padding])
パラメータ: 
  • bounds:  表示する LatLngBounds|LatLngBoundsLiteral 境界。
  • padding:  number|Padding optional パディング（ピクセル単位）。境界は、パディングが削除された後に残る地図の部分に収まるように調整されます。数値を使用すると、4 辺すべてに同じパディングが適用されます。ここでは 0 を指定して、getBounds の結果に対して fitBounds をべき等にします。
戻り値: なし
指定された境界が含まれるようにビューポートを設定します。
注: マップが display: none に設定されている場合、fitBounds 関数はマップのサイズを 0x0 として読み取るため、何も行いません。地図が非表示の状態でビューポートを変更するには、地図を visibility: hidden に設定して、地図の div に実際のサイズが設定されるようにします。ベクターマップの場合、このメソッドはマップの傾斜と見出しをデフォルトのゼロ値に設定します。このメソッドを呼び出すと、地図が境界に合わせてパンやズームを行う際に、スムーズなアニメーションが実行されることがあります。このメソッドがアニメーション化されるかどうかは、内部ヒューリスティックによって決まります。
getBounds
getBounds()
パラメータ: なし
戻り値:  LatLngBounds|undefined 現在のビューポートの緯度/経度の境界。
現在のビューポートの緯度/経度の境界を返します。世界地図のコピーが複数表示されている場合、経度の範囲は -180 ～ 180 度（両端を含む）になります。地図がまだ初期化されていない場合、または中心とズームが設定されていない場合、結果は undefined になります。傾斜または見出しがゼロ以外のベクター地図の場合、返される緯度/経度の境界は、地図のビューポートで表示されるリージョンを含む最小の境界ボックスを表します。地図のビューポートの正確な表示領域を取得する方法については、MapCanvasProjection.getVisibleRegion をご覧ください。
getCenter
getCenter()
パラメータ: なし
戻り値:  LatLng|undefined
地図の中心に表示されている位置を返します。この LatLng オブジェクトはラップされていません。詳しくは、LatLng をご覧ください。中心または境界が設定されていない場合、結果は undefined になります。
getClickableIcons
getClickableIcons()
パラメータ: なし
戻り値:  boolean|undefined
地図アイコンのクリック可能かどうかを返します。地図アイコンは、スポット（POI）を表します。戻り値が true の場合、地図上のアイコンはクリック可能です。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
パラメータ: 
  • datasetId:  string
戻り値:  FeatureLayer
指定された datasetId の FeatureLayer を返します。データセット ID は Google Cloud コンソールで構成する必要があります。データセット ID が地図の地図のスタイルに関連付けられていない場合、またはデータドリブン スタイル設定が利用できない場合（マップ ID、ベクタータイル、地図のスタイルで構成されたデータドリブン スタイル設定のフィーチャー レイヤまたはデータセットがない場合）、エラーがログに記録され、結果の FeatureLayer.isAvailable は false になります。
getDiv
getDiv()
パラメータ: なし
戻り値:  HTMLElement 地図の mapDiv。
getFeatureLayer
getFeatureLayer(featureType)
パラメータ: 
戻り値:  FeatureLayer
特定の FeatureType の FeatureLayer を返します。Google Cloud コンソールで FeatureLayer を有効にする必要があります。指定した FeatureType の FeatureLayer がこの地図に存在しない場合、またはデータドリブン スタイル設定が利用できない場合（マップ ID がない、ベクタータイルがない、マップスタイルで FeatureLayer が有効になっていない）、エラーがログに記録され、結果の FeatureLayer.isAvailable は false になります。
getHeading
getHeading()
パラメータ: なし
戻り値:  number|undefined
地図のコンパス方位を返します。方位の値は、北を基準とした時計回りの角度で表されます。マップがまだ初期化されていない場合、結果は undefined になります。
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
パラメータ: なし
戻り値:  boolean|null
見出しの操作が有効かどうかを返します。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
パラメータ: なし
戻り値:  Iterable<string>|null
使用状況属性 ID のリストを返します。この ID は、マーカー クラスタリング ライブラリの使用状況など、どのライブラリやサンプルがデベロッパーに役立つかを Google が把握するのに役立ちます。
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 をご覧ください。
getTiltInteractionEnabled
getTiltInteractionEnabled()
パラメータ: なし
戻り値:  boolean|null
傾斜操作が有効かどうかを返します。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
getZoom
getZoom()
パラメータ: なし
戻り値:  number|undefined
地図のズームを返します。ズームが設定されていない場合、結果は undefined になります。
moveCamera
moveCamera(cameraOptions)
パラメータ: 
戻り値: なし
アニメーションなしで、地図のカメラをターゲットのカメラ オプションにすぐに設定します。
panBy
panBy(x, y)
パラメータ: 
  • x:  number 地図を x 方向に移動するピクセル数。
  • y:  number 地図を y 方向に移動するピクセル数。
戻り値: なし
地図の中心を指定された距離（ピクセル単位）だけ移動します。距離が地図の幅と高さの両方よりも小さい場合、トランジションはスムーズにアニメーション化されます。地図の座標系は、西から東（x 値の場合）と北から南（y 値の場合）に増分します。
panTo
panTo(latLng)
パラメータ: 
戻り値: なし
地図の中心を指定された LatLng に変更します。変更範囲が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション表示されます。
panToBounds
panToBounds(latLngBounds[, padding])
パラメータ: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral マップをパンする境界。
  • padding:  number|Padding optional パディング（ピクセル単位）。数値を使用すると、4 辺すべてに同じパディングが適用されます。デフォルト値は 0 です。
戻り値: なし
指定された LatLngBounds を含むために必要な最小限の量だけ地図をパンします。{currentMapSizeInPx} - {padding} 内にできるだけ多くの境界が表示されるように地図がパンされることを除き、地図上の境界の位置は保証されません。ラスター地図とベクター地図のどちらの場合も、地図のズーム、傾斜、方向は変更されません。
setCenter
setCenter(latlng)
パラメータ: 
戻り値: なし
setClickableIcons
setClickableIcons(value)
パラメータ: 
  • value:  boolean
戻り値: なし
地図アイコンをクリック可能にするかどうかを制御します。地図アイコンは、スポット（POI）を表します。地図アイコンのクリックを無効にするには、このメソッドに値 false を渡します。
setHeading
setHeading(heading)
パラメータ: 
  • heading:  number
戻り値: なし
地図のコンパスの向首方向を、北からの角度で設定します。ラスター地図の場合、この方法は航空写真にのみ適用されます。
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
パラメータ: 
  • headingInteractionEnabled:  boolean
戻り値: なし
見出しの操作を有効にするかどうかを設定します。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
setMapTypeId
setMapTypeId(mapTypeId)
パラメータ: 
戻り値: なし
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setRenderingType
setRenderingType(renderingType)
パラメータ: 
戻り値: なし
地図の現在の RenderingType を設定します。
setStreetView
setStreetView(panorama)
パラメータ: 
戻り値: なし
StreetViewPanorama を地図にバインドします。このパノラマはデフォルトの StreetViewPanorama をオーバーライドし、地図が地図外の外部パノラマにバインドできるようにします。パノラマを null に設定すると、デフォルトの埋め込みパノラマが地図にバインドされます。
setTilt
setTilt(tilt)
パラメータ: 
  • tilt:  number
戻り値: なし
ベクターマップの場合、地図の入射角を設定します。指定できる値は、地図のズームレベルによって制限されます。

ラスターマップの場合、マップの入射角の自動切り替え動作を制御します。指定できる値は 0 と 45 のみです。setTilt(0) を指定すると、ズームレベルやビューポートに関係なく、地図で常に 0° の俯瞰図が使用されます。setTilt(45) を指定すると、現在のズームレベルとビューポートで 45° 画像が利用可能な場合は傾斜角度が自動的に 45 に切り替わり、45° 画像が利用できない場合は 0 に戻ります（これがデフォルトの動作です）。45° 画像は、satellite および hybrid のマップタイプでのみ、一部の地域で、一部のズームレベルでのみご利用いただけます。注: getTilt は、setTilt で設定された値ではなく、現在の傾斜角度を返します。getTilt と setTilt は異なるものを参照するため、tilt プロパティを bind() しないでください。そうすると、予測できない影響が生じる可能性があります。
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
パラメータ: 
  • tiltInteractionEnabled:  boolean
戻り値: なし
傾斜操作が有効かどうかを設定します。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
setZoom
setZoom(zoom)
パラメータ: 
  • zoom:  number ズーム値が大きいほど、解像度が高くなります。
戻り値: なし
地図のズームを設定します。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
bounds_changed
function()
引数: なし
このイベントは、ビューポートの境界が変更されると発生します。
center_changed
function()
引数: なし
このイベントは、地図の中心プロパティが変更されると発生します。
click
function(event)
引数: 
このイベントは、ユーザーが地図をクリックしたときに発生します。場所アイコンがクリックされた場合を除き、クリックされた場所のプロパティを含む MapMouseEvent が返されます。場所アイコンがクリックされた場合は、場所 ID を含む IconMouseEvent が返されます。IconMouseEvent と MapMouseEvent は、IconMouseEvent にプレイス ID フィールドがある点を除いて同じです。プレイス ID が重要でない場合は、イベントを常に MapMouseEvent として扱うことができます。マーカーまたは情報ウィンドウがクリックされた場合、クリック イベントは発行されません。
contextmenu
function(event)
引数: 
このイベントは、地図コンテナで DOM contextmenu イベントが発生したときに発生します。
dblclick
function(event)
引数: 
このイベントは、ユーザーが地図をダブルクリックしたときに発生します。クリック イベントは、このイベントの直前に 1 回または 2 回発生することがあります。
drag
function()
引数: なし
このイベントは、ユーザーが地図をドラッグしている間に繰り返し発生します。
dragend
function()
引数: なし
このイベントは、ユーザーが地図のドラッグを終了したときに発生します。注: ユーザーがキーボードを使用して地図のパンを停止した場合、dragend は発行されません。ユーザーが地図のパンまたはドラッグを停止したタイミングを判断するには、代わりに Map.idle イベントを使用してください。
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()
引数: なし
このイベントは、renderingType が変更されたときに発生します。
tilesloaded
function()
引数: なし
このイベントは、表示されているタイルの読み込みが完了したときに発生します。
tilt_changed
function()
引数: なし
このイベントは、地図の傾斜プロパティが変更されると発生します。
zoom_changed
function()
引数: なし
このイベントは、地図のズーム プロパティが変更されると発生します。
rightclick
function(event)
引数: 
このイベントは、ユーザーが地図を右クリックしたときに発生します。

MapOptions インターフェース

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

Map で設定できるプロパティを定義するために使用される MapOptions オブジェクト。
backgroundColor optional
タイプ:  string optional
マップの div の背景に使用される色。ユーザーがパンしているときにタイルがまだ読み込まれていない場合、この色が表示されます。このオプションは、地図が初期化されたときのみ設定できます。
cameraControl optional
タイプ:  boolean optional
カメラ コントロールの有効/無効の状態。
cameraControlOptions optional
タイプ:  CameraControlOptions optional
カメラ コントロールの表示オプション。
center optional
タイプ:  LatLng|LatLngLiteral optional
地図の初期の中心。
clickableIcons optional
タイプ:  boolean optional
デフォルト: true
false の場合、地図のアイコンはクリックできません。地図アイコンは、スポット（POI）を表します。
colorScheme optional
タイプ:  ColorScheme|string optional
デフォルト: ColorScheme.LIGHT
地図の初期のカラーパターン。このオプションは、地図が初期化されたときのみ設定できます。
controlSize optional
タイプ:  number optional
地図上に表示されるコントロールのサイズ（ピクセル単位）。この値は、Map の作成時に直接指定する必要があります。後でこの値を更新すると、コントロールが 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
航空写真の向き。真北から時計回りに測った角度（度数）。方位は、画像を表示できる最も近い角度に合わせられます。
headingInteractionEnabled optional
タイプ:  boolean optional
デフォルト: false
地図でカメラの向き（回転）をユーザーが制御できるようにするかどうか。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
internalUsageAttributionIds optional
タイプ:  Iterable<string> optional
デフォルト: null
使用状況の帰属 ID を初期化子に追加します。これにより、マーカー クラスタリング ライブラリの使用状況など、デベロッパーに役立つライブラリとサンプルを Google が把握できるようになります。使用状況アトリビューション ID の送信をオプトアウトするには、このプロパティを削除するか、値を空の文字列に置き換えても安全です。一意の値のみが送信されます。インスタンス化後にこの値を変更しても、無視されることがあります。
isFractionalZoomEnabled optional
タイプ:  boolean optional
デフォルト: ベクター地図の場合は true、ラスター地図の場合は false
地図で小数ズームレベルを許可するかどうか。isfractionalzoomenabled_changed をリッスンして、デフォルトが設定されたタイミングを把握します。
keyboardShortcuts optional
タイプ:  boolean optional
false の場合、キーボードで地図を操作できなくなります。キーボード ショートカットはデフォルトで有効になっています。
mapId optional
タイプ:  string optional
地図のマップ ID。このパラメータは、マップのインスタンス化後に設定または変更することはできません。Map.DEMO_MAP_ID を使用すると、マップ 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
パン コントロールの表示オプション。
renderingType optional
タイプ:  RenderingType optional
デフォルト: RenderingType.RASTER
地図をラスター地図にするかベクター地図にするか。このパラメータは、マップのインスタンス化後に設定または変更することはできません。設定されていない場合、地図 ID のクラウド構成によってレンダリング タイプが決定されます（利用可能な場合）。ベクター地図は、一部のデバイスやブラウザではご利用いただけない場合があります。その場合、地図は必要に応じてラスター地図にフォールバックします。
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。パノラマが指定されていない場合、ペグマンをドロップすると、地図の div にデフォルトの StreetViewPanorama が表示されます。
streetViewControl optional
タイプ:  boolean optional
ストリートビューのペグマン コントロールの初期の有効/無効の状態。このコントロールはデフォルトの UI の一部です。ストリートビューの道路オーバーレイを表示すべきでない地図タイプ（地球以外の地図タイプなど）を表示する場合は、false に設定する必要があります。
streetViewControlOptions optional
タイプ:  StreetViewControlOptions optional
ストリートビューでペグマン コントロールの最初の表示オプション。
styles optional
タイプ:  Array<MapTypeStyle> optional
デフォルトの地図のタイプごとに適用するスタイル。satellite/hybrid モードと terrain モードでは、これらのスタイルはラベルとジオメトリにのみ適用されます。この機能は、マップ ID を使用している場合や、ベクターマップを使用している場合は使用できません（代わりに Cloud ベースのマップのスタイル設定を使用してください）。
tilt optional
タイプ:  number optional
ベクターマップの場合、地図の入射角を設定します。指定できる値は、地図のズームレベルによって制限されます。ラスターマップの場合、マップの入射角の自動切り替え動作を制御します。指定できる値は 0 と 45 のみです。値 0 を指定すると、ズームレベルやビューポートに関係なく、地図は常に 0° の俯瞰図を使用します。値 45 を指定すると、現在のズームレベルとビューポートで 45 度画像が利用可能な場合は傾斜角度が自動的に 45 に切り替わり、45 度画像が利用できない場合は 0 に戻ります（これがデフォルトの動作です）。45° 画像は、satellite および hybrid のマップタイプでのみ、一部の地域で、一部のズームレベルでのみご利用いただけます。注: getTilt は、このオプションで指定された値ではなく、現在の傾斜角度を返します。getTilt とこのオプションは異なるものを参照するため、tilt プロパティを bind() しないでください。そうすると、予測できない影響が生じる可能性があります。
tiltInteractionEnabled optional
タイプ:  boolean optional
デフォルト: false
地図でユーザーがカメラの傾きを制御できるようにするかどうか。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
zoom optional
タイプ:  number optional
地図の初期ズームレベル。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度が高くなります。
zoomControl optional
タイプ:  boolean optional
ズーム コントロールの有効/無効状態。
zoomControlOptions optional
タイプ:  ZoomControlOptions optional
ズーム コントロールの表示オプション。

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 イベント。デベロッパーは、target、currentTarget、relatedTarget、path の各プロパティが定義され、一貫性があることを前提にすべきではありません。また、デベロッパーは 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 についてご確認ください。
継承: domEvent、 latLng
継承: stop

ColorScheme 定数

google.maps.ColorScheme 定数

地図のカラーパターンの識別子。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'FOLLOW_SYSTEM' や、google.maps.ColorScheme.FOLLOW_SYSTEM です。

const {ColorScheme} = await google.maps.importLibrary("core") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
DARK 地図のダーク カラーパターン。
FOLLOW_SYSTEM カラーパターンはシステム設定に基づいて選択されます。
LIGHT 地図のライト カラーパターン。以前の Maps JS のデフォルト値。

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 インスタンスのレジストリ。MapType ID をキーとして使用します。

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

const {MapTypeRegistry} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
MapTypeRegistry
MapTypeRegistry()
パラメータ: なし
MapTypeRegistry は、地図で使用可能なカスタムのマップタイプのコレクションを保持します。API は、たとえばコントロールで使用可能なマップタイプのリストを提供するときに、このレジストリを参照します。
set
set(id, mapType)
パラメータ: 
  • id:  string レジストリに追加する MapType の識別子。
  • mapType:  MapType|? レジストリに追加する MapType オブジェクト。
戻り値: なし
渡された文字列 ID を渡された MapType と関連付けるように、レジストリを設定します。
継承: addListener、 bindTo、 get、 notify、 setValues、 unbind、 unbindAll

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|null
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
  • map:  Map optional
戻り値: なし
指定された地図にレイヤをレンダリングします。マップが null に設定されている場合、レイヤは削除されます。
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

TrafficLayerOptions インターフェース

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

TrafficLayer で設定できるプロパティを定義するために使用される TrafficLayerOptions オブジェクト。
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|null
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
  • map:  Map optional
戻り値:  void
指定された地図にレイヤをレンダリングします。マップが null に設定されている場合、レイヤは削除されます。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

BicyclingLayer クラス

google.maps.BicyclingLayer クラス

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

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

const {BicyclingLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
BicyclingLayer
BicyclingLayer()
パラメータ: なし
自動車レーンとパスを表示し、幹線道路を目立たなくするレイヤ。
getMap
getMap()
パラメータ: なし
戻り値:  Map|null
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
  • map:  Map optional
戻り値:  void
指定された地図にレイヤをレンダリングします。マップが null に設定されている場合、レイヤは削除されます。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

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 つの点が含まれます。ベクターマップでは、ベクターマップに傾斜がある場合、このポリゴンは長方形ではなく台形になります。
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-styling と https://goo.gle/gmp-FeatureLayerIsAvailable をご覧ください。
isWebGLOverlayViewAvailable optional
タイプ:  boolean optional
true の場合、このマップは WebGLOverlayView の使用を許可するように正しく構成されています。