걷기 하나도 세밀하게, REMO 보행 분석 그래프 API 완벽 가이드
걷기 하나도 세밀하게, REMO 보행 분석 그래프 API 완벽 가이드
걸음걸이는 단순한 이동 동작이 아닌 우리 몸의 건강 상태를 보여주는 중요한 지표입니다. 무릎이 어느 각도로 굽혀지는지, 엉덩이 관절은 어떻게 움직이는지, 좌우 균형은 제대로 맞춰져 있는지 하나하나가 건강에 대한 중요한 정보를 담고 있습니다.
이러한 걸음걸이의 동작을 이제는 말로만 설명하는 대신, 디지털 데이터와 그래프로 시각화할 수 있습니다. REMO의 보행 분석 그래프 API는 걸음의 움직임을 정밀하게 수치화하여 건강 평가부터 운동 처방, 재활 과정 모니터링까지 활용할 수 있는 강력한 도구입니다.
REMO 보행 분석 그래프 API란?
REMO가 제공하는 보행 분석 그래프 API는 이미 분석 완료된 보행 영상에서 관절 각도 관련 데이터를 요청하여 받을 수 있는 전문 API입니다. 즉, 영상 분석이 끝난 뒤 엉덩이, 무릎, 발목의 움직임 정보를 수치와 그래프로 상세하게 추출하여 개발자와 의료진이 활용할 수 있도록 설계되었습니다.
기존의 단편적인 영상이나 이미지 분석에서 탈피해 보행의 동작 전체를 정량화하고 데이터 기반으로 접근한다는 점이 큰 특징입니다.
API 요청 방법
POST http://api.remo.re.kr/api/analysis-walking-angle
필수 입력 파라미터
id (string): 사용자 이메일 주소
uuid (string): 사전에 분석이 완료된 영상의 고유 식별자
응답 데이터 형식과 구조
응답은 JSON 포맷으로 제공되며, 대상 영상에서 추출된 관절별 분석 결과가 포함됩니다. 주요 관절은 엉덩이(hip), 무릎(knee), 발목(ankle)이며, 각각의 관절 데이터는 세 가지 기준면에 따른 움직임 정보를 담고 있습니다.
Sagittal (시상면): 앞뒤 움직임
Coronal (관상면): 좌우 기울기
Transverse (수평면): 회전 움직임
{"hip": { "Sagittal": { "range": [0, 100], "left": { "mean": [ ... ] }, "right": { "mean": [ ... ] } }, ...}
위 예시처럼 각 관절별로 좌우 평균 각도 값 리스트와 그래프의 범위가 구체적으로 포함되어 있어 보행 분석에 필요한 모든 핵심 데이터를 확인할 수 있습니다.
range: 그래프의 변화 구간
left, right: 좌우 관절의 평균 각도 값 배열
보행 분석에서 제공하는 핵심 데이터
각 관절은 보행 중 다양한 움직임을 보여주며, REMO의 API는 이를 세분화해서 제공합니다.
엉덩이(Hip): 골반의 회전, 다리 들어올림 등 주요 움직임
무릎(Knee): 굽힘과 폄 각도
발목(Ankle): 지면 접촉 상태, 발끝의 방향
이 데이터들을 통해 자세한 걸음걸이 분석과 함께 다음과 같은 패턴 및 이상 징후를 감지할 수 있습니다.
좌우 무릎 굽힘 각도 불균형
보행 중 나타나는 골반의 기울기 변화
발목 유연성이나 착지 방향성의 문제
특정 구간에서 감지되는 비정상적 각도 변화
활용 사례와 응용 분야
REMO 보행 분석 API는 의료와 피트니스 분야에 걸쳐 광범위하게 활용됩니다. 몇 가지 대표적인 적용처는 다음과 같습니다.
정형외과: 수술 후 회복 상태를 정밀하게 모니터링
재활의학과: 뇌졸중, 척추 질환 환자의 보행 기능 평가
헬스케어 앱: AI 기반 코칭과 워킹 피드백 제공
고령자 돌봄: 낙상 위험성을 조기 예측하는 예방 솔루션
스포츠 분야: 러닝폼 교정과 골프 스윙 또는 피니시 분석
API 사용 절차 및 흐름
보행 분석 데이터를 받아보는 과정은 간단하고 명료합니다. 주요 단계는 다음과 같습니다.
사용자의 보행 영상 분석 완료 후 고유한 uuid 생성
이 uuid와 사용자 ID를 REMO 보행 분석 API에 전송
JSON 형식으로 결과 관절 각도 리스트 응답 수신
앱 내 차트 시각화, 점수화, 혹은 종합 리포트 작성 등 다양한 후처리 가능
에러 응답 및 주의 사항
실제 사용 시, 다음과 같은 상황에서 에러가 발생할 수 있습니다. 예를 들어 영상 데이터가 없거나 UUID가 존재하지 않을 때는 다음과 같은 메시지가 응답됩니다.
{ "state": 0, "message": "file does not exist"}
보통 분석 전 UUID를 요청하거나 부정확한 이메일 정보 입력 시 발생하니 요청 전 데이터를 반드시 확인해야 합니다.
왜 데이터 기반 보행 분석이 중요한가?
운동이나 재활 평가, 낙상 위험 예측 등 다양한 분야에서 정확한 각도 데이터만큼 신뢰할 수 있는 출발점은 없습니다. 기존 시각적 관찰에서 벗어나 체계적인 수치와 그래프로 걸음걸이를 평가하면 문제를 조기에 발견하고 맞춤형 솔루션을 제안할 수 있습니다.
보행은 이제 직관이 아닌 숫자로 말해야 할 시대입니다. REMO API를 통해 한 걸음 더 나은 건강 관리를 경험해 보세요.