このページは 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>>` 地図に添付する追加のコントロール。コントロールを地図に追加するには、レンダリングされる `ControlPosition` に対応する `MVCArray` に、コントロールの `<div>` を追加します。
`data`	タイプ: `Data` 地図にバインドされる `Data` のインスタンス。この `Data` オブジェクトに対象物を追加すると、対象物をこの地図にわかりやすく表示できるようになります。
`mapTypes`	タイプ: `MapTypeRegistry` 文字列 ID による `MapType` インスタンスのレジストリ。
`overlayMapTypes`	タイプ: `MVCArray<MapType optional>` オーバーレイする追加のマップタイプ。オーバーレイのマップタイプは、関連付けられている基本地図の上に表示され、その順序は `overlayMapTypes` 配列での記述順序です（インデックス値が高いオーバーレイが、インデックス値が低いオーバーレイの前に表示されます）。

Methods
`fitBounds`	`fitBounds(bounds[, padding])` パラメータ: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` 表示する境界。 `padding`: `number\|Padding optional` ピクセル単位のパディング。境界は、パディングを削除した後もマップの残りの部分に収まります。数値を指定すると、四辺はすべて同じパディングになります。getBounds の結果で fitBounds をべき等にするには、ここで 0 を指定します。戻り値: なし指定された境界が含まれるようにビューポートを設定します。注: 地図が `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` 地図アイコンのクリック可能性を返します。地図アイコンはスポット（スポット）を表します。戻り値が `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` になります。
`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)` パラメータ: `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` ピクセル単位のパディング。数値を指定すると、四辺はすべて同じパディングになります。デフォルト値は 0 です。戻り値: なし指定された `LatLngBounds` を格納するのに必要な最小量で、地図をパンします。`{currentMapSizeInPx} - {padding}` 内で可能な限り多くの境界が表示されるように地図がパンされるという点を除き、境界が地図上のどこに位置するかは保証されません。ラスター地図とベクター地図のどちらの場合も、地図のズーム、傾斜、方角は変更されません。
`setCenter`	`setCenter(latlng)` パラメータ: `latlng`: `LatLng\|LatLngLiteral` 戻り値: なし
`setClickableIcons`	`setClickableIcons(value)` パラメータ: `value`: `boolean` 戻り値: なし地図アイコンをクリック可能にするかどうかを指定します。地図アイコンはスポット（スポット）を表します。地図アイコンのクリックを無効にするには、このメソッドに `false` の値を渡します。
`setHeading`	`setHeading(heading)` パラメータ: `heading`: `number` 戻り値: なし地図のコンパス方位を、北を基本方位からの度数で設定します。ラスター地図の場合、このメソッドは航空画像にのみ適用されます。
`setMapTypeId`	`setMapTypeId(mapTypeId)` パラメータ: `mapTypeId`: `MapTypeId\|string` 戻り値: なし
`setOptions`	`setOptions(options)` パラメータ: `options`: `MapOptions optional` 戻り値: なし
`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()` しないでください。予期しない結果が生じる可能性があります。
`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 コンテキストメニューイベントが発生すると発生します。
`dblclick`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図上でダブルクリックすると発生します。クリックイベントは、この直前に 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)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図コンテナ上にマウスオーバーすると発生します。
`mouseout`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが地図コンテナから離れると発生します。
`mouseover`	`function(event)` 引数: `event`: `MapMouseEvent` このイベントは、マウスが地図コンテナ内に入ると発生します。
`projection_changed`	`function()` 引数: なしこのイベントは、投影が変更されると発生します。
`renderingtype_changed`	`function()` 引数: なしこのイベントは、renderType が変更されると発生します。
`tilesloaded`	`function()` 引数: なしこのイベントは、表示可能なタイルの読み込みが完了すると発生します。
`tilt_changed`	`function()` 引数: なしこのイベントは、地図の傾斜プロパティが変更されると発生します。
`zoom_changed`	`function()` 引数: なしこのイベントは、地図のズームプロパティが変更されると発生します。
`rightclick`	非推奨: macOS で control-click などの使用パターンをサポートするには、代わりに `Map.contextmenu` イベントを使用してください。 `function(event)` 引数: `event`: `MapMouseEvent` このイベントは、ユーザーが地図上で右クリックされると発生します。

MapOptions インターフェース

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

地図に設定可能なプロパティを定義するのに使用される 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`	非推奨: 2017 年に非推奨となりました。地図上でのドラッグを無効にするには、`gestureHandling` プロパティを使用して、`"none"` に設定します。タイプ: `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 内かに応じて、協調的（cooperative）か貪欲（greedy）のいずれかになります。
`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`	非推奨: パンコントロールは 2015 年 9 月に非推奨となりました。タイプ: `boolean optional` パンコントロールの有効/無効状態。
`panControlOptions optional`	非推奨: パンコントロールは 2015 年 9 月に非推奨となりました。タイプ: `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` ベクター地図の場合、地図の表示角度を設定します。マップのズームレベルに応じて、使用できる値が制限されます。ラスター地図の場合、地図の表示角度の自動切り替え動作を制御します。指定できる値は `0` と `45` のみです。値 `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 のライブラリをご覧ください。

