GMSMapView 클래스 참조

CGRectZero 및 기본 옵션을 사용하여 초기화합니다.

특정 옵션으로 새 지도뷰를 만듭니다.

옵션 객체의 값은 이 메서드에 의해 복사됩니다.

프레임과 카메라 타겟이 있는 지도뷰를 빌드하고 반환합니다.

프레임, 지도 ID, 카메라 타겟이 있는 지도뷰를 빌드하고 반환하는 편의 이니셜라이저입니다.

프레임 및 카메라 타겟이 있는 지도뷰를 빌드하고 반환합니다.

참고:

이 기능은 지원 중단되었습니다. 대신 -init 또는 -initWithOptions: 를 사용하세요.

프레임, 지도 ID, 카메라 타겟이 있는 지도뷰를 빌드하고 반환합니다.

참고:

이 기능은 지원 중단되었습니다. 대신 -init 또는 -initWithOptions: 를 사용하세요.

지도에 렌더기를 강화하도록 지시합니다.

선택사항이며 멱등성이 있습니다.

참고:

이 기능은 지원 중단되었습니다. 이 메서드는 더 이상 사용되지 않으며 향후 버전에서 삭제될 예정입니다.

지도에 렌더기를 종료하도록 지시합니다.

선택사항이며 멱등성이 있습니다.

참고:

이 기능은 지원 중단되었습니다. 이 메서드는 더 이상 사용되지 않으며 향후 버전에서 삭제될 예정입니다.

마커, 다중선, 지면 오버레이를 포함하여 지도에 추가된 모든 마크업을 지웁니다.

표시된 위치 점이 지워지거나 현재 mapType이 재설정되지는 않습니다.

minZoom와 maxZoom를 설정합니다.

이 메서드는 최소값이 최대값보다 작거나 같을 것으로 예상하며, 그렇지 않으면 이름이 NSRangeException인 예외를 발생시킵니다.

padding로 bounds를 표시하는 GMSCameraPosition을 빌드합니다.

카메라는 방위와 기울기가 0입니다 (즉, 북쪽을 향하여 지구를 바라보게 됨). 여기에서는 이 GMSMapView의 프레임과 패딩을 고려합니다.

경계가 유효하지 않은 경우 이 메서드는 nil 카메라를 반환합니다.

update에 따라 카메라를 변경합니다.

카메라가 즉시 변경됩니다 (애니메이션 없음).

내부적으로 사용된 정밀도와 변환을 고려하여 지정된 카메라 위치로 인해 카메라가 실제로 동일하게 렌더링되는지 확인합니다.

지정된 유형의 지형지물 레이어를 반환합니다.

지형지물 레이어는 Cloud 콘솔에서 구성해야 합니다.

지정된 유형의 레이어가 이 지도에 없거나 데이터 기반 스타일 지정이 사용 설정되지 않은 경우 또는 메탈 렌더링 프레임워크가 사용되지 않는 경우 결과 레이어의 `isAvailable` 이 NO가 되고 호출에 응답하지 않습니다.

메탈 렌더기가 필요합니다. https://developers.google.com/maps/documentation/ios-sdk/config#use-metal에서 Metal 사용 설정 방법을 알아보세요.

지정된 데이터 세트의 데이터 세트 지형지물 레이어를 반환합니다.

데이터 세트 ID는 Cloud 콘솔에서 구성해야 합니다.

지정된 ID의 데이터 세트가 이 지도에 없거나 데이터 기반 스타일 지정이 사용 설정되지 않은 경우 결과 레이어의 `isAvailable` 은 NO가 되고 호출에 응답하지 않습니다.

액세서리 뷰를 무효화하고 해당 뷰의 재레이아웃을 트리거합니다.

뷰는 현재 액세서리 뷰 중 하나여야 합니다. 안내가 없으면 이 통화는 NO-OP 안내입니다.

탐색 UI의 기본 헤더 아래에 있는 액세서리 뷰의 위치를 설정합니다.

nil 값을 전달하면 액세서리 뷰가 삭제됩니다. 안내가 없으면 이 통화는 NO-OP 안내입니다.

@note 지도뷰가 짧은 경우 공간 제약으로 인해 SDK에서 액세서리 뷰를 숨깁니다. 뷰는 지도 표시를 최적화하기 위해 내부적으로 관리됩니다.

