タイル オーバーレイは、基本地図タイルの上に重ねて表示される画像のセットです。これらのタイルは透明化できるため、既存の地図に対象物を追加できます。タイル オーバーレイには次のプロパティがあります。
- タイル プロバイダ
TileProvider
は、タイル オーバーレイで使用される画像を提供します。タイル プロバイダは、地図に追加する前に指定する必要があります。追加後にタイル プロバイダを変更することはできませんが、特定の座標に対して異なる画像を返すようにタイル プロバイダの動作を変更できます。タイル プロバイダによって提供されるタイルが変更された場合は、後でclearTileCache()
を呼び出して、以前のタイルがレンダリングされないようにする必要があります。- Z インデックス
- 他のオーバーレイ(
GroundOverlay
、Circle
、Polyline
、Polygon
など。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 を取得します。
|
整数 |
hashCode()
|
ブール値 |
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。 |
---|