Package com.inavi.mapsdk.maps

Class FusedLocationProvider

java.lang.Object

com.inavi.mapsdk.maps.FusedLocationProvider

All Implemented Interfaces:

LocationProvider

public class FusedLocationProvider
extends Object
implements LocationProvider

Google Play 서비스의 Fused Location Provider를 사용하는 LocationProvider 구현체 클래스.

이 구현체를 사용하려면 AndroidManifest.xml에 ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION 권한을 명시해야 합니다.

 <manifest>
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 </manifest>
 

이 클래스는 런타임 권한 처리 기능(ActivityResultContracts.RequestPermission)을 내장하고 있습니다.
필요 시 자동으로 권한을 요청하며, 객체를 Activity 또는 Fragment의 Lifecycle.Event#ON_CREATE 생명주기에 생성해야 합니다.

Nested Class Summary

Nested classes/interfaces inherited from interface com.inavi.mapsdk.maps.LocationProvider

LocationProvider.OnLocationChangedListener

Constructor Summary

Constructors

Constructor	Description
FusedLocationProvider(Activity activity, int requestCode)	Deprecated. FusedLocationProvider(AppCompatActivity)로 대체됩니다.
FusedLocationProvider(AppCompatActivity activity, OnPermissionResultCallback callback)	AppCompatActivity를 사용하는 생성자. 필요 시 ActivityResultContracts.RequestPermission로 권한을 요청합니다. 객체를 Activity의 Lifecycle.Event#ON_CREATE 생명주기에 생성해야 합니다.
FusedLocationProvider(Fragment fragment, int requestCode)	Deprecated. FusedLocationProvider(Fragment)로 대체됩니다.
FusedLocationProvider(Fragment fragment, OnPermissionResultCallback callback)	Fragment를 사용하는 생성자. 필요 시 ActivityResultContracts.RequestPermission로 권한을 요청합니다. 객체를 Fragment의 Lifecycle.Event#ON_CREATE 생명주기에 생성해야 합니다.

Method Summary

Modifier and Type	Method	Description
void	activate(LocationProvider.OnLocationChangedListener listener)	InaviMap에서 위치 추적 기능이 활성화 되었을 경우 호출되는 콜백 함수.
void	deactivate()	InaviMap에서 위치 추적 기능이 비활성화 되었을 호출되는 콜백 함수.
boolean	onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)	Deprecated. FusedLocationProvider(AppCompatActivity) 생성자나 FusedLocationProvider(Fragment) 생성자를 통한 객체 생성 시 onRequestPermissionsResult(int, String[], int[]) 메서드 연결 없이 자체 권한 처리되어 활성화됩니다.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

FusedLocationProvider

public FusedLocationProvider(AppCompatActivity activity,
 OnPermissionResultCallback callback)

AppCompatActivity를 사용하는 생성자.
필요 시 ActivityResultContracts.RequestPermission로 권한을 요청합니다.
객체를 Activity의 Lifecycle.Event#ON_CREATE 생명주기에 생성해야 합니다.

Parameters:

activity - 권한을 요청할 AppCompatActivity 객체.

callback - 권한 요청 시 결과를 전달 받는 콜백

FusedLocationProvider

public FusedLocationProvider(Activity activity,
 int requestCode)

Deprecated.

FusedLocationProvider(AppCompatActivity)로 대체됩니다.

Activity를 사용하는 생성자.
필요 시 Activity.requestPermissions(String[], int)로 권한을 요청하며
결과를 onRequestPermissionsResult(int, String[], int[])에 연결하여 활성화합니다.

Parameters:

activity - 권한을 요청할 Activity 객체

requestCode - 권한 요청 코드

FusedLocationProvider

public FusedLocationProvider(Fragment fragment,
 OnPermissionResultCallback callback)

Fragment를 사용하는 생성자.
필요 시 ActivityResultContracts.RequestPermission로 권한을 요청합니다.
객체를 Fragment의 Lifecycle.Event#ON_CREATE 생명주기에 생성해야 합니다.

Parameters:

fragment - 권한을 요청할 Fragment 객체

callback - 권한 요청 시 결과를 전달 받는 콜백

FusedLocationProvider

public FusedLocationProvider(Fragment fragment,
 int requestCode)

Deprecated.

FusedLocationProvider(Fragment)로 대체됩니다.

Fragment를 사용하는 생성자. 필요 시 Fragment#requestPermissions(String[], int)로 권한을 요청하며
결과를 onRequestPermissionsResult(int, String[], int[])에 연결하여 활성화합니다.

Parameters:

fragment - 권한을 요청할 Fragment 객체

requestCode - 권한 요청 코드

Method Details

deactivate

public void deactivate()

InaviMap에서 위치 추적 기능이 비활성화 되었을 호출되는 콜백 함수.

비활성화되면 activate(OnLocationChangedListener)에서 설정된 listener의 콜백 함수가 더 이상 호출되어서는 안 됩니다.

Specified by:

deactivate in interface LocationProvider

See Also:

• LocationProvider.OnLocationChangedListener.onLocationChanged(Location)

activate

public void activate(LocationProvider.OnLocationChangedListener listener)

InaviMap에서 위치 추적 기능이 활성화 되었을 경우 호출되는 콜백 함수.

활성화되면 deactivate()가 호출될 때까지 주기적으로 listener의 콜백 함수가 호출되어야 합니다.

Specified by:

activate in interface LocationProvider

Parameters:

listener - 위치 변경에 대한 리스너 객체

See Also:

• LocationProvider.OnLocationChangedListener.onLocationChanged(Location)

onRequestPermissionsResult

public boolean onRequestPermissionsResult(int requestCode,
 String[] permissions,
 int[] grantResults)

Deprecated.

FusedLocationProvider(AppCompatActivity) 생성자나 FusedLocationProvider(Fragment) 생성자를 통한 객체 생성 시 onRequestPermissionsResult(int, String[], int[]) 메서드 연결 없이 자체 권한 처리되어 활성화됩니다.

FusedLocationProvider를 생성한 Activity 또는 Fragment의 onRequestPermissionsResult()에서 반드시 호출해야 하는 함수.

Parameters:

requestCode - onRequestPermissionsResult()로 전달받은 requestCode

permissions - onRequestPermissionsResult()로 전달받은 permissions

grantResults - onRequestPermissionsResult()로 전달받은 grantResults

Returns:

true : 권한이 처리됨 (requestCode가 생성자에 지정한 requestCode와 동일할 경우)
false : 권한이 처리되지 않음