プロパティ
`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` の位置に配置します。

Methods
`addEventListener`	注意: v=beta チャネルでのみご利用いただけます。 `addEventListener(type, listener[, options])` パラメータ: `type`: `string` リッスンするイベントタイプを表す文字列（大文字と小文字を区別）。 `listener`: `EventListener\|EventListenerObject` 通知を受け取るオブジェクト。これは、handleEvent メソッドを使用する関数またはオブジェクトである必要があります `options`: `boolean\|AddEventListenerOptions optional` オプションをご覧ください。カスタムイベントは、`capture` と `passive` のみをサポートします。戻り値: `void` 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener を参照
`removeEventListener`	注意: v=beta チャネルでのみご利用いただけます。 `removeEventListener(type, listener[, options])` パラメータ: `type`: `string` イベントリスナーを削除するイベントのタイプを指定する文字列。 `listener`: `EventListener\|EventListenerObject` イベントターゲットから削除するイベントハンドラのイベントリスナー。 `options`: `boolean\|EventListenerOptions optional` オプションをご覧ください戻り値: `void` 以前に addEventListener で登録されたイベントリスナーをターゲットから削除します。removeEventListener をご覧ください。

Methods

addEventListener

addEventListener(type, listener[, options])

パラメータ:

type: string リッスンするイベントタイプを表す文字列（大文字と小文字を区別）。
listener: EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを使用する関数またはオブジェクトである必要があります
options: boolean|AddEventListenerOptions optional オプションをご覧ください。カスタムイベントは、capture と passive のみをサポートします。

戻り値: void

指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener を参照

removeEventListener

removeEventListener(type, listener[, options])

パラメータ:

type: string イベントリスナーを削除するイベントのタイプを指定する文字列。
listener: EventListener|EventListenerObject イベントターゲットから削除するイベントハンドラのイベントリスナー。
options: boolean|EventListenerOptions optional オプションをご覧ください

戻り値: void

以前に addEventListener で登録されたイベントリスナーをターゲットから削除します。removeEventListener をご覧ください。

イベント
`gmp-zoomchange`	`function(event)` 引数: `event`: `ZoomChangeEvent` このイベントは、地図のズームプロパティが変更されると発生します。

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`	タイプ: `MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` 対応するネイティブ DOM イベント。デベロッパーは、`target`、`currentTarget`、`relatedTarget`、`path` の各プロパティが定義されていて、一貫性がある状態を前提とすべきではありません。また、Maps API の内部実装の DOM 構造に依存しないようにしてください。内部イベントマッピングのため、`domEvent` のセマンティクスは `MapMouseEvent` と異なる場合があります（たとえば、`MapMouseEvent` の「クリック」の `domEvent` は `KeyboardEvent` 型です）。
`latLng optional`	タイプ: `LatLng optional` イベント発生時にカーソルの下にあった緯度と経度。

プロパティ

domEvent

タイプ: MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

対応するネイティブ DOM イベント。デベロッパーは、target、currentTarget、relatedTarget、path の各プロパティが定義されていて、一貫性がある状態を前提とすべきではありません。また、Maps API の内部実装の DOM 構造に依存しないようにしてください。内部イベントマッピングのため、domEvent のセマンティクスは MapMouseEvent と異なる場合があります（たとえば、MapMouseEvent の「クリック」の domEvent は KeyboardEvent 型です）。

latLng optional

タイプ: LatLng optional

イベント発生時にカーソルの下にあった緯度と経度。

Methods
`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`

Methods
継承: `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 は、たとえばコントロール内で使用可能なマップタイプのリストを提供する際に、このレジストリを参照します。

