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
タイプ:  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 境界。
  • paddingnumber|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)
パラメータ: 
  • 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 のクラウド構成が使用されます(利用可能な場合)。
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)
パラメータ: 
  • 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)
パラメータ: