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>

カスタム要素:
<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 のライブラリをご覧ください。

メソッド
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 をご覧ください。

MapElementOptions インターフェース

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

MapElement に設定できるプロパティを定義するために使用される MapElementOptions オブジェクト。

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 のライブラリをご覧ください。

メソッド
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	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

MapOptions インターフェース

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

Map で設定できるプロパティを定義するために使用される MapOptions オブジェクト。