TileOverlay

パブリック ファイナル クラス TileOverlay オブジェクト
を拡張

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

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

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

タイル座標

なお、世界は左(西)をメルカトル図法(ウィキペディアを参照)で投影しています 経度 -180 度、地図の右側(東)に対応する地図の 緯度 180 度に相当します。地図を正方形にするために この地図は緯度 85.0511 度に対応し、地図の下部(南)は緯度 85.0511 度に 緯度 -85.0511 度まで計算しています。この緯度の範囲外となるエリアはレンダリングされません。

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

  • ズームレベル 0 では、1 つのタイルが世界全体を表します。そのタイルの座標は (x, y) = (0, 0) となります。
  • ズームレベル 1 では、世界が 4 つのタイルに分割され、2 x 2 のグリッドに配置されます。
  • ...
  • ズームレベル N では、世界は 4N 個のタイルに分割され、2N 単位で配置されます。 x 2N グリッド。
で確認できます。 なお、カメラがサポートする最小ズームレベル(これはさまざまな要因によって異なります) 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 から再度リクエストされるようにします。
boolean
equals(オブジェクト その他)
この TileOverlay が別の値と等しいかどうかをテストします。
boolean
getFadeIn()
オーバーレイ タイルをフェードインするかどうかを取得します。
文字列
getId()
このタイル オーバーレイの ID を取得します。
float
getTransparency()
このタイル オーバーレイの透明度を取得します。
float
getZIndex()
このタイル オーバーレイの zIndex を取得します。
int
boolean
isVisible()
このタイル オーバーレイの可視性を取得します。
void
remove()
地図からこのタイル オーバーレイを削除します。
void
setFadeIn(boolean fadeIn)
オーバーレイ タイルをフェードインするかどうかを設定します。
void
setTransparency(浮動小数点の透明度)
このタイル オーバーレイの透明度を設定します。
void
setVisible(boolean visible)
このタイル オーバーレイの表示 / 非表示を設定します。
void
setZIndex(浮動小数点 zIndex)
このタイル オーバーレイの zIndex を設定します。

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

パブリック メソッド

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 clearTileCache ()

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

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 等しい (オブジェクト その他)

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

パラメータ
その他 Object
戻り値
  • 両方のオブジェクトが同じオブジェクトの場合、つまり、これは「== other」の場合は true を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 getFadeIn ()

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

戻り値
  • タイルをフェードインする場合は true。そうでない場合は false

<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()

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

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getTransparency ()

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getZIndex ()

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 整数 hashCode ()

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isVisible ()

このタイル オーバーレイの可視性を取得します。なお、このメソッドは、タイル 実際には画面のビューポート内にあるオーバーレイを ビューポート内に収まるように配置されます

戻り値
  • このタイル オーバーレイの公開設定を指定します。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 削除 ()

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

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setFadeIn (ブール値 fadeIn)

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

パラメータ
fadeIn true: タイルをフェードインします。false を使用して、即座にレンダリングします。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTransparency (浮動小数点数)

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setVisible (ブール値表示)

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

パラメータ
表示 true: このオーバーレイを表示します。false して非表示にします。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setZIndex (浮動小数点数 zIndex)

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

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