이 지도의 카메라에 cameraPosition에 애니메이션을 적용합니다.

animateToCameraPosition:과 동일하나 카메라의 위치만 변경합니다 (즉, 현재 위치에서 location로).

animateToCameraPosition:과 동일하나 카메라의 확대/축소 수준만 변경합니다.

이 값은 [kGMSMinZoomLevel, kGMSMaxZoomLevel]로 고정됩니다.

animateToCameraPosition:과 동일하나 카메라의 방위 (단위: 도)만 변경합니다.

0은 진북을 나타냅니다.

animateToCameraPosition:과 동일하지만 카메라의 시야각 (단위: 도)만 변경합니다.

이 값은 지구와의 상대적 근접도에 따라 최소 0 (예: 수직을 향한 방향)에서 지평선을 향해 30~45도로 고정됩니다.

현재 카메라에 cameraUpdate를 적용한 다음 animateToCameraPosition:에 따라 결과를 사용합니다.

이 메서드는 CarPlay 지도 템플릿용 화면 이동 동작을 구현하려면 애플리케이션의 CPMapTemplateDelegate 메서드 -mapTemplateDidBeginPanGesture: 구현에서 호출해야 합니다.

이 메서드는 CarPlay 지도 템플릿용 화면 이동 동작을 구현하려면 애플리케이션의 CPMapTemplateDelegate 메서드 -mapTemplate:didUpdatePanGestureWithTranslation: 구현에서 호출해야 합니다.

이 메서드는 CarPlay 지도 템플릿용 화면 이동 동작을 구현하려면 애플리케이션의 CPMapTemplateDelegate 메서드 -mapTemplate:didEndPanGestureWithVelocity: 구현에서 호출해야 합니다.

지정된 내비게이션 세션을 사용하여 이 지도뷰에서 내비게이션을 시작합니다.

참고:

메모리와 CPU를 가장 효율적으로 사용하려면 이 지도뷰에서 다른 내비게이션 관련 메서드를 호출하기 전에 이 메서드를 호출합니다.

반환:

내비게이션이 성공적으로 시작되었는지 여부입니다. 예를 들어 이용약관에 아직 동의하지 않으면 NO가 반환됩니다.

나침반 버튼의 접근성 식별자입니다.

'내 위치'의 접근성 식별자 버튼을 클릭합니다.

'할당량 초과'에 대한 접근성 식별자 오류 라벨이 표시됩니다.

GMSMapView 위임.

지도의 방향을 정의하는 카메라를 제어합니다.

이 속성은 즉시 수정됩니다.

화면 좌표와 위도/경도 좌표 간에 변환하는 데 사용할 수 있는 GMSProjection 객체를 반환합니다.

현재 투영의 스냅샷이며 카메라가 이동해도 자동으로 업데이트되지 않습니다. 마지막으로 그린 GMSMapView 프레임의 투영을 나타냅니다. 다음 프레임을 나타낼 수 있습니다. 결코 nil이 아닙니다.

내 위치 도트 및 정확도 원 사용 여부를 제어합니다.

기본값은 NO입니다.

내 위치가 사용 설정된 경우 기기 위치 점이 그려진 위치를 표시합니다.

사용 중지되거나 사용 설정되어 있지만 위치 데이터를 사용할 수 없는 경우 nil이 됩니다. 이 속성은 KVO를 사용하여 관찰할 수 있습니다.

선택된 마커입니다.

이 속성을 설정하면 특정 마커가 선택되어 그 위에 정보 창이 표시됩니다. 이 속성이 nil이 아닌 경우 nil로 설정하면 마커가 선택 해제되어 정보 창이 숨겨집니다. 이 속성은 KVO를 사용하여 관찰할 수 있습니다.

지도에서 교통정보 데이터를 그릴지 여부를 제어합니다(사용 가능한 경우).

이는 교통정보 데이터 가용성에 따라 달라집니다. 기본값은 NO입니다.

표시할 지도 타일의 유형을 제어합니다.

기본값은 kGMSTypeNormal입니다.

지도의 스타일을 제어합니다.

nil이 아닌 mapStyle은 mapType이 Normal인 경우에만 적용됩니다.

지도를 원하는 [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc)으로 변경합니다.

