GMSURLTileLayer 클래스 참조

GMSURLTileLayer 클래스 참조

개요

GMSURLTileProvider는 GMSTileURLStructor에서 반환된 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
 모든 타일이 다시 요청되도록 캐시를 지웁니다.

정적 공개 멤버 함수

(인스턴스 유형)+ tileLayerWithURLConstructor:
 편의 생성자입니다.

속성

NSString * userAgent
 애플리케이션을 설명할 사용자 에이전트를 지정합니다.
GMSMapViewmap
 이 GMSTileOverlay가 표시되는 지도입니다.
int zIndex
 zIndex 값이 높은 타일 레이어가 하위 zIndex 값의 타일 레이어 및 오버레이 위에 그려집니다.
NSIntegertileSize
 반환된 타일 이미지가 표시할 픽셀 (점 아님) 수를 지정합니다.
float 불투명도
 타일 레이어의 불투명도를 지정합니다.
부울fadeIn
 타일의 페이드 인 여부를 지정합니다.

(이 함수는 멤버 함수가 아닙니다.)

typedef NSURL *_Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 확대/축소)
 GMSTileURLConstructorx, y, zoom를 가져와 NSURL을 반환하는 블록이며, 해당 위치에 타일이 없음을 나타내는 nil입니다.

멤버 함수 문서

편의 생성자입니다.

constructor은 nil이 아니어야 합니다.

- (void) requestTileForX: (NSUInteger) x
y: (NSUInteger)
확대/축소: (NSUInteger) 확대/축소
받는 사람: (id< GMSTileReceiver >) 수신자

requestTileForX:y:zoom:receiver: 는 GMSTileOverlay의 이미지 타일을 생성합니다.

서브클래스에서 재정의해야 합니다. 지정된 x, y, zoom의 타일은 나중에 receiver에 전달되어야 합니다.

이 위치에 사용할 수 있는 타일이 없는 경우 kGMSTileLayerNoTile을 지정하고, 일시적인 오류가 발생하여 나중에 카드를 사용할 수 있는 경우에는 nil을 지정합니다.

이 메서드는 기본 스레드에서 호출됩니다. 애플리케이션의 기본 스레드에서 실행되지 않는 차단 타일 레이어를 구현하는 기본 클래스는 GMSSyncTileLayer를 참고하세요.

- (void) clearTileCache

모든 타일이 다시 요청되도록 캐시를 지웁니다.


- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 확대/축소) [related]

GMSTileURLConstructorx, y, zoom를 가져와 NSURL을 반환하는 블록이며, 해당 위치에 타일이 없음을 나타내는 nil입니다.


속성 문서

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

애플리케이션을 설명할 사용자 에이전트를 지정합니다.

nil (기본값)인 경우 HTTP 요청에 기본 iOS 사용자 에이전트가 사용됩니다.

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

이 GMSTileOverlay가 표시되는 지도입니다.

이 속성을 설정하면 지도에 레이어가 추가됩니다. nil로 설정하면 지도에서 이 레이어가 삭제됩니다. 레이어는 어느 때든 최대 1개의 지도에서 활성화할 수 있습니다.

- (정수) zIndex [read, write, assign, inherited]

zIndex 값이 높은 타일 레이어가 하위 zIndex 값의 타일 레이어 및 오버레이 위에 그려집니다.

값이 같으면 그리기 순서가 정의되지 않습니다.

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

반환된 타일 이미지가 표시할 픽셀 (점 아님) 수를 지정합니다.

최상의 결과를 얻으려면 이 값은 맞춤 타일의 가장자리 길이여야 합니다. 기본값은 Google 지도 타일의 기본 크기인 256입니다.

128포인트보다 작은 값 (예: 레티나 기기의 경우 256픽셀)은 성능이 저하될 수 있으므로 권장하지 않습니다.

예를 들어, 애플리케이션 개발자는 레티나 기기에 레티나 타일 (512픽셀 에지 길이)을 제공하여, 레티나가 아닌 기기에 기본값 256이 제공하는 것과 동일한 뷰당 타일 수를 유지하고자 할 수 있습니다.

- (부동 소수점 수) 불투명도 [read, write, assign, inherited]

타일 레이어의 불투명도를 지정합니다.

이렇게 하면 타일 이미지의 알파 채널에 승수가 제공됩니다.

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

타일의 페이드 인 여부를 지정합니다.

기본값은 '예'입니다.