GoogleMap

public final クラス GoogleMap 拡張 Object

これは Google Maps SDK for Android のメインクラスであり、地図に関連するすべてのメソッドのエントリ ポイントです。GoogleMap オブジェクトを直接インスタンス化することはできません。アプリに追加した MapFragment または MapView の getMapAsync() メソッドから取得する必要があります。

注: View オブジェクトと同様に、GoogleMap は Android UI スレッドからのみ読み取りと変更を行えます。別のスレッドから GoogleMap メソッドを呼び出すと、例外が発生します。

（地図を動かすのではなく）カメラの位置を変更することで、地図の視点を調整できます。地図のカメラを使用して、位置、ズームレベル、傾斜角、Bearing（水平方向の向き）などのパラメータを設定できます。詳しくは、カメラとビューをご覧ください。

デベロッパー ガイド

開始するには、Google Maps SDK for Android デベロッパー ガイドをご覧ください。

ネストクラスの概要

インターフェース GoogleMap.CancelableCallback タスクが完了またはキャンセルされたことを報告するためのコールバック インターフェース。
インターフェース GoogleMap.InfoWindowAdapter 情報ウィンドウのカスタマイズ レンダリングを行うビューを提供します。
インターフェース GoogleMap.OnCameraChangeListener このインターフェースは非推奨になりました。GoogleMap.OnCameraMoveStartedListener、GoogleMap.OnCameraMoveListener、GoogleMap.OnCameraIdleListener に置き換えられました。非推奨になった onCameraChange メソッドが、新しいカメラ変更リスナーのメソッドに対して呼び出される順序は未定義です。  
インターフェース GoogleMap.OnCameraIdleListener カメラの移動が終了したときのコールバック インターフェース。
インターフェース GoogleMap.OnCameraMoveCanceledListener カメラの動きが停止したとき、または新しい理由でカメラが動き始めたときのコールバック インターフェース。
インターフェース GoogleMap.OnCameraMoveListener カメラの位置が変更されたときのコールバック インターフェース。
インターフェース GoogleMap.OnCameraMoveStartedListener カメラのモーションが開始されたときのコールバック インターフェース。
インターフェース GoogleMap.OnCircleClickListener 円がクリックされたときのコールバック インターフェース。
インターフェース GoogleMap.OnGroundOverlayClickListener 地面オーバーレイをクリックしたときのコールバック インターフェース。
インターフェース GoogleMap.OnIndoorStateChangeListener 室内状態が変化したときのリスナー。
インターフェース GoogleMap.OnInfoWindowClickListener マーカーの情報ウィンドウでのクリック/タップ イベントのコールバック インターフェースです。
インターフェース GoogleMap.OnInfoWindowCloseListener マーカーの情報ウィンドウでの閉じるイベントのコールバック インターフェースです。
インターフェース GoogleMap.OnInfoWindowLongClickListener ユーザーがマーカーの情報ウィンドウを長押ししたときのコールバック インターフェース。
インターフェース GoogleMap.OnMapClickListener ユーザーが地図をタップしたときのコールバック インターフェース。
インターフェース GoogleMap.OnMapLoadedCallback 地図のレンダリングが完了したときのコールバック インターフェース。
インターフェース GoogleMap.OnMapLongClickListener ユーザーが地図上で長押ししたときのコールバック インターフェース。
インターフェース GoogleMap.OnMarkerClickListener マーカーがクリックまたはタップされたときに呼び出されるメソッドのシグネチャを定義します。
インターフェース GoogleMap.OnMarkerDragListener マーカーでのドラッグ イベント用のコールバック インターフェース。
インターフェース GoogleMap.OnMyLocationButtonClickListener 現在地ボタンがクリックされたときのコールバック インターフェース。
インターフェース GoogleMap.OnMyLocationChangeListener このインターフェースは非推奨になりました。代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。FusedLocationProviderApi は、位置情報の検出と電力使用量を改善し、「現在地」の青い点で使用されます。FusedLocationProviderApi の使用方法については、 現在の場所を選択するチュートリアルまたは位置情報に関するデベロッパー ガイドをご覧ください。  
インターフェース GoogleMap.OnMyLocationClickListener 現在地を示すドット（ユーザーの現在地）がクリックされたときのコールバック インターフェース。
インターフェース GoogleMap.OnPoiClickListener スポットのタップのリスナー。
インターフェース GoogleMap.OnPolygonClickListener ポリゴンがクリックされたときのコールバック インターフェース。
インターフェース GoogleMap.OnPolylineClickListener ポリラインがクリックされたときのコールバック インターフェース。
インターフェース GoogleMap.SnapshotReadyCallback スナップショットが取得されたときに通知するためのコールバック インターフェース。

定数の概要

