개요
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 |
모든 타일이 다시 요청되도록 캐시를 지웁니다. | |
정적 공개 멤버 함수 | |
(인스턴스 유형) | + tileLayerWithURL팀 생성자: |
편의 생성자입니다. | |
속성 | |
NSString * | userAgent |
애플리케이션을 설명하는 사용자 에이전트를 지정합니다. | |
GMSMapView * | map |
이 GMSTileOverlay가 표시되는 지도입니다. | |
int | zIndex |
zIndex 값이 더 높은 타일 레이어가 하위 zIndex 값의 타일 레이어 및 오버레이 위에 그려집니다. | |
NSInteger | tileSize |
반환된 타일 이미지가 표시할 픽셀 (점 아님) 수를 지정합니다. | |
float | 불투명도 |
타일 레이어의 불투명도를 지정합니다. | |
부울 | fadeIn |
타일의 페이드 인 여부를 지정합니다. | |
관련 함수 | |
(이 함수는 멤버 함수가 아닙니다.) | |
typedef NSURL *_Nullable(^ | GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger 확대/축소) |
GMSTileURLConstructor 는 x , y , zoom 를 가져와 NSURL을 반환하는 블록이며, 해당 위치에 타일이 없음을 나타내기 위해 nil을 반환합니다. |
멤버 함수 문서
+ (instancetype) tileLayerWithURLEstablishor: | (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 (기본값)인 경우 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] |
타일의 페이드 인 여부를 지정합니다.
기본값은 YES입니다.