GMSGroundOverlay 클래스 참조

GMSGroundOverlay 클래스 참조

개요

GMSGroundOverlay는 지표면에 존재하는 지면 오버레이에 사용할 수 있는 옵션을 지정합니다.

마커와 달리 지면 오버레이의 위치는 명시적으로 지정되며 카메라를 향하지 않습니다.

GMSOverlay를 상속합니다.

정적 공개 멤버 함수

(인스턴스 유형)+ groundOverlayWithBounds:icon:
 특정 boundsiconGMSGroundOverlay의 편의 생성자입니다.
(인스턴스 유형)+ groundOverlayWithPosition:icon:zoomLevel:
 마치 이미지의 실제 크기가 zoomLevel의 카메라 픽셀과 일치하는 것처럼 position에서 지정된 icon를 렌더링하는 GMSGroundOverlay를 구성합니다.

속성

CLLocationCoordinate2Dposition
 GMSGroundOverlay의 위치 또는 더 구체적으로 앵커의 실제 위치입니다.
CGPoint앵커
 앵커는 bounds를 기준으로 이 GMSGroundOverlay가 어스에 고정된 위치를 지정합니다.
UI이미지 * 아이콘
 어스의 bounds 내에서 렌더링하는 아이콘
float 불투명도
 지면 오버레이의 불투명도를 0(완전 투명)에서 1(기본값) 사이(기본값 포함)로 설정합니다.
CLLocationDirectionbearing
 이 지면 오버레이의 방위입니다(단위: 도).
GMSCoordinateBounds경계
 icon가 그려지는 지구의 2D 경계입니다.
NSString * title
 제목, 오버레이에 관한 간단한 설명.
GMSMapViewmap
 이 오버레이가 있는 지도입니다.
부울탭 가능
 이 오버레이가 탭 알림을 발생시켜야 하는지 여부입니다.
int zIndex
 zIndex 값이 높은 오버레이가 zIndex 값이 낮은 타일 레이어 및 오버레이 위에 그려집니다.
IDuserData
 데이터 오버레이

멤버 함수 문서

+ (instancetype) groundOverlayWithBounds: (null을 허용하는 GMSCoordinateBounds *) 경계
아이콘을 클릭합니다. (nullable UIImage *)  아이콘

특정 boundsiconGMSGroundOverlay의 편의 생성자입니다.

이에 따라 position를 설정합니다.

+ (instancetype) groundOverlayWithPosition: (CLLocationCoordinate2D)  position
아이콘을 클릭합니다. (nullable UIImage *)  아이콘
확대/축소 수준: (CGFloat) zoomLevel

마치 이미지의 실제 크기가 zoomLevel의 카메라 픽셀과 일치하는 것처럼 position에서 지정된 icon를 렌더링하는 GMSGroundOverlay를 구성합니다.


속성 문서

- (CLLocationCoordinate2D) 위치 [read, write, assign]

GMSGroundOverlay의 위치 또는 더 구체적으로 앵커의 실제 위치입니다.

변경하면 bounds가 새 위치를 중심으로 이동합니다.

- (CGPoint) anchor [read, write, assign]

앵커는 bounds를 기준으로 이 GMSGroundOverlay가 어스에 고정된 위치를 지정합니다.

이 속성을 수정하면 positionbounds 내의 상응하는 새 위치로 설정됩니다.

- (UIImage*) 아이콘 [read, write, assign]

어스의 bounds 내에서 렌더링하는 아이콘

nil이면 기본 이미지가 있는 GMSMarker와 달리 오버레이가 표시되지 않습니다.

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

지면 오버레이의 불투명도를 0(완전 투명)에서 1(기본값) 사이(기본값 포함)로 설정합니다.

- (CLLocationDirection) 방위 [read, write, assign]

이 지면 오버레이의 방위입니다(단위: 도).

기본값인 0은 지구의 일반 Y 축을 따라 이 지면 오버레이를 위/아래로 가리킵니다.

- (GMSCoordinateBounds*) 경계 [read, write, assign]

icon가 그려지는 지구의 2D 경계입니다.

이 값을 변경하면 position가 그에 따라 조정됩니다.

- (NSString*) title [read, write, copy, inherited]

제목, 오버레이에 관한 간단한 설명.

마커와 같은 일부 오버레이는 지도에 제목을 표시합니다. 제목은 기본 접근성 텍스트이기도 합니다.

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

이 오버레이가 있는 지도입니다.

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

- (BOOL) 탭 가능 [read, write, assign, inherited]

이 오버레이가 탭 알림을 발생시켜야 하는지 여부입니다.

마커와 같은 일부 오버레이는 기본적으로 탭할 수 있도록 설정됩니다.

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

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

값이 같으면 그리기 순서가 정의되지 않습니다. 마커는 zIndex와 관계없이 항상 타일 레이어 및 마커가 아닌 다른 오버레이 위에 그려집니다. 즉, 사실상 다른 오버레이와 비교하여 별도의 Z-색인 그룹에 있는 것으로 간주됩니다.

- (ID) userData [read, write, assign, inherited]

데이터 오버레이

이 속성을 사용하여 임의의 객체를 이 오버레이와 연결할 수 있습니다. iOS용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다.

userData는 지도 객체에 대한 강력한 참조를 보유해서는 안 됩니다. 그렇지 않으면 유지 주기가 생성되어 객체가 해제되지 않을 수 있습니다.