모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Android API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Android API 활성화
  3. 적합한 키 생성
계속

컨트롤 및 제스처

Google Maps Android API를 사용하면 어떤 내장 UI 구성 요소를 지도에 표시하고, 어느 제스처를 허용할지 결정하여 사용자가 지도와 상호작용하는 방식을 지정할 수 있습니다.

코드 샘플

Github의 ApiDemos 리포지토리에는 컨트롤 및 제스처 옵션의 용도를 보여주는 샘플이 포함되어 있습니다.

사용자 상호작용이 최소화된 라이트 모드

사용자 상호작용이 최소화된 경량 지도를 원하는 경우, 라이트 모드 지도를 사용해 보세요. 라이트 모드는 지정된 위치와 확대/축소 수준으로 표시되는 비트맵 이미지의 지도를 제공합니다. 라이트 모드에서는 사용자가 지도를 패닝하거나 확대/축소할 수 없으며 제스처가 작동하지 않습니다. 자세한 내용은 라이트 모드 가이드를 참조하세요.

UI 컨트롤

Maps API는 Android 휴대폰의 Google 지도 애플리케이션에 나오는 것과 유사한 내장 UI 컨트롤을 제공합니다. UiSettings 클래스를 사용하여 이러한 컨트롤의 가시성을 전환할 수 있습니다. 이 클래스는 GoogleMap.getUiSettings 메서드로 GoogleMap에서 얻을 수 있습니다. 이 클래스의 변경 사항은 지도에 즉시 반영됩니다. 이 기능의 예시는 샘플 애플리케이션에서 UI 설정 데모 액티비티를 참조하세요.

또한, 지도가 XML 특성을 통하거나 GoogleMapOptions 클래스를 사용하여 생성되는 경우 이 옵션 대부분을 구성할 수 있습니다. 자세한 내용은 초기 상태 구성을 참조하세요.

각 UI 컨트롤은 지도 가장자리에 대해 상대적인 위치가 사전 지정되어 있습니다. GoogleMap 객체에 [여백]을 추가하여 컨트롤을 위, 아래, 왼쪽 또는 오른쪽 가장자리에서 떨어진 위치로 이동할 수 있습니다.

확대/축소 컨트롤

Maps API는 지도의 오른쪽 아래 모서리에 나타나는 내장 확대/축소 컨트롤을 제공합니다. 이 컨트롤은 기본적으로 비활성화되어 있지만 UiSettings.setZoomControlsEnabled(true)를 호출하여 활성화할 수 있습니다.

확대/축소 컨트롤

나침반

Maps API는 특정 상황에서 지도의 왼쪽 위 모서리에 나타나는 나침반 그래픽을 제공합니다. 나침반은 카메라가 0이 아닌 베어링이나 0이 아닌 틸트 방향에 있을 때만 나타납니다. 사용자가 나침반을 클릭하면 카메라가 틸트와 베어링이 0인 위치(기본 방향)로 다시 애니메이트되고, 잠시 후에 나침반이 사라집니다. UiSettings.setCompassEnabled(boolean)를 호출하여 아예 나침반이 나타나지 않도록 비활성화할 수 있습니다. 그러나 항상 나침반이 표시되도록 강제할 수는 없습니다.

나침반

My Location 버튼

My Location 버튼은 My Location 계층이 활성화되었을 때만 화면 오른쪽 위 모서리에 나타납니다. 자세한 내용은 위치 데이터 가이드를 참조하세요.

My Location 버튼

레벨 선택기

기본적으로 레벨 선택기(층 선택기)는 사용자가 실내 지도를 보고 있을 때 화면 중앙 오른쪽 가장자리에 나타납니다. 두 개 이상의 실내 지도가 보이면 레벨 선택기는 현재 초점이 맞춰진 건물에 적용됩니다. 주로 화면 중앙에서 가장 가까운 건물입니다. 각 건물은 선택기가 처음 표시될 때 선택되는 기본 레벨이 있습니다. 사용자는 선택기에서 다양한 레벨을 선택할 수 있습니다.

GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean)를 호출하여 레벨 선택기 컨트롤을 활성화/비활성화할 수 있습니다.

기본 레벨 선택기를 자체 레벨 선택기로 교체할 때 유용한 기능입니다.

레벨 선택기

지도 툴바

기본적으로 툴바는 사용자가 마커를 누르면 지도 오른쪽 하단에 나타납니다. 툴바는 사용자가 Google 지도 모바일 앱에 빠르게 액세스할 수 있게 해줍니다.