int MAP_TYPE_HYBRID 主要道路の透明なレイヤを使用した航空写真地図。
int MAP_TYPE_NONE 基本地図タイルはありません。
int MAP_TYPE_NORMAL 基本的な地図
int MAP_TYPE_SATELLITE ラベルのない航空写真地図。
int MAP_TYPE_TERRAIN 地形図

パブリック メソッドの概要

Circle
addCircle（CircleOptions オプション）
この地図に円を追加してください。
GroundOverlay
addGroundOverlay（GroundOverlayOptions オプション）
この地図に画像を追加します。
マーカー
addMarker（MarkerOptions オプション）
この地図にマーカーを追加します。
ポリゴン
addPolygon（PolygonOptions オプション）
この地図にポリゴンを追加します。
ポリライン
addPolyline（PolylineOptions オプション）
この地図にポリラインを追加します。
TileOverlay
addTileOverlay（TileOverlayOptions オプション）
タイル オーバーレイをこの地図に追加します。
void
animateCamera（CameraUpdate アップデート）
現在位置から更新で定義された位置へのカメラの移動をアニメーション化します。
void
animateCamera（CameraUpdate 更新、GoogleMap.CancelableCallback コールバック）
現在の位置から更新で定義された位置へのカメラの移動をアニメーション化し、完了時にオプションのコールバックを呼び出します。
void
animateCamera（CameraUpdate の更新、int durationMs、GoogleMap.CancelableCallback コールバック）
更新に従って、指定された時間にわたってアニメーションで地図を移動し、完了時にオプションのコールバックを呼び出します。
void
clear()
すべてのマーカー、ポリライン、ポリゴン、オーバーレイなどを地図から削除します。
CameraPosition
getCameraPosition()
カメラの現在の位置を取得します。
IndoorBuilding
getFocusedBuilding()
現在フォーカスされている建物を取得します。
整数
getMapType()
現在表示されている地図のタイプを取得します。
浮動小数点数
getMaxZoomLevel()
現在のカメラ位置の最大ズームレベルを返します。
浮動小数点数
getMinZoomLevel()
最小ズームレベルを返します。
位置情報
getMyLocation()
このメソッドは非推奨となりました。代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。FusedLocationProviderApi は、位置情報の検出と電力使用量を改善し、「現在地」の青い点で使用されます。サンプルコードについては、サンプル アプリケーション フォルダ内にある MyLocationDemoActivity または位置情報に関するデベロッパー ガイドをご覧ください。
投影
getProjection()
画面座標と緯度/経度の座標を変換するために使用できる Projection オブジェクトを返します。
UiSettings
getUiSettings()
地図のユーザー インターフェース設定を取得します。
ブール値
isBuildingsEnabled()
建物の 3D 表示レイヤが有効かどうかを返します。
ブール値
isIndoorEnabled()
インドアマップが現在有効になっているかどうかを取得します。
ブール値
isMyLocationEnabled()
現在地レイヤのステータスを取得します。
ブール値
isTrafficEnabled()
地図に交通状況データを描画しているかどうかを確認します。
void
moveCamera（CameraUpdate アップデート）
アップデートで定義されている指示に従って、カメラの位置を変更します。
void
resetMinMaxZoomPreference()
以前に指定したズーム上限と下限をすべて削除します。
void
setBuildingsEnabled（ブール値が有効）
建物の 3D 表示レイヤをオンまたはオフにします。
void
setContentDescription（文字列の説明）
地図の contentDescription を設定します。
ブール値
setIndoorEnabled（ブール値が有効）
インドアマップを有効にするかどうかを設定します。
void
setInfoWindowAdapter（GoogleMap.InfoWindowAdapter アダプタ）
情報ウィンドウのコンテンツ用のカスタム レンダラを設定します。
void
setLatLngBoundsForCameraTarget（LatLngBounds 境界）
ユーザーが地図をスクロールしてパンしたときに、カメラ ターゲットがこれらの境界の外に移動しないように、LatLngBounds を指定してカメラ ターゲットを制限します。
void
setLocationSource（LocationSource ソース）
my-location レイヤの位置情報ソースを置き換えます。
ブール値
setMapStyle（MapStyleOptions style）
基本地図のスタイルを設定します。
void
setMapType（int 型）
表示する地図タイルのタイプを設定します。
void
setMaxZoomPreference（float maxZoomPreference）
カメラのズームの優先上限を設定します。
void
setMinZoomPreference（float minZoomPreference）
カメラズームの下限を設定します。
void
setMyLocationEnabled（ブール値が有効）
現在地レイヤを有効または無効にします。
void
setOnCameraChangeListener（GoogleMap.OnCameraChangeListener リスナー）
このメソッドは非推奨となりました。setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)、setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)、setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)、setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) に置き換えられます。
void
setOnCameraIdleListener（GoogleMap.OnCameraIdleListener リスナー）
カメラの移動が終了したときに呼び出されるコールバックを設定します。
void
setOnCameraMoveCanceledListener（GoogleMap.OnCameraMoveCanceledListener リスナー）
カメラのモーションが新しいタイプのアニメーションによって停止または中断されたときに呼び出されるコールバックを設定します。
void
setOnCameraMoveListener（GoogleMap.OnCameraMoveListener リスナー）
カメラの移動中に繰り返し呼び出されるコールバックを設定します。
void
setOnCameraMoveStartedListener（GoogleMap.OnCameraMoveStartedListener リスナー）
カメラが移動を開始したとき、またはカメラのモーションの理由が変更されたときに呼び出されるコールバックを設定します。
void
setOnCircleClickListener（GoogleMap.OnCircleClickListener リスナー）
円がクリックされたときに呼び出されるコールバックを設定します。
void
setOnGroundOverlayClickListener（GoogleMap.OnGroundOverlayClickListener リスナー）
地面オーバーレイがクリックされたときに呼び出されるコールバックを設定します。
void
setOnIndoorStateChangeListener（GoogleMap.OnIndoorStateChangeListener リスナー）
屋内イベントのリスナーを設定またはクリアします。
void
setOnInfoWindowClickListener（GoogleMap.OnInfoWindowClickListener リスナー）
マーカー情報ウィンドウがクリックされたときに呼び出されるコールバックを設定します。
void
setOnInfoWindowCloseListener（GoogleMap.OnInfoWindowCloseListener リスナー）
マーカーの情報ウィンドウが閉じられたときに呼び出されるコールバックを設定します。
void
setOnInfoWindowLongClickListener（GoogleMap.OnInfoWindowLongClickListener リスナー）
マーカーの情報ウィンドウが長押しされたときに呼び出されるコールバックを設定します。
void
setOnMapClickListener（GoogleMap.OnMapClickListener リスナー）
地図がタップされたときに呼び出されるコールバックを設定します。
void
setOnMapLoadedCallback（GoogleMap.OnMapLoadedCallback コールバック）
この地図のレンダリングが完了すると呼び出されるコールバックを設定します。
void
setOnMapLongClickListener（GoogleMap.OnMapLongClickListener リスナー）
地図が長押しされたときに呼び出されるコールバックを設定します。
void
setOnMarkerClickListener（GoogleMap.OnMarkerClickListener リスナー）
マーカーがクリックされたときに呼び出されるコールバックを設定します。
void
setOnMarkerDragListener（GoogleMap.OnMarkerDragListener リスナー）
マーカーがドラッグされたときに呼び出されるコールバックを設定します。
void
setOnMyLocationButtonClickListener（GoogleMap.OnMyLocationButtonClickListener リスナー）
現在地ボタンがクリックされたときに呼び出されるコールバックを設定します。
void
setOnMyLocationChangeListener（GoogleMap.OnMyLocationChangeListener リスナー）
このメソッドは非推奨となりました。代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。FusedLocationProviderApi は、位置情報の検出と電力使用量を改善し、「現在地」の青い点で使用されます。サンプルコードについては、サンプル アプリケーション フォルダ内にある MyLocationDemoActivity または位置情報に関するデベロッパー ガイドをご覧ください。
void
setOnMyLocationClickListener（GoogleMap.OnMyLocationClickListener リスナー）
現在地を示すドット（ユーザーの現在地を示す）がクリックされたときに呼び出されるコールバックを設定します。
void
setOnPoiClickListener（GoogleMap.OnPoiClickListener リスナー）
スポットがクリックまたはタップされたときにトリガーされるリスナーを設定します。
void
setOnPolygonClickListener（GoogleMap.OnPolygonClickListener リスナー）
ポリゴンがクリックされたときに呼び出されるコールバックを設定します。
void
setOnPolylineClickListener（GoogleMap.OnPolylineClickListener リスナー）
ポリラインがクリックされたときに呼び出されるコールバックを設定します。
void
setPadding（int left, int top, int right, int down）
地図上にパディングを設定します。
void
setTrafficEnabled（ブール値が有効）
交通状況レイヤをオンまたはオフにします。
void
snapshot（GoogleMap.SnapshotReadyCallback コールバック）
地図のスナップショットを取得します。
void
snapshot（GoogleMap.SnapshotReadyCallback コールバック、ビットマップ ビットマップ）
地図のスナップショットを取得します。
void
stopAnimation()
カメラのアニメーションがある場合は、アニメーションを停止します。

継承されたメソッドの概要

定数

public static final int MAP_TYPE_HYBRID

主要道路の透明なレイヤを使用した航空写真地図。

定数値: 4

public static final int MAP_TYPE_NONE

基本地図タイルはありません。

定数値: 0

public static final int MAP_TYPE_NORMAL

基本的な地図

定数値: 1

public static final int MAP_TYPE_SATELLITE

ラベルのない航空写真地図。

定数値: 2

public static final int MAP_TYPE_TERRAIN

地形図

定数値: 3

パブリック メソッド

public Circle addCircle （CircleOptions オプション）

この地図に円を追加してください。

パラメータ
オプション 円のレンダリング方法を定義する円のオプション オブジェクト。
戻り値
  • 地図に追加される Circle オブジェクト

public GroundOverlay addGroundOverlay （GroundOverlayOptions オプション）

この地図に画像を追加します。

パラメータ
オプション オーバーレイのレンダリング方法を定義する地面オーバーレイ オプション オブジェクト。オプションでは、画像（AnchoredBitmap）と位置を指定する必要があります。
戻り値
例外
IllegalArgumentException オプションで画像または位置のいずれかが指定されていない場合。

public Marker addMarker （MarkerOptions オプション）

この地図にマーカーを追加します。

マーカーのアイコンは、地図上の Marker.position の位置にレンダリングされます。マーカーをクリックすると、マーカーの中心にカメラが配置されます。Marker.title が定義されている場合は、マーカーのタイトルとスニペットが記載された情報ボックスが地図に表示されます。マーカーがドラッグ可能な場合は、長押ししてからドラッグすると、マーカーが移動します。

