概要

GMSTileLayer は、指定した GMSMapView にカスタム画像タイルを重ね合わせることができる抽象クラスです。

直接初期化することはできません。サブクラスは、タイルを返すために tileForX:y:zoom: メソッドを実装する必要があります。

ズームレベル 0 では、世界全体が 1 つのタイルで覆われた正方形となり、そのタイルの座標 x と y はどちらも 0 です。ズームレベル 1 では、世界は x と y が 0 または 1 の 4 つのタイルで覆われています。

GMSSyncTileLayer と GMSURLTileLayer によって継承されます。

公開メンバー関数
(void)	- requestTileForX:y:zoom:receiver:
	requestTileForX:y:zoom:receiver: は GMSTileOverlay の画像タイルを生成します。
(void)	- clearTileCache
	キャッシュを消去し、すべてのタイルが再度リクエストされるようにします。
プロパティ
GMSMapView *	map
	この GMSTileOverlay が表示される地図です。
int	zIndex
	`zIndex` 値が高いタイルレイヤは、`zIndex` 値が低いタイルレイヤとオーバーレイの上に描画されます。
NSInteger	tileSize
	返されたタイル画像の表示に使用するピクセル数（ポイント数ではない）を指定します。
float	不透明度
	タイルレイヤの不透明度を指定します。
BOOL	fadeIn
	タイルをフェードインするかどうかを指定します。

メンバー関数のドキュメント

requestTileForX:y:zoom:receiver: は GMSTileOverlay の画像タイルを生成します。

サブクラスでオーバーライドする必要があります。指定された x、y、zoom のタイルは、後で receiver に渡す必要があります。

この位置で使用できるタイルがない場合は kGMSTileLayerNoTile を指定し、一時的なエラーが発生してタイルが後で使用可能になる場合は nil を指定します。

このメソッドの呼び出しはメインスレッドで行われます。アプリのメインスレッドで実行されないブロックタイルレイヤを実装する基本クラスについては、GMSSyncTileLayer をご覧ください。

-（void）clearTileCache

キャッシュを消去し、すべてのタイルが再度リクエストされるようにします。

- (GMSMapView*) map [read, write, assign]

この GMSTileOverlay が表示される地図です。

このプロパティを設定すると、地図にレイヤが追加されます。nil に設定すると、このレイヤが地図から削除されます。レイヤは、一度に最大 1 つの地図でアクティブにできます。

-（整数）zIndex [read, write, assign]

zIndex 値が高いタイルレイヤは、zIndex 値が低いタイルレイヤとオーバーレイの上に描画されます。

同じ値を指定すると、描画の順序は定義されません。

-（NSInteger）tileSize [read, write, assign]

返されたタイル画像の表示に使用するピクセル数（ポイント数ではない）を指定します。

最良の結果を得るには、これはカスタムタイルの端の長さです。デフォルトは 256（Google マップのタイルの従来のサイズ）です。

128 ポイントに相当する値（網膜デバイスでは 256 ピクセルなど）未満の値を指定すると、パフォーマンスが低下する可能性があるため、推奨されません。

一例として、アプリケーションデベロッパーは、Retina デバイス上に Retina タイル（512 ピクセルエッジの長さ）を提供し、非 Retina デバイスに対するデフォルト値の 256 と同じビューあたりのタイル数を維持したい場合があります。

-（浮動小数点数）opacity [read, write, assign]

タイルレイヤの不透明度を指定します。

これにより、タイル画像のアルファチャンネルの乗数が提供されます。

-（BOOL）fadeIn [read, write, assign]

タイルをフェードインするかどうかを指定します。

デフォルトは YES です。