위치 (Location)

기기의 현재 GPS 위치 정보를 조회하는 모듈입니다.

개요

appify.location은 위치 권한 확인 및 요청, 현재 좌표 조회 기능을 제공합니다. 지도 표시, 위치 기반 서비스, 배달 앱의 현재 위치 확인 등 GPS 데이터가 필요한 모든 상황에서 사용합니다. 위치 정보 접근 전에 반드시 권한을 확인해야 합니다.

API

checkPermission(): Promise<boolean>

위치 정보 접근 권한 상태를 확인하고, 아직 요청하지 않은 경우 시스템 권한 요청 다이얼로그를 표시합니다.

매개변수

없음

반환값: Promise<boolean> - 위치 권한 허용 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

const isAllowed = await appify.location.checkPermission();
if (!isAllowed) {
  console.log('위치 권한이 거부되었습니다.');
}

---

getCurrentPosition(): Promise<Position | null>

현재 기기의 GPS 위치 정보를 조회합니다.

매개변수

없음

반환값: Promise<Position | null> - 위치 정보 객체, 조회 실패 시 null

필드	타입	설명
latitude	number	위도
longitude	number	경도
altitude	number	고도 (미터)
accuracy	number	수평 정확도 (미터)
altitudeAccuracy	number	고도 정확도 (미터)
heading	number	이동 방향 (도, 북쪽 기준)
speed	number	이동 속도 (m/s)

예제

import { appify } from '@nolraunsoft/appify-sdk';

const isAllowed = await appify.location.checkPermission();
if (isAllowed) {
  const position = await appify.location.getCurrentPosition();
  if (position) {
    console.log(`위도: ${position.latitude}, 경도: ${position.longitude}`);
  }
}

플랫폼별 참고사항

• iOS: 위치 권한은 사용하는 동안, 항상 허용 두 가지 수준으로 나뉩니다. checkPermission은 사용하는 동안 수준의 권한을 요청합니다.
• Android: Android 10 이상에서는 백그라운드 위치 접근에 별도 권한(ACCESS_BACKGROUND_LOCATION)이 필요합니다.