概要
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 |
タイルをフェードインするかどうかを指定します。 |
メンバー関数のドキュメント
- (void) requestTileForX: | (NSUInteger) | x | |
y: | (NSUInteger) | y | |
zoom: | (NSUInteger) | ズーム | |
output: | (id< GMSTileReceiver >) | receiver | |
requestTileForX:y:zoom:receiver: GMSTileOverlay の画像タイルを生成します。
サブクラスでオーバーライドする必要があります。指定された x
、y
、zoom
のタイルは、後で receiver
に渡す必要があります。
この位置で使用できるタイルがない場合は kGMSTileLayerNoTile を指定します。一時的なエラーが発生して後でタイルを使用可能にする場合は、nil を指定します。
このメソッドの呼び出しはメインスレッドで行われます。アプリのメインスレッドでは実行されないブロック タイル レイヤを実装する基本クラスについては、GMSSyncTileLayer をご覧ください。
-(void)clearTileCache |
キャッシュを消去し、すべてのタイルが再度リクエストされるようにします。
プロパティのドキュメント
- (GMSMapView*) map [read, write, assign] |
この GMSTileOverlay が表示される地図です。
このプロパティを設定すると、地図にレイヤが追加されます。nil に設定すると、地図からこのレイヤが削除されます。レイヤは常に 1 つの地図でアクティブにできます。
-(int)zIndexzIndex [read, write, assign] |
zIndex
値が高いタイルレイヤは、zIndex
値が低いタイルレイヤとオーバーレイの上に描画されます。
同じ値を指定すると、描画順序は定義されません。
-(NSInteger)tileSize [read, write, assign] |
返されたタイル画像の表示対象として優先するピクセル数(ポイント数ではない)を指定します。
最適な結果を得るには、カスタムタイルの端の長さにする必要があります。デフォルトは 256(Google マップのタイルの従来のサイズ)です。
128 ポイント相当(たとえば、Retina デバイスの 256 ピクセル)未満の値を指定すると、良好なパフォーマンスが得られない可能性があるため、推奨されません。
一例として、アプリケーション デベロッパーは、Retina デバイスに Retina タイル(512 ピクセルの縁の長さ)を提供し、Retina 以外のデバイスのデフォルト値である 256 と同じビューあたりのタイル数を維持することを望む場合があります。
-(浮動小数点数)不透明度 [read, write, assign] |
タイルレイヤの不透明度を指定します。
タイル画像のアルファ チャンネルの乗数を指定します。
- (BOOL)fadeIn [read, write, assign] |
タイルをフェードインするかどうかを指定します。
デフォルトは YES です。