Maps

マップ クラス

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
タイプ:  Array<MVCArray<HTMLElement>>
地図に添付する追加のコントロール。地図にコントロールを追加するには、コントロールの <div> を、レンダリングされる ControlPosition に対応する MVCArray に追加します。
data
タイプ:  Data
地図にバインドされている Data のインスタンス。この Data オブジェクトに対象物を追加して、この地図で簡単に表示できるようにします。
mapTypes
タイプ:  MapTypeRegistry
文字列 ID 別の MapType インスタンスのレジストリ。
overlayMapTypes
タイプ:  MVCArray<MapType optional>
オーバーレイする追加のマップタイプ。オーバーレイのマップタイプは、関連付けられている基本地図の上に、overlayMapTypes 配列での順番で表示されます(インデックス値が大きいオーバーレイは、インデックス値が小さいオーバーレイより前に表示されます)。
fitBounds
fitBounds(bounds[, padding])
パラメータ: 
  • boundsLatLngBounds|LatLngBoundsLiteral 表示する境界。
  • paddingnumber|Padding optional ピクセル単位のパディング。境界は、パディングが削除された後も地図に残った部分に収まります。数値では、上下左右に同じパディングが作成されます。getBounds の結果に対して fitBounds をべき等にするには、ここに 0 を指定します。
戻り値: なし
指定された境界が含まれるようにビューポートを設定します。
注: 地図が display: none に設定されている場合、fitBounds 関数は地図のサイズを 0x0 と読み取って何も行いません。地図が非表示のときにビューポートを変更するには、地図を visibility: hidden に設定して、地図の div を実際のサイズにします。ベクターマップの場合、このメソッドは地図の傾斜と方角をデフォルトのゼロ値に設定します。このメソッドを呼び出すと、境界に収まるように地図がパンおよびズームされるため、スムーズなアニメーションが発生する場合があります。このメソッドがアニメーション化するかどうかは、内部ヒューリスティックによって異なります。
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 になります。
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
パラメータ: なし
戻り値:  boolean|null
見出し操作が有効かどうかを返します。このオプションは、地図がベクターマップの場合にのみ有効になります。コードで設定されていない場合、マップ ID のクラウド設定が使用されます(利用可能な場合)。
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)
パラメータ: 
  • xnumber 地図を x 方向に動かすピクセル数。
  • ynumber 地図を y 方向に移動するピクセル数。
戻り値: なし
ピクセル単位で指定された距離だけ、地図の中心を変更します。距離が地図の幅と高さの両方より小さい場合、遷移はスムーズにアニメーション表示されます。地図の座標系は、x 値の場合は西から東に(y 値の場合は)北から南に増加します。
panTo
panTo(latLng)
パラメータ: 
戻り値: なし
地図の中心を指定された LatLng に変更します。変更範囲が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション表示されます。
panToBounds
panToBounds(latLngBounds[, padding])
パラメータ: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral 地図をパンする境界。
  • paddingnumber|Padding optional ピクセル単位のパディング。数値では、上下左右に同じパディングが作成されます。デフォルト値は 0 です。
戻り値: なし
指定された LatLngBounds を含めるために必要な最小量だけ地図を移動します。地図上で境界がどこにあるかは保証されませんが、{currentMapSizeInPx} - {padding} 内で可能な限り多くの境界が表示されるように地図がパンされます。ラスター地図とベクター地図のどちらでも、地図のズーム、傾斜、方角は変更されません。
setCenter
setCenter(latlng)
パラメータ: 
戻り値: なし
setClickableIcons
setClickableIcons(value)
パラメータ: 
  • valueboolean
戻り値: なし
地図アイコンをクリック可能にするかどうかを指定します。地図アイコンはスポット(スポット)を表します。地図アイコンのクリックを無効にするには、このメソッドに値 false を渡します。
setHeading
setHeading(heading)
パラメータ: 
  • headingnumber
戻り値: なし
地図のコンパス方角を北の基本方向からの度数で設定します。ラスター地図の場合、このメソッドは航空画像にのみ適用されます。
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
パラメータ: 
  • headingInteractionEnabledboolean
