날짜, GPS 위치, 건강 데이터 연동 | Appbox SDK

날짜•위치•건강 데이터

날짜 선택 달력

화면에 달력을 띄워 원하는 날짜를 선택하거나, 특정 기간을 지정할 수 있습니다.
테마 컬러로 커스터마이징된 달력에서 특정 기간을 선택하거나 예약, 일정 관리 등을 직관적이고 편리하게 이용해 보세요.

달력을 띄워 날짜 선택하기

AppboxSDK.ui.calendarOpen(...)

Javascript
1 // 달력 표기
2 AppboxSDK.ui.calendarOpen(
3 {
4 type: "DAY",
5 selColor: "#FF0000",
6 fromDate: "20250110"
7 }, (err, data) => {
8 if (err) {
9 console.error( "달력 실패:", "code:", err.code, "message:", err.message );
10 } else {
11 console.log( "달력 DAY OK:", "fromDate:", data.fromDate, "toDate:", data.toDate );
12 }
13 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
type 필수 날짜 타입 (DAY : 특정 날짜 선택, TERM : 시작일부터 종료일까지의 기간 선택)
fromDate - 시작 날짜 (ex : yyyyMMdd)
toDate - 종료 날짜 (ex : yyyyMMdd)
selColor - 달력 테마 칼라
textColor - 버튼 텍스트 칼라 #FFFFFF


Response 항목 정의

Response 결과값
data.fromDate 시작 날짜 (ex : yyyyMMdd)
data.toDate 종료 날짜 (ex : yyyyMMdd)
err.code 에러코드 (-1000 : 사용자 닫음)
err.message 에러 메시지





걸음수 가져오기

사용자의 기기에서 저장된 걸음 수 데이터를 가져올 수 있는 기능입니다.
오늘, 이번 주, 이번 달 기준으로 걸음 수를 조회할 수 있으며, 이를 건강 관리, 운동 기록, 목표 달성 기능 등에 활용할 수 있습니다. 앱에서 사용자의 활동 현황을 직접 보여주거나 보상, 챌린지, 미션 시스템과 연동해 활용할 수 있습니다.

디바이스의 걸음수 가져오기

AppboxSDK.health.getStep(...)

Javascript
1 // 걸음수
2 AppboxSDK.health.getStep(
3 {
4 fromDate: "20250201",
5 toDate: "20250405"
6 }, (err, data) => {
7 if (err) {
8 console.error( "걸음수 실패:", "code:", err.code, "message:", err.message );
9 } else {
10 console.log( "걸음수 데이터 OK:", data.result );
11 }
12 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
fromDate 필수 시작일(부터). yyyyMMdd
toDate 필수 종료일(까지). yyyyMMdd. 시작일이 종료일보다 뒤면 SDK 가 바로 VALIDATION 오류를 돌려줍니다

건강데이터 엑섹스 하려면 사용자가 최초 한번은 시스템 권한이 승인되어야 합니다. Android 는 권한을 거부하면 err.code=-7000 을 돌려줍니다. iOS 는 거부 여부를 앱에 알려 주지 않아 보통 빈 배열 [] 로 성공합니다.




Response 항목 정의

Response 결과값
data.result
[ { date: "2025-01-01", step: 1210 }, { date: "2025-01-02", step: 4290 }, ..... ]
날짜는 문자열(yyyy-MM-dd, 한국 시간). 기록이 없는 날은 빠지고, Android 는 순서를 보장하지 않습니다
err.code 에러코드 (-7000 : 권한 없음(Android), -7001 : 지원 안 하는 기기, -7002 : Health Connect 미설치(Android), -2000, -2001, -3001 : 날짜 빠짐, 형식 오류, -8000 : 시간 초과(Android 15초))
err.message 에러 메시지





위치 받아오기

사용자의 기기에서 현재 위치 정보를 받아올 수 있는 기능입니다.
요청 시 네이티브 기능을 통해 위도와 경도 값이 조회되며, 이 데이터를 웹으로 전달해 위치 기반 서비스, 길 안내, 매장 찾기, 체크인 기능 등에 활용할 수 있습니다.

위.경도 위치정보를 받아오기

AppboxSDK.application.getLocationCurrent()

Javascript
1 AppboxSDK.application.getLocationCurrent( (err, data) => {
2 if (err) {
3 console.error( "위치 실패:", "code:", err.code, "message:", err.message );
4 } else {
5 console.log( "위도 OK:", "위도:", data.lat, "경도:", data.lng );
6 }
7 });

Response 항목 정의

Response 결과값
data.lat 위도 (ex : 35.4516133686)
data.lng 경도 (ex : 126.538897703)
err.code 에러코드 (-7000 : 위치 권한 없음)
err.message 에러 메시지

위치를 받아오려면 사용자가 최초 한번은 위치 권한을 승인하여야 합니다. 승인 하지 않은 경우 err.code=-7000 으로 리턴됩니다.






www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.