Info Window

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

InfoWindow クラス

google.maps.InfoWindow クラス

バブルのように見えるオーバーレイで、多くの場合マーカーにつながっています。

このクラスは MVCObject を拡張します。

v=beta を使用している場合は、const {InfoWindow} = await google.map.importLibrary("maps") または const {InfoWindow} = await google.map.importLibrary("streetView") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

InfoWindow
InfoWindow([opts])
パラメータ:
指定されたオプションで情報ウィンドウを作成します。InfoWindow は、オプションの指定内容に応じて、地図上の特定の位置またはマーカーより上に配置できます。自動パンが無効になっている場合を除き、情報ウィンドウが開いているときに情報ウィンドウが表示されるように地図をパンします。情報ウィンドウを作成したら、open を呼び出して地図上に表示します。ユーザーは情報ウィンドウの閉じるボタン [X] をクリックして地図から情報ウィンドウを削除できます。またはデベロッパーが close() を呼び出しても同じことです。
close
close()
パラメータ: なし
戻り値: None
DOM 構造から削除して、この情報ウィンドウを閉じます。
focus
focus()
パラメータ: なし
戻り値: None
この InfoWindow にフォーカスを設定します。このメソッドを visible イベントと併用して、フォーカスを設定する前に InfoWindow を表示することをおすすめします。表示されていない InfoWindow はフォーカスできません。
getContent
getContent()
パラメータ: なし
戻り値: string|Element|null|Text|undefined この情報ウィンドウのコンテンツ。以前にコンテンツとして設定したものと同じです。
getPosition
getPosition()
パラメータ: なし
戻り値: LatLng|null|undefined: この情報ウィンドウの LatLng の位置。
getZIndex
getZIndex()
パラメータ: なし
戻り値: number この情報ウィンドウの zIndex。
open
open([options, anchor])
パラメータ:
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional InfoWindowOpenOptions オブジェクト(推奨)か、この情報ウィンドウをレンダリングする地図|パノラマ。
  • anchor: MVCObject|AdvancedMarkerView optional この情報ウィンドウを配置するアンカー。アンカーが null 以外の場合、情報ウィンドウはアンカーの上部中央に配置されます。情報ウィンドウは、アンカー(使用可能な場合)と同じ地図またはパノラマにレンダリングされます。
戻り値: None
指定した地図上でこの情報ウィンドウを開きます。必要に応じて、情報ウィンドウをアンカーに関連付けることができます。コア API では、唯一のアンカーは Marker クラスです。ただし、アンカーは、LatLng の position プロパティと、必要に応じて pixelOffset を計算するためにポイント anchorPoint プロパティを公開する任意の MVCObject を指定できます(InfoWindowOptions を参照)。anchorPoint は、アンカーの位置から情報ウィンドウの先端までのオフセットです。このメソッドの単一の引数として InfoWindowOpenOptions インターフェースを使用することをおすすめします。ブラウザ フォーカスが開かないように変更するには、InfoWindowOpenOptions.shouldFocusfalse に設定します。
setContent
setContent([content])
パラメータ:
  • contentstring|Element|Text optional この情報ウィンドウで表示されるコンテンツ。
戻り値: None
setOptions
setOptions([options])
パラメータ:
戻り値: None
setPosition
setPosition([position])
パラメータ:
  • positionLatLng|LatLngLiteral optionalこの情報ウィンドウを表示する LatLng 位置。
戻り値: None
setZIndex
setZIndex(zIndex)
パラメータ:
  • zIndexnumber この情報ウィンドウの Z-Index。Z-Index が大きい情報ウィンドウは、Z-Index が低い他の情報ウィンドウよりも先に表示されます。
