지도 구성

플랫폼 선택: Android iOS

이 개요에서는 iOS용 Maps SDK를 사용하여 iOS 앱에 추가된 지도를 구성하는 방법을 설명합니다.

개요

앱에 지도를 추가한 후 지도의 초기 옵션과 런타임 설정을 구성할 수 있습니다. 지도 컨테이너 추가에 대한 자세한 내용은 지도 추가를 참고하세요.

초기 지도 설정에는 다음이 포함됩니다.

런타임 시 GMSMapView 객체를 업데이트하여 이러한 설정 및 일부 추가 설정을 구성할 수 있습니다.

지도 옵션

지도뷰를 초기화할 때 구성 옵션은 GMSMapViewOptions로 설정됩니다. 옵션 속성에는 frame, camera, mapID, backgroundColor가 있습니다.

지도 옵션
프레임
값: CGRect
지도 프레임입니다. 기본값은 CGRectZero입니다.
카메라
값: GMSCameraPosition
기본 지도 카메라 위치입니다.
mapID
값: GMSMapID
Google 지도 ID입니다. 선택적 매개변수입니다.
backgroundColor
값: UIColor
기본값은 UIColor.light그레이입니다.

지도 옵션 구성

자체 옵션 속성을 설정하거나 기본값이 있는 인스턴스화된 GMSMapViewOptionsGMSMapView에 직접 전달할 수 있습니다.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

다음은 기본값이 있는 GMSMapViewOptions 객체를 GMSMapView에 직접 전달하는 예입니다.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

배경 색상 구성

어두운 모드에서 작업하거나 지도 뷰 간에 전환할 때는 기본 지도 배경 색상을 재정의하는 것이 유용할 수 있습니다. 이렇게 하려면 지도 옵션 backgroundColor 속성을 설정하면 됩니다.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

지도 유형

여러 지도 유형 중 하나로 지도를 사용자 지정할 수 있습니다. 지도의 유형에 따라 지도의 전체적인 모양이 결정됩니다. 예를 들어 지도책에는 일반적으로 경계 표시에 중점을 두는 행정구역 지도와 도시 또는 지역의 모든 도로를 표시하는 도로 지도가 포함됩니다. iOS용 Maps SDK는 다음 유형의 지도를 제공합니다.

지도 유형
일반
값: kGMSTypeNormal
일반적인 도로 지도입니다. 도로, 인공 지형지물, 중요한 자연 지형지물(예: 강)이 표시됩니다. 도로 및 지형지물 라벨도 표시됩니다.
하이브리드
값: kGMSTypeHybrid
도로 지도가 추가된 위성 사진 데이터입니다. 도로 및 지형지물 라벨도 표시됩니다.
위성
값: kGMSTypeSatellite
위성 사진 데이터입니다. 도로 및 지형지물 라벨은 표시되지 않습니다.
지형
값: kGMSTypeTerrain
지형 데이터입니다. 지도에는 색상, 등고선, 라벨, 원근 음영이 포함됩니다. 도로 및 라벨도 일부 표시됩니다.
없음
값: kGMSTypeNone
지도 타일이 없습니다. 기본 지도 타일은 렌더링되지 않습니다. 이 모드는 타일 레이어와 함께 사용하면 유용합니다. 지도 유형이 없음으로 설정되면 교통정보 데이터 표시가 사용 중지됩니다.

지도 유형 변경

지도 유형을 설정하려면 GMSMapView.mapType 속성에 새 값을 할당합니다. 예를 들어, 위성 지도 유형을 표시하려면:

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

아래 선택기는 동일한 위치의 지형, 일반, 하이브리드 지도를 비교한 것입니다.

실내 지도

높은 확대/축소 수준에서 iOS용 Maps SDK는 공항, 쇼핑몰, 대형 소매점, 대중교통 정류장과 같은 실내 공간 평면도를 표시합니다. 실내 평면도는 '일반' 지도 유형 (kGMSTypeNormal)의 기본 지도 타일에 통합되며, 사용자가 확대하면 자동으로 사용 설정되고 지도를 축소하면 사라집니다.

GMSMapViewindoorEnabled 속성을 NO로 설정하여 실내 지도를 사용 중지할 수 있습니다.

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

또는 층 선택기 컨트롤만 사용 중지할 수도 있습니다.

평면도 추가