이렇게 하면 기본 UIKit 동작이 재정의되고, 이전 버전과의 호환성을 보장하기 위해 기본값은 UIUserInterfaceStyleLight가 됩니다. 이는 일반 및 지형 지도 유형의 색 구성표에 영향을 미칩니다.

최소 확대/축소 (카메라가 축소될 수 있는 가장 먼 범위)

기본값은 kGMSMinZoomLevel입니다. -setMinZoom:maxZoom:으로 수정됩니다.

최대 확대/축소 (카메라가 지구에 가장 가까울 수 있음)

기본값은 kGMSMaxZoomLevel입니다. -setMinZoom:maxZoom:으로 수정됩니다.

설정하면 가능한 경우 3D 빌딩이 표시됩니다.

기본값은 '예'입니다.

이는 지도에 맞춤 타일 레이어를 추가할 때 높은 확대/축소 수준에서 더 명확하게 표시하기 위해 유용할 수 있습니다. 이 값을 변경하면 모든 타일이 잠시 무효화됩니다.

실내 지도의 표시 여부를 설정합니다(가능한 경우).

기본값은 '예'입니다.

NO로 설정하면 실내 데이터 캐시가 삭제될 수 있으며 최종 사용자가 현재 선택한 층이 재설정될 수 있습니다.

실내 데이터 표시의 측면을 관찰하거나 제어할 수 있는 GMSIndoorDisplay 인스턴스를 가져옵니다.

지도의 사용자 인터페이스 설정을 제어하는 GMSUISettings 객체를 가져옵니다.

'표시' 지정할 수 있습니다.

뷰의 가장자리 주변에 패딩을 적용하면 지도 데이터는 포함하지만 UI 컨트롤은 포함하지 않는 영역을 만들 수 있습니다.

패딩이 균형이 맞지 않으면 뷰의 시각적 중심이 적절하게 이동합니다. 패딩은 projection 속성에도 영향을 주므로 표시되는 영역에 패딩 영역이 포함되지 않습니다. GMSCameraUpdate fitToBounds를 사용하면 이 패딩과 요청된 패딩이 모두 고려됩니다.

이 속성은 UIView 기반 애니메이션 블록 내에서 애니메이션될 수 있습니다.

안전 영역 인셋이 패딩 값에 추가되는 방식을 제어합니다.

패딩과 마찬가지로 안전 영역 인셋은 나침반, My Location 버튼, 층 선택기와 같은 지도 컨트롤을 기기 안전 영역 내에 배치합니다.

기본값은 kGMSMapViewPaddingAdjustmentBehaviorAlways입니다.

기본값은 '예'입니다.

NO로 설정하면 GMSMapView가 오버레이 객체의 접근성 요소(예: GMSMarker 및 GMSPolyline)를 생성합니다.

이 속성은 비공식 UIAccessibility 프로토콜을 따릅니다(기본값 YES 제외).

레이어에 사용되는 맞춤 CALayer 유형의 접근자입니다.

렌더링 프레임 속도를 제어합니다.

기본값은 kGMSFrameRate최대입니다.

nil이 아니면 동작으로 인해 지정된 경계를 벗어나지 않도록 카메라 타겟을 제한합니다.

현재 사용 가능한 모든 조건부 사용 가능 (지도 ID 또는 기타 지도 설정에 따라 다름) 기능입니다.

항상 사용 가능한 기능은 포함되지 않습니다.

내비게이션 UI 이벤트의 콜백을 수신하는 GMSMapView의 대리자입니다.

이 지도에 내비게이션 기능이 사용 설정되어 있는지 여부입니다.

'예'인 경우 지도에 경로와 세부 경로 안내를 표시할 수 있고 카메라가 따라가기 모드로 전환될 수 있으며 카메라가 기기 위치를 따라가지 않을 때 다시 가운데 버튼이 표시됩니다.

사용자가 Google 내비게이션 이용약관에 동의하지 않은 경우 이 속성을 설정해도 아무런 효과가 없습니다. 이용약관 대화상자를 표시하려면 GMSNavigationServices의 메서드를 참고하세요.

경로를 요청하고 세부 경로 안내를 시작할 수 있는 이 GMSMapView의 탐색기입니다.

