TileOverlay

public final クラス TileOverlay の拡張 Object

タイル オーバーレイは、基本地図タイルの上に重ねて表示される画像のセットです。これらのタイルは透明化できるため、既存の地図に対象物を追加できます。タイル オーバーレイには次のプロパティがあります。

タイル プロバイダ
TileProvider は、タイル オーバーレイで使用される画像を提供します。タイル プロバイダは、地図に追加する前に指定する必要があります。追加後にタイル プロバイダを変更することはできませんが、特定の座標に対して異なる画像を返すようにタイル プロバイダの動作を変更できます。タイル プロバイダによって提供されるタイルが変更された場合は、後で clearTileCache() を呼び出して、以前のタイルがレンダリングされないようにする必要があります。
Z インデックス
他のオーバーレイ(GroundOverlayCirclePolylinePolygon など。Marker は除く)に対する、このタイル オーバーレイの描画順序。Z-Index の大きいオーバーレイは、小さい Z-Index のオーバーレイの上に描画されます。Z-Index が同じオーバーレイの順序は任意です。デフォルトの zIndex は 0 です。
透明性
範囲 [0..1] におけるタイル オーバーレイの透明度。0 はオーバーレイが不透明であることを示し、1 はオーバーレイが完全に透明であることを意味します。指定したビットマップがすでに部分的に透明になっている場合、それに応じて各ピクセルの透明度がスケーリングされます(たとえば、ビットマップのピクセルのアルファ値が 200 で、タイル オーバーレイの透明度を 0.25 に指定した場合、ピクセルはアルファ値が 150 の画面上にレンダリングされます)。このプロパティの指定は任意であり、デフォルトの透明度は 0(不透明)です。
公開設定
タイル オーバーレイを表示するかどうかを指定します(つまり、地図上に描画するかどうかを示します)。非表示のタイル オーバーレイは描画されませんが、他のすべてのプロパティを保持します。デフォルトは true(可視)です。

このクラスのメソッドは、メインスレッドでのみ呼び出す必要があります。実装しないと、IllegalStateException が発生します。

タイル座標

世界はメルカトル図法(Wikipedia を参照)を使用して投影されており、地図の左側(西)は経度 -180 度、地図の右側(東)は経度 180 度に対応します。地図を正方形にするには、地図の上(北)側が緯度 85.0511 度、地図の下(南)側が緯度 -85.0511 度に対応します。この緯度範囲外の地域はレンダリングされません。

各ズームレベルで、地図がタイルに分割され、画面に重なるタイルのみがダウンロードおよびレンダリングされます。各タイルは正方形で、地図は次のようにタイルに分割されます。

  • ズームレベル 0 では、1 つのタイルが世界全体を表します。そのタイルの座標は (x, y) = (0, 0) です。
  • ズームレベル 1 では、世界が 2 x 2 のグリッドに配置された 4 つのタイルに分割されます。
  • ...
  • ズームレベル N では、世界は 2N x 2N のグリッドに配置された 4N 個のタイルに分割されます。
カメラがサポートする最小ズームレベルは GoogleMap.getMinZoomLevel で、最大ズームレベルは GoogleMap.getMaxZoomLevel です(これはさまざまな要因によって異なります)。

タイルの座標は地図の左上(北西)の角から測定されます。ズームレベル N では、タイル座標の x 値は 0 ~ 2N - 1 の範囲で西から東に増加し、y 値は 0 ~ 2N - 1 の範囲で北から南に増加します。

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

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

void
clearTileCache()
タイル キャッシュを消去し、すべてのタイルが TileProvider から再度リクエストされるようにします。
ブール値
equals(Object other)
この TileOverlay が他と等しいかどうかをテストします。
ブール値
getFadeIn()
オーバーレイ タイルをフェードインするかどうかを取得します。
文字列
getId()
このタイル オーバーレイの ID を取得します。
浮動小数点数
getTransparency()
このタイル オーバーレイの透明度を取得します。
浮動小数点数
getZIndex()
このタイル オーバーレイの zIndex を取得します。
整数
ブール値
isVisible()
このタイル オーバーレイの表示設定を取得します。
void
remove()
このタイル オーバーレイを地図から削除します。
void
setFadeIn(ブール値 fadeIn)
オーバーレイ タイルをフェードインするかどうかを設定します。
void
setTransparency(浮動小数点透明度)
このタイル オーバーレイの透明度を設定します。
void
setVisible(ブール値を表示)
このタイル オーバーレイの表示設定を設定します。
void
setZIndex(float zIndex)
このタイル オーバーレイの zIndex を設定します。

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

パブリック メソッド

public void clearTileCache ()

タイル キャッシュを消去し、すべてのタイルが TileProvider から再度リクエストされるようにします。このタイル オーバーレイの現在のタイルも、このメソッドを呼び出すと地図から消去されます。API は、タイルの小さなメモリ内キャッシュを保持します。タイルをより長くキャッシュに保存したい場合は、ディスク上のキャッシュを実装する必要があります。

public boolean equals (Object other)

この TileOverlay が他と等しいかどうかをテストします。

パラメータ
その他 Object
戻り値
  • 両方のオブジェクトが同じオブジェクトである場合(つまり、これ == other の場合)は true になります。

public boolean getFadeIn ()

オーバーレイ タイルをフェードインするかどうかを取得します。

戻り値
  • タイルをフェードインする場合は true、フェードインしない場合は false

public String getId ()

このタイル オーバーレイの ID を取得します。

public float getTransparency ()

このタイル オーバーレイの透明度を取得します。

戻り値
  • このタイル オーバーレイの透明度を指定します。

public float getZIndex ()

このタイル オーバーレイの zIndex を取得します。

戻り値
  • タイル オーバーレイの zIndex。

public int hashCode ()

public boolean isVisible ()

このタイル オーバーレイの表示設定を取得します。なお、これはタイル オーバーレイが実際に画面のビューポート内にあるかどうかではなく、それが画面のビューポートに含まれている場合に描画されるかどうかを返します。

戻り値
  • このタイル オーバーレイの公開設定。

public void remove ()

このタイル オーバーレイを地図から削除します。

public void setFadeIn (boolean fadeIn)

オーバーレイ タイルをフェードインするかどうかを設定します。

パラメータ
fadeIn タイルをフェードインする場合は true、瞬時にレンダリングする場合は false です。

public void setTransparency (float Transparency)

このタイル オーバーレイの透明度を設定します。詳細については、このクラスの冒頭にあるドキュメントをご覧ください。

パラメータ
透明性 [0..1] の範囲の浮動小数点数。0 はタイル オーバーレイが不透明であることを表し、1 はタイル オーバーレイが透明であることを意味します。

public void setVisible (boolean visible)

このタイル オーバーレイの表示設定を設定します。非表示の場合、タイル オーバーレイは描画されませんが、他のすべてのプロパティは保持されます。タイル オーバーレイはデフォルトで表示されます。

パラメータ
表示 このオーバーレイを表示する場合は true、非表示にする場合は false を指定します。

public void setZIndex (float zIndex)

このタイル オーバーレイの zIndex を設定します。詳細については、このクラスの先頭のドキュメントをご覧ください。

パラメータ
zIndex このタイル オーバーレイの zIndex。