GMSURLTileLayer-Klassenreferenz


Überblick

GMSURLTileProvider ruft Kacheln anhand der von einem GMSTileURLKonstruktor zurückgegebenen URLs ab.

Beispiel:

   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 darf keine Unterklasse sein und sollte nur über seinen Convenience-Konstruktor erstellt werden.

Übernimmt GMSTileLayer.

Öffentliche Mitgliederfunktionen

(void) requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:receiver: Erzeugt Bildkacheln für GMSTileOverlay.
(void) clearTileCache
 Löscht den Cache, sodass alle Kacheln erneut angefordert werden.

Statische Funktionen für öffentliche Mitglieder

(Instanztyp)+ tileLayerWithURLKonstruktor:
 Convenience-Konstruktor.

Attribute

NSString * userAgent
 Geben Sie den User-Agent an, um Ihre Anwendung zu beschreiben.
GMSMapViewKarte
 Die Karte, auf der dieses GMSTileOverlay angezeigt wird
int zIndex
 Kachelebenen mit einem höheren Wert von zIndex werden über Kachelebenen und Overlays mit einem niedrigeren Wert von zIndex gezeichnet.
NSIntegertileSize
 Gibt die Anzahl der Pixel (nicht Punkte) an, mit denen die zurückgegebenen Kachelbilder bevorzugt angezeigt werden sollen.
float Deckkraft
 Gibt die Deckkraft der Kachelebene an.
BOOLfadeIn
 Gibt an, ob die Kacheln langsam eingeblendet werden sollen.

(Beachten Sie, dass dies keine Mitgliederfunktionen sind.)

typedef NSURL *_Nullable(^ GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger-Zoom)
 GMSTileURLConstructor ist ein Block, der x, y und zoom umfasst und eine NSURL oder null zurückgibt, um anzugeben, dass keine Kachel für diesen Standort vorhanden ist.

Dokumentation zu Mitgliederfunktionen

+ (Instanztyp) tileLayerWithURLKonstruktor: (GMSTileURLConstructor) Konstrukteur

Convenience-Konstruktor.

constructor darf nicht null sein.

- (void) requestTileForX: (NSUInteger) x
y: (NSUInteger) J
Zoom: (NSUInteger) Zoomen
Empfänger: (id< GMSTileReceiver >) Empfänger

requestTileForX:y:zoom:receiver: Erzeugt Bildkacheln für GMSTileOverlay.

Er muss von Unterklassen überschrieben werden. Die Kachel für die angegebenen x-, y- und zoom-Werte muss später an receiver übergeben werden.

Geben Sie „kGMSTileLayerNoTile“ an, wenn für diesen Standort keine Kachel verfügbar ist, oder „nil“, wenn ein vorübergehender Fehler aufgetreten ist und eine Kachel möglicherweise später verfügbar ist.

Aufrufe dieser Methode erfolgen im Hauptthread. Unter GMSSyncTileLayer finden Sie eine Basisklasse, die eine blockierende Kachelebene implementiert, die nicht im Hauptthread Ihrer Anwendung ausgeführt wird.

- (void) clearTileCache

Löscht den Cache, sodass alle Kacheln erneut angefordert werden.


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

GMSTileURLConstructor ist ein Block, der x, y und zoom umfasst und eine NSURL oder null zurückgibt, um anzugeben, dass keine Kachel für diesen Standort vorhanden ist.


Property-Dokumentation

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

Geben Sie den User-Agent an, um Ihre Anwendung zu beschreiben.

Ist dieser Wert „nil“ (Standardeinstellung), wird der standardmäßige iOS-User-Agent für HTTP-Anfragen verwendet.

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

Die Karte, auf der dieses GMSTileOverlay angezeigt wird

Wenn diese Eigenschaft festgelegt wird, wird die Ebene zur Karte hinzugefügt. Wenn der Wert auf null gesetzt wird, wird diese Ebene von der Karte entfernt. Eine Ebene kann jeweils nur auf einer Karte aktiv sein.

- (int) zIndex [read, write, assign, inherited]

Kachelebenen mit einem höheren Wert von zIndex werden über Kachelebenen und Overlays mit einem niedrigeren Wert von zIndex gezeichnet.

Gleiche Werte führen zu einer undefinierten Zeichenreihenfolge.

– (NSInteger) tileSize [read, write, assign, inherited]

Gibt die Anzahl der Pixel (nicht Punkte) an, mit denen die zurückgegebenen Kachelbilder bevorzugt angezeigt werden sollen.

Für ein optimales Ergebnis sollte dies die Kantenlänge Ihrer benutzerdefinierten Kacheln sein. Die Standardeinstellung ist 256. Dies ist die herkömmliche Größe von Google Maps-Kacheln.

Werte unter 128 Punkten (z.B. 256 Pixel auf Retina-Geräten) funktionieren möglicherweise nicht gut und werden nicht empfohlen.

Ein Anwendungsentwickler möchte zum Beispiel Retina-Kacheln (Randlänge von 512 Pixeln) auf Retina-Geräten bereitstellen, um die gleiche Anzahl von Kacheln pro Ansicht beizubehalten, die der Standardwert von 256 auf einem Nicht-Retina-Gerät erreichen würde.

- (Gleitkommazahl) opacity [read, write, assign, inherited]

Gibt die Deckkraft der Kachelebene an.

Dadurch wird ein Multiplikator für den Alphakanal der Kachelbilder bereitgestellt.

- (BOOL) fadeIn [read, write, assign, inherited]

Gibt an, ob die Kacheln langsam eingeblendet werden sollen.

Standardeinstellung JA.