MapFragment

공개 클래스 MapFragment가 Fragment를 확장

앱의 지도 구성요소입니다. 이 프래그먼트는 애플리케이션에 지도를 배치하는 가장 간단한 방법입니다. 필요한 수명 주기 요구사항을 자동으로 처리하는 지도 뷰의 래퍼입니다. 이 구성요소는 프래그먼트이므로 간단히 아래 XML을 사용하여 활동의 레이아웃 파일에 추가할 수 있습니다. 

 <fragment
    class="com.google.android.libraries.maps.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
GoogleMap는 getMapAsync(OnMapReadyCallback)를 사용하여 획득해야 합니다. 이 클래스는 지도 시스템과 뷰를 자동으로 초기화합니다.

MapFragment의 onDestroyView() 메서드가 호출되고 useViewLifecycleInFragment(boolean) 옵션이 설정되면 뷰를 삭제할 수 있습니다. 이 경우 MapFragment의 onCreateView(LayoutInflater, ViewGroup, Bundle) 메서드가 호출될 때 뷰가 다시 생성될 때까지 더 이상 MapFragment가 유효하지 않습니다.

GoogleMap에서 가져온 객체는 모두 뷰와 연결됩니다. 뷰의 수명 이상으로 객체 (예: Marker)를 보유하지 않는 것이 중요합니다. 그러지 않으면 뷰를 해제할 수 없으므로 메모리 누수가 발생합니다.

API 12 이상을 타겟팅하는 경우에만 이 클래스를 사용합니다. 그 외의 경우에는 빌드 경로에 Android 지원 라이브러리를 추가하여 SupportMapFragment를 사용하세요.

개발자 가이드

자세한 내용은 Android용 Google Maps SDK 개발자 가이드를 참고하세요.

상속받은 상수 요약

공개 생성자 요약

MapFragment()
지도 프래그먼트를 만듭니다.

공개 메서드 요약

void
getMapAsync(OnMapReadyCallback callback)
GoogleMap 인스턴스를 사용할 준비가 되면 트리거될 콜백 객체를 설정합니다.
정적 MapFragment
newInstance(GoogleMapOptions 옵션)
지정된 옵션으로 지도 프래그먼트를 만듭니다.
정적 MapFragment
newInstance()
기본 옵션을 사용하여 지도 프래그먼트를 만듭니다.
void
onActivityCreated(Bundle savedInstanceState)
void
onAttach(활동 활동)
void
onConfigurationChanged(구성 구성)
void
onCreate(Bundle savedInstanceState)
View
onCreateView(LayoutInflater 인플레이터, ViewGroup 컨테이너, Bundle savedInstanceState)
void
onDestroy()
void
onDestroyView()
최종 void
onEnterAmbient(BundleAmbientDetails)
이 메서드는 상위 WearableActivity의 해당 메서드에서 호출해야 합니다.
최종 void
onExitAmbient()를
이 메서드는 상위 WearableActivity의 해당 메서드에서 호출해야 합니다.
void
onInflate(활동 활동, AttributeSet attrs, Bundle savedInstanceState)
확장 중에 뷰 계층 구조에서 처리하는 인수로 속성을 파싱합니다.
void
onLowMemory()
void
onPause()
void
onResume()
void
onSaveInstanceState(번들 outState)
프래그먼트가 소멸되기 전에 프래그먼트의 상태를 저장하는 Bundle를 제공합니다.
void
onStart()
void
onStop()
void
setArguments(번들 인수)

상속받은 메서드 요약

공개 생성자

공개 MapFragment ()

지도 프래그먼트를 만듭니다. 이 생성자는 인플레이터에서만 사용하도록 공개되어 있습니다. newInstance()를 사용하여 프로그래매틱 방식으로 MapFragment를 만듭니다.

공개 메서드

public void getMapAsync (OnMapReadyCallback 콜백)

GoogleMap 인스턴스를 사용할 준비가 되면 트리거될 콜백 객체를 설정합니다.

참고:

  • 이 메서드는 기본 스레드에서 호출해야 합니다.
  • 콜백은 기본 스레드에서 실행됩니다.
  • 사용자의 기기에 Google Play 서비스가 설치되어 있지 않은 경우 사용자가 앱을 설치할 때까지 콜백이 트리거되지 않습니다.
  • 드물지만 생성 직후 GoogleMap이 소멸되는 경우에는 콜백이 트리거되지 않습니다.
  • 콜백에서 제공하는 GoogleMap 객체는 null이 아닙니다.

매개변수
콜백 지도를 사용할 준비가 되면 트리거되는 콜백 객체입니다.

공개 정적 MapFragment newInstance (GoogleMapOptions 옵션)

지정된 옵션으로 지도 프래그먼트를 만듭니다.

매개변수
옵션

공개 정적 MapFragment newInstance ()

기본 옵션을 사용하여 지도 프래그먼트를 만듭니다.

public void onActivityCreated (Bundle savedInstanceState)

매개변수
savedInstanceState

public void onAttach (활동 활동)

매개변수
활동

public void onConfigurationChanged (구성 구성)

매개변수
config

public void onCreate (Bundle savedInstanceState)

매개변수
savedInstanceState

public View onCreateView (LayoutInflater 인플레이터, ViewGroup 컨테이너, Bundle savedInstanceState)

매개변수
인플레이터
컨테이너
savedInstanceState

public void onDestroy ()

public void onDestroyView ()

공개 최종 void onEnterAmbient (BundleAmbientDetails)

이 메서드는 상위 WearableActivity의 해당 메서드에서 호출해야 합니다.

매개변수
ambientDetails

public 최종 void onExitAmbient ()

이 메서드는 상위 WearableActivity의 해당 메서드에서 호출해야 합니다.

public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)

확장 중에 뷰 계층 구조에서 처리하는 인수로 속성을 파싱합니다.

매개변수
활동
attrs
savedInstanceState

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

프래그먼트가 소멸되기 전에 프래그먼트의 상태를 저장하는 Bundle를 제공합니다. 나중에 onCreate(Bundle)가 다시 호출될 때 가져올 수 있습니다.

매개변수
outState

public void onStart ()

public void onStop ()

public void setArguments (번들 인수)

매개변수
args