パラメータ
オプション マーカーのレンダリング方法を定義するマーカー オプション オブジェクト。
戻り値
  • 地図に追加された Marker。

public Polygon addPolygon （PolygonOptions のオプション）

この地図にポリゴンを追加します。

パラメータ
オプション ポリゴンのレンダリング方法を定義するポリゴン オプション オブジェクト。
戻り値
  • 地図に追加される Polygon オブジェクト。

public Polyline addPolyline （PolylineOptions のオプション）

この地図にポリラインを追加します。

パラメータ
オプション ポリラインのレンダリング方法を定義するポリライン オプション オブジェクト。
戻り値
  • 地図に追加された Polyline オブジェクト。

public TileOverlay addTileOverlay （TileOverlayOptions オプション）

タイル オーバーレイをこの地図に追加します。詳しくは、TileOverlay をご覧ください。

他のオーバーレイとは異なり、地図を再作成した場合、タイル オーバーレイは自動的に復元されないため、手動で追加し直す必要があります。

パラメータ
オプション オーバーレイのレンダリング方法を定義するタイル オーバーレイ オプション オブジェクト。オプションには TileProvider を指定する必要があります。指定しないと、IllegalArgumentException がスローされます。
戻り値
例外
IllegalArgumentException オプションで TileProvider が指定されていない場合。

public void animateCamera （CameraUpdate の更新）

現在位置から更新で定義された位置へのカメラの移動をアニメーション化します。アニメーション中に getCameraPosition() を呼び出すと、カメラの中間位置が返されます。

更新内容については、CameraUpdateFactory をご覧ください。

パラメータ
update カメラに適用する変更。

public void animateCamera （CameraUpdate の更新、GoogleMap.CancelableCallback コールバック）

現在の位置から更新で定義された位置へのカメラの移動をアニメーション化し、完了時にオプションのコールバックを呼び出します。更新内容については、CameraUpdateFactory をご覧ください。

アニメーション中に getCameraPosition() を呼び出すと、カメラの中間位置が返されます。

パラメータ
update カメラに適用する変更。
callback アニメーションが停止したときに Android UI スレッドから呼び出すコールバック。アニメーションが正常に終了した場合は onFinish() が呼び出され、それ以外の場合は onCancel() が呼び出されます。onCancel() 内からカメラを更新したり、アニメーション化したりしないでください。

public void animateCamera （CameraUpdate の更新、int durationMs、GoogleMap.CancelableCallback コールバック）

更新に従って、指定された時間にわたってアニメーションで地図を移動し、完了時にオプションのコールバックを呼び出します。更新内容については、CameraUpdateFactory をご覧ください。

アニメーション中に getCameraPosition() が呼び出されると、飛行中のカメラの現在地が返されます。

パラメータ
update
durationMs アニメーションの再生時間（ミリ秒単位）。これは真に正の数である必要があります。そうでない場合、IllegalArgumentException がスローされます。
callback アニメーションが停止したときに Android UI スレッドから通知されるコールバック（省略可）。自然な完了によってアニメーションが停止した場合、コールバックは onFinish() で通知されます。その後のカメラ移動やユーザー操作による中断でアニメーションが停止した場合は、onCancel() が呼び出されます。コールバックは、キャンセル メソッドでカメラの移動やアニメーション化を試行してはなりません。コールバックが不要な場合は、null のままにします。

