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