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() を呼び出しても同じことです。 |
Methods | |
---|---|
close |
close() パラメータ: なし
戻り値: None
DOM 構造から削除して、この情報ウィンドウを閉じます。 |
focus |
focus() パラメータ: なし
戻り値: None
この InfoWindow にフォーカスを設定します。このメソッドを visible イベントと併用して、フォーカスを設定する前に InfoWindow を表示することをおすすめします。表示されていない InfoWindow はフォーカスできません。 |
getContent |
getContent() パラメータ: なし
|
getPosition |
getPosition() パラメータ: なし
戻り値:
LatLng|null|undefined : この情報ウィンドウの LatLng の位置。 |
getZIndex |
getZIndex() パラメータ: なし
戻り値:
number この情報ウィンドウの zIndex。 |
open |
open([options, anchor]) パラメータ:
戻り値: None
指定した地図上でこの情報ウィンドウを開きます。必要に応じて、情報ウィンドウをアンカーに関連付けることができます。コア API では、唯一のアンカーは Marker クラスです。ただし、アンカーは、LatLng の position プロパティと、必要に応じて pixelOffset を計算するためにポイント anchorPoint プロパティを公開する任意の MVCObject を指定できます(InfoWindowOptions を参照)。anchorPoint は、アンカーの位置から情報ウィンドウの先端までのオフセットです。このメソッドの単一の引数として InfoWindowOpenOptions インターフェースを使用することをおすすめします。ブラウザ フォーカスが開かないように変更するには、InfoWindowOpenOptions.shouldFocus を false に設定します。 |
setContent |
setContent([content]) 戻り値: None
|
setOptions |
setOptions([options]) パラメータ:
戻り値: None
|
setPosition |
setPosition([position]) パラメータ:
戻り値: None
|
setZIndex |
setZIndex(zIndex) パラメータ:
戻り値: None
|
継承:
addListener 、
bindTo 、
get 、
notify 、
set 、
setValues 、
unbind 、
unbindAll
|
イベント | |
---|---|
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 |
情報ウィンドウに表示するコンテンツです。これは、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 に設定されている場合は、ヒューリスティックを使用してフォーカスを移動するかどうかを決定します。ヒューリスティックは変更される可能性があり、すべてのユースケースで適切に機能しない可能性があるため、このプロパティは必要に応じて明示的に設定することをおすすめします。 |