public void clear ()

すべてのマーカー、ポリライン、ポリゴン、オーバーレイなどを地図から削除します。

public CameraPosition getCameraPosition ()

カメラの現在の位置を取得します。

返される CameraPosition は、現在位置のスナップショットであり、カメラが移動しても自動的には更新されません。

カメラの位置の変更について詳しくは、カメラとビューをご覧ください。

戻り値
  • カメラの現在の位置。

public IndoorBuilding getFocusedBuilding ()

現在フォーカスされている建物を取得します。

戻り値
  • 現在のフォーカスされている建物。フォーカスされていない場合は null。

public int getMapType ()

現在表示されている地図のタイプを取得します。有効な値については、MAP_TYPE_NORMAL、MAP_TYPE_SATELLITE、MAP_TYPE_TERRAIN をご覧ください。

戻り値
  • 地図タイプ。

public float getMaxZoomLevel ()

現在のカメラ位置の最大ズームレベルを返します。その際、現在使用されているマップタイプが考慮されます。たとえば、衛星地図や地形地図は、基本地図タイルよりも最大ズームレベルが低い場合があります。

カメラのズームレベルの変更について詳しくは、カメラとビューをご覧ください。

戻り値
  • 現在のカメラ位置で利用可能な最大ズームレベル。

public float getMinZoomLevel ()

最小ズームレベルを返します。これは（最大ズームレベルとは異なり）すべての場所で同じですが、デバイスと地図サイズによって異なる場合があります。

カメラのズームレベルの変更について詳しくは、カメラとビューをご覧ください。

戻り値
  • 利用可能な最小ズームレベル。

public Location getMyLocation ()

このメソッドは非推奨になりました。
代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。FusedLocationProviderApi は、位置情報の検出と電力使用量を改善し、「現在地」の青い点で使用されます。サンプルコードについては、サンプル アプリケーション フォルダ内にある MyLocationDemoActivity または位置情報に関するデベロッパー ガイドをご覧ください。

現在表示されているユーザーの位置情報を返します。利用可能な位置情報がない場合は null を返します。

戻り値
例外
IllegalStateException 現在地レイヤが有効になっていない場合です。

public Projection getProjection ()

画面座標と緯度/経度の座標を変換するために使用できる Projection オブジェクトを返します。

返される Projection は現在の投影のスナップショットであり、カメラが移動しても自動的には更新されません。この操作はコストがかかるため、投影は画面ごとに 1 回だけ行う必要があります。Google マップでは、メルカトル図法を使用して地理データから地図を作成し、地図上のポイントを地理座標に変換します。

戻り値

public UiSettings getUiSettings ()

地図のユーザー インターフェース設定を取得します。

戻り値

public boolean isBuildingsEnabled ()

建物の 3D 表示レイヤが有効かどうかを返します。

戻り値
  • 建物が有効な場合は true、そうでない場合は false です。

public boolean isIndoorEnabled ()

インドアマップが現在有効になっているかどうかを取得します。

戻り値
  • インドアマップが有効な場合は true、インドアマップが無効な場合は false。

public boolean isMyLocationEnabled ()

現在地レイヤのステータスを取得します。

戻り値
  • 現在地レイヤが有効になっている場合は true、そうでない場合は false。

public boolean isTrafficEnabled ()

地図に交通状況データを描画しているかどうかを確認します。ただし、トラフィック データを利用できるかどうかが条件となります。

戻り値
  • トラフィック データが有効な場合は true、そうでない場合は false。

public void moveCamera （CameraUpdate アップデート）

アップデートで定義されている指示に従って、カメラの位置を変更します。移動は瞬時に行われ、その後の getCameraPosition() に新しい位置が反映されます。更新内容については、CameraUpdateFactory をご覧ください。

パラメータ
update カメラに適用する変更。

public void resetMinMaxZoomPreference ()

以前に指定したズーム上限と下限をすべて削除します。

public void setBuildingsEnabled (boolean enabled)

建物の 3D 表示レイヤをオンまたはオフにします。

パラメータ
有効 建物の 3D 表示レイヤを有効にする場合は true、建物の 3D 表示を無効にする場合は false です。

public void setContentDescription （文字列の説明）

地図の contentDescription を設定します。

ユーザー補助モードで、地図の音声による説明を提供するために使用されます。デフォルト値は「Google マップ」です。

パラメータ
説明 説明として使用する文字列。

public boolean setIndoorEnabled (boolean enabled)

