MapElement クラス
google.maps.MapElement クラス
MapElement は、地図をレンダリングするための HTMLElement サブクラスです。maps ライブラリを読み込んだ後、HTML で地図を作成できます。次に例を示します。
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>内部的には
Map を使用します。これには MapElement.innerMap プロパティでアクセスできます。
カスタム要素:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
このクラスは HTMLElement を拡張します。
このクラスは MapElementOptions を実装します。
const {MapElement} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
MapElement |
MapElement([options])パラメータ:
|
プロパティ | |
|---|---|
center |
タイプ:
LatLng|LatLngLiteral optional地図の中心の緯度と経度。
HTML 属性:
|
headingInteractionDisabled |
タイプ:
boolean optionalデフォルト:
falseユーザーがカメラの向き(回転)を操作できるようにするかどうかを指定します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。
HTML 属性:
|
innerMap |
タイプ:
MapMapElement が内部で使用する Map への参照。 |
internalUsageAttributionIds |
タイプ:
Iterable<string> optionalデフォルト:
null初期化子に使用状況属性 ID を追加します。これにより、Google は、マーカー クラスタリング ライブラリの使用状況など、デベロッパーにとって有用なライブラリやサンプルを把握できます。使用状況アトリビューション ID の送信をオプトアウトするには、このプロパティを削除するか、値を空の文字列に置き換えます。一意の値のみが送信されます。インスタンス化後にこの値を変更しても無視されることがあります。
HTML 属性:
|
mapId |
タイプ:
string optional地図のマップ ID。このパラメータは、地図のインスタンス化後に設定または変更することはできません。
Map.DEMO_MAP_ID は、マップ ID を必要とするが、クラウドの有効化を必要としない機能を試すために使用できます。HTML 属性:
|
renderingType |
タイプ:
RenderingType optionalデフォルト:
RenderingType.VECTOR地図をラスターマップにするかベクターマップにするか。このパラメータは、地図のインスタンス化後に設定または変更することはできません。設定されていない場合は、マップ ID のクラウド構成によってレンダリング タイプが決定されます(利用可能な場合)。ベクターマップは、一部のデバイスやブラウザでは利用できない場合があります。その場合、マップは必要に応じてラスターマップにフォールバックされます。
HTML 属性:
|
tiltInteractionDisabled |
タイプ:
boolean optionalデフォルト:
falseユーザーがカメラの傾きを制御できるようにするかどうか。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。
HTML 属性:
|
zoom |
タイプ:
number optional地図のズームレベル。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度が高くなります。
HTML 属性:
|
メソッド | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])パラメータ:
戻り値:
void指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options])パラメータ:
戻り値:
voidaddEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
イベント | |
|---|---|
gmp-zoomchange |
function(event)引数:
このイベントは、地図のズーム プロパティが変更されると発生します。 |
MapElementOptions インターフェース
google.maps.MapElementOptions インターフェース
MapElement に設定できるプロパティを定義するために使用される MapElementOptions オブジェクト。
プロパティ | |
|---|---|
center optional |
タイプ:
LatLng|LatLngLiteral optionalMapElement.center をご覧ください。 |
headingInteractionDisabled optional |
タイプ:
boolean optional |
internalUsageAttributionIds optional |
タイプ:
Iterable<string> optional |
mapId optional |
タイプ:
string optionalMapElement.mapId をご覧ください。 |
renderingType optional |
タイプ:
RenderingType optionalMapElement.renderingType をご覧ください。 |
tiltInteractionDisabled optional |
タイプ:
boolean optionalMapElement.tiltInteractionDisabled をご覧ください。 |
zoom optional |
タイプ:
number optionalMapElement.zoom をご覧ください。 |
ZoomChangeEvent クラス
google.maps.ZoomChangeEvent クラス
このイベントは、ズームの変更をモニタリングすることで作成されます。
このクラスは Event を拡張します。
const {ZoomChangeEvent} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
Map クラス
google.maps.Map クラス
このクラスは MVCObject を拡張します。
const {Map} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
Map |
Map(mapDiv[, opts])パラメータ:
指定された HTML コンテナ(通常は DIV 要素)内に新しい地図を作成します。 |
定数 | |
|---|---|
DEMO_MAP_ID |
マップ ID を必要とするコードサンプルに使用できるマップ ID。このマップ ID は、本番環境のアプリケーションでの使用を想定したものではなく、クラウド構成を必要とする機能(クラウド スタイル設定など)には使用できません。 |
プロパティ | |
|---|---|
controls |
タイプ:
Array<MVCArray<HTMLElement>>地図にアタッチする追加のコントロール。地図にコントロールを追加するには、コントロールの <div> を、レンダリングする ControlPosition に対応する MVCArray に追加します。 |
data |
タイプ:
Data地図にバインドされた Data のインスタンス。この Data オブジェクトに対象物を追加すると、この地図上に簡単に表示できます。 |
mapTypes |
タイプ:
MapTypeRegistry文字列 ID による MapType インスタンスのレジストリ。 |
overlayMapTypes |
オーバーレイする追加の地図タイプ。オーバーレイのマップタイプは、関連付けられている任意の基本地図の上に表示され、その順序は overlayMapTypes 配列での記述順序です(より高いインデックス値を持つオーバーレイが、低いインデックス値を持つオーバーレイの前に表示されます)。 |
メソッド | |
|---|---|
fitBounds |
fitBounds(bounds[, padding])パラメータ:
戻り値: なし
指定された境界が含まれるようにビューポートを設定します。 注: 地図が display: none に設定されている場合、fitBounds 関数は地図のサイズを 0x0 として読み取るため、何も行いません。地図が非表示のときにビューポートを変更するには、地図を visibility: hidden に設定して、地図の div に実際のサイズが設定されるようにします。ベクターマップの場合、このメソッドは地図の傾きと方位をデフォルトのゼロ値に設定します。このメソッドを呼び出すと、境界に合わせて地図がパンおよびズームされるときに、スムーズなアニメーションが表示されることがあります。このメソッドがアニメーション化されるかどうかは、内部ヒューリスティックによって異なります。 |
getBounds |
getBounds()パラメータ: なし
戻り値:
LatLngBounds|undefined 現在のビューポートの緯度 / 経度の境界。現在のビューポートの緯度 / 経度の境界を返します。世界地図が複数表示されている場合、境界の経度は -180 ~ 180 度の範囲になります。マップがまだ初期化されていない場合、または中心とズームが設定されていない場合は、結果は undefined になります。傾斜または方位がゼロ以外のベクターマップの場合、返される緯度 / 経度の境界は、地図のビューポートの表示領域を含む最小の境界ボックスを表します。地図のビューポートの正確な表示領域を取得する方法については、MapCanvasProjection.getVisibleRegion をご覧ください。 |
getCenter |
getCenter()パラメータ: なし
戻り値:
LatLng|undefined |
getClickableIcons |
getClickableIcons()パラメータ: なし
戻り値:
boolean|undefined地図アイコンのクリック可能性を返します。地図アイコンは、スポット(POI)を表します。戻り値が true の場合、地図上のアイコンはクリック可能です。 |
|
getDatasetFeatureLayer(datasetId)パラメータ:
戻り値:
FeatureLayer指定された datasetId の FeatureLayer を返します。データセット ID は Google Cloud コンソールで構成する必要があります。データセット ID が地図の地図のスタイルに関連付けられていない場合、またはデータドリブン スタイル設定が利用できない場合(マップ ID、ベクタータイル、データドリブン スタイル設定の地図のレイヤ、または地図のスタイルで構成されたデータセットがない場合)、エラーがログに記録され、結果の FeatureLayer.isAvailable は false になります。 |
getDiv |
getDiv()パラメータ: なし
戻り値:
HTMLElement 地図の mapDiv。 |
getFeatureLayer |
getFeatureLayer(featureType)パラメータ:
戻り値:
FeatureLayer特定の FeatureType の FeatureLayer を返します。Google Cloud コンソールで FeatureLayer を有効にする必要があります。指定した FeatureType の FeatureLayer がこの地図に存在しない場合、またはデータドリブン スタイル設定が利用できない場合(マップ ID、ベクタータイル、地図のスタイルで有効になっている FeatureLayer がない場合)、エラーがログに記録され、結果の FeatureLayer.isAvailable は false になります。 |
getHeading |
getHeading()パラメータ: なし
戻り値:
number|undefined地図のコンパス方位を返します。方角の値は、北を基準に時計回りの角度で測定されます。地図がまだ初期化されていない場合、結果は undefined になります。 |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled()パラメータ: なし
戻り値:
boolean|null見出しの操作が有効かどうかを返します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
getInternalUsageAttributionIds |
getInternalUsageAttributionIds()パラメータ: なし
戻り値:
Iterable<string>|null使用状況アトリビューション ID のリストを返します。これにより、Google は、マーカー クラスタリング ライブラリの使用状況など、どのライブラリやサンプルがデベロッパーに役立っているかを把握できます。 |
getMapCapabilities |
getMapCapabilities()パラメータ: なし
戻り値:
MapCapabilities指定されたマップ ID に基づいて、マップで現在利用可能な機能を呼び出し元に通知します。 |
getMapTypeId |
getMapTypeId()パラメータ: なし
戻り値:
MapTypeId|string|undefined |
getProjection |
getProjection()パラメータ: なし
戻り値:
Projection|undefined現在の Projection を返します。地図がまだ初期化されていない場合、結果は undefined になります。projection_changed イベントをリッスンし、その値が undefined でないことを確認します。 |
getRenderingType |
getRenderingType()パラメータ: なし
戻り値:
RenderingType地図の現在の RenderingType を返します。 |
getStreetView |
getStreetView()パラメータ: なし
戻り値:
StreetViewPanorama 地図にバインドされたパノラマ。地図にバインドされているデフォルトの StreetViewPanorama を返します。これは、地図に埋め込まれているデフォルトのパノラマか、setStreetView() を使用して設定されたパノラマです。地図の streetViewControl を変更すると、バインドされたパノラマの表示に反映されます。 |
getTilt |
getTilt()パラメータ: なし
戻り値:
number|undefined地図の現在の入射角を、ビューポート平面から地図平面までの角度(度単位)で返します。ラスターマップの場合、真上から撮影された画像では 0、45° 画像では 45 が返されます。このメソッドは、setTilt によって設定された値を返しません。詳しくは、setTilt をご覧ください。 |
getTiltInteractionEnabled |
getTiltInteractionEnabled()パラメータ: なし
戻り値:
boolean|null傾斜操作が有効かどうかを返します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
getZoom |
getZoom()パラメータ: なし
戻り値:
number|undefined地図のズームを返します。ズームが設定されていない場合、結果は undefined になります。 |
moveCamera |
moveCamera(cameraOptions)パラメータ:
戻り値: なし
アニメーションなしで、地図のカメラをターゲット カメラ オプションにすぐに設定します。 |
panBy |
panBy(x, y)パラメータ:
戻り値: なし
指定された距離(ピクセル単位)だけ地図の中心を変更します。距離が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション化されます。地図の座標系は、西から東(x 値)および北から南(y 値)に増加します。 |
panTo |
panTo(latLng)パラメータ:
戻り値: なし
地図の中心を指定された LatLng に変更します。変更範囲が地図の幅と高さの両方よりも小さい場合、遷移はスムーズにアニメーション表示されます。 |
panToBounds |
panToBounds(latLngBounds[, padding])パラメータ:
戻り値: なし
指定された LatLngBounds が表示されるように、必要最小限の量だけ地図をパンします。地図上のどこに境界が表示されるかは保証されませんが、{currentMapSizeInPx} - {padding} 内にできるだけ多くの境界が表示されるように地図がパンされます。ラスターマップとベクターマップのどちらの場合も、地図のズーム、傾斜、方向は変更されません。 |
setCenter |
setCenter(latlng)パラメータ:
戻り値: なし
|
setClickableIcons |
setClickableIcons(value)パラメータ:
戻り値: なし
地図アイコンをクリック可能にするかどうかを制御します。地図アイコンは、スポット(POI)を表します。地図アイコンのクリックを無効にするには、このメソッドに false の値を渡します。 |
setHeading |
setHeading(heading)パラメータ:
戻り値: なし
地図のコンパス方位を、基本方位の北からの角度で設定します。ラスターマップの場合、このメソッドは航空画像にのみ適用されます。 |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled)パラメータ:
戻り値: なし
見出しの操作を有効にするかどうかを設定します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
setMapTypeId |
setMapTypeId(mapTypeId)パラメータ:
戻り値: なし
|
setOptions |
setOptions(options)パラメータ:
戻り値: なし
|
setRenderingType |
setRenderingType(renderingType)パラメータ:
戻り値: なし
地図の現在の RenderingType を設定します。 |
setStreetView |
setStreetView(panorama)パラメータ:
戻り値: なし
StreetViewPanorama を地図にバインドします。このパノラマはデフォルトの StreetViewPanorama をオーバーライドし、地図を地図外の外部パノラマにバインドできるようにします。パノラマを null に設定すると、デフォルトの埋め込みパノラマが地図にバインドされます。 |
setTilt |
setTilt(tilt)パラメータ:
戻り値: なし
ベクターマップの場合、地図の入射角を設定します。指定できる値は、地図のズームレベルによって制限されます。 ラスターマップの場合、地図の入射角の自動切り替え動作を制御します。指定できる値は 0 と 45 のみです。setTilt(0) を指定すると、ズームレベルやビューポートに関係なく、地図は常に 0° の俯瞰ビューを使用します。setTilt(45) を指定すると、現在のズームレベルとビューポートで 45° 画像が利用可能な場合は、傾斜角度が自動的に 45 に切り替わり、45° 画像が利用できない場合は 0 に戻ります(これがデフォルトの動作です)。45° 画像は、satellite および hybrid のマップタイプでのみ、一部の場所と一部のズームレベルで利用できます。注: getTilt は、setTilt で設定された値ではなく、現在の傾斜角度を返します。getTilt と setTilt は異なるものを参照しているため、tilt プロパティを bind() しないでください。予期しない影響が生じる可能性があります。 |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled)パラメータ:
戻り値: なし
傾斜操作を有効にするかどうかを設定します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
setZoom |
setZoom(zoom)パラメータ:
戻り値: なし
地図のズームを設定します。 |
継承:
addListener、
bindTo、
get、
notify、
set、
setValues、
unbind、
unbindAll
| |
イベント | |
|---|---|
bounds_changed |
function()引数: なし
このイベントは、ビューポートの境界が変更されると発生します。 |
center_changed |
function()引数: なし
このイベントは、地図の中心プロパティが変更されると発生します。 |
click |
function(event)引数:
このイベントは、ユーザーが地図をクリックしたときに発生します。クリックされた場所のプロパティを含む MapMouseEvent が返されます。ただし、場所アイコンがクリックされた場合は、プレイス ID を含む IconMouseEvent が返されます。IconMouseEvent と MapMouseEvent は同じですが、IconMouseEvent にはプレイス ID フィールドがあります。プレイス ID が重要でない場合は、イベントを常に MapMouseEvent として扱うことができます。マーカーまたは情報ウィンドウがクリックされた場合、クリック イベントは発生しません。 |
contextmenu |
function(event)引数:
このイベントは、地図コンテナで DOM contextmenu イベントが発生したときに発生します。 |
dblclick |
function(event)引数:
このイベントは、ユーザーが地図をダブルクリックしたときに呼び出されます。クリック イベントは、このイベントの直前に 1 回または 2 回発生することがあります。 |
drag |
function()引数: なし
このイベントは、ユーザーが地図をドラッグしている間に繰り返し発生します。 |
dragend |
function()引数: なし
このイベントは、ユーザーが地図のドラッグを停止したときに発生します。注: ユーザーがキーボードを使用して地図のパンを停止した場合は、dragend は発生しません。ユーザーが地図のパンまたはドラッグを停止したタイミングを判断するには、代わりに Map.idle イベントを使用してください。 |
dragstart |
function()引数: なし
このイベントは、ユーザーが地図のドラッグを開始すると発生します。 |
heading_changed |
function()引数: なし
このイベントは、地図の方位プロパティが変更されると発生します。 |
idle |
function()引数: なし
このイベントは、移動またはズームの後に地図がアイドルになると発生します。 |
isfractionalzoomenabled_changed |
function()引数: なし
このイベントは、isFractionalZoomEnabled プロパティが変更されたときに発生します。 |
mapcapabilities_changed |
function()引数: なし
このイベントは、地図の機能が変更されたときに発生します。 |
maptypeid_changed |
function()引数: なし
このイベントは、map TypeId プロパティが変更されると発生します。 |
mousemove |
function(event)引数:
このイベントは、ユーザーが地図コンテナ上にマウスオーバーすると発生します。 |
mouseout |
function(event)引数:
このイベントは、マウスが地図コンテナから離れると発生します。 |
mouseover |
function(event)引数:
このイベントは、マウスが地図コンテナ内に入ると発生します。 |
projection_changed |
function()引数: なし
このイベントは、投影が変更されると発生します。 |
renderingtype_changed |
function()引数: なし
このイベントは、renderingType が変更されたときに発生します。 |
tilesloaded |
function()引数: なし
このイベントは、表示されているタイルの読み込みが完了したときに発生します。 |
tilt_changed |
function()引数: なし
このイベントは、地図の傾斜プロパティが変更されると発生します。 |
zoom_changed |
function()引数: なし
このイベントは、地図のズーム プロパティが変更されると発生します。 |
|
function(event)引数:
このイベントは、ユーザーが地図を右クリックしたときに呼び出されます。 |
MapOptions インターフェース
google.maps.MapOptions インターフェース
MapOptions オブジェクトは、Map に設定できるプロパティを定義するために使用されます。
プロパティ | |
|---|---|
backgroundColor optional |
タイプ:
string optionalマップ div の背景に使用される色。この色は、ユーザーがパンしたときにタイルがまだ読み込まれていない場合に表示されます。このオプションは、地図が初期化されたときのみ設定できます。 |
cameraControl optional |
タイプ:
boolean optionalカメラ コントロールの有効 / 無効の状態。 |
cameraControlOptions optional |
タイプ:
CameraControlOptions optionalカメラ コントロールの表示オプション。 |
center optional |
タイプ:
LatLng|LatLngLiteral optional地図の初期の中心。 |
clickableIcons optional |
タイプ:
boolean optionalデフォルト:
truefalse の場合、地図アイコンはクリックできません。地図アイコンは、スポット(POI)を表します。 |
colorScheme optional |
タイプ:
ColorScheme|string optionalデフォルト:
ColorScheme.LIGHT地図の初期カラーパターン。このオプションは、地図が初期化されたときのみ設定できます。 |
controlSize optional |
タイプ:
number optional地図に表示されるコントロールのサイズ(ピクセル単位)。この値は、地図の作成時に直接指定する必要があります。後でこの値を更新すると、コントロールが undefined 状態になる可能性があります。Maps API 自体によって行われるコントロールのみを管理します。デベロッパーが作成したカスタム コントロールはスケーリングされません。 |
disableDefaultUI optional |
タイプ:
boolean optionalすべてのデフォルト UI ボタンを有効または無効にします。個別にオーバーライドできます。キーボード コントロールは無効になりません。キーボード コントロールは MapOptions.keyboardShortcuts オプションで個別に制御されます。ジェスチャー操作は無効になりません。ジェスチャー操作は MapOptions.gestureHandling オプションで個別に制御されます。 |
disableDoubleClickZoom optional |
タイプ:
boolean optionalダブルクリックによるズームと中央表示を有効または無効にします。デフォルトで有効。 注: このプロパティはおすすめしません。ダブルクリックによるズームを無効にするには、 |
|
タイプ:
boolean optionalfalse の場合、マウスやタッチ操作による地図のドラッグやズームができなくなります。ドラッグはデフォルトで有効になっています。 |
draggableCursor optional |
タイプ:
string optionalドラッグ可能な地図にマウスを合わせたときに表示されるカーソルの名前または URL。このプロパティは、CSS の cursor 属性を使用してアイコンを変更します。css プロパティと同様に、URL ではないフォールバック カーソルを少なくとも 1 つ指定する必要があります。例: draggableCursor: 'url(http://www.example.com/icon.png), auto;'。 |
draggingCursor optional |
タイプ:
string optional地図をドラッグしているときに表示するカーソルの名前または URL。このプロパティは、CSS の cursor 属性を使用してアイコンを変更します。css プロパティと同様に、URL ではないフォールバック カーソルを少なくとも 1 つ指定する必要があります。例: draggingCursor: 'url(http://www.example.com/icon.png), auto;'。 |
fullscreenControl optional |
タイプ:
boolean optional全画面表示コントロールの有効 / 無効の状態。 |
fullscreenControlOptions optional |
タイプ:
FullscreenControlOptions optional全画面表示コントロールの表示オプション。 |
gestureHandling optional |
タイプ:
string optionalこの設定は、API が地図上の操作を処理する方法を制御します。使用できる値:
|
heading optional |
タイプ:
number optional航空画像の向き。基本方角の北から時計回りの角度で表されます。方位は、画像を表示できる最も近い角度に合わせられます。 |
headingInteractionEnabled optional |
タイプ:
boolean optionalデフォルト:
falseユーザーがカメラの向き(回転)を操作できるようにするかどうかを指定します。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
internalUsageAttributionIds optional |
タイプ:
Iterable<string> optionalデフォルト:
null初期化子に使用状況属性 ID を追加します。これにより、Google は、マーカー クラスタリング ライブラリの使用状況など、デベロッパーにとって有用なライブラリやサンプルを把握できます。使用状況アトリビューション ID の送信をオプトアウトするには、このプロパティを削除するか、値を空の文字列に置き換えます。一意の値のみが送信されます。インスタンス化後にこの値を変更しても無視されることがあります。 |
isFractionalZoomEnabled optional |
タイプ:
boolean optionalデフォルト: ベクターマップの場合は
true、ラスターマップの場合は false地図で小数ズームレベルを許可するかどうか。デフォルトが設定されたタイミングを把握するには、 isfractionalzoomenabled_changed をリッスンします。 |
keyboardShortcuts optional |
タイプ:
boolean optionalfalse の場合、キーボードで地図を操作できなくなります。キーボード ショートカットはデフォルトで有効になっています。 |
mapId optional |
タイプ:
string optional地図のマップ ID。このパラメータは、地図のインスタンス化後に設定または変更することはできません。 Map.DEMO_MAP_ID は、マップ ID を必要とするが、クラウドの有効化を必要としない機能を試すために使用できます。 |
mapTypeControl optional |
タイプ:
boolean optional地図タイプ コントロールの初期の有効 / 無効状態。 |
mapTypeControlOptions optional |
タイプ:
MapTypeControlOptions optional地図タイプ コントロールの初期表示オプション。 |
mapTypeId optional |
タイプ:
MapTypeId|string optional初期の Map mapTypeId。デフォルトは ROADMAP です。 |
maxZoom optional |
タイプ:
number optional地図に表示される最大ズームレベル。省略するか、 null に設定すると、代わりに現在の地図タイプの最大ズームが使用されます。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。 |
minZoom optional |
タイプ:
number optional地図に表示される最小ズームレベル。省略するか、 null に設定すると、現在の地図タイプの最小ズームが代わりに使用されます。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。 |
noClear optional |
タイプ:
boolean optionaltrue の場合、Map div のコンテンツを消去しないでください。 |
|
タイプ:
boolean optionalパン コントロールの有効 / 無効の状態。 |
|
タイプ:
PanControlOptions optionalパン コントロールの表示オプション。 |
renderingType optional |
タイプ:
RenderingType optionalデフォルト:
RenderingType.RASTER地図をラスターマップにするかベクターマップにするか。このパラメータは、地図のインスタンス化後に設定または変更することはできません。設定されていない場合は、マップ ID のクラウド構成によってレンダリング タイプが決定されます(利用可能な場合)。ベクターマップは、一部のデバイスやブラウザでは利用できない場合があります。その場合、マップは必要に応じてラスターマップにフォールバックされます。 |
restriction optional |
タイプ:
MapRestriction optionalユーザーがアクセスできる地図のエリアを制限する境界を定義します。設定すると、ユーザーはカメラビューが境界の範囲内にある間のみ、パンとズームを行うことができます。 |
rotateControl optional |
タイプ:
boolean optional回転コントロールの有効/無効状態。 |
rotateControlOptions optional |
タイプ:
RotateControlOptions optional回転コントロールの表示オプション。 |
scaleControl optional |
タイプ:
boolean optionalスケール コントロールの最初の有効/無効状態。 |
scaleControlOptions optional |
タイプ:
ScaleControlOptions optionalスケール コントロールの最初の表示オプション。 |
scrollwheel optional |
タイプ:
boolean optionalfalse の場合、マウスのスクロール ホイールを使用した地図のズームが無効になります。スクロール ホイールはデフォルトで有効になっています。注: このプロパティはおすすめしません。スクロール ホイールを使用したズームを無効にするには、 |
streetView optional |
タイプ:
StreetViewPanorama optionalストリートビューのペグマンが地図上にドロップされたときに表示される StreetViewPanorama。パノラマが指定されていない場合、ペグマンがドロップされると、デフォルトの StreetViewPanorama が地図の div に表示されます。 |
streetViewControl optional |
タイプ:
boolean optionalストリートビューのペグマン コントロールの初期の有効 / 無効状態。このコントロールはデフォルトの UI の一部であり、ストリートビューの道路オーバーレイを表示すべきでない地図タイプ(地球以外の地図タイプなど)を表示する場合は、 false に設定する必要があります。 |
streetViewControlOptions optional |
タイプ:
StreetViewControlOptions optionalストリートビューでペグマン コントロールの最初の表示オプション。 |
styles optional |
タイプ:
Array<MapTypeStyle> optionalデフォルトの地図タイプごとに適用するスタイル。 satellite/hybrid モードと terrain モードでは、これらのスタイルはラベルとジオメトリにのみ適用されます。この機能は、マップ ID を使用している場合や、ベクターマップを使用している場合は使用できません(代わりに Cloud ベースのマップのスタイル設定を使用してください)。 |
tilt optional |
タイプ:
number optionalベクターマップの場合、地図の入射角を設定します。指定できる値は、地図のズームレベルによって制限されます。ラスターマップの場合、地図の入射角の自動切り替え動作を制御します。指定できる値は 0 と 45 のみです。0 を指定すると、ズームレベルやビューポートに関係なく、地図は常に 0° の俯瞰ビューを使用します。値 45 を指定すると、現在のズームレベルとビューポートで 45° 画像が利用可能な場合は、傾斜角度が自動的に 45 に切り替わり、45° 画像が利用できない場合は 0 に戻ります(これがデフォルトの動作です)。45° 画像は、satellite および hybrid のマップタイプでのみ、一部の場所と一部のズームレベルで利用できます。注: getTilt は、このオプションで指定された値ではなく、現在の傾斜角度を返します。getTilt とこのオプションは異なるものを参照しているため、tilt プロパティを bind() しないでください。予期しない影響が生じる可能性があります。 |
tiltInteractionEnabled optional |
タイプ:
boolean optionalデフォルト:
falseユーザーがカメラの傾きを制御できるようにするかどうか。このオプションは、地図がベクターマップの場合にのみ有効です。コードで設定されていない場合は、マップ ID のクラウド構成が使用されます(利用可能な場合)。 |
zoom optional |
タイプ:
number optional地図の初期ズームレベル。有効なズーム値は、0 からサポートされている最大ズームレベルまでの数値です。ズーム値が大きいほど、解像度が高くなります。 |
zoomControl optional |
タイプ:
boolean optionalズーム コントロールの有効/無効状態。 |
zoomControlOptions optional |
タイプ:
ZoomControlOptions optionalズーム コントロールの表示オプション。 |
MapTypeStyle インターフェース
google.maps.MapTypeStyle インターフェース
MapTypeStyle は、地図のスタイルを定義するセレクタとスタイラーのコレクションです。セレクタは、影響を受ける地図の対象物や要素を指定し、スタイラは、それらの対象物や要素を変更する方法を指定します。詳しくは、スタイル リファレンスをご覧ください。
プロパティ | |
|---|---|
stylers |
選択した地図上の対象物と要素に適用するスタイルルール。ルールは、この配列で指定した順序で適用されます。使用方法と有効な値に関するガイドラインについては、スタイル リファレンスをご覧ください。 |
elementType optional |
タイプ:
string optionalスタイラを適用する要素。要素は、地図上の対象物の視覚的な側面です。たとえば、ラベル、アイコン、ジオメトリに適用されるストロークや塗りつぶしなどです。省略可。 elementType が指定されていない場合、値は 'all' であるとみなされます。使用方法と使用可能な値の詳細については、スタイル リファレンスをご覧ください。 |
featureType optional |
タイプ:
string optionalスタイラを適用する対象物または対象物のグループ。省略可。 featureType が指定されていない場合、値は 'all' であるとみなされます。使用方法と使用可能な値の詳細については、スタイル リファレンスをご覧ください。 |
MapMouseEvent インターフェース
google.maps.MapMouseEvent インターフェース
このオブジェクトは、地図やオーバーレイでのさまざまなマウスイベントから返され、以下に示すフィールドがすべて含まれています。
プロパティ | |
|---|---|
domEvent |
対応するネイティブ DOM イベント。デベロッパーは、 target、currentTarget、relatedTarget、path プロパティが定義され、一貫していることを前提とすべきではありません。また、デベロッパーは Maps API の内部実装の DOM 構造に依存しないようにする必要があります。内部イベント マッピングにより、domEvent のセマンティクスが MapMouseEvent と異なる場合があります(例: MapMouseEvent「クリック」の domEvent のタイプが KeyboardEvent になる場合があります)。 |
latLng optional |
タイプ:
LatLng optionalイベント発生時にカーソルの下にあった緯度 / 経度。 |
メソッド | |
|---|---|
stop |
stop()パラメータ: なし
戻り値:
voidこのイベントがこれ以上伝播されないようにします。 |
IconMouseEvent インターフェース
google.maps.IconMouseEvent インターフェース
このオブジェクトは、ユーザーが地図上のアイコンをクリックしたときにイベントで送信されます。この場所のプレイス ID は placeId メンバーに保存されます。デフォルトの情報ウィンドウが表示されないようにするには、このイベントで stop() メソッドを呼び出して、イベントが伝播されないようにします。プレイス ID について詳しくは、Places API デベロッパー ガイドをご覧ください。
このインターフェースは MapMouseEvent を拡張します。
プロパティ | |
|---|---|
placeId optional |
タイプ:
string optionalクリックされた場所のプレイス ID。このプレイス ID を使用して、クリックされた対象物に関する詳細情報をクエリできます。 プレイス ID について詳しくは、Places API デベロッパー ガイドをご覧ください。 |
継承元:
domEvent、
latLng
| |
メソッド | |
|---|---|
継承:
stop
|
ColorScheme 定数
google.maps.ColorScheme 定数
地図のカラーパターンの識別子。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'FOLLOW_SYSTEM' や、google.maps.ColorScheme.FOLLOW_SYSTEM です。
const {ColorScheme} = await google.maps.importLibrary("core") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
|---|---|
DARK |
地図のダーク カラーパターン。 |
FOLLOW_SYSTEM |
カラーパターンは、メソッドの実行時に 1 回チェックされるシステム設定に基づいて選択されます。 |
LIGHT |
地図のライト カラーパターン。以前の Maps JS のデフォルト値。 |
MapTypeId 定数
google.maps.MapTypeId 定数
一般的な MapType の識別子。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'satellite' や、google.maps.MapTypeId.SATELLITE です。
const {MapTypeId} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
|---|---|
HYBRID |
このマップ タイプは、航空写真上に主要な道路の透明なレイヤを表示します。 |
ROADMAP |
このマップ タイプは通常の市街地図を表示します。 |
SATELLITE |
このマップ タイプは航空写真を表示します。 |
TERRAIN |
このマップ タイプは地形や樹木などの地形的特徴を持つ地図を表示します。 |
MapTypeRegistry クラス
google.maps.MapTypeRegistry クラス
MapType インスタンスのレジストリ。MapType ID をキーとして使用します。
このクラスは MVCObject を拡張します。
const {MapTypeRegistry} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
MapTypeRegistry |
MapTypeRegistry()パラメータ: なし
MapTypeRegistry は、地図で使用可能なカスタム地図タイプのコレクションを保持します。API は、たとえばコントロール内で使用可能なマップタイプのリストを提供する際に、このレジストリを参照します。 |
メソッド | |
|---|---|
set |
set(id, mapType)パラメータ:
戻り値: なし
渡された文字列 ID を渡された MapType と関連付けるように、レジストリを設定します。 |
継承:
addListener、
bindTo、
get、
notify、
setValues、
unbind、
unbindAll
| |
MapRestriction インターフェース
google.maps.MapRestriction インターフェース
マップに適用できる制限。地図のビューポートは、これらの制限を超えません。
プロパティ | |
|---|---|
latLngBounds |
設定すると、ユーザーは指定された境界内でのみパンとズームを行うことができます。境界は、経度と緯度の両方を制限することも、緯度のみを制限することもできます。緯度のみの境界の場合は、西経と東経にそれぞれ -180 と 180 を使用します(例: latLngBounds: {north: northLat, south: southLat, west: -180, east: 180})。 |
strictBounds optional |
タイプ:
boolean optionalstrictBounds フラグを true に設定すると、境界をより制限的にすることができます。これにより、ユーザーがズームアウトできる範囲が制限され、制限された境界の外側にあるものはすべて非表示になります。デフォルトは false です。これは、ユーザーがズームアウトして、境界領域全体が表示されるまでズームアウトできることを意味します。境界領域外の領域も表示される可能性があります。 |
TrafficLayer クラス
google.maps.TrafficLayer クラス
交通レイヤ。
このクラスは MVCObject を拡張します。
const {TrafficLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
TrafficLayer |
TrafficLayer([opts])パラメータ:
現在の道路渋滞状況を表示するレイヤ。 |
メソッド | |
|---|---|
getMap |
getMap()パラメータ: なし
戻り値:
Map|nullこのレイヤが表示される地図を返します。 |
setMap |
setMap(map)パラメータ:
戻り値: なし
指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。 |
setOptions |
setOptions(options)パラメータ:
戻り値: なし
|
継承:
addListener、
bindTo、
get、
notify、
set、
setValues、
unbind、
unbindAll
| |
TrafficLayerOptions インターフェース
google.maps.TrafficLayerOptions インターフェース
TrafficLayerOptions オブジェクト。TrafficLayer に設定できるプロパティを定義するために使用します。
プロパティ | |
|---|---|
autoRefresh optional |
タイプ:
boolean optionalデフォルト:
true交通状況レイヤが更新された情報で自動的に更新されるかどうか。 |
map optional |
タイプ:
Map optional交通状況レイヤを表示する地図。 |
TransitLayer クラス
google.maps.TransitLayer クラス
交通機関レイヤ。
このクラスは MVCObject を拡張します。
const {TransitLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
TransitLayer |
TransitLayer()パラメータ: なし
交通機関の路線を表示するレイヤ。 |
メソッド | |
|---|---|
getMap |
getMap()パラメータ: なし
戻り値:
Map|nullこのレイヤが表示される地図を返します。 |
setMap |
setMap(map)パラメータ:
戻り値:
void指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。 |
継承:
addListener、
bindTo、
get、
notify、
set、
setValues、
unbind、
unbindAll
| |
BicyclingLayer クラス
google.maps.BicyclingLayer クラス
自動車レーンとパスを表示するレイヤ。
このクラスは MVCObject を拡張します。
const {BicyclingLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
|---|---|
BicyclingLayer |
BicyclingLayer()パラメータ: なし
自動車レーンとパスを表示し、幹線道路を目立たなくするレイヤ。 |
メソッド | |
|---|---|
getMap |
getMap()パラメータ: なし
戻り値:
Map|nullこのレイヤが表示される地図を返します。 |
setMap |
setMap(map)パラメータ:
戻り値:
void指定された地図にレイヤをレンダリングします。地図が null に設定されている場合、レイヤは削除されます。 |
継承:
addListener、
bindTo、
get、
notify、
set、
setValues、
unbind、
unbindAll
| |
CameraOptions インターフェース
google.maps.CameraOptions インターフェース
地図のカメラ オプションを設定するために使用されます。
プロパティ | |
|---|---|
center optional |
タイプ:
LatLngLiteral|LatLng optional |
heading optional |
タイプ:
number optional |
tilt optional |
タイプ:
number optional |
zoom optional |
タイプ:
number optional |
VisibleRegion インターフェース
google.maps.VisibleRegion インターフェース
地図の表示領域である四角形のポリゴンを定義する 4 つのポイントが含まれます。ベクターマップに傾斜がある場合、このポリゴンは長方形ではなく台形になることがあります。
プロパティ | |
|---|---|
farLeft |
タイプ:
LatLng |
farRight |
タイプ:
LatLng |
latLngBounds |
タイプ:
LatLngBounds表示されるリージョンを含む最小の境界ボックス。 |
nearLeft |
タイプ:
LatLng |
nearRight |
タイプ:
LatLng |
RenderingType 定数
google.maps.RenderingType 定数
const {RenderingType} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
|---|---|
RASTER |
地図がラスターマップであることを示します。 |
UNINITIALIZED |
地図の初期化がまだ完了していないため、地図がベクターかラスターかがまだ不明であることを示します。 |
VECTOR |
地図がベクターマップであることを示します。 |
MapCapabilities インターフェース
google.maps.MapCapabilities インターフェース
地図で現在利用可能な機能のスナップショットを含むオブジェクト。これは、関連するモジュールが読み込まれている、または初期化されていることを意味するのではなく、現在の地図にこれらの API を使用する権限があることを意味します。可能な機能の一覧については、プロパティをご覧ください。
プロパティ | |
|---|---|
isAdvancedMarkersAvailable optional |
タイプ:
boolean optionaltrue の場合、この地図は高度なマーカーを使用できるように適切に構成されています。高度なマーカーを使用するには、 marker ライブラリをインポートする必要があります。詳しくは、https://goo.gle/gmp-isAdvancedMarkersAvailable をご覧ください。 |
isDataDrivenStylingAvailable optional |
タイプ:
boolean optionaltrue の場合、この地図は、少なくとも 1 つの FeatureLayer でデータドリブン スタイル設定を使用できるように適切に構成されています。詳しくは、https://goo.gle/gmp-data-driven-styling と https://goo.gle/gmp-FeatureLayerIsAvailable をご覧ください。 |
isWebGLOverlayViewAvailable optional |
タイプ:
boolean optionaltrue の場合、このマップは WebGLOverlayView を使用できるように正しく構成されています。 |