戻り値: None
継承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
closeclick
function()
引数: なし
このイベントは、閉じるボタン [X] がクリックされると発生します。
content_changed
function()
引数: なし
このイベントは、content プロパティが変更されると発生します。
domready
function()
引数: なし
このイベントは、InfoWindow のコンテンツを含む <div> が DOM にアタッチされたときに発生します。情報ウィンドウのコンテンツを動的に作成している場合は、このイベントを監視できます。
position_changed
function()
引数: なし
このイベントは、位置プロパティが変更されると発生します。
visible
function()
引数: なし
このイベントは、InfoWindow が完全に表示されると発生します。InfoWindow がパンで戻され、画面に戻ったときに、このイベントは呼び出されません。
zindex_changed
function()
引数: なし
このイベントは、InfoWindow の zIndex が変更されると発生します。

InfoWindowOptions インターフェース

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

情報ウィンドウで設定できるプロパティを定義するために使用される InfoWindowOptions オブジェクト。

ariaLabel optional
タイプ: string optional
情報ウィンドウに割り当てる AriaLabel。
content optional
タイプ: string|Element|Text optional
情報ウィンドウに表示するコンテンツです。これは、HTML 要素、書式なしテキストの文字列、または HTML を含む文字列です。情報ウィンドウのサイズはコンテンツに応じて決まります。コンテンツの明示的なサイズを設定するには、コンテンツをそのサイズの HTML 要素に設定します。
disableAutoPan optional
タイプ: boolean optional
デフォルト: false
地図のパンを無効にして、情報ウィンドウを開いたときに完全に表示されるようにしました。
maxWidth optional
タイプ: number optional
情報ウィンドウの最大幅(コンテンツの幅に関係なく)。この値は、open() の呼び出し前に設定される場合にのみ考慮されます。コンテンツを変更する際に最大幅を変更するには、close()setOptions()open() の順に呼び出します。
minWidth optional
タイプ: number optional
情報ウィンドウの幅(コンテンツの幅に関係なく)。このプロパティを使用する場合は、minWidth を地図の幅(ピクセル単位)よりも小さい値に設定することを強くおすすめします。この値は、open() の呼び出し前に設定される場合にのみ考慮されます。コンテンツの最小幅を変更するには、close()setOptions()open() の順に呼び出します。
pixelOffset optional
タイプ: Size optional
情報ウィンドウが固定されている地理的座標の地図上の地点から情報ウィンドウの先端までのオフセット(ピクセル単位)。アンカーを使用して情報ウィンドウが開いている場合、pixelOffset はアンカーの anchorPoint プロパティから計算されます。
position optional
タイプ: LatLng|LatLngLiteral optional
この情報ウィンドウを表示する LatLng。アンカーを使用して情報ウィンドウを開いている場合は、代わりにアンカーの位置が使用されます。
zIndex optional
タイプ: number optional
すべての情報ウィンドウは、zIndex の順で地図上に表示されます。つまり、大きい値が、低い値を持つ情報ウィンドウより前に表示されます。デフォルトでは、InfoWindows は緯度の値に基づいて表示されます。一方、情報ウィンドウは低い緯度を指定すると、情報ウィンドウよりも前面に表示されます。情報ウィンドウは常にマーカーの前に表示されます。

InfoWindowOpenOptions インターフェース

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

情報ウィンドウを開くオプション

anchor optional
タイプ: MVCObject|AdvancedMarkerView optional
この情報ウィンドウを配置するアンカー。アンカーが null 以外の場合、情報ウィンドウはアンカーの上部中央に配置されます。情報ウィンドウは、アンカー(使用可能な場合)と同じ地図またはパノラマにレンダリングされます。
map optional
タイプ: Map|StreetViewPanorama optional
この情報ウィンドウをレンダリングする地図またはパノラマ。
shouldFocus optional
タイプ: boolean optional
情報ウィンドウが開かれたときに、そのウィンドウ内でフォーカスを移動するかどうかを指定します。このプロパティが設定されていない場合、または null または undefined に設定されている場合は、ヒューリスティックを使用してフォーカスを移動するかどうかを決定します。ヒューリスティックは変更される可能性があり、すべてのユースケースで適切に機能しない可能性があるため、このプロパティは必要に応じて明示的に設定することをおすすめします。