インドアマップを有効にするかどうかを設定します。現在、インドアマップは一度に 1 つの地図にのみ表示できます。デフォルトでは、これがアプリケーションに最初に追加された地図です。別の地図でインドアマップを有効にするには、まず元の地図のインドアマップを無効にする必要があります。インドアマップを別の地図で有効にしている場合でも、有効にしようとしても何も起こらず、false が返されます。地図で Indoor が有効になっていない場合、屋内に関連するすべてのメソッドは null または false を返します。

パラメータ
有効 インドアマップを有効にするには true、インドアマップを無効にするには false にします。
戻り値
  • インドアマップを有効にできるかどうか。

public void setInfoWindowAdapter （GoogleMap.InfoWindowAdapter アダプタ）

情報ウィンドウのコンテンツ用のカスタム レンダラを設定します。

地図のイベント リスナーと同様、この状態は地図にシリアル化されません。構成の変更などにより地図が再作成された場合、カスタマイズを保持するため、このメソッドを再度呼び出してください。

パラメータ
アダプター 情報ウィンドウのコンテンツに使用するアダプター。情報ウィンドウでデフォルトのコンテンツ レンダリングを使用する場合は null を指定します。

public void setLatLngBoundsForCameraTarget （LatLngBounds 境界）

ユーザーが地図をスクロールしてパンしたときに、カメラ ターゲットがこれらの境界の外に移動しないように、LatLngBounds を指定してカメラ ターゲットを制限します。

境界ボックスを完全に消去するには、null に設定します。以前に指定した境界ボックスが新しい境界に置き換えられます。

LatLngBounds が変更されると、可能であれば、その境界に沿って以降のすべてのカメラ更新が調整されます。技術的な考慮事項により、SDK がカメラ ターゲットを境界内に収めるのを妨げる場合があります。たとえば、浮動小数点精度の丸め誤差や、ズームレベルが非常に低い場合などです。

パラメータ
bounds カメラ ターゲットを制限する範囲。

public void setLocationSource （LocationSource のソース）

my-location レイヤの位置情報ソースを置き換えます。

パラメータ
target my-location レイヤで使用する位置情報ソースです。デフォルトの位置情報を使用するには、null に設定します。

public boolean setMapStyle （MapStyleOptions スタイル）

基本地図のスタイルを設定します。

スタイル オプションを使用すると、地図上の対象物や要素にカスタム スタイルを適用できます。スタイルの定義については、MapStyleOptions をご覧ください。

null に設定すると、以前のカスタム スタイルがクリアされます。

パラメータ
スタイル
戻り値
  • スタイルが正常に解析された場合は true、MapStyleOptions で解析不能なスタイル設定 JSON、認識できない対象物タイプ、認識できない要素タイプ、無効なスタイラキーなどの問題が検出された場合は false。戻り値が false の場合、現在のスタイルは変更されません。

public void setMapType （int タイプ）

表示する地図タイルのタイプを設定します。指定できる値は次のとおりです。

パラメータ
type 表示する地図のタイプ。

public void setMaxZoomPreference (float maxZoomPreference)

カメラズームの優先上限を設定します。

最大ズームが変更されると、SDK は以降のすべてのカメラ更新を、可能な限りその最大ズームに基づいて調整します。技術的な考慮事項により、SDK ではユーザーが地図を深く掘り下げることができない場合があります。たとえば、衛星地図や地形地図は、基本地図タイルよりも最大ズームレベルが低いことがあります。

SDK は最小値と最大値の競合を解決します。最小ズームレベルを現在の最大レベルよりも高い値に設定すると、SDK では最小値と最大値の両方に新しい最小値が使用されます。最大ズームレベルを最小値よりも低いズームレベルに設定すると、SDK では最小値と最大値に新しい最大値が使用されます。たとえば、現在の最小ズームが 8、最大ズームが 14 であるとします。次に、最大ズームを 6 に設定します。SDK では最小ズーム 6 と最大ズーム 6 が使用されます。

パラメータ
maxZoomPreference 優先される上限。

public void setMinZoomPreference （float minZoomPreference）

カメラズームの下限を設定します。

最小ズームが変更されると、可能であれば、SDK は以降のすべてのカメラ更新を、可能な限りその最小ズームを尊重するように調整します。なお、技術的な考慮事項により、SDK では極端に低いズームレベルに対応できない場合があることに注意してください。

SDK は最小値と最大値の競合を解決します。最小ズームレベルを現在の最大レベルよりも高い値に設定すると、SDK では最小値と最大値の両方に新しい最小値が使用されます。最大ズームレベルを最小値よりも低いズームレベルに設定すると、SDK では最小値と最大値に新しい最大値が使用されます。たとえば、現在の最小ズームが 8、最大ズームが 14 であるとします。次に、最小ズームを 16 に設定します。SDK は最小ズーム 16 と最大ズーム 16 を使用します。

