地図のカメラを変更する CameraUpdate
オブジェクトを作成するためのメソッドを含むクラス。地図のカメラを変更するには、このクラスで作成した CameraUpdate
オブジェクトを使用して、animateCamera(CameraUpdate)
、animateCamera(CameraUpdate, GoogleMap.CancelableCallback)
、または moveCamera(CameraUpdate)
を呼び出します。
たとえば、地図を拡大するには、次のコードを使用します。
GoogleMap map = ...;
map.animateCamera(CameraUpdateFactory.zoomIn());
このクラスのメソッドを使用する前に、このクラスが確実に初期化されるように、次のいずれかを行う必要があります。
- アプリに追加した
MapFragment
またはMapView
でGoogleMap
が利用できるようになるまで待ちます。GoogleMap
インスタンスを取得するには、getMapAsync()
を呼び出してonMapReady(GoogleMap map)
コールバックを待ちます。 initialize(Context)
を呼び出します。GooglePlayServicesNotAvailableException
がスローされない限り、このクラスは正しく初期化されます。
デベロッパー ガイド
詳しくは、カメラとビューのデベロッパー ガイドをご覧ください。
パブリック メソッドの概要
static CameraUpdate | |
static CameraUpdate | |
static CameraUpdate |
newLatLngBounds(LatLngBounds 境界、int 幅、int 高さ、int padding)
可能な限り最大のズームレベルで、指定された寸法の境界ボックス内で指定された緯度と経度の境界が画面上の中央に配置されるようにカメラを変換する
CameraUpdate を返します。 |
static CameraUpdate |
newLatLngBounds(LatLngBounds 境界、int パディング)
指定された緯度と経度の境界が、可能な限り最大のズームレベルで画面の中央に配置されるようにカメラを変換する
CameraUpdate を返します。 |
static CameraUpdate |
newLatLngZoom(LatLng latLng、floatzoom)
画面の中心を
LatLng オブジェクトで指定された緯度と経度に移動して、指定されたズームレベルに移動する CameraUpdate を返します。 |
static CameraUpdate |
scrollBy(float xPixel, float yPixel)
カメラを地図上でスクロールし、x 方向と y 方向で指定されたピクセル数だけビューの中心をシフトする
CameraUpdate を返します。 |
static CameraUpdate |
zoomBy(浮動小数点数、ポイント フォーカス)
現在のカメラ 視点のズームレベルをシフトする
CameraUpdate を返します。 |
static CameraUpdate |
zoomBy(浮動小数点数)
現在のカメラ 視点のズームレベルをシフトする
CameraUpdate を返します。 |
static CameraUpdate |
zoomIn()
視点の高さを地表面に近づけることで地図を拡大する
CameraUpdate を返します。 |
static CameraUpdate |
zoomOut()
視点の高さを地表面から離れた位置に移動させて地図をズームアウトする
CameraUpdate を返します。 |
static CameraUpdate |
zoomTo(浮動小数点ズーム)
カメラの視点を特定のズームレベルに移動する
CameraUpdate を返します。 |
継承されたメソッドの概要
パブリック メソッド
public static CameraUpdate newCameraPosition (CameraPosition cameraPosition)
指定された CameraPosition
にカメラを移動する CameraUpdate
を返します。実際には、CameraPosition
オブジェクトの緯度、経度、ズームレベル、方向、傾斜から変換が作成されます。
パラメータ
cameraPosition |
---|
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate newLatLng (LatLng latLng)
画面の中心を LatLng
オブジェクトで指定された緯度と経度に移動する CameraUpdate
を返します。これにより、カメラが LatLng
オブジェクトの中心に設定されます。
パラメータ
latLng | 目的の緯度と経度を含む LatLng オブジェクト。 |
---|
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate newLatLngBounds (LatLngBounds 境界、int 幅、int 高さ、int パディング)
可能な限り最大のズームレベルで、指定された寸法の境界ボックス内で指定された緯度と経度の境界が画面上の中央に配置されるようにカメラを変換する CameraUpdate
を返します。追加のパディングを指定して、境界ボックスのサイズをさらに制限できます。返される CameraUpdate
の bearing は 0、tilt は 0 です。
newLatLngBounds(LatLngBounds, int)
とは異なり、このメソッドによって返される CameraUpdate
を使用して、地図のレイアウト フェーズの前にカメラを変更できます。これは、引数で境界ボックスのサイズを指定するためです。
パラメータ
bounds | 境界ボックスに収まるリージョン |
---|---|
width | 境界ボックスの幅(ピクセル単位)(px) |
height | 境界ボックスの高さ(ピクセル単位)(px) |
padding | 境界ボックスの追加のサイズ制限(px) |
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate newLatLngBounds (LatLngBounds 境界、int パディング)
指定された緯度と経度の境界が、可能な限り最大のズームレベルで画面の中央に配置されるようにカメラを変換する CameraUpdate
を返します。地図ビューの端から境界ボックスをはめ込むために、パディングを指定できます。返される CameraUpdate
の bearing は 0、tilt は 0 です。
地図のレイアウトが完了するまで、このカメラの更新でカメラを変更しないでください(このメソッドで適切な境界ボックスとズームレベルを正しく決定するには、地図にサイズが必要です)。そうでない場合、IllegalStateException
がスローされます。地図が利用可能であるだけでは不十分です。地図を含むビューも、サイズが決定されるようにレイアウトする必要があります。これが発生したかどうか不明な場合は、代わりに newLatLngBounds(LatLngBounds, int, int, int)
を使用して、地図のサイズを手動で指定します。
パラメータ
bounds | 画面に合わせて配置できます。 |
---|---|
padding | 境界ボックスの端とビューの端の間のスペース(px 単位)。この値は、境界ボックスの 4 辺すべてに適用されます。 |
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate newLatLngZoom (LatLng latLng、floatzoom)
画面の中心を LatLng
オブジェクトで指定された緯度と経度に移動して、指定されたズームレベルに移動する CameraUpdate
を返します。
パラメータ
latLng | 目的の緯度と経度を含む LatLng オブジェクト。 |
---|---|
ズーム | 2.0 ~ 21.0 の範囲で目的のズームレベルを指定します。この範囲より小さい値は 2.0 に設定され、この範囲を超える値は 21.0 に設定されます。拡大するには、値を大きくします。すべてのエリアに最大ズームレベルのタイルがあるわけではありません。 |
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate scrollBy (float xPixel, float yPixel)
カメラを地図上でスクロールし、ビューの中心を x 方向と y 方向に指定されたピクセル数だけシフトする CameraUpdate
を返します。
例:
- xPixel = 5、yPixel = 0 の場合は、カメラが右にスクロールされ、地図が 5 ピクセル左にシフトしたように見えます。
- xPixel = 0 かつ yPixel = 5 の場合は、カメラを下にスクロールすると、地図が 5 ピクセル上に移動したように見えます。
スクロールは、カメラの現在の向きを基準にしています。たとえば、カメラの方向が 90 度の場合、東に「上」、右にスクロールするとカメラは南に移動します。
パラメータ
xPixel | 水平方向にスクロールするピクセル数。正の値を指定すると、カメラは現在の向きに対して右に移動します。負の値を指定すると、カメラは現在の向きに対して左に移動します。 |
---|---|
yPixel | 垂直方向にスクロールするピクセル数。正の値を指定すると、カメラは現在の向きに対して下に移動します。負の値を指定すると、カメラは現在の向きに対して上に移動します。 |
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate zoomBy (浮動小数点数、ポイント フォーカス)
現在のカメラ 視点のズームレベルをシフトする CameraUpdate
を返します。
フォーカスで指定された地点は固定されたままになります(つまり、ズーム処理の前後で同じ緯度/経度に対応します)。
このメソッドは、ズームが現在のカメラに対して相対的になるという点で zoomTo(float)
とは異なります。
たとえば、現在 LatLng
(11.11、22.22)が画面の位置(23、45)にある場合は、ズーム量とこの LatLng
を指定してこのメソッドを呼び出した後も、この LatLng
の画面位置は(23, 45)のままとなります。
パラメータ
amount | ズームレベルを変えることができます。正の値は地球の表面により近い位置にズームすることを示し、負の値は地球の表面から離れる方向を示します。 |
---|---|
ピント | ズーム処理後も固定される画面上のピクセル位置。 カメラの移動前のピクセル位置の緯度/経度は、カメラが移動した後も変わりません。 |
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate zoomBy (浮動小数点数)
現在のカメラ 視点のズームレベルをシフトする CameraUpdate
を返します。
このメソッドは、ズームが現在のカメラに対して相対的になるという点で zoomTo(float)
とは異なります。
パラメータ
amount | ズームレベルを変えることができます。正の値は地球の表面により近い位置にズームすることを示し、負の値は地球の表面から離れる方向を示します。 |
---|
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate zoomIn ()
視点の高さを地表面に近づけることで地図を拡大する CameraUpdate
を返します。ズームの増分は 1.0 です。
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate zoomOut ()
視点の高さを地表面から離れた位置に移動させて地図をズームアウトする CameraUpdate
を返します。ズームの増分は -1.0 です。
戻り値
- 変換を含む
CameraUpdate
。
public static CameraUpdate zoomTo (浮動小数点ズーム)
カメラの視点を特定のズームレベルに移動する CameraUpdate
を返します。
パラメータ
ズーム | 2.0 ~ 21.0 の範囲で目的のズームレベルを指定します。この範囲より小さい値は 2.0 に設定され、この範囲を超える値は 21.0 に設定されます。拡大するには、値を大きくします。すべてのエリアに最大ズームレベルのタイルがあるわけではありません。 |
---|