Map3DElement クラス
google.maps.maps3d.Map3DElement
クラス
Map3DElement は、3D 地図ビューの HTML インターフェースです。3D 地図のレンダリングを開始するには、mode
を設定する必要があります。
カスタム要素:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>
このクラスは HTMLElement
を拡張します。
このクラスは Map3DElementOptions
を実装します。
const {Map3DElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Map3DElement |
Map3DElement([options]) パラメータ:
|
プロパティ | |
---|---|
bounds |
タイプ:
LatLngBounds|LatLngBoundsLiteral optional 設定すると、カメラの位置が指定された緯度/経度の境界内に制限されます。境界外のオブジェクトもレンダリングされることに注意してください。境界では、経度と緯度の両方を制限することも、緯度または経度のいずれか一方のみを制限することもできます。緯度のみの境界には、それぞれ -180 と 180 の西経度と東経度を使用します。経度のみの境界には、それぞれ 90 と -90 の北緯と南緯を使用します。 |
center |
タイプ:
LatLngAltitude|LatLngAltitudeLiteral optional 地図の中心。LatLngAltitude として指定します。高度は地表からのメートル単位です。
range フィールドは地図の中心からのカメラの距離に影響するため、必ずしもカメラの位置がこの場所にあるとは限りません。設定しない場合、デフォルトで {lat: 0, lng: 0, altitude: 63170000} になります。63170000 メートルは、許容される最大高度です(地球の半径に 10 を掛けた値)。HTML 属性:
|
defaultUIDisabled |
タイプ:
boolean optional デフォルト:
false true の場合、デフォルトの UI ボタンはすべて無効になります。キーボードとジェスチャー操作を無効にしません。HTML 属性:
|
heading |
タイプ:
number optional 地図のコンパス方位(度数)。真北は 0 です。傾きがない場合、ロールはすべて見出しとして解釈されます。
HTML 属性:
|
maxAltitude |
タイプ:
number optional 地図に表示される地表からの最大高度。有効な値は
0 ~63170000 メートル(地球の半径に 10 を掛けた値)です。HTML 属性:
|
maxHeading |
タイプ:
number optional 地図の向き(回転)の最大角度。有効な値は
0 ~360 度です。minHeading と maxHeading は、見出しジェスチャーが許可される <= 360 度の範囲を表します。minHeading = 180 と maxHeading = 90 を使用すると、[0, 90] の見出しと [180, 360] の見出しが許可されます。minHeading = 90 と maxHeading = 180 を使用すると、[90, 180] で見出しを使用できます。HTML 属性:
|
maxTilt |
タイプ:
number optional マップの最大入射角。有効な値は
0 ~90 度です。HTML 属性:
|
minAltitude |
タイプ:
number optional 地図に表示される地上からの最小高度。有効な値は
0 ~63170000 メートル(地球の半径に 10 を掛けた値)です。HTML 属性:
|
minHeading |
タイプ:
number optional 地図の向き(回転)の最小角度。有効な値は
0 ~360 度です。minHeading と maxHeading は、見出しジェスチャーが許可される <= 360 度の範囲を表します。minHeading = 180 と maxHeading = 90 を使用すると、[0, 90] の見出しと [180, 360] の見出しが許可されます。minHeading = 90 と maxHeading = 180 を使用すると、[90, 180] で見出しを使用できます。HTML 属性:
|
minTilt |
タイプ:
number optional マップの最小入射角。有効な値は
0 ~90 度です。HTML 属性:
|
mode |
タイプ:
MapMode optional 地図のレンダリング モードを指定します。設定されていない場合、地図はレンダリングされません。
HTML 属性:
|
range |
タイプ:
number optional カメラから地図の中心までの距離(メートル単位)。
HTML 属性:
|
roll |
タイプ:
number optional ビュー ベクトルを中心としたカメラのロール(度数)。曖昧さを解消するため、傾斜がない場合、ロールはすべて見出しとして解釈されます。
HTML 属性:
|
tilt |
タイプ:
number optional カメラのビュー ベクトルの傾斜(度単位)。地球を真上から見下ろすビューベクトルは、傾斜が 0 度になります。地球から離れる方向を指すビュー ベクトルの傾斜は
180 度になります。HTML 属性:
|
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
flyCameraAround |
flyCameraAround(options) パラメータ:
戻り値: なし
このメソッドは、指定された時間、指定された回数だけ、指定された場所を中心にカメラを回転させます。 デフォルトでは、カメラは時計回りに回転します。ラウンドに負の数が指定された場合、カメラは反時計回りに周回します。 アニメーションは地図が最小限読み込まれた後にのみ開始できるため、このメソッドは非同期です。アニメーションが開始されると、メソッドは戻ります。 ラウンド数が 0 の場合、スピンは発生せず、アニメーションは開始直後に完了します。 |
flyCameraTo |
flyCameraTo(options) パラメータ:
戻り値: なし
このメソッドは、指定された期間にわたって、現在の位置から指定された終了位置までカメラを放物線状に移動させます。 アニメーションは地図が最小限読み込まれた後にのみ開始できるため、このメソッドは非同期です。アニメーションが開始されると、メソッドは戻ります。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
stopCameraAnimation |
stopCameraAnimation() パラメータ: なし
戻り値: なし
このメソッドは、実行中のフライ アニメーションを停止します。カメラはアニメーションの途中で停止し、終点にテレポートすることはありません。 アニメーションは地図が最小限の量を読み込んだ後にのみ開始または停止できるため、このメソッドは非同期です。アニメーションが停止すると、メソッドが返されます。 |
イベント | |
---|---|
gmp-animationend |
function(animationEndEvent) 引数:
このイベントは、フライ アニメーションが終了したときに発生します。このイベントは DOM ツリーをバブリングします。 |
gmp-centerchange |
function(centerChangeEvent) 引数:
このイベントは、Map3DElement の center プロパティが変更されたときに発生します。 |
gmp-click |
function(clickEvent) 引数:
このイベントは、 Map3DElement 要素がクリックされたときに発生します。 |
gmp-headingchange |
function(headingChangeEvent) 引数:
このイベントは、Map3DElement の heading プロパティが変更されたときに発生します。 |
gmp-rangechange |
function(rangeChangeEvent) 引数:
このイベントは、Map3DElement の range プロパティが変更されたときに発生します。 |
gmp-rollchange |
function(rollChangeEvent) 引数:
このイベントは、Map3DElement の roll プロパティが変更されたときに発生します。 |
gmp-steadychange |
function(steadyChangeEvent) 引数:
このイベントは、 Map3DElement の定常状態が変化したときに発生します。 |
gmp-tiltchange |
function(tiltChangeEvent) 引数:
このイベントは、Map3DElement の傾斜プロパティが変更されたときに発生します。 |
Map3DElementOptions インターフェース
google.maps.maps3d.Map3DElementOptions
インターフェース
Map3DElement で設定できるプロパティを定義するために使用される Map3DElementOptions オブジェクト。
プロパティ | |
---|---|
bounds optional |
タイプ:
LatLngBounds|LatLngBoundsLiteral optional Map3DElement.bounds をご覧ください。 |
center optional |
タイプ:
LatLngAltitude|LatLngAltitudeLiteral optional Map3DElement.center をご覧ください。 |
defaultUIDisabled optional |
タイプ:
boolean optional Map3DElement.defaultUIDisabled をご覧ください。 |
heading optional |
タイプ:
number optional Map3DElement.heading をご覧ください。 |
maxAltitude optional |
タイプ:
number optional Map3DElement.maxAltitude をご覧ください。 |
maxHeading optional |
タイプ:
number optional Map3DElement.maxHeading をご覧ください。 |
maxTilt optional |
タイプ:
number optional Map3DElement.maxTilt をご覧ください。 |
minAltitude optional |
タイプ:
number optional Map3DElement.minAltitude をご覧ください。 |
minHeading optional |
タイプ:
number optional Map3DElement.minHeading をご覧ください。 |
minTilt optional |
タイプ:
number optional Map3DElement.minTilt をご覧ください。 |
mode optional |
タイプ:
MapMode optional Map3DElement.mode をご覧ください。 |
range optional |
タイプ:
number optional Map3DElement.range をご覧ください。 |
roll optional |
タイプ:
number optional Map3DElement.roll をご覧ください。 |
tilt optional |
タイプ:
number optional Map3DElement.tilt をご覧ください。 |
MapMode 定数
google.maps.maps3d.MapMode
定数
地図のレンダリング モードを指定します。
const {MapMode} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
HYBRID |
この地図モードでは、航空写真またはフォトリアリスティックな画像の上に主要な道路の透明なレイヤが表示されます。 |
SATELLITE |
この地図モードでは、航空写真や、利用可能な場合はフォトリアリスティックな画像が表示されます。 |
FlyAroundAnimationOptions インターフェース
google.maps.maps3d.FlyAroundAnimationOptions
インターフェース
FlyCameraAround アニメーションのカスタマイズ オプション。
プロパティ | |
---|---|
camera |
タイプ:
CameraOptions 軌道アニメーション中にカメラが向くべき中心点。カメラがこの中心点を中心に回転すると、地図の向きが変わります。 |
durationMillis optional |
タイプ:
number optional アニメーションの再生時間(ミリ秒単位)。これは 1 回の回転の長さではなく、アニメーションの合計時間です。 |
rounds optional |
タイプ:
number optional 指定された期間内に中心を回転する回数。これにより、回転の全体的な速度が制御されます。rounds に負の数を渡すと、カメラはデフォルトの時計回りではなく反時計回りに回転します。 |
FlyToAnimationOptions インターフェース
google.maps.maps3d.FlyToAnimationOptions
インターフェース
FlyCameraTo アニメーションのカスタマイズ オプション。
プロパティ | |
---|---|
endCamera |
タイプ:
CameraOptions アニメーションの終了時にカメラが向くべき位置。 |
durationMillis optional |
タイプ:
number optional アニメーションの再生時間(ミリ秒単位)。duration が 0 の場合、カメラは終了位置に直接移動します。 |
CameraOptions インターフェース
google.maps.maps3d.CameraOptions
インターフェース
カメラ オブジェクトで設定できるプロパティを定義するために使用される CameraOptions オブジェクト。カメラ オブジェクトは、カメラ位置を持つものであれば何でも構いません。たとえば、現在の地図の状態や、リクエストされた将来のアニメーションの状態などです。
プロパティ | |
---|---|
center optional |
タイプ:
LatLngAltitude|LatLngAltitudeLiteral optional Map3DElement.center をご覧ください。 |
heading optional |
タイプ:
number optional Map3DElement.heading をご覧ください。 |
range optional |
タイプ:
number optional Map3DElement.range をご覧ください。 |
roll optional |
タイプ:
number optional Map3DElement.roll をご覧ください。 |
tilt optional |
タイプ:
number optional Map3DElement.tilt をご覧ください。 |
SteadyChangeEvent クラス
google.maps.maps3d.SteadyChangeEvent
クラス
このイベントは、Map3DElement
の定常状態のモニタリングから作成されます。このイベントは DOM ツリーをバブリングします。
このクラスは Event
を拡張します。
const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
プロパティ | |
---|---|
isSteady |
タイプ:
boolean Map3DElement が安定している(つまり、現在のシーンのすべてのレンダリングが完了している)かどうかを示します。 |
LocationClickEvent クラス
google.maps.maps3d.LocationClickEvent
クラス
このイベントは、Map3DElement をクリックしたときに作成されます。
このクラスは Event
を拡張します。
const {LocationClickEvent} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
プロパティ | |
---|---|
position |
タイプ:
LatLngAltitude optional イベントが発生したときにカーソルの下にあった緯度/経度/高度。なお、粗いレベルでは、精度が低いデータが返されます。また、カメラ位置が高い場所から水面をクリックすると、高度の値として海底の標高が返されることがあります。このイベントは DOM ツリーをバブリングします。 |
PlaceClickEvent クラス
google.maps.maps3d.PlaceClickEvent
クラス
このイベントは、Map3DElement
の場所アイコンをクリックすると作成されます。デフォルトのポップオーバーが表示されないようにするには、このイベントで preventDefault()
メソッドを呼び出して、Map3DElement
で処理されないようにします。
このクラスは LocationClickEvent
を拡張します。
const {PlaceClickEvent} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
プロパティ | |
---|---|
placeId |
タイプ:
string 地図上の対象物の Place ID。 |
継承:
position
|
メソッド | |
---|---|
fetchPlace |
fetchPlace() パラメータ: なし
このプレイス ID の Place を取得します。結果の Place オブジェクトでは、id プロパティに値が設定されます。追加のフィールドは、通常の Places API の有効化と課金に従って、Place.fetchFields() を介して後でリクエストできます。Place の取得でエラーが発生した場合、Promise は拒否されます。 |
Marker3DElement クラス
google.maps.maps3d.Marker3DElement
クラス
3D 地図上に位置を表示します。Marker3DElement
を表示するには、position
を設定する必要があります。
カスタム要素:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" position="lat,lng" size-preserved z-index="number"></gmp-marker-3d>
このクラスは HTMLElement
を拡張します。
このクラスは Marker3DElementOptions
を実装します。
const {Marker3DElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Marker3DElement |
Marker3DElement([options]) パラメータ:
指定されたオプションで Marker3DElement を作成します。 |
プロパティ | |
---|---|
altitudeMode |
タイプ:
AltitudeMode optional デフォルト:
AltitudeMode.CLAMP_TO_GROUND 位置の高度コンポーネントの解釈方法を指定します。
HTML 属性:
|
collisionBehavior |
タイプ:
CollisionBehavior optional デフォルト:
CollisionBehavior.REQUIRED 別の Marker3DElement またはベースマップのラベルと重なった場合の Marker3DElement の動作を指定する列挙型。
HTML 属性:
|
drawsWhenOccluded |
タイプ:
boolean optional デフォルト:
false このマーカーが隠れたときに描画するかどうかを指定します。マーカーは地図のジオメトリ(建物など)によって遮られることがあります。
HTML 属性:
|
extruded |
タイプ:
boolean optional デフォルト:
false マーカーを地面に接続するかどうかを指定します。マーカーを押し出すには、
altitudeMode を RELATIVE_TO_GROUND または ABSOLUTE にする必要があります。HTML 属性:
|
label |
タイプ:
string optional このマーカーで表示されるテキスト。
HTML 属性:
|
position |
タイプ:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional マーカーの先端の位置。高度は特定のモードでは無視されるため、省略可能です。
HTML 属性:
|
sizePreserved |
タイプ:
boolean optional デフォルト:
false カメラからの距離に関係なく、このマーカーのサイズを保持するかどうかを指定します。デフォルトでは、マーカーはカメラからの距離と傾斜に基づいてスケーリングされます。
HTML 属性:
|
zIndex |
タイプ:
number optional 他のマーカーと比較した zIndex。
HTML 属性:
|
スロット | |
---|---|
default |
Marker3DElement に直接追加されたカスタム要素はスロット化されますが、マーカーの描画に使用されるのは HTMLImageElement 、SVGElement 、PinElement タイプの要素のみで、他の要素は無視されます。、 HTMLImageElement 、SVGElement は、Marker3DElement のデフォルト スロットに割り当てる前に、<template> 要素でラップする必要があります。現在、画像と SVG は 3D シーンでレンダリングされる前にラスタライズされるため、SVG に埋め込まれたカスタム HTML や画像に追加された CSS クラスは適用されず、マーカーが画面に表示されたときに反映されない可能性があります。 |
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
Marker3DElementOptions インターフェース
google.maps.maps3d.Marker3DElementOptions
インターフェース
Marker3DElement に設定できるプロパティを定義するために使用される Marker3DElementOptions オブジェクト。
プロパティ | |
---|---|
altitudeMode optional |
タイプ:
AltitudeMode optional Marker3DElement.altitudeMode をご覧ください。 |
collisionBehavior optional |
タイプ:
CollisionBehavior optional Marker3DElement.collisionBehavior をご覧ください。 |
drawsWhenOccluded optional |
タイプ:
boolean optional Marker3DElement.drawsWhenOccluded をご覧ください。 |
extruded optional |
タイプ:
boolean optional Marker3DElement.extruded をご覧ください。 |
label optional |
タイプ:
string optional Marker3DElement.label をご覧ください。 |
position optional |
タイプ:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Marker3DElement.position をご覧ください。 |
sizePreserved optional |
タイプ:
boolean optional Marker3DElement.sizePreserved をご覧ください。 |
zIndex optional |
タイプ:
number optional Marker3DElement.zIndex をご覧ください。 |
Marker3DInteractiveElement クラス
google.maps.maps3d.Marker3DInteractiveElement
クラス
3D 地図上に位置を表示します。Marker3DInteractiveElement
を表示するには、position
を設定する必要があります。Marker3DElement
とは異なり、Marker3DInteractiveElement
は gmp-click
イベントを受け取ります。
カスタム要素:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>
このクラスは Marker3DElement
を拡張します。
このクラスは Marker3DInteractiveElementOptions
を実装します。
const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options]) パラメータ:
指定されたオプションで Marker3DInteractiveElement を作成します。 |
プロパティ | |
---|---|
gmpPopoverTargetElement |
タイプ:
PopoverElement optional 設定すると、このマーカーをクリックしたときにポップオーバー要素が開きます。
HTML 属性:
|
title |
タイプ:
string ロールオーバー テキスト。指定した場合、ユーザー補助機能のテキスト(スクリーン リーダーで使用するなど)が、指定された値とともに
Marker3DInteractiveElement に追加されます。HTML 属性:
|
継承:
altitudeMode 、
collisionBehavior 、
drawsWhenOccluded 、
extruded 、
label 、
position 、
sizePreserved 、
zIndex
|
スロット | |
---|---|
default |
Marker3DInteractiveElement に直接追加されたカスタム要素はスロットに配置されますが、マーカーの描画に使用されるのは PinElement 型の要素のみで、他の要素は無視されます。 |
メソッド | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
イベント | |
---|---|
gmp-click |
function(clickEvent) 引数:
このイベントは、 Marker3DInteractiveElement 要素がクリックされたときに発生します。 |
Marker3DInteractiveElementOptions インターフェース
google.maps.maps3d.Marker3DInteractiveElementOptions
インターフェース
Marker3DInteractiveElement で設定できるプロパティを定義するために使用される Marker3DInteractiveElementOptions オブジェクト。
このインターフェースは Marker3DElementOptions
を拡張します。
プロパティ | |
---|---|
gmpPopoverTargetElement optional |
タイプ:
PopoverElement optional |
title optional |
タイプ:
string optional Marker3DInteractiveElement.title をご覧ください。 |
継承:
altitudeMode 、
collisionBehavior 、
drawsWhenOccluded 、
extruded 、
label 、
position 、
sizePreserved 、
zIndex
|
Model3DElement クラス
google.maps.maps3d.Model3DElement
クラス
gLTF モデルのレンダリングを可能にする 3D モデル。Model3DElement
を表示するには、position
と src
を設定する必要があります。
gLTF PBR のコア プロパティをサポートする必要があります。現在、拡張機能や拡張プロパティはサポートされていません。
カスタム要素:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>
このクラスは HTMLElement
を拡張します。
このクラスは Model3DElementOptions
を実装します。
const {Model3DElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Model3DElement |
Model3DElement([options]) パラメータ:
指定されたオプションで Model3DElement を作成します。 |
プロパティ | |
---|---|
altitudeMode |
タイプ:
AltitudeMode optional デフォルト:
AltitudeMode.CLAMP_TO_GROUND 位置の高度の解釈方法を指定します。
HTML 属性:
|
orientation |
タイプ:
Orientation3D|Orientation3DLiteral optional 3D モデルの座標系を回転させて、3D マップ上にモデルを配置する方法について説明します。
回転は、ロール、チルト、見出しの順にモデルに適用されます。 HTML 属性:
|
position |
タイプ:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Model3DElement の位置を設定します。高度は特定のモードでは無視されるため、省略可能です。HTML 属性:
|
scale |
タイプ:
number|Vector3D|Vector3DLiteral optional デフォルト:
1 モデルの座標空間で、モデルを x 軸、y 軸、z 軸に沿ってスケーリングします。
HTML 属性:
|
src |
タイプ:
string|URL optional 3D モデルの URL を指定します。現在のところ、
.glb 形式のモデルのみがサポートされています。相対 HTTP URL は、対応する絶対 URL に解決されます。 メイン アプリケーションとは異なるウェブサイトまたはサーバーで .glb モデルファイルをホストしている場合は、正しい CORS HTTP ヘッダーを設定してください。これにより、アプリケーションは他のドメインのモデルファイルに安全にアクセスできます。HTML 属性:
|
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
Model3DElementOptions インターフェース
google.maps.maps3d.Model3DElementOptions
インターフェース
Model3DElement で設定できるプロパティを定義するために使用される Model3DElementOptions オブジェクト。
プロパティ | |
---|---|
altitudeMode optional |
タイプ:
AltitudeMode optional Model3DElement.altitudeMode をご覧ください。 |
orientation optional |
タイプ:
Orientation3D|Orientation3DLiteral optional Model3DElement.orientation をご覧ください。 |
position optional |
タイプ:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Model3DElement.position をご覧ください。 |
scale optional |
タイプ:
number|Vector3D|Vector3DLiteral optional Model3DElement.scale をご覧ください。 |
src optional |
タイプ:
string|URL optional Model3DElement.src をご覧ください。 |
Model3DInteractiveElement クラス
google.maps.maps3d.Model3DInteractiveElement
クラス
gLTF モデルのレンダリングを可能にする 3D モデル。Model3DElement
を表示するには、position
と src
を設定する必要があります。
gLTF PBR のコア プロパティをサポートする必要があります。現在、拡張機能や拡張プロパティはサポートされていません。
Model3DElement
とは異なり、Model3DInteractiveElement
は gmp-click
イベントを受信します。
カスタム要素:
<gmp-model-3d-interactive></gmp-model-3d-interactive>
このクラスは Model3DElement
を拡張します。
このクラスは Model3DInteractiveElementOptions
を実装します。
const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Model3DInteractiveElement |
Model3DInteractiveElement([options]) パラメータ:
指定されたオプションで Model3DInteractiveElement を作成します。 |
プロパティ | |
---|---|
継承:
altitudeMode 、
orientation 、
position 、
scale 、
src
|
メソッド | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
イベント | |
---|---|
gmp-click |
function(clickEvent) 引数:
このイベントは、 Model3DInteractiveElement 要素がクリックされたときに発生します。 |
Model3DInteractiveElementOptions インターフェース
google.maps.maps3d.Model3DInteractiveElementOptions
インターフェース
Model3DInteractiveElement に設定できるプロパティを定義するために使用される Model3DInteractiveElementOptions オブジェクト。
このインターフェースは Model3DElementOptions
を拡張します。
プロパティ | |
---|---|
継承:
altitudeMode 、
orientation 、
position 、
scale 、
src
|
Polyline3DElement クラス
google.maps.maps3d.Polyline3DElement
クラス
3D ポリラインは、3D 地図上の連結された一連の線分からなる線形オーバーレイです。
カスタム要素:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>
このクラスは HTMLElement
を拡張します。
このクラスは Polyline3DElementOptions
を実装します。
const {Polyline3DElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) パラメータ:
指定されたオプションで Polyline3DElement を作成します。 |
プロパティ | |
---|---|
altitudeMode |
タイプ:
AltitudeMode optional デフォルト:
AltitudeMode.CLAMP_TO_GROUND 座標の高度コンポーネントの解釈方法を指定します。
HTML 属性:
|
coordinates |
タイプ:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional ポリラインの座標の順序付けられたシーケンス。高度は特定のモードでは無視されるため、省略可能です。 |
drawsOccludedSegments |
タイプ:
boolean optional デフォルト:
false ポリラインの隠れる可能性のある部分を描画するかどうかを指定します。ポリラインは地図のジオメトリ(建物など)によって隠れることがあります。
HTML 属性:
|
extruded |
タイプ:
boolean optional デフォルト:
false ポリラインを地面に接続するかどうかを指定します。ポリラインを押し出すには、
altitudeMode を RELATIVE_TO_GROUND または ABSOLUTE にする必要があります。HTML 属性:
|
geodesic |
タイプ:
boolean optional デフォルト:
false true の場合、ポリラインのエッジは測地線として解釈され、地球の曲率に沿って描画されます。false の場合、ポリラインの端は画面空間で直線としてレンダリングされます。HTML 属性:
|
outerColor |
タイプ:
string optional 外側の色。すべての CSS3 色に対応します。
HTML 属性:
|
outerWidth |
タイプ:
number optional 外側の幅は
0.0 ~1.0 です。これは strokeWidth の割合です。HTML 属性:
|
strokeColor |
タイプ:
string optional ストロークの色。すべての CSS3 色に対応します。
HTML 属性:
|
strokeWidth |
タイプ:
number optional ピクセル単位のストローク幅。
HTML 属性:
|
zIndex |
タイプ:
number optional その他のポリラインと比較した zIndex。
HTML 属性:
|
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
Polyline3DElementOptions インターフェース
google.maps.maps3d.Polyline3DElementOptions
インターフェース
Polyline3DElement に設定できるプロパティを定義するために使用される Polyline3DElementOptions オブジェクト。
プロパティ | |
---|---|
altitudeMode optional |
タイプ:
AltitudeMode optional Polyline3DElement.altitudeMode をご覧ください。 |
coordinates optional |
タイプ:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Polyline3DElement.coordinates をご覧ください。 |
drawsOccludedSegments optional |
タイプ:
boolean optional |
extruded optional |
タイプ:
boolean optional Polyline3DElement.extruded をご覧ください。 |
geodesic optional |
タイプ:
boolean optional Polyline3DElement.geodesic をご覧ください。 |
outerColor optional |
タイプ:
string optional Polyline3DElement.outerColor をご覧ください。 |
outerWidth optional |
タイプ:
number optional Polyline3DElement.outerWidth をご覧ください。 |
strokeColor optional |
タイプ:
string optional Polyline3DElement.strokeColor をご覧ください。 |
strokeWidth optional |
タイプ:
number optional Polyline3DElement.strokeWidth をご覧ください。 |
zIndex optional |
タイプ:
number optional Polyline3DElement.zIndex をご覧ください。 |
Polyline3DInteractiveElement クラス
google.maps.maps3d.Polyline3DInteractiveElement
クラス
3D ポリラインは、3D 地図上の連結された一連の線分からなる線形オーバーレイです。Polyline3DElement
とは異なり、Polyline3DInteractiveElement
は gmp-click
イベントを受け取ります。
カスタム要素:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
このクラスは Polyline3DElement
を拡張します。
このクラスは Polyline3DInteractiveElementOptions
を実装します。
const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Polyline3DInteractiveElement |
Polyline3DInteractiveElement([options]) パラメータ:
指定されたオプションで Polyline3DInteractiveElement を作成します。 |
プロパティ | |
---|---|
継承:
altitudeMode 、
coordinates 、
drawsOccludedSegments 、
extruded 、
geodesic 、
outerColor 、
outerWidth 、
strokeColor 、
strokeWidth 、
zIndex
|
メソッド | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
イベント | |
---|---|
gmp-click |
function(clickEvent) 引数:
このイベントは、 Polyline3DInteractiveElement 要素がクリックされたときに発生します。 |
Polyline3DInteractiveElementOptions インターフェース
google.maps.maps3d.Polyline3DInteractiveElementOptions
インターフェース
Polyline3DInteractiveElement で設定できるプロパティを定義するために使用される Polyline3DInteractiveElementOptions オブジェクト。
このインターフェースは Polyline3DElementOptions
を拡張します。
プロパティ | |
---|---|
継承:
altitudeMode 、
coordinates 、
drawsOccludedSegments 、
extruded 、
geodesic 、
outerColor 、
outerWidth 、
strokeColor 、
strokeWidth 、
zIndex
|
Polygon3DElement クラス
google.maps.maps3d.Polygon3DElement
クラス
3D ポリゴン(3D ポリラインなど)は、順序付けされた一連の接続された座標を定義します。また、ポリゴンは閉じたループを形成し、塗りつぶされた領域を定義します。
カスタム要素:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>
このクラスは HTMLElement
を拡張します。
このクラスは Polygon3DElementOptions
を実装します。
const {Polygon3DElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) パラメータ:
指定されたオプションで Polygon3DElement を作成します。 |
プロパティ | |
---|---|
altitudeMode |
タイプ:
AltitudeMode optional デフォルト:
AltitudeMode.CLAMP_TO_GROUND 座標の高度コンポーネントの解釈方法を指定します。
HTML 属性:
|
drawsOccludedSegments |
タイプ:
boolean optional デフォルト:
false オクルージョンされる可能性のあるポリゴンの部分を描画するかどうかを指定します。ポリゴンは地図のジオメトリ(建物など)によってオクルージョンされることがあります。
HTML 属性:
|
extruded |
タイプ:
boolean optional デフォルト:
false ポリゴンを地面に接続するかどうかを指定します。ポリゴンを押し出すには、
altitudeMode は RELATIVE_TO_GROUND または ABSOLUTE のいずれかである必要があります。HTML 属性:
|
fillColor |
タイプ:
string optional 塗りつぶしの色。すべての CSS3 色に対応します。
HTML 属性:
|
geodesic |
タイプ:
boolean optional デフォルト:
false true の場合、ポリゴンのエッジは測地線として解釈され、地球の曲率に沿って描画されます。false の場合、ポリゴンのエッジは画面空間で直線としてレンダリングされます。HTML 属性:
|
innerCoordinates |
タイプ:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional 閉じたループを指定する座標の順序付きシーケンス。ポリラインとは異なり、ポリゴンは 1 つ以上のパスで構成され、ポリゴンの内部に複数の切り抜きを作成できます。 |
outerCoordinates |
タイプ:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional 閉じたループを指定する座標の順序付きシーケンス。高度は特定のモードでは無視されるため、省略可能です。 |
strokeColor |
タイプ:
string optional ストロークの色。すべての CSS3 色に対応します。
HTML 属性:
|
strokeWidth |
タイプ:
number optional ピクセル単位のストローク幅。
HTML 属性:
|
zIndex |
タイプ:
number optional その他のポリラインと比較した zIndex。
HTML 属性:
|
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
Polygon3DElementOptions インターフェース
google.maps.maps3d.Polygon3DElementOptions
インターフェース
Polygon3DElement で設定できるプロパティを定義するために使用される Polygon3DElementOptions オブジェクト。
プロパティ | |
---|---|
altitudeMode optional |
タイプ:
AltitudeMode optional Polygon3DElement.altitudeMode をご覧ください。 |
drawsOccludedSegments optional |
タイプ:
boolean optional |
extruded optional |
タイプ:
boolean optional Polygon3DElement.extruded をご覧ください。 |
fillColor optional |
タイプ:
string optional Polygon3DElement.fillColor をご覧ください。 |
geodesic optional |
タイプ:
boolean optional Polygon3DElement.geodesic をご覧ください。 |
innerCoordinates optional |
タイプ:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional Polygon3DElement.innerCoordinates をご覧ください。 |
outerCoordinates optional |
タイプ:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Polygon3DElement.outerCoordinates をご覧ください。 |
strokeColor optional |
タイプ:
string optional Polygon3DElement.strokeColor をご覧ください。 |
strokeWidth optional |
タイプ:
number optional Polygon3DElement.strokeWidth をご覧ください。 |
zIndex optional |
タイプ:
number optional Polygon3DElement.zIndex をご覧ください。 |
Polygon3DInteractiveElement クラス
google.maps.maps3d.Polygon3DInteractiveElement
クラス
3D ポリゴン(3D ポリラインなど)は、順序付けされた一連の接続された座標を定義します。また、ポリゴンは閉じたループを形成し、塗りつぶされた領域を定義します。Polygon3DElement
とは異なり、Polygon3DInteractiveElement
は gmp-click
イベントを受け取ります。
カスタム要素:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
このクラスは Polygon3DElement
を拡張します。
このクラスは Polygon3DInteractiveElementOptions
を実装します。
const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
Polygon3DInteractiveElement |
Polygon3DInteractiveElement([options]) パラメータ:
指定されたオプションで Polygon3DInteractiveElement を作成します。 |
プロパティ | |
---|---|
継承:
altitudeMode 、
drawsOccludedSegments 、
extruded 、
fillColor 、
geodesic 、
innerCoordinates 、
outerCoordinates 、
strokeColor 、
strokeWidth 、
zIndex
|
メソッド | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
イベント | |
---|---|
gmp-click |
function(clickEvent) 引数:
このイベントは、 Polygon3DInteractiveElement 要素がクリックされたときに発生します。 |
Polygon3DInteractiveElementOptions インターフェース
google.maps.maps3d.Polygon3DInteractiveElementOptions
インターフェース
Polygon3DInteractiveElement で設定できるプロパティを定義するために使用される Polygon3DInteractiveElementOptions オブジェクト。
このインターフェースは Polygon3DElementOptions
を拡張します。
プロパティ | |
---|---|
継承:
altitudeMode 、
drawsOccludedSegments 、
extruded 、
fillColor 、
geodesic 、
innerCoordinates 、
outerCoordinates 、
strokeColor 、
strokeWidth 、
zIndex
|
PopoverElement クラス
google.maps.maps3d.PopoverElement
クラス
ポップオーバーをレンダリングするカスタム HTML 要素。バブルのような形で、多くの場合マーカーに接続されています。
カスタム要素:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>
このクラスは HTMLElement
を拡張します。
このクラスは PopoverElementOptions
を実装します。
const {PopoverElement} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
PopoverElement |
PopoverElement([options]) パラメータ:
|
プロパティ | |
---|---|
altitudeMode |
タイプ:
AltitudeMode optional デフォルト:
AltitudeMode.CLAMP_TO_GROUND 位置の高度コンポーネントの解釈方法を指定します。
HTML 属性:
|
lightDismissDisabled |
タイプ:
boolean optional デフォルト:
false このポップオーバーを「ライト ディスミス」にするかどうかを指定します。「ライト ディスミス」の動作は、ブラウザの Popover API の一部である
popover="auto" 属性の設定に似ています。HTML 属性:
|
open |
タイプ:
boolean optional デフォルト:
false このポップオーバーを開くかどうかを指定します。
HTML 属性:
|
positionAnchor |
タイプ:
LatLngLiteral|LatLngAltitudeLiteral|Marker3DInteractiveElement|string optional このポップオーバーを表示する位置。ポップオーバーがインタラクティブ マーカーに固定されている場合は、代わりにマーカーの位置が使用されます。
HTML 属性:
|
スロット | |
---|---|
default |
スロット付きコンテンツをポップオーバーのメイン セクションに配置します。 |
header |
スロット付きコンテンツをポップオーバーの見出しセクションに配置します。 |
CSS プロパティ | |
---|---|
--gmp-popover-max-width |
コンテンツの幅に関係なく、ポップオーバーの最大幅。 |
--gmp-popover-min-width |
コンテンツの幅に関係なく、ポップオーバーの最小幅。このプロパティを使用する場合は、地図の幅(ピクセル単位)よりも小さい値に設定することを強くおすすめします。 |
--gmp-popover-pixel-offset-x |
ポップオーバーの先端の x 軸上のオフセット(ピクセル単位)。ポップオーバーがアンカーされている地図上のポイントの地理座標からのオフセットです。 |
--gmp-popover-pixel-offset-y |
ポップオーバーの先端の y 軸上のオフセット(ピクセル単位)。ポップオーバーがアンカーされている地図上のポイントの地理座標からのオフセットです。 |
color-scheme |
このポップオーバーをレンダリングできるカラースキームを示します。詳しくは、 color-scheme ドキュメントをご覧ください。指定しない場合、デフォルトでユーザーの配色設定が使用されます。 |
メソッド | |
---|---|
|
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
|
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
PopoverElementOptions インターフェース
google.maps.maps3d.PopoverElementOptions
インターフェース
PopoverElement で設定できるプロパティを定義するために使用される PopoverElementOptions オブジェクト。
プロパティ | |
---|---|
altitudeMode optional |
タイプ:
AltitudeMode optional PopoverElement.altitudeMode をご覧ください。 |
lightDismissDisabled optional |
タイプ:
boolean optional PopoverElement.lightDismissDisabled をご覧ください。 |
open optional |
タイプ:
boolean optional PopoverElement.open をご覧ください。 |
positionAnchor optional |
タイプ:
LatLngLiteral|LatLngAltitudeLiteral|string|Marker3DInteractiveElement optional PopoverElement.positionAnchor をご覧ください。 |
AltitudeMode 定数
google.maps.maps3d.AltitudeMode
定数
座標の高度コンポーネントの解釈方法を指定します。
const {AltitudeMode} = await google.maps.importLibrary("maps3d")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
ABSOLUTE |
平均海面を基準としたオブジェクトの表現を可能にします。つまり、オブジェクトの下の地形の詳細レベルが変更されても、絶対位置は同じままになります。 |
CLAMP_TO_GROUND |
地面に配置されたオブジェクトを表現できます。指定された高度に関係なく、地形に沿って地面に留まります。オブジェクトが大きな水域の上にある場合は、海面レベルに配置されます。 |
RELATIVE_TO_GROUND |
地面の表面を基準にオブジェクトを表現できます。地形の詳細レベルが変化しても、オブジェクトの位置は地面に対して一定のままになります。水上では、高度は海抜高度(メートル単位)として解釈されます。 |
RELATIVE_TO_MESH |
地面、建物、水面の最も高い位置を基準にオブジェクトを表現できます。水上では水面、地形上では建物表面(存在する場合)または地面(建物がない場合)になります。 |