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를 상속합니다.

공개 멤버 함수

(무효)- requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:Receiver: GMSTileOverlay용 이미지 타일을 생성합니다.
(무효)- clearTileCache
 모든 타일이 다시 요청되도록 캐시를 지웁니다.

정적 공개 구성원 함수

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

속성

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

참고로, 이러한 함수는 멤버 함수가 아닙니다.

typedef NSURL *_Nullable(^ GMSTileURLConstructor)(NSU정수 x, NSU정수 y, NSU정밀도)
 GMSTileURLConstructorx, y, zoom를 가져와 NSURL을 반환하거나 nil을 반환하여 해당 위치에 타일이 없음을 나타냅니다.

구성원 함수 문서

편의 생성자입니다.

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

- requestvoidForX: (void) (NSU정수) x
y: (NSU정수)
확대/축소: (NSU정수) 확대/축소
받는 사람: (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 zoom) [related]

GMSTileURLConstructorx, y, zoom를 가져와 NSURL을 반환하거나 nil을 반환하여 해당 위치에 타일이 없음을 나타냅니다.


속성 문서

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

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

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

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

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

이 속성을 설정하면 지도에 레이어가 추가됩니다. nil로 설정하면 지도에서 이 레이어가 삭제됩니다. 레이어는 항상 최대 한 개의 지도에서만 활성화될 수 있습니다.

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

높은 zIndex 값 타일 레이어는 낮은 zIndex 값 타일 레이어와 오버레이 위에 그려집니다.

값이 같으면 정의되지 않은 그리기 순서가 생성됩니다.

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

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

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

128포인트에 상응하는 값 (예: 레티나 기기의 경우 256픽셀)보다 낮은 값은 제대로 작동하지 않을 수 있으므로 권장되지 않습니다.

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

- (부동 소수점 수) opacity [read, write, assign, inherited]

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

타일 이미지의 알파 채널에 대한 배율을 제공합니다.

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

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

기본값은 '예'입니다.