개요
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를 상속합니다.
를 탭합니다. 공개 멤버 함수 | |
(무효) | - requestTileForX:y:zoom:receiver: |
requestTileForX:y:zoom:receiver: GMSTileOverlay의 이미지 타일을 생성합니다. | |
(무효) | - clearTileCache를 추가합니다. |
모든 타일이 다시 요청되도록 캐시를 지웁니다. | |
를 탭합니다. 정적 공개 멤버 함수 | |
(instancetype) | + tileLayerWithURLConstructor: |
편의 생성자입니다. | |
를 탭합니다. 속성 | |
NSString * | userAgent |
사용자 에이전트를 지정하여 애플리케이션을 설명합니다. | |
GMSMapView * | map |
이 GMSTileOverlay가 표시되는 지도입니다. | |
정수 | zIndex |
zIndex 값이 높은 타일 레이어는 zIndex 값이 낮은 타일 레이어 및 오버레이 위에 그려집니다. | |
NSInteger | tileSize |
반환된 타일 이미지를 표시할 픽셀 수 (포인트 아님)를 지정합니다. | |
부동 소수점 수 | 불투명도 |
타일 레이어의 불투명도를 지정합니다. | |
부울 | fadeIn |
타일의 페이드 인 여부를 지정합니다. | |
를 탭합니다. 관련 함수 | |
(이는 멤버 함수가 아닙니다.) | |
typedef NSURL *_Nullable(^) | GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 확대/축소) |
GMSTileURLConstructor 는 x , y , zoom 를 가져와 NSURL 또는 nil을 반환하여 해당 위치에 타일이 없음을 나타내는 블록입니다. |
구성원 기능 문서
+ (인스턴스 유형) tileLayerWithURLConstructor: | (GMSTileURLConstructor) | 생성자 |
편의 생성자입니다.
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] |
GMSTileURLConstructor
는 x
, y
, zoom
를 가져와 NSURL 또는 nil을 반환하여 해당 위치에 타일이 없음을 나타내는 블록입니다.
속성 문서
- (NSString*) userAgent [read, write, copy] |
사용자 에이전트를 지정하여 애플리케이션을 설명합니다.
nil (기본값)이면 기본 iOS 사용자 에이전트가 HTTP 요청에 사용됩니다.
- (GMSMapView*) 지도 [read, write, assign, inherited] |
이 GMSTileOverlay가 표시되는 지도입니다.
이 속성을 설정하면 지도에 레이어가 추가됩니다. nil로 설정하면 이 레이어가 지도에서 삭제됩니다. 레이어는 특정 시점에 최대 1개의 지도에서 활성화될 수 있습니다.
- (정수) zIndex [read, write, assign, inherited] |
zIndex
값이 높은 타일 레이어는 zIndex
값이 낮은 타일 레이어 및 오버레이 위에 그려집니다.
값이 같으면 그리기 순서가 정의되지 않습니다.
- (NSInteger) tileSize [read, write, assign, inherited] |
반환된 타일 이미지를 표시할 픽셀 수 (포인트 아님)를 지정합니다.
최상의 결과를 얻으려면 맞춤 타일의 가장자리 길이여야 합니다. 기본값은 256으로, 일반적인 Google 지도 타일 크기입니다.
128포인트에 상응하는 값 (예: 레티나 기기의 경우 256픽셀)보다 작은 값은 제대로 작동하지 않을 수 있으므로 권장하지 않습니다.
예를 들어, 애플리케이션 개발자는 레티나 기기에 레티나 타일 (512픽셀 가장자리 길이)을 제공하여 뷰당 타일 수를 기본값인 256으로 유지하여 레티나가 아닌 기기에 제공할 수 있습니다.
- (부동 소수점 수) 불투명도 [read, write, assign, inherited] |
타일 레이어의 불투명도를 지정합니다.
이는 타일 이미지의 알파 채널에 대한 배율을 제공합니다.
- (BOOL) fadeIn [read, write, assign, inherited] |
타일의 페이드 인 여부를 지정합니다.
기본값은 '예'입니다.