パラメータ
minZoomPreference 優先される下限。

public void setMyLocationEnabled (boolean enabled)

現在地レイヤを有効または無効にします。

現在地レイヤが有効で位置情報が利用可能な場合、現在地レイヤはユーザーの現在地と方角を継続的に描画し、ユーザーが現在地を操作するための UI コントロールを表示します（例: カメラによる位置と方角のトラッキングを有効または無効にします）。

現在地レイヤ機能を使用するには、カスタムの位置情報ソースを設定していない限り、ACCESS_COARSE_LOCATION または ACCESS_FINE_LOCATION の権限をリクエストする必要があります。

setLocationSource(LocationSource) を使用してカスタムの位置情報を設定した場合、Google Maps SDK for Android は上記の権限が付与されているかどうかを確認しません。ただし、カスタム位置情報ソースに必要なすべての権限をユーザーが付与していることは確認する必要があります。

パラメータ
有効 有効にする場合は true、無効にする場合は false です。
例外
SecurityException 位置情報の利用許可が付与されていない場合。

public void setOnCameraChangeListener （GoogleMap.OnCameraChangeListener リスナー）

このメソッドは非推奨になりました。
: setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)、setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)、setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)、setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) に置き換えられます。

カメラが変更されたときに呼び出されるコールバックを設定します。

パラメータ
リスナー カメラが変更されたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnCameraIdleListener （GoogleMap.OnCameraIdleListener リスナー）

カメラの移動が終了したときに呼び出されるコールバックを設定します。

パラメータ
リスナー 呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnCameraMoveCanceledListener （GoogleMap.OnCameraMoveCanceledListener リスナー）

カメラのモーションが新しいタイプのアニメーションによって停止または中断されたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。onCameraMoveCanceled() 内からカメラを更新したり、アニメーション化したりしないでください。

public void setOnCameraMoveListener （GoogleMap.OnCameraMoveListener リスナー）

カメラの移動中に繰り返し呼び出されるコールバックを設定します。このコールバックは、フレームごとに 1 回程度の頻度で呼び出すことができます。負荷の大きいオペレーションは実行しないようにする必要があります。

パラメータ
リスナー 呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnCameraMoveStartedListener （GoogleMap.OnCameraMoveStartedListener リスナー）

カメラが移動を開始したとき、またはカメラのモーションの理由が変更されたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。onCameraMoveStarted() 内からカメラを更新したり、アニメーション化したりしないでください。

public void setOnCircleClickListener （GoogleMap.OnCircleClickListener リスナー）

円がクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 円がクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnGroundOverlayClickListener （GoogleMap.OnGroundOverlayClickListener リスナー）

地面オーバーレイがクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 地面オーバーレイがクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnIndoorStateChangeListener （GoogleMap.OnIndoorStateChangeListener リスナー）

屋内イベントのリスナーを設定またはクリアします。リスナーは 1 つだけ設定できます。新しいリスナーを設定すると、以前のリスナーは削除されます。

パラメータ
リスナー null でない場合、屋内イベントのリスナー。それ以外の場合は、リスナーを消去します。

public void setOnInfoWindowClickListener （GoogleMap.OnInfoWindowClickListener リスナー）

マーカー情報ウィンドウがクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー マーカー情報ウィンドウがクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnInfoWindowCloseListener （GoogleMap.OnInfoWindowCloseListener リスナー）

マーカーの情報ウィンドウが閉じられたときに呼び出されるコールバックを設定します。

パラメータ
リスナー マーカーの情報ウィンドウが閉じられたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnInfoWindowLongClickListener （GoogleMap.OnInfoWindowLongClickListener リスナー）

マーカーの情報ウィンドウが長押しされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー マーカーの情報ウィンドウが長押しされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMapClickListener （GoogleMap.OnMapClickListener リスナー）

地図がタップされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 地図がタップされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMapLoadedCallback （GoogleMap.OnMapLoadedCallback コールバック）

この地図のレンダリングが完了すると呼び出されるコールバックを設定します。コールバックは 1 回だけ呼び出されます。

地図が完全にレンダリングされたときにこのメソッドが呼び出されると、コールバックが直ちに呼び出されます。接続の問題により地図が読み込まれない場合や、地図が絶えず変化していてユーザーが地図を常時操作しているため読み込みが完了しない場合、このイベントは発生しません。

パラメータ
callback 地図のレンダリングが完了すると呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMapLongClickListener （GoogleMap.OnMapLongClickListener リスナー）

地図が長押しされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 地図が長押しされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMarkerClickListener （GoogleMap.OnMarkerClickListener リスナー）

マーカーがクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー マーカーがクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMarkerDragListener （GoogleMap.OnMarkerDragListener リスナー）

マーカーがドラッグされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー マーカーのドラッグ イベントで呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnMyLocationButtonClickListener （GoogleMap.OnMyLocationButtonClickListener リスナー）

現在地ボタンがクリックされたときに呼び出されるコールバックを設定します。

listener が true を返す場合、イベントは消費され、デフォルトの動作は発生しません。false が返された場合は、デフォルトの動作（ユーザーの現在地が中心になるようにカメラが移動する）が発生します。

パラメータ
リスナー 現在地ボタンがクリックされたときに呼び出されるコールバック。

public void setOnMyLocationChangeListener （GoogleMap.OnMyLocationChangeListener リスナー）

このメソッドは非推奨になりました。
代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。FusedLocationProviderApi は、位置情報の検出と電力使用量を改善し、「現在地」の青い点で使用されます。サンプルコードについては、サンプル アプリケーション フォルダ内にある MyLocationDemoActivity または位置情報に関するデベロッパー ガイドをご覧ください。

現在地を示す点が現在地が変更されたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 現在地のドットが変更されたときに呼び出されるコールバック。

public void setOnMyLocationClickListener （GoogleMap.OnMyLocationClickListener リスナー）

現在地を示すドット（ユーザーの現在地を示す）がクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー 現在地のドットがクリックされたときに呼び出されるコールバック。

public void setOnPoiClickListener （GoogleMap.OnPoiClickListener リスナー）

スポットがクリックまたはタップされたときにトリガーされるリスナーを設定します。

null を渡して、リスナーをクリアします。

パラメータ
リスナー

public void setOnPolygonClickListener （GoogleMap.OnPolygonClickListener リスナー）

ポリゴンがクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー ポリゴンがクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setOnPolylineClickListener （GoogleMap.OnPolylineClickListener リスナー）

ポリラインがクリックされたときに呼び出されるコールバックを設定します。

パラメータ
リスナー ポリラインがクリックされたときに呼び出されるコールバック。コールバックの設定を解除するには、null を使用します。

public void setPadding （int left, int top, int right, int down）

地図上にパディングを設定します。

このメソッドを使用すると、マップの表示領域を定義し、マップの 4 辺のそれぞれにパディングを設定して、縁の周りのマップの部分を隠すことができることをマップに知らせます。マップの関数がパディングに合わせて調整されます。たとえば、ズーム コントロール、コンパス、著作権に関する通知、Google ロゴは定義された領域内に収まるように移動したり、カメラの移動は表示領域の中心を基準として移動したりできます。

パラメータ
左 地図の左側に追加するパディングのピクセル数。
上 地図の上部に追加するパディングのピクセル数。
右 地図の右側に追加するパディングのピクセル数。
下 地図の下部に追加するパディングのピクセル数。

public void setTrafficEnabled (boolean enabled)

交通状況レイヤをオンまたはオフにします。

パラメータ
有効

public void snapshot （GoogleMap.SnapshotReadyCallback コールバック）

地図のスナップショットを取得します。

インタラクティブな地図を使用するのが難しい場合や不可能な場合は、アプリケーション内でスナップショットを使用できます。たとえば、snapshot() メソッドで生成された画像は、アプリで地図のサムネイルを表示したり、通知センターにスナップショットを表示するために使用できます。

注: 地図の画像をサーバーに送信したり、アプリの外部で使用したりしないでください。地図を別のアプリケーションやユーザーに送信する必要がある場合は、スナップショットではなく、新しいユーザー用に地図を再構築できるデータを送信します。

パラメータ
callback スナップショットが取得されたときに呼び出されるコールバック メソッド。

public void snapshot （GoogleMap.SnapshotReadyCallback コールバック、ビットマップ ビットマップ）

地図のスナップショットを取得します。

このメソッドは snapshot(SnapshotReadyCallback) と同等ですが、事前に割り当てられた Bitmap を指定できます。ビットマップが地図の現在のサイズと一致しない場合は、地図のサイズが合致する別のビットマップが割り当てられます。

ほとんどの場合、コールバック メソッドによって渡されるオブジェクトはこのメソッドのパラメータで渡されるオブジェクトと同じですが、返されるオブジェクトが異なる場合もあります（スナップショットが実際に取得された時点でビューのディメンションが変更された場合など）。したがって、コールバック メソッドから渡されたビットマップのコンテンツのみを信頼する必要があります。

パラメータ
callback スナップショットが取得されたときに呼び出されるコールバック メソッド。
ビットマップ 事前に割り当てられたビットマップ。null の場合、snapshot(SnapshotReadyCallback) と同様に動作します。

public void stopAnimation ()

カメラのアニメーションがある場合は、アニメーションを停止します。このメソッドが呼び出されると、カメラはすぐに移動を停止し、その位置に留まります。