개요
마커는 지도 표면의 특정 지점에 배치되는 아이콘입니다.
마커의 아이콘은 지도의 표면이 아닌 기기의 화면을 향하여 방향이 그려집니다. 즉, 지도 회전, 기울기 또는 확대/축소로 인해 방향이 반드시 바뀌지는 않습니다.
GMSOverlay를 상속합니다.
GMSAdvancedMarker에서 상속됩니다.
정적 공개 멤버 함수 | |
(인스턴스 유형) | + markerWithPosition: |
기본 마커의 편의 생성자입니다. | |
(UIImage *) | + markerImageWithColor: |
아이콘으로 사용할 기본 마커 이미지의 색조가 조정된 버전을 만듭니다. | |
속성 | |
CLLocationCoordinate2D | position |
마커 위치 | |
NSString * | 스니펫 |
선택 시 정보 창의 제목 아래에 표시되는 스니펫 텍스트입니다. | |
UI이미지 * | 아이콘 |
렌더링할 마커 아이콘 | |
UIView * | iconView |
렌더링할 마커 뷰 | |
부울 | tracksViewChanges |
이 마커의 아이콘을 프레임마다 다시 그려야 하는지 여부를 제어합니다. | |
부울 | tracksInfoWindowChanges |
이 마커의 정보 창을 프레임마다 다시 그려야 하는지 여부를 제어합니다. | |
CGPoint | groundAnchor |
지면 앵커는 아이콘 이미지에서 지표면의 마커 위치에 고정된 지점을 지정합니다. | |
CGPoint | infoWindowAnchor |
정보 창 앵커는 아이콘 이미지에서 정보 창을 고정할 지점을 지정하며, 이 지점 바로 위에 표시됩니다. | |
GMSMarkerAnimation | appearAnimation |
이 마커가 GMSMapView에 배치될 때 사용되는 애니메이션을 제어합니다 (기본 kGMSMarkerAnimationNone, 애니메이션 없음). | |
부울 | 드래그 가능 |
마커를 대화형으로 드래그할 수 있는지 여부를 제어합니다 (기본값 NO). | |
부울 | 수평 |
마커를 지면에 평평하게 배치해야 하는지 (예) 또는 카메라를 향하는 빌보드에 마커를 놓을지 (기본값, 기본값) 제어합니다. | |
CLLocationDegrees | 회전 |
마커의 앵커 포인트를 기준으로 마커의 회전 각도를 시계 방향으로 설정합니다. | |
float | 불투명도 |
마커의 불투명도를 0 (완전 투명)에서 1 (기본값) 사이로 설정합니다. | |
GMSMarkerLayer * | 레이어 |
이 GMSMarker에 핵심 애니메이션 레이어를 제공합니다. | |
GMSPanoramaView * | panoramaView |
panoramaView 는 이 마커를 표시하려고 시도할 파노라마 뷰를 지정합니다. | |
NSString * | title |
제목, 오버레이에 관한 간단한 설명. | |
GMSMapView * | map |
이 오버레이가 있는 지도입니다. | |
부울 | 탭 가능 |
이 오버레이가 탭 알림을 발생시켜야 하는지 여부입니다. | |
int | zIndex |
zIndex 값이 높은 오버레이가 zIndex 값이 낮은 타일 레이어 및 오버레이 위에 그려집니다. | |
ID | userData |
데이터 오버레이 |
멤버 함수 문서
+ (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | position |
기본 마커의 편의 생성자입니다.
+ (UIImage *) markerImageWithColor: | (nullable UIColor *) | color |
아이콘으로 사용할 기본 마커 이미지의 색조가 조정된 버전을 만듭니다.
속성 문서
- (CLLocationCoordinate2D) 위치 [read, write, assign] |
마커 위치
애니메이션
- (NSString*) 스니펫 [read, write, copy] |
선택 시 정보 창의 제목 아래에 표시되는 스니펫 텍스트입니다.
- (UIImage*) 아이콘 [read, write, assign] |
렌더링할 마커 아이콘
nil로 두면 기본 SDK 장소 마커를 사용합니다.
애니메이션 이미지를 지원하지만 각 프레임의 크기가 같거나 동작이 정의되지 않아야 합니다.
축소된 탭 영역을 지정하기 위한 AlignmentRectInsets 사용을 지원합니다. 이렇게 하면 앵커가 지정되는 방식이 재정의됩니다. 애니메이션 이미지의 경우 개별 프레임이 아닌 애니메이션 값이 사용됩니다.
- (UIView*) iconView [read, write, assign] |
렌더링할 마커 뷰
nil로 두면 대신 icon
속성으로 대체됩니다.
UIView의 모든 애니메이션 가능한 속성의 애니메이션을 지원합니다(frame
및 center
제외). 이러한 속성 또는 상응하는 CALayer 버전(position
포함) 변경은 지원되지 않습니다.
뷰는 실제 값과 관계없이 clipsToBounds
가 YES로 설정된 것처럼 동작합니다.
- (BOOL) tracksViewChanges [read, write, assign] |
이 마커의 아이콘을 프레임마다 다시 그려야 하는지 여부를 제어합니다.
'아니요'에서 '예'로 변경하면 아이콘이 다음 프레임에 다시 그려집니다.
기본값은 YES입니다. iconView
이 nil이면 아무런 영향을 미치지 않습니다.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
이 마커의 정보 창을 프레임마다 다시 그려야 하는지 여부를 제어합니다.
이 값이 '아니요'에서 '예'로 변경되면 정보 창이 다음 프레임에 다시 그려집니다.
기본값은 NO입니다.
- (CGPoint) groundAnchor [read, write, assign] |
지면 앵커는 아이콘 이미지에서 지표면의 마커 위치에 고정된 지점을 지정합니다.
이 지점은 연속 공간 [0.0, 1.0] x [0.0, 1.0] 내에서 지정됩니다. 여기서 (0,0)은 이미지의 왼쪽 상단이고 (1,1)은 오른쪽 하단 모서리입니다.
이미지에 0이 아닌 AlignmentRectInsets가 있는 경우 위에서 언급한 왼쪽 상단과 오른쪽 하단은 이미지의 인셋 섹션을 참조합니다.
- (CGPoint) infoWindowAnchor [read, write, assign] |
정보 창 앵커는 아이콘 이미지에서 정보 창을 고정할 지점을 지정하며, 이 지점 바로 위에 표시됩니다.
이 지점은 groundAnchor와 동일한 공간 내에서 지정됩니다.
- (GMSMarkerAnimation) appearAnimation [read, write, assign] |
이 마커가 GMSMapView에 배치될 때 사용되는 애니메이션을 제어합니다 (기본 kGMSMarkerAnimationNone, 애니메이션 없음).
- (BOOL) 드래그 가능 [read, write, assign] |
마커를 대화형으로 드래그할 수 있는지 여부를 제어합니다 (기본값 NO).
- (BOOL) 플랫 [read, write, assign] |
마커를 지면에 평평하게 배치해야 하는지 (예) 또는 카메라를 향하는 빌보드에 마커를 놓을지 (기본값, 기본값) 제어합니다.
- (CLLocationDegrees) 회전 [read, write, assign] |
마커의 앵커 포인트를 기준으로 마커의 회전 각도를 시계 방향으로 설정합니다.
회전 축은 마커와 직각입니다. 회전이 0이면 마커의 기본 위치에 해당합니다. 애니메이션
마커가 지도에서 평면인 경우 기본 위치는 북쪽으로 정렬되며, 회전은 마커가 지도에서 항상 평평한 상태로 유지됩니다. 마커가 빌보드인 경우 기본 위치는 위를 향하며, 회전은 마커가 항상 카메라를 향하도록 합니다.
- (부동 소수점 수) 불투명도 [read, write, assign] |
마커의 불투명도를 0 (완전 투명)에서 1 (기본값) 사이로 설정합니다.
- (GMSMarkerLayer*) 레이어 [read, assign] |
이 GMSMarker에 핵심 애니메이션 레이어를 제공합니다.
- (GMSPanoramaView*) panoramaView [read, write, assign] |
panoramaView
는 이 마커를 표시하려고 시도할 파노라마 뷰를 지정합니다.
마커의 position
이 panoramaView
의 현재 파노라마 위치에서 너무 멀리 있으면 너무 작아져 표시되지 않습니다.
nil로 설정하면 연결된 현재 파노라마 뷰에서 마커를 삭제할 수 있습니다.
마커는 파노라마와 지도에 동시에 표시될 수 있습니다.
- (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는 지도 객체에 대한 강력한 참조를 보유해서는 안 됩니다. 그렇지 않으면 유지 주기가 생성되어 객체가 해제되지 않을 수 있습니다.