개요
마커는 지도 표면의 특정 지점에 배치되는 아이콘입니다.
마커의 아이콘은 지도의 표면이 아니라 기기의 화면을 향하도록 방향이 그려집니다. 즉, 지도 회전, 기울기 또는 확대/축소로 인해 반드시 방향이 변경되지는 않습니다.
GMSOverlay를 상속합니다.
GMSAdvancedMarker에 의해 상속되었습니다.
정적 공개 구성원 함수 | |
| (instancetype) | + markerWithPosition: |
| 기본 마커의 편의 생성자입니다. | |
| (UIImage *) | + markerImageWithColor: |
| 아이콘으로 사용할 기본 마커 이미지의 색조가 조정된 버전을 만듭니다. | |
속성 | |
| CLLocationCoordinate2D | position |
| 마커 위치입니다. | |
| NSString * | 스니펫 |
| 선택 시 정보 창의 제목 아래에 표시되는 스니펫 텍스트입니다. | |
| UIImage * | 아이콘 |
| 렌더링할 마커 아이콘입니다. | |
| UIView * | 아이콘 보기 |
| 렌더링할 마커 뷰입니다. | |
| 부울 | tracksViewChanges |
| 이 마커의 아이콘을 프레임마다 다시 그릴지 여부를 제어합니다. | |
| 부울 | 추적 정보 창 변경사항 |
| 이 마커에 대한 정보 창을 프레임마다 다시 그려야 하는지 여부를 제어합니다. | |
| CGPoint | 지면 앵커 |
| 지면 앵커는 아이콘 이미지에서 지표면의 마커 위치에 고정된 지점을 지정합니다. | |
| CGPoint | 정보 창 앵커 |
| 정보 창 앵커는 아이콘 이미지에서 정보 창을 고정할 지점을 지정합니다. 이 지점은 이 지점 바로 위에 표시됩니다. | |
| GMSMarkerAnimation | AppearanceAnimation |
| 이 마커가 GMSMapView에 배치될 때 사용되는 애니메이션을 제어합니다 (기본값: kGMSMarkerAnimationNone, 애니메이션 없음). | |
| 부울 | 드래그 가능 |
| 이 마커를 대화형으로 드래그할 수 있는지 여부를 제어합니다. 기본값은 NO입니다. | |
| 부울 | 평면 |
| 이 마커를 지면에 대고 평평하게 표시할지 (예) 카메라를 마주 보는 빌보드에 표시할 것인지 (아니요, 기본값) 지정합니다. | |
| CLLocationDegrees | 회전 |
| 마커의 앵커 지점을 기준으로 마커의 회전을 시계 방향의 각도로 설정합니다. | |
| 부동 소수점 수 | 불투명도 |
| 마커의 불투명도를 0 (완전 투명)에서 1 (기본값) 사이로 설정합니다. | |
| GMSMarkerLayer * | layer |
| 이 GMSMarker에 핵심 애니메이션 레이어를 제공합니다. | |
| GMS 파노라마 보기 * | 파노라마 뷰 |
panoramaView는 이 마커를 표시하려고 시도할 파노라마 뷰를 지정합니다. | |
| NSString * | title |
| 제목: 오버레이에 관한 간단한 설명 | |
| GMSMapView * | map |
| 이 오버레이가 있는 지도입니다. | |
| 부울 | 탭 가능 |
| 이 오버레이가 탭 알림을 발생시켜야 하는지 여부입니다. | |
| 정수 | Z색인 |
zIndex 값이 더 높은 오버레이는 하위 zIndex 값의 타일 레이어 및 오버레이 위에 그려집니다. | |
| ID | 사용자 데이터 |
| 데이터 오버레이 | |
멤버 함수 문서
| + (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | position |
기본 마커의 편의 생성자입니다.
| + (UIImage *) markerImageWithColor: | (null을 허용하는 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이 아닌 alignRectInsets가 있는 경우 위에서 언급한 왼쪽 상단 및 오른쪽 하단은 이미지의 인셋 섹션을 나타냅니다.
- (CGPoint) infoWindowAnchor [read, write, assign] |
정보 창 앵커는 아이콘 이미지에서 정보 창을 고정할 지점을 지정합니다. 이 지점은 이 지점 바로 위에 표시됩니다.
이 지점은 groundAnchor와 동일한 공간 내에서 지정됩니다.
- (GMSMarkerAnimation) AppearanceAnimation [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에 핵심 애니메이션 레이어를 제공합니다.
- (GMS 파노라마 보기*) 파노라마 보기 [read, write, assign] |
panoramaView는 이 마커를 표시하려고 시도할 파노라마 뷰를 지정합니다.
마커의 position이 panoramaView의 현재 파노라마 위치에서 너무 멀리 있으면 너무 작아져 표시되지 않습니다.
nil로 설정하여 마커가 연결된 현재 파노라마 뷰에서 마커를 삭제할 수 있습니다.
파노라마와 지도에 동시에 마커를 표시할 수 있습니다.
- (NSString*) title [read, write, copy, inherited] |
제목: 오버레이에 관한 간단한 설명
마커와 같은 일부 오버레이는 지도에 제목을 표시합니다. 제목은 기본 접근성 텍스트이기도 합니다.
- (GMSMapView*) 지도 [read, write, assign, inherited] |
이 오버레이가 있는 지도입니다.
이 속성을 설정하면 지도에 오버레이가 추가됩니다. nil로 설정하면 지도에서 이 오버레이가 제거됩니다. 오버레이는 특정 시점에 최대 1개의 지도에서 활성화할 수 있습니다.
- (BOOL) 탭 가능 [read, write, assign, inherited] |
이 오버레이가 탭 알림을 발생시켜야 하는지 여부입니다.
마커와 같은 일부 오버레이는 기본적으로 탭할 수 있도록 설정됩니다.
- (정수) zIndex [read, write, assign, inherited] |
zIndex 값이 더 높은 오버레이는 하위 zIndex 값의 타일 레이어 및 오버레이 위에 그려집니다.
값이 같으면 정의되지 않은 그리기 순서가 발생합니다. 마커는 zIndex에 관계없이 항상 타일 레이어 및 기타 비 마커 오버레이 위에 그려지므로, 사실상 다른 오버레이와 비교하여 별도의 Z-색인 그룹에 있는 것으로 간주됩니다.
- (ID) userData [read, write, assign, inherited] |
데이터 오버레이
이 속성을 사용하여 임의의 객체를 이 오버레이와 연결할 수 있습니다. iOS용 Google 지도 SDK에서는 이 속성을 읽거나 쓰지 않습니다.
userData는 지도 객체에 대한 강력한 참조를 보유해서는 안 됩니다. 그렇지 않으면 유지 주기가 생성될 수 있습니다 (객체가 해제되지 않음).