Google Maps SDK for Android のメインクラスであり、地図に関連するすべてのメソッドのエントリ ポイントです。GoogleMap
オブジェクトを直接インスタンス化することはできません。代わりに、アプリに追加した MapFragment
または MapView
の getMapAsync()
メソッドからオブジェクトを取得する必要があります。
注: View
オブジェクトと同様に、GoogleMap
の読み取りと変更は Android UI スレッドからのみ行うことができます。別のスレッドから GoogleMap
メソッドを呼び出すと、例外が発生します。
地図を移動するのではなく、カメラの位置を変更することで、地図の視点を調整できます。地図のカメラを使用して、位置、ズームレベル、傾斜角度、方向指定などのパラメータを設定できます。詳しくは、カメラとビューをご覧ください。
デベロッパー ガイド
ご利用にあたっては、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 | POI タップのリスナー。 | |
インターフェース | 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 | 地形マップ |
パブリック メソッドの概要
サークル | |
GroundOverlay | |
マーカー | |
ポリゴン | |
ポリライン | |
TileOverlay | |
void | |
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 | |
void |
resetMinMaxZoomPreference()
以前に指定した上限と下限のズームを削除します。
|
void |
setBuildingsEnabled(ブール値が有効)
建物の 3D 表示レイヤをオンまたはオフにします。
|
void |
setContentDescription(文字列の説明)
地図の contentDescription を設定します。
|
ブール値 |
setIndoorEnabled(ブール値が有効)
インドアマップを有効にするかどうかを設定します。
|
void | |
void |
setLatLngBoundsForCameraTarget(LatLngBounds 境界)
LatLng 境界を指定してカメラ ターゲットを制約し、ユーザーが地図をスクロールしてパン移動したときに、カメラ ターゲットがこれらの境界の外に移動しないようにします。
|
void | |
ブール値 | |
void |
setMapType(int 型)
表示する地図タイルの種類を設定します。
|
void |
setMaxZoomPreference(float maxZoomPreference)
カメラのズームに望ましい上限を設定します。
|
void |
setMinZoomPreference(float minZoomPreference)
カメラのズームに推奨される下限を設定します。
|
void |
setMyLocationEnabled(ブール値が有効)
現在地レイヤを有効または無効にします。
|
void | |
void | |
void |
setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener リスナー)
カメラの動きが新しいタイプのアニメーションによって停止または中断されたときに呼び出されるコールバックを設定します。
|
void | |
void |
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener リスナー)
カメラが移動を開始したときや、カメラの動作理由が変更されたときに呼び出されるコールバックを設定します。
|
void | |
void |
setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener リスナー)
地面オーバーレイがクリックされたときに呼び出されるコールバックを設定します。
|
void | |
void |
setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener リスナー)
マーカー情報ウィンドウがクリックされたときに呼び出されるコールバックを設定します。
|
void |
setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener リスナー)
マーカーの情報ウィンドウを閉じたときに呼び出されるコールバックを設定します。
|
void |
setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener リスナー)
マーカーの情報ウィンドウが長押しされたときに呼び出されるコールバックを設定します。
|
void | |
void | |
void | |
void | |
void | |
void |
setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener リスナー)
現在地ボタンがクリックされたときに呼び出されるコールバックを設定します。
|
void |
setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener リスナー)
このメソッドは非推奨になりました。代わりに com.google.android.gms.location.FusedLocationProviderApi を使用してください。
FusedLocationProviderApi は、現在地を特定して改善された電力使用量を提供し、「現在地」の青い点で使用されます。サンプルコードについては、サンプル アプリケーション フォルダの MyLocationDemoActivity またはロケーション デベロッパー ガイドをご覧ください。
|
void |
setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener リスナー)
現在地ドット(ユーザーの現在地を示す)がクリックされたときに呼び出されるコールバックを設定します。
|
void | |
void | |
void |
setOnPolylineClickListener(GoogleMap.OnPolylineClickListener リスナー)
ポリラインがクリックされたときに呼び出されるコールバックを設定します。
|
void |
setPadding(int left、int top、intright、int top)
地図のパディングを設定します。
|
void |
setTrafficEnabled(ブール値が有効)
交通状況レイヤをオンまたはオフにします。
|
void | |
void | |
void |
stopAnimation()
カメラのアニメーションが進行中の場合、そのアニメーションを停止します。
|
継承されたメソッドの概要
定数
public static final int MAP_TYPE_HYBRID
主要な通りが透明な航空写真マップ。
public static final int MAP_TYPE_NONE
基本地図タイルがありません。
public static final int MAP_TYPE_NORMAL
基本地図
public static final int MAP_TYPE_SATELLITE
ラベルのない衛星地図。
public static final int MAP_TYPE_TERRAIN
地形マップ
パブリック メソッド
public Circle addCircle (CircleOptions オプション)
この地図に円を追加します。
パラメータ
オプション | 円のレンダリング方法を定義する円オプション オブジェクト |
---|
戻り値
- 地図に追加される
Circle
オブジェクト
public GroundOverlay addGroundOverlay (GroundOverlayOptions オプション)
この地図に画像を追加します。
パラメータ
オプション | オーバーレイのレンダリング方法を定義する、地面オーバーレイ オプション オブジェクト。オプションには、画像(AnchoredBitmap)と位置を指定する必要があります。 |
---|
戻り値
- 地図に追加された
GroundOverlay
。
スロー値
IllegalArgumentException | 画像または位置のいずれかがオプションで指定されている場合。 |
---|
公開 Marker addMarker (MarkerOptions オプション)
この地図にマーカーを追加します。
マーカーのアイコンは、地図上の位置 Marker.position でレンダリングされます。マーカーをクリックすると、カメラがマーカーの中央に配置されます。Marker.title が定義されている場合、地図にはマーカーのタイトルとスニペットを含む情報ボックスが表示されます。マーカーがドラッグ可能である場合は、長押ししてからドラッグすると、マーカーが移動します。
パラメータ
オプション | マーカーのレンダリング方法を定義するマーカー オプション オブジェクト。 |
---|
戻り値
- マップに追加された
Marker
。
public Polygon addPolygon (PolygonOptions options)
この地図にポリゴンを追加します。
パラメータ
オプション | ポリゴンのレンダリング方法を定義するポリゴン オプション オブジェクト。 |
---|
戻り値
- マップに追加される
Polygon
オブジェクト。
public Polyline addPolyline (PolylineOptions options)
この地図にポリラインを追加します。
パラメータ
オプション | ポリラインのオプション オブジェクト。ポリラインのレンダリング方法を定義します。 |
---|
戻り値
- マップに追加された
Polyline
オブジェクト。
public TileOverlay addTileOverlay (TileOverlayOptions オプション)
この地図にタイル オーバーレイを追加します。詳しくは、TileOverlay
をご覧ください。
他のオーバーレイとは異なり、地図を再作成してもタイル オーバーレイは自動的には復元されないため、手動で追加し直す必要があります。
パラメータ
オプション | オーバーレイのレンダリング方法を定義する、タイル オーバーレイのオプション オブジェクト。オプションには TileProvider を指定する必要があります。指定しない場合、IllegalArgumentException がスローされます。 |
---|
戻り値
- 地図に追加された
TileOverlay
。
スロー値
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 update, int durationMs, GoogleMap.CancelableCallback callback)
指定された時間内にアニメーション付きで移動して地図を移動し、完了時にオプションのコールバックを呼び出します。一連の更新については、CameraUpdateFactory
をご覧ください。
アニメーション中に getCameraPosition()
が呼び出されると、処理中のカメラの現在地が返されます。
パラメータ
update | |
---|---|
期間 | アニメーションの再生時間(ミリ秒単位)。これは真に正の値でなければなりません。そうでない場合は、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
を返します。
戻り値
- 現在表示されている
user location
。
スロー値
IllegalStateException | 現在地レイヤが有効になっていない場合。 |
---|
public Projection getProjection ()
画面座標と緯度/経度の座標間の変換に使用できる Projection
オブジェクトを返します。
返される Projection
は、現在の投影のスナップショットであり、カメラが移動しても自動的に更新されません。このオペレーションは高コストであるため、プロジェクションは画面ごとに 1 回だけ取得する必要があります。Google マップは、メルカトル図法を使用して地理データから地図を作成し、地図上の地点を地理座標に変換します。
戻り値
- 地図の現在の
Projection
。
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 (ブール値有効)
建物の 3D 表示レイヤをオンまたはオフにします。
パラメータ
有効 | true : 建物の 3D 表示を有効にするレイヤ。false を選択すると、建物の 3D 表示が無効になります。
|
---|
public void setContentDescription (文字列の説明)
地図の contentDescription を設定します。
これは、ユーザー補助モードで地図の音声による説明を提供するために使用されます。デフォルト値は「Google マップ」です。
パラメータ
説明 | 説明として使用する文字列。 |
---|
公開 ブール値 setIndoorEnabled (ブール値有効)
インドアマップを有効にするかどうかを設定します。現在、インドアマップは一度に 1 つのマップにしか表示できません。デフォルトでは、これが最初にアプリケーションに追加されるマップです。別の地図でインドアマップを有効にするには、まず、元の地図でインドアマップを無効にする必要があります。別の地図でインドアマップを有効にしようとしても、何も行われず、false
が返されます。地図でインドアが有効でない場合、インドアに関連するすべてのメソッドは null
または false
を返します。
パラメータ
有効 | インドアマップを有効にしたい場合は「true 」、インドアマップを無効にするには「false 」と入力します。 |
---|
戻り値
- インドアマップを有効化できたかどうか。
public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter アダプタ)
情報ウィンドウのコンテンツにカスタム レンダラを設定します。
地図イベント リスナーと同様に、この状態は地図とシリアル化されません。構成が変更された場合などに地図が再作成された場合は、カスタマイズを維持するために、このメソッドを再度呼び出す必要があります。
パラメータ
アダプター | 情報ウィンドウのコンテンツに使用するアダプター。null は、情報ウィンドウのデフォルトのコンテンツ レンダリングを使用します。 |
---|
public void setLatLngBoundsForCameraTarget (LatLngBounds 境界)
LatLng 境界を指定してカメラ ターゲットを制約し、ユーザーが地図をスクロールしてパン移動したときに、カメラ ターゲットがこれらの境界の外に移動しないようにします。
null に設定すると、境界ボックスが完全に消去されます。新しい境界ボックスは、以前に指定した境界ボックスに置き換わるものです。
LatLngBounds が変更されると、SDK では、以降の更新はすべて、可能な限りそれらの境界を反映するように調整されます。SDK がカメラ ターゲットを境界内に厳密に収めるのを妨げる技術的な考慮事項があります。たとえば、浮動小数点精度の丸め誤差や非常に低いズームレベルなどです。
パラメータ
境界 | カメラ ターゲットをその範囲内に制限するための境界。 |
---|
public void setLocationSource (LocationSource ソース)
現在地レイヤの位置情報ソースを置き換えます。
パラメータ
source | 現在地レイヤで使用する位置情報のソース。デフォルトの位置情報ソースを使用するには、null に設定します。 |
---|
public boolean setMapStyle (MapStyleOptions スタイル)
基本地図のスタイルを設定します。
スタイル オプションを使用すると、地図上の対象物と要素にカスタム スタイルを適用できます。
スタイル定義の詳細については、MapStyleOptions
をご覧ください。
以前にカスタマイズしたカスタム スタイルを消去する場合は、null に設定します。
パラメータ
スタイル |
---|
戻り値
- スタイルが正常に解析された場合は
true
、MapStyleOptions
で問題が検出された場合はfalse
(解析不能なスタイル JSON、認識されない対象物タイプ、認識されない要素タイプ、無効なスタイラキーなど)が含まれます。戻り値がfalse
の場合、現在のスタイルは変更されません。
public void setMapType (int 型)
表示する地図タイルの種類を設定します。指定できる値は次のとおりです。
MAP_TYPE_NORMAL
: 基本の地図。MAP_TYPE_SATELLITE
: 衛星画像。MAP_TYPE_HYBRID
: 道路とラベルの付いた衛星画像。MAP_TYPE_TERRAIN
: 地形データ。MAP_TYPE_NONE
: 基本地図タイルがありません。
パラメータ
タイプ | 表示する地図のタイプ。 |
---|
public void setMaxZoomPreference (float maxZoomPreference)
カメラのズームに望ましい上限を設定します。
最大ズームが変更されると、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 (ブール値有効)
現在地レイヤを有効または無効にします。
位置情報が有効になっていて位置情報が利用可能な間は、現在地レイヤがユーザーの現在地と方角を継続的に表示し、ユーザーが位置情報を操作できる 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 リスナー)
カメラが動いている間に繰り返し呼び出されるコールバックを設定します。コールバックはフレームごとに何度も呼び出される可能性があるため、負荷の高い処理を実行しないでください。
パラメータ
リスナー | 呼び出されるコールバック。コールバックの設定を解除するには、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, intright, intBottom)
地図のパディングを設定します。
このメソッドでは、地図上に表示可能な領域を定義し、地図の 4 つのエッジのそれぞれにパディングを設定して、エッジの周囲にあるマップ上の部分が不明瞭になる可能性があることを地図に通知できます。Map 関数はパディングに調整されます。たとえば、ズーム コントロール、コンパス、著作権に関する通知、Google ロゴは、指定した領域内に収まるよう移動され、カメラの移動は可視領域の中心に対する相対位置などに配置されます。
パラメータ
left | 地図の左側に追加するパディングのピクセル数。 |
---|---|
top | 地図の上に追加されるパディングのピクセル数。 |
right | 地図の右側に追加するパディングのピクセル数。 |
下 | 地図の下部に追加するパディングのピクセル数。 |
public void setTrafficEnabled (ブール値有効)
交通状況レイヤをオンまたはオフにします。
パラメータ
有効 |
---|
public void snapshot (GoogleMap.SnapshotReadyCallback コールバック)
地図のスナップショットを撮ります。
アプリケーション内でスナップショットは、インタラクティブな地図を使用するのが困難または不可能な場合に使用できます。たとえば、snapshot()
メソッドで生成された画像を使用して、アプリ内の地図のサムネイルや通知センターのスナップショットを表示できます。
注: 地図の画像をサーバーに送信したり、アプリケーション以外で使用することはできません。別のアプリケーションやユーザーにマップを送信する必要がある場合は、データを送信することで、スナップショットではなく新規ユーザーの地図を再構築できるようにします。
パラメータ
callback | スナップショットの取得時に呼び出されるコールバック メソッド。 |
---|
public void snapshot (GoogleMap.SnapshotReadyCallback コールバック、ビットマップ ビットマップ)
地図のスナップショットを撮ります。
このメソッドは snapshot(SnapshotReadyCallback)
と同等ですが、事前に割り当てられた Bitmap
を指定できます。ビットマップが地図の現在のサイズと一致しない場合、そのビットマップに合った別のビットマップが割り当てられます。
ほとんどの場合、コールバック メソッドから渡されたオブジェクトが、このメソッドにパラメータで指定されたオブジェクトと同じですが、返されるオブジェクトが異なる場合があります(たとえば、スナップショットが実際に取得されるまでにビューのサイズが変更された場合)。したがって、コールバック メソッドから渡されたビットマップの内容のみを信頼する必要があります。
パラメータ
callback | スナップショットの取得時に呼び出されるコールバック メソッド。 |
---|---|
ビットマップ | 事前に割り当てられたビットマップ。null の場合、snapshot(SnapshotReadyCallback) のように動作します。 |
public void stopAnimation ()
カメラのアニメーションが進行中の場合、そのアニメーションを停止します。メソッドが呼び出されると、カメラは直ちに移動を停止し、その位置に留まります。