このページは Cloud Translation API によって翻訳されました。

Maps

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` の場合、地図上のアイコンはクリック可能です。
`getDatasetFeatureLayer`	注意: v=beta チャンネルでのみ使用できます。 `getDatasetFeatureLayer(datasetId)` パラメータ: `datasetId`: `string` 戻り値: `FeatureLayer` 指定された `datasetId` の `FeatureLayer` を返します。データセット ID は Google Cloud コンソールで構成する必要があります。データセット ID が地図の地図のスタイルに関連付けられていない場合、またはデータドリブンスタイル設定が利用できない場合（マップ ID、ベクタータイル、地図のスタイルで構成されたデータドリブンスタイル設定のフィーチャーレイヤまたはデータセットがない場合）、エラーがログに記録され、結果の `FeatureLayer.isAvailable` は false になります。
`getDiv`	`getDiv()` パラメータ: なし戻り値: `HTMLElement` 地図の mapDiv。
`getFeatureLayer`	`getFeatureLayer(featureType)` パラメータ: `featureType`: `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)` パラメータ: `cameraOptions`: `CameraOptions` 戻り値: なしアニメーションなしで、地図のカメラをターゲットのカメラオプションにすぐに設定します。
`panBy`	`panBy(x, y)` パラメータ: `x`: `number` 地図を x 方向に移動するピクセル数。 `y`: `number` 地図を y 方向に移動するピクセル数。戻り値: なし地図の中心を指定された距離（ピクセル単位）だけ移動します。距離が地図の幅と高さの両方よりも小さい場合、トランジションはスムーズにアニメーション化されます。地図の座標系は、西から東（x 値の場合）と北から南（y 値の場合）に増分します。
`panTo`	`panTo(latLng)` パラメータ: `latLng`: `LatLng\|LatLngLiteral` 地図の新しい中心の緯度/経度。戻り値: なし地図の中心を指定された `LatLng` に変更します。変更範囲が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション表示されます。
`panToBounds`	`panToBounds(latLngBounds[, padding])` パラメータ: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` マップをパンする境界。 `padding`: `number\|Padding optional` パディング（ピクセル単位）。数値を使用すると、4 辺すべてに同じパディングが適用されます。デフォルト値は 0 です。戻り値: なし指定された `LatLngBounds` を含むために必要な最小限の量だけ地図をパンします。`{currentMapSizeInPx} - {padding}` 内にできるだけ多くの境界が表示されるように地図がパンされることを除き、地図上の境界の位置は保証されません。ラスター地図とベクター地図のどちらの場合も、地図のズーム、傾斜、方向は変更されません。
`setCenter`	`setCenter(latlng)` パラメータ: `latlng`: `LatLng\|LatLngLiteral` 戻り値: なし
`setClickableIcons`	`setClickableIcons(value)` パラメータ: `value`: `boolean` 戻り値: なし地図アイコンをクリック可能にするかどうかを制御します。地図アイコンは、スポット（POI）を表します。地図アイコンのクリックを無効にするには、このメソッドに値 `false` を渡します。
`setHeading`	`setHeading(heading)` パラメータ: `heading`: `number` 戻り値: なし地図のコンパスの向首方向を、北からの角度で設定します。ラスター地図の場合、この方法は航空写真にのみ適用されます。
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` パラメータ: `headingInteractionEnabled`: `boolean` 戻り値: なし見出しの操作を有効にするかどうかを設定します。このオプションは、地図がベクター地図の場合にのみ有効です。コードで設定されていない場合は、地図 ID のクラウド構成が使用されます（利用可能な場合）。
`setMapTypeId`	`setMapTypeId(mapTypeId)` パラメータ: `mapTypeId`: `MapTypeId\|string` 戻り値: なし
`setOptions`	`setOptions(options)` パラメータ: `options`: `MapOptions optional` 戻り値: なし
`setRenderingType`	`setRenderingType(renderingType)` パラメータ: `renderingType`: `RenderingType` 戻り値: なし地図の現在の RenderingType を設定します。
`setStreetView`	`setStreetView(panorama)` パラメータ: `panorama`: `StreetViewPanorama optional` 地図にバインドするパノラマ。戻り値: なし `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)` 引数: `event`: `MapMouseEvent\|IconMouseEvent` このイベントは、ユーザーが地図をクリックしたときに発生します。場所アイコンがクリックされた場合を除き、クリックされた場所のプロパティを含む MapMouseEvent が返されます。場所アイコンがクリックされた場合は、場所 ID を含む IconMouseEvent が返されます。IconMouseEvent と MapMouseEvent は、IconMouseEvent にプレイス ID フィールドがある点を除いて同じです。プレイス ID が重要でない場合は、イベントを常に MapMouseEvent として扱うことができます。マーカーまたは情報ウィンドウがクリックされた場合、クリックイベントは発行されません。
`contextmenu`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、地図コンテナで DOM contextmenu イベントが発生したときに発生します。
`dblclick`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図をダブルクリックしたときに発生します。クリックイベントは、このイベントの直前に 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)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図コンテナ上にマウスオーバーすると発生します。
`mouseout`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが地図コンテナから離れると発生します。
`mouseover`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが地図コンテナ内に入ると発生します。
`projection_changed`	`function()` 引数: なしこのイベントは、投影が変更されると発生します。
`renderingtype_changed`	`function()` 引数: なしこのイベントは、renderingType が変更されたときに発生します。
`tilesloaded`	`function()` 引数: なしこのイベントは、表示されているタイルの読み込みが完了したときに発生します。
`tilt_changed`	`function()` 引数: なしこのイベントは、地図の傾斜プロパティが変更されると発生します。
`zoom_changed`	`function()` 引数: なしこのイベントは、地図のズームプロパティが変更されると発生します。
`rightclick`	非推奨: macOS でのコントロールクリックなどの使用パターンをサポートするには、代わりに `Map.contextmenu` イベントを使用してください。 `function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図を右クリックしたときに発生します。

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 ボタンを有効または無効にします。個別にオーバーライドできます。キーボード操作は無効になりません。キーボード操作は

Maps コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Map クラス

コンストラクタ

定数

プロパティ

メソッド

イベント

MapOptions インターフェース

プロパティ

Maps