사용자가 Google 내비게이션 이용약관에 동의하지 않은 경우 nil이 표시됩니다. 이용약관 대화상자를 표시하려면 GMSNavigationServices의 메서드를 참고하세요.

도로에 맞춘 위치 업데이트에 대한 구독을 허용합니다.

사용자가 Google 내비게이션 이용약관에 동의하지 않은 경우 nil이 표시됩니다. 이용약관 대화상자를 표시하려면 GMSNavigationServices의 메서드를 참고하세요.

기기 위치를 시뮬레이션할 수 있습니다.

시뮬레이션된 위치는 지도 상의 V자형 아이콘의 위치, 세부 경로 안내의 진행 상황 및 도로에 맞추기된 위치 제공자가 제공하는 업데이트에 영향을 미칩니다.

사용자가 Google 내비게이션 이용약관에 동의하지 않은 경우 nil이 표시됩니다. 이용약관 대화상자를 표시하려면 GMSNavigationServices의 메서드를 참고하세요.

NavigationEnabled 속성이 YES로 설정된 경우 동작을 결정하는 카메라 모드입니다.

사용 가능한 모드는 GMSNavigationCameraMode를 참고하세요.

기기 위치를 따라갈 때 사용될 카메라 시점입니다.

이 관점을 적용하려면 navigationEnabled 속성을 YES로 설정하고 cameraMode를 GMSNavigationCameraModeFollowing으로 설정해야 합니다.

가져올 경로의 유형과 기기 과정이 결정되는 방식을 결정하는 이동 수단입니다.

운전 모드에서 기기 과정은 이동 방향을 기반으로 하는 반면, 사이클링 또는 도보 모드에서는 기기가 향하는 나침반 방향을 기반으로 합니다. 기기 과정은 기기 위치 마커의 방향으로 표시되며 GMSRoadSnappedLocationProvider에 의해 보고됩니다.

조명 모드는 지도를 렌더링하는 데 사용해야 하는 색 구성표를 결정합니다.

또한 다양한 인터페이스 요소의 기본 색상을 결정하는 데도 사용됩니다.

안내가 활성 상태이고 속도 제한 데이터를 사용할 수 있을 때 속도 제한을 표시해야 하는지 여부를 결정합니다.

기본값은 NO입니다.

속도계 아이콘 표시 여부를 지정합니다.

사용 설정하면 안내 중에 차량 속도를 나타내는 속도계 아이콘이 하단 모서리에 표시됩니다. 신뢰할 수 있는 속도 제한 데이터를 사용할 수 있는 경우 속도 제한 아이콘도 표시되며 속도계 아이콘과 함께 표시됩니다. 속도계 아이콘은 속도 알림의 심각도에 따라 텍스트와 배경 색상이 다를 수 있습니다.

다시 가운데 맞춤 버튼을 사용 설정한 경우, 중심 재설정 버튼이 표시될 때 속도 제한과 속도계 아이콘이 일시적으로 숨겨집니다.

탐색 헤더가 다루는 직사각형입니다.

헤더가 숨겨져 있으면 높이는 0입니다.

탐색 바닥글이 적용되는 직사각형입니다.

바닥글이 숨겨져 있으면 높이는 0입니다.

사용할 경로 콜아웃 형식 (기본, 시간 또는 거리)을 지정합니다.

탐색 중 확대/축소 수준을 맞춤설정했습니다.

이 값을 설정하면 카메라가 기기 위치를 따라갈 때 기본 Navigation SDK 확대/축소 수준이 재정의됩니다 (cameraMode과 GMSNavigationCameraModeFollowing 같음). 확대/축소 수준 재정의를 사용하지 않아야 하는 경우 GMSNavigationNoFollowingZoomLevel로 설정할 수 있습니다.

지도뷰에 대한 내 위치 제공자를 설정합니다.

일반적으로 지도뷰의 내 위치 점과 정확도 원은 실제 기기 위치에 따라 달라집니다. 이 속성을 설정하면 내 위치 도트와 정확도 원은 대신 지정된 위치 제공자의 도로에 맞추어진 위치를 기준으로 운전합니다. 정상적인 동작으로 돌아가려면 이 속성을 nil로 설정하세요.

지도뷰에 navigationEnabled가 사용 설정되어 있으면 아무 효과가 없습니다.