Methods
`set`	`set(id, mapType)` パラメータ: `id`: `string` レジストリに追加する MapType の ID。 `mapType`: レジストリに追加する `MapType\|` MapType オブジェクト。戻り値:* なし渡された文字列 ID を渡された MapType と関連付けるように、レジストリを設定します。
継承: `addListener`、 `bindTo`、 `get`、 `notify`、 `setValues`、 `unbind`、 `unbindAll`

MapRestriction インターフェース

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

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

プロパティ
`latLngBounds`	タイプ: `LatLngBounds\|LatLngBoundsLiteral` 設定すると、ユーザーは指定された境界内でのみパンとズームを行うことができます。境界では、経度と緯度の両方を制限することも、緯度のみを制限することもできます。緯度のみの境界には、西経と東経をそれぞれ -180 と 180 を使用します（例: `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`）。
`strictBounds optional`	タイプ: `boolean optional` 境界は、`strictBounds` フラグを `true` に設定することで制限をかけることができます。これにより、ユーザーがズームアウトできる範囲が狭まり、制限された境界の外側にあるものはすべて非表示になります。デフォルト値は `false` です。つまり、ユーザーは境界領域全体がビュー内に表示されるまでズームアウトできます（境界領域外の領域も含まれる場合があります）。

プロパティ

latLngBounds

タイプ: LatLngBounds|LatLngBoundsLiteral

設定すると、ユーザーは指定された境界内でのみパンとズームを行うことができます。境界では、経度と緯度の両方を制限することも、緯度のみを制限することもできます。緯度のみの境界には、西経と東経をそれぞれ -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])` パラメータ: `opts`: `TrafficLayerOptions optional` 現在の道路渋滞状況を表示するレイヤ。

Methods
`getMap`	`getMap()` パラメータ: なし戻り値: `Map` このレイヤが表示される地図を返します。
`setMap`	`setMap(map)` パラメータ: `map`: `Map` 戻り値: なし指定された地図にレイヤをレンダリングします。地図が `null` に設定されている場合、レイヤは削除されます。
`setOptions`	`setOptions(options)` パラメータ: `options`: `TrafficLayerOptions` 戻り値: なし
継承: `addListener`、 `bindTo`、 `get`、 `notify`、 `set`、 `setValues`、 `unbind`、 `unbindAll`

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()` パラメータ: なし交通機関の路線を表示するレイヤ。

Methods
`getMap`	`getMap()` パラメータ: なし戻り値: `Map` このレイヤが表示される地図を返します。
`setMap`	`setMap(map)` パラメータ: `map`: `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()` パラメータ: なし自動車レーンとパスを表示し、幹線道路を目立たなくするレイヤ。

Methods
`getMap`	`getMap()` パラメータ: なし戻り値: `Map` このレイヤが表示される地図を返します。
`setMap`	`setMap(map)` パラメータ: `map`: `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-styling と https://goo.gle/gmp-FeatureLayerIsAvailable をご覧ください。

Maps

Map クラス

コンストラクタ

定数

プロパティ

Methods

イベント

MapOptions インターフェース

プロパティ

MapElement クラス

プロパティ

スロット

Methods

イベント

MapElementOptions インターフェース

プロパティ

ZoomChangeEvent クラス

MapTypeStyle インターフェース

プロパティ

MapMouseEvent インターフェース

プロパティ

Methods

IconMouseEvent インターフェース

プロパティ

Methods

MapTypeId 定数

定数

MapTypeRegistry クラス

コンストラクタ

Methods

MapRestriction インターフェース

プロパティ

TrafficLayer クラス

コンストラクタ

Methods

TrafficLayerOptions インターフェース

プロパティ

TransitLayer クラス

コンストラクタ

Methods

BicyclingLayer クラス

コンストラクタ

Methods

CameraOptions インターフェース

プロパティ

VisibleRegion インターフェース

プロパティ

RenderingType 定数

定数

MapCapabilities インターフェース

プロパティ