평면도는 일부 위치에서만 사용할 수 있습니다. 애플리케이션에서 강조하려는 건물의 평면도 데이터를 사용할 수 없는 경우 다음을 수행할 수 있습니다.

  • Google 지도에 직접 평면도를 추가하세요. 이렇게 하면 모든 Google 지도 사용자가 계획을 사용할 수 있습니다.
  • 지면 오버레이로 평면도를 표시합니다. 이렇게 하면 애플리케이션 사용자만 평면도를 볼 수 있습니다.

교통정보 레이어

사용자에게 상단에 교통량 정보가 표시된 지도를 제공할 수 있습니다. 이 레이어는 지역 교통상황을 시각적으로 요약하여 보여줍니다. trafficEnabled 메서드를 호출하여 교통정보 레이어를 사용 설정하거나 중지할 수 있습니다. 다음 예는 교통정보 레이어가 지도에 표시되는 방법을 보여줍니다.

교통정보 레이어를 보여주는
Google 지도

접근성

기본적으로, 지도의 접근성 요소는 숨겨져 있습니다. GMSMapViewaccessibilityElementsHidden 속성을 NO로 설정하여 접근성을 사용 설정할 수도 있습니다. 이렇게 하면 오버레이 객체 (예: GMSMarker 및 정보 창, GMSPolyline 등)의 접근성 요소가 생성됩니다.

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

이 속성은 비공식 UIAccessibility 프로토콜을 따릅니다. 단, iOS용 Maps SDK의 기본값은 YES입니다.

내 위치

기본적으로, 위치 데이터는 지도에 표시되지 않습니다. GMSMapView에서 myLocationEnabled를 설정하여 파란색 '내 위치' 점과 나침반 방향을 사용 설정할 수 있습니다.

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

이 기능을 사용 설정하면 myLocation 속성을 통해 사용자의 현재 위치를 제공합니다. 예를 들어 iOS에서 사용자에게 이 데이터에 대한 액세스를 허용하라는 메시지를 표시하는 경우 이 속성을 즉시 사용하지 못할 수도 있습니다. 이 경우에는 nil입니다.

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

3D 건물

아래의 워싱턴주 시애틀 이미지와 같이 확대해서 보면 많은 도시에 3D 빌딩이 표시됩니다.

워싱턴주 시애틀에 있는 건물의 3D 지도입니다.

아래와 같이 Swift 또는 Objective-C에서 해당 GMSMapView 속성을 설정하여 3D 빌딩을 사용 중지할 수 있습니다.

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

지도 패딩

Google 지도는 GMSMapView에서 정의한 전체 영역을 채우도록 디자인되었습니다. 지도가 표시되고 작동하는 방식의 여러 측면은 뷰의 크기에 의해 정의됩니다.

  • 카메라의 타겟은 패딩 처리된 영역의 중심을 반영합니다.
  • 지도 컨트롤은 지도의 가장자리를 기준으로 배치됩니다.
  • 저작권 정보, Google 로고와 같은 법적 정보는 지도의 하단 가장자리를 따라 표시됩니다.

GMSMapView.padding 속성 지도는 계속해서 전체 컨테이너를 채우지만 텍스트와 컨트롤 배치, 지도 동작, 카메라 움직임은 더 작은 공간에 배치된 것처럼 작동합니다. 이에 따라 다음과 같이 변경됩니다.

  • API 호출 또는 버튼 누르기 (예: 나침반, 내 위치)를 사용한 카메라 이동은 패딩 처리된 영역을 기준으로 합니다.
  • GMSMapView.projection는 패딩 처리된 영역만 포함된 프로젝션을 반환합니다.
  • UI 컨트롤은 컨테이너의 가장자리에서 지정된 지점 수만큼 떨어집니다.

패딩은 지도의 일부와 겹쳐지는 UI를 디자인할 때 도움이 될 수 있습니다. 예를 들어 이미지의 지도는 상단 및 오른쪽 가장자리를 따라 패딩 처리됩니다. 화면에 보이는 지도 컨트롤과 법적 고지 텍스트는 패딩 처리된 영역(녹색)의 가장자리를 따라 표시되며 지도는 계속해서 전체 컨테이너(파란색)를 채웁니다. 이 예에서는 지도 컨트롤을 가리지 않고 지도의 오른쪽에 메뉴를 띄울 수 있습니다.

지도 패딩

지도에 패딩을 추가하려면 UIEdgeInsets 객체를 만들어 GMSMapView에 전달합니다.padding 속성

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;