Info Window

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

InfoWindow クラス

google.maps.InfoWindow クラス

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

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

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

InfoWindowOptions インターフェース

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

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

ariaLabel optional
タイプ: string optional
情報ウィンドウに割り当てる AriaLabel。
content optional
タイプ: string|Element|Text optional
情報ウィンドウに表示するコンテンツ。これは、HTML 要素、書式なしテキストの文字列、または HTML を含む文字列です。InfoWindow のサイズは、コンテンツに応じて調整されます。コンテンツの明示的なサイズを設定するには、そのサイズの 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
この InfoWindow を表示する LatLng。情報ウィンドウを情報ウィンドウで開いた場合、代わりにアンカーの位置が使用されます。
zIndex optional
タイプ: number optional
すべての InfoWindows は zIndex 順に地図上に表示され、値が大きいほど情報ウィンドウが前面に表示されます。デフォルトでは、InfoWindows は緯度の緯度に従って表示され、低い緯度の InfoWindows はより高い緯度の InfoWindows の前に表示されます。情報ウィンドウは常にマーカーの前に表示されます。

InfoWindowOpenOptions インターフェース

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

情報ウィンドウを開く方法

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