UiSettings.setMapToolbarEnabled(boolean)를 호출하여 툴바를 활성화/비활성화할 수 있습니다.

라이트 모드 지도에서 툴바는 사용자의 작업과 관계없이 유지됩니다. 완전한 대화형 지도에서 툴바는 사용자가 마커를 누르면 슬라이드인되고, 마커가 초점에서 벗어나면 다시 슬라이드아웃됩니다.

툴바는 Google 지도 모바일 앱에서 지도 뷰나 길찾기 요청에 액세스할 수 있는 아이콘을 표시합니다. 사용자가 툴바에서 아이콘을 누르면, API가 인텐트를 빌드하고 Google 지도 모바일 앱에서 해당 액티비티를 시작합니다.

지도 툴바

툴바는 위 스크린샷에서 지도의 오른쪽 하단에 표시됩니다. 지도의 콘텐츠에 따라 지도에 인텐트 아이콘이 나타나지 않거나, 1개 또는 2개가 모두 나타납니다. 단, Google 지도 모바일 앱이 해당 인텐트를 지원해야 합니다.

지도 제스처

Google Maps Android API로 생성된 지도는 Google 지도 애플리케이션과 동일한 제스처를 지원합니다. 그러나 지도 상태를 보존하기 위해 특정 제스처를 비활성화하고 싶을 수도 있습니다. 프로그래밍 방식으로 확대/축소, 팬, 틸트, 베어링도 설정할 수 있습니다. 자세한 내용은 카메라 및 뷰를 참조하세요. 제스처를 비활성화하더라도 여기에 영향을 받지 않고 프로그래밍 방식으로 카메라 위치를 변경할 수 있습니다.

UI 컨트롤과 마찬가지로 UiSettings 클래스로 제스처를 활성화/비활성화할 수 있습니다. 이 클래스는 GoogleMap.getUiSettings를 호출하여 GoogleMap에서 얻을 수 있습니다. 이 클래스의 변경 사항은 지도에 즉시 반영됩니다. 이 기능의 예시는 [샘플 애플리케이션]에서 UI 설정 데모 액티비티를 참조하세요(자세한 설치 방법은 여기 참조).

또한, 지도가 XML 특성을 통하거나 GoogleMapOptions클래스를 사용하여 생성되는 경우 이 옵션을 구성할 수 있습니다. 자세한 내용은 지도 구성을 참조하세요.

확대/축소 제스처

지도는 카메라의 확대/축소 수준을 변경할 수 있는 다양한 제스처에 반응합니다.

  • 확대/축소 수준을 1 올리려면 두 번 누릅니다(확대).
  • 확대/축소 수준을 1 내리려면 두 손가락으로 누릅니다(축소).
  • 두 손가락 모으기/벌리기
  • 한 손가락으로 두 번 눌러서 확대/축소합니다. 두 번째 누를 때 손가락을 떼지 않고 위로 밀어올리면 축소되고, 아래로 밀어내리면 확대됩니다.

UiSettings.setZoomGesturesEnabled(boolean)를 호출하여 확대/축소 제스처를 비활성화할 수 있습니다. 사용자가 확대/축소 컨트롤을 사용하여 확대/축소하는 데는 영향을 미치지 않습니다.

스크롤(팬) 제스처

사용자가 손가락으로 지도를 드래그하여 스크롤(팬)할 수 있습니다. UiSettings.setScrollGesturesEnabled(boolean)를 호출하여 스크롤을 비활성화할 수 있습니다.

틸트 제스처

사용자가 지도에 두 손가락을 대고 한꺼번에 위아래로 움직여 지도를 틸트할 수 있습니다. 손가락을 위로 올리면 틸트 각도가 커지고, 손가락을 아래로 내리면 틸트 각도가 작아집니다. UiSettings.setTiltGesturesEnabled(boolean)를 호출하여 틸트 제스처를 비활성화할 수 있습니다.

회전 제스처

사용자가 지도에 두 손가락을 대고 회전 동작을 적용하여 지도를 회전할 수 있습니다. UiSettings.setRotateGesturesEnabled(boolean)를 호출하여 회전을 비활성화할 수 있습니다.

다음에 대한 의견 보내기...

Google Maps Android API
Google Maps Android API
도움이 필요하시나요? 지원 페이지를 방문하세요.