Info Window

InfoWindow クラス

google.maps.InfoWindow クラス

バブルのように表示されるオーバーレイで、多くの場合マーカーに接続されています。

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

const {InfoWindow} = await google.maps.importLibrary("maps") または const {InfoWindow} = await google.maps.importLibrary("streetView") を呼び出してアクセスします。詳しくは、Maps JavaScript API のライブラリをご覧ください。
InfoWindow
InfoWindow([opts])
パラメータ: 
指定されたオプションで情報ウィンドウを作成します。情報ウィンドウは、オプションで指定された内容に応じて、地図上の特定の位置またはマーカーの上に配置できます。自動パンが無効になっていない限り、情報ウィンドウは、開いているときに地図のウィンドウをパンして表示されます。情報ウィンドウを作成した後、地図上に表示するために open を呼び出す必要があります。ユーザーは情報ウィンドウの閉じるボタン [X] をクリックして地図から情報ウィンドウを削除できます。またはデベロッパーが close() を呼び出しても同じことです。
close
close()
パラメータ: なし
戻り値: None
DOM 構造から削除して、この情報ウィンドウを閉じます。
focus
focus()
パラメータ: なし
戻り値: None
この InfoWindow にフォーカスを設定します。フォーカスを設定する前に、このメソッドを visible イベントとともに使用して、InfoWindow が表示されるようにすることをおすすめします。表示されていない InfoWindow はフォーカスできません。
getContent
getContent()
パラメータ: なし
戻り値:  string|Element|Text|null|undefined この情報ウィンドウのコンテンツ。以前にコンテンツとして設定したものと同じです。
getPosition
getPosition()
パラメータ: なし
戻り値:  LatLng|null|undefined この情報ウィンドウの LatLng の位置。
getZIndex
getZIndex()
パラメータ: なし
戻り値:  number この情報ウィンドウの zIndex。
open
open([options, anchor])
パラメータ: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional InfoWindowOpenOptions オブジェクト（推奨）か、この情報ウィンドウをレンダリングする map|jpg のいずれか。
  • anchor:  MVCObject|AdvancedMarkerElement optional この情報ウィンドウを配置するアンカー。アンカーが null でない場合、情報ウィンドウはアンカーの上部中央に配置されます。情報ウィンドウは、アンカー（利用可能な場合）と同じ地図またはパノラマにレンダリングされます。
戻り値: None
指定された地図上でこの情報ウィンドウを開きます。必要に応じて、情報ウィンドウをアンカーに関連付けることができます。コア API のアンカーは Marker クラスのみです。ただし、アンカーには、pixelOffset を計算するための LatLng position プロパティと、オプションで Point anchorPoint プロパティを公開する InfoVC オプションを指定できます（InfoWindowOptions を参照）。anchorPoint は、アンカーの位置から情報ウィンドウの先端までのオフセットです。このメソッドの単一の引数として InfoWindowOpenOptions インターフェースを使用することをおすすめします。ブラウザのフォーカスが開いたままにならないようにするには、InfoWindowOpenOptions.shouldFocus を false に設定します。
setContent
setContent([content])
パラメータ: 
  • content:  string|Element|Text optional この情報ウィンドウによって表示されるコンテンツ。
戻り値: None
setOptions
setOptions([options])
パラメータ: 
戻り値: None
setPosition
setPosition([position])
パラメータ: 
  • position:  LatLng|LatLngLiteral optional この情報ウィンドウを表示する LatLng の位置。
戻り値: None
setZIndex
setZIndex(zIndex)
パラメータ: 
  • zIndex:  number この情報ウィンドウの Z-Index。Z-Index が大きい InfoWindow が、Z-Index がより低い他のすべての情報ウィンドウの前に表示されます。
戻り値: None
継承済み: addListener、 bindTo、 get、 notify、set、setValues、unbind、 unbindAll
closeclick
function()
引数: なし
このイベントは、閉じるボタン [X] がクリックされると発生します。
content_changed
function()
引数: なし
このイベントは、コンテンツ プロパティが変更されると発生します。
domready
function()
引数: なし
このイベントは、InfoWindow のコンテンツを含む <div> が DOM に接続されているときに発生します。情報ウィンドウのコンテンツを動的に作成している場合は、このイベントを監視できます。
position_changed
function()
引数: なし
このイベントは、position プロパティが変更されると発生します。
visible
function()
引数: なし
このイベントは、InfoWindow が完全に表示されたときに発生します。InfoWindow をパンして画面に戻ったとき、このイベントは呼び出されません。
zindex_changed
function()
引数: なし
このイベントは、InfoWindow の zIndex が変更されると発生します。

InfoWindowOptions インターフェース

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

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
すべての InfoWindows は zIndex の順で表示され、値が大きいと、情報ウィンドウが前面に表示されます。デフォルトでは、InfoWindows は緯度に従って表示され、低い緯度の InfoWindows はより高い緯度の InfoWindows の前に表示されます。情報ウィンドウは常にマーカーの前に表示されます。

InfoWindowOpenOptions インターフェース

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

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