GMSURLTileLayer クラス リファレンス

パブリック メンバー関数 | 静的パブリック メンバー関数 | プロパティ | 関連関数
GMSURLTileLayer クラス リファレンス

概要

GMSURLTileProvider は、GMSTileURLConstructor から返された URL に基づいてタイルを取得します。

次に例を示します。

   GMSTileURLConstructor constructor = ^(NSUInteger x, NSUInteger y, NSUInteger zoom) {
     NSString *URLStr =
         [NSString stringWithFormat:"https://example.com/%d/%d/%d.png", x, y, zoom];
     return [NSURL URLWithString:URLStr];
   };
   GMSTileLayer *layer =
       [GMSURLTileLayer tileLayerWithURLConstructor:constructor];
   layer.userAgent = "SDK user agent";
   layer.map = map;

GMSURLTileProvider はサブクラス化できないため、コンビニエンス コンストラクタを介してのみ作成する必要があります。

GMSTileLayer を継承します。

パブリック メンバー関数

(void) - requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:receiver: GMSTileOverlay の画像タイルを生成します。
(void) - clearTileCache
 キャッシュを消去し、すべてのタイルが再度リクエストされるようにします。

静的パブリック メンバー関数

（instancetype）+ tileLayerWithURLConstructor:
 コンビニエンス コンストラクタ。

プロパティ

NSString * userAgent
 ユーザー エージェントを指定して、アプリケーションを記述します。
GMSMapView * map
 この GMSTileOverlay が表示される地図です。
int zIndex
 zIndex 値が高いタイルレイヤは、zIndex 値が低いタイルレイヤとオーバーレイの上に描画されます。
NSIntegertileSize
 返されたタイル画像の表示対象として優先するピクセル数（ポイント数ではない）を指定します。
float 不透明度
 タイルレイヤの不透明度を指定します。
BOOL fadeIn
 タイルをフェードインするかどうかを指定します。

（これらはメンバー関数ではないことに注意してください）。

typedef NSURL *_Nullable(^ GMSTileURLConstructor）（NSUInteger x、NSUInteger y、NSUInteger ズーム）
 GMSTileURLConstructor は x、y、zoom を受け取って NSURL を返すブロックです。その場所にタイルがないことを示す場合は nil を返します。

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

+ (instancetype) tileLayerWithURLConstructor: （GMSTileURLConstructor） コンストラクタ

コンビニエンス コンストラクタ。

constructor は nil 以外にする必要があります。

- (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

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

- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger ズーム)) [related]

GMSTileURLConstructor は x、y、zoom を受け取って NSURL を返すブロックです。その場所にタイルがないことを示す場合は nil を返します。

プロパティのドキュメント

- (NSString*) userAgent [read, write, copy]

ユーザー エージェントを指定して、アプリケーションを記述します。

これが nil（デフォルト）の場合、HTTP リクエストにはデフォルトの iOS ユーザー エージェントが使用されます。

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

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

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

-（int）zIndexzIndex [read, write, assign, inherited]

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

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

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

返されたタイル画像の表示対象として優先するピクセル数（ポイント数ではない）を指定します。

最適な結果を得るには、カスタムタイルの端の長さにする必要があります。デフォルトは 256（Google マップのタイルの従来のサイズ）です。

128 ポイント相当（たとえば、Retina デバイスの 256 ピクセル）未満の値を指定すると、良好なパフォーマンスが得られない可能性があるため、推奨されません。

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

-（浮動小数点数）不透明度 [read, write, assign, inherited]

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

タイル画像のアルファ チャンネルの乗数を指定します。

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

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

デフォルトは YES です。