を拡張
タイル オーバーレイは、基本地図タイルの上に表示される画像のセットです。これらのタイル は透明で、既存の地図に対象物を追加できます。タイル オーバーレイには、 次のプロパティがあります。
- タイル供給業者
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(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 |
hashCode()
|
| 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 です。 |
|---|