戻り値: なし
見出しの操作を有効にするかどうかを設定します。このオプションは、地図がベクターマップの場合にのみ有効になります。コードで設定されていない場合、マップ ID のクラウド設定が使用されます(利用可能な場合)。
setMapTypeId
setMapTypeId(mapTypeId)
パラメータ: 
戻り値: なし
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setRenderingType
setRenderingType(renderingType)
パラメータ: 
戻り値: なし
地図の現在の RenderingType を設定します。
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() しないでください。予期しない結果が生じる可能性があります。
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
パラメータ: 
  • tiltInteractionEnabledboolean
戻り値: なし
傾斜操作を有効にするかどうかを設定します。このオプションは、地図がベクターマップの場合にのみ有効になります。コードで設定されていない場合、マップ ID のクラウド設定が使用されます(利用可能な場合)。
setZoom
setZoom(zoom)
パラメータ: 
  • zoomnumber ズームの値が大きいほど、解像度が高くなります。
戻り値: なし
地図のズームを設定します。
継承: 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 コンテキスト メニュー イベントが発生すると発生します。
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 の場合、地図アイコンはクリックできません。地図アイコンはスポット(スポット)を表します。
BetacolorScheme optional
タイプ:  ColorScheme|string optional
デフォルト: ColorScheme.LIGHT
地図の初期カラーパターン。このオプションは、地図が初期化されたときのみ設定できます。
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
航空画像の向き(基本方角から時計回りに測定した度数)。方位は、画像を表示できる最も近い角度に合わせられます。
headingInteractionEnabled optional
タイプ:  boolean optional
デフォルト: false
地図でカメラ方角(回転)の制御をユーザーに許可するかどうかを指定します。このオプションは、地図がベクターマップの場合にのみ有効になります。コードで設定されていない場合、マップ 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。パノラマが指定されていない場合、ペグマンがドロップされると、デフォルトの StreetViewPanorama が地図の div に表示されます。
streetViewControl optional
タイプ:  boolean optional
ストリートビューのペグマン コントロールの有効/無効の初期状態。このコントロールはデフォルトの UI の一部であり、ストリートビューの道路オーバーレイを表示すべきでないマップタイプ(Earth 以外のマップタイプなど)を表示する場合は、false に設定する必要があります。
streetViewControlOptions optional
タイプ:  StreetViewControlOptions optional
ストリートビューでペグマン コントロールの最初の表示オプション。
styles optional
タイプ:  Array<MapTypeStyle> optional
各デフォルトのマップタイプに適用するスタイル。satellite モード、hybrid モード、terrain モードの場合、これらのスタイルはラベルとジオメトリにのみ適用されます。マップ ID を使用している場合やベクターマップを使用している場合、この機能は使用できません(代わりに Cloud ベースのマップのスタイル設定を使用してください)。
tilt optional
タイプ:  number optional
ベクターマップの場合、地図の表示角を設定します。使用できる値は、地図のズームレベルに応じて制限されます。ラスター地図の場合、地図の表示角度の自動切り替え動作を制御します。指定できる値は 045 のみです。値 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
ズーム コントロールの表示オプション。

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 を使用し、innerMap プロパティを使用してアクセスできます。

カスタム要素:
<gmp-map center="lat,lng" heading-interaction-disabled 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 への参照。
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
カスタム要素を使用して、Maps JavaScript Web Components の周囲に再利用可能なコンポーネント(AdvancedMarkerElement など)を作成できます。デフォルトでは、MapElement に直接追加されたカスタム要素は MapPanes.overlayMouseTarget にスロットリングされ、レンダリングされます。ただし、Maps JavaScript API Web Components は MapElement の内部スロットに再スロットされる場合があります。
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
MapElement.center をご覧ください。
headingInteractionDisabled optional
タイプ:  boolean optional
MapElement.headingInteractionDisabled をご覧ください。
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 のライブラリをご覧ください。

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 の「クリック」は KeyboardEvent 型の domEvent になります)。
latLng optional
タイプ:  LatLng optional
イベントが発生したときにカーソルより下にあった緯度と経度。
stop
stop()
パラメータ: なし
戻り値:  void
このイベントがそれ以上伝播されないようにします。

IconMouseEvent インターフェース

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

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

このインターフェースは MapMouseEvent

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

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

継承: 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 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 と関連付けるように、レジストリを設定します。
継承: 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
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が 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
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が 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
このレイヤが表示される地図を返します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が 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 辺ポリゴンを定義する 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 をご覧ください。
isWebGLOverlayViewAvailable optional
タイプ:  boolean optional
true の場合、この地図は WebGLOverlayView で使用できるように適切に設定されています。