TileOverlay

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

タイル プロバイダ

TileProvider は、タイル オーバーレイで使用される画像を提供します。タイル プロバイダは、地図に追加する前に指定する必要があります。タイル プロバイダは、追加後に変更することはできませんが、特定の座標に対して異なる画像を返すようにタイル プロバイダの動作を変更できます。タイル プロバイダが提供するタイルが変更された場合、変更後に clearTileCache() を呼び出して、以前のタイルがレンダリングされないようにする必要があります。

Z-Index

他のオーバーレイに対する、このタイル オーバーレイの描画順序（GroundOverlay、Circle、Polyline、Polygon など。ただし Marker は含まない）。z インデックスが大きいオーバーレイは、z インデックスが小さいオーバーレイの上に描画されます。z インデックスが同じオーバーレイの順序は任意です。デフォルトの 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 では、世界が 2^N x 2^N グリッドに配置された 4^N 個のタイルに分割されます。

タイルの座標は地図の左上（北西）から測定されます。ズームレベル N では、タイル座標の x 値の範囲は 0 ～ 2^N - 1 になり、西から東に増分します。y 値の範囲は 0 ～ 2^N - 1 で、北から南に増分します。

例

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