API Reference

Golf Swing Analyzer 소개

Pose Estimation API 를 이용하여 실내 골프 스윙 영상을 분석해서 골프 스윙 준비 자세를 추출하고, 머리, 관절, 골프 공 등을 추출해 최적의 준비 자세 Guideline 을 제공합니다.

2000

제공 기능

영상 분석

영상 업로드 정보 요청하기(create_analyzer) → 앞 단계에서 얻은 URL, 정보로 영상 올리기 → 결과 확인(get_result) 순으로 API를 호출합니다.
Golf Swing Analyzer는 입력된 영상을 다중 이미지화하여 골프 스윙 준비 자세 프레임을 추출하고 해당 자세에서 사람의 코, 눈 귀, 어깨, 팔꿈치, 손목, 골반, 무릎, 발목, 골프 클럽, 골프 공 등 28개의 키 포인트를 추출하여 골프스윙 준비 자세 가이드를 제공합니다.

API기능
create_analyzer골프 스윙 영상 내, 준비 자세의 Frame을 추출하기 위해 영상을 업로드 할 수 있는 AWS S3 URL과 Job ID를 반환합니다.
영상 올리기
(create_anlyzer
response URL)		영상 파일을 올려서 준비자세, 관절 포인트, Guideline 을 분석을 실행합니다.
get_result분석된 결과물을 JSON 객체로 반환합니다.

End to End 분석

API기능
e2e3MB 이하의 영상 또는 이미지의 업로드와 분석을 한 번에 처리하여 JSON 객체로 반환합니다. 분석이 성공적으로 완료되면 골프 스윙 준비 자세 프레임과 해당 프레임에서 가장 큰 사람의 관절 좌표를 JSON 객체로 반환합니다.

주의 사항

  • 최대 10MB 용량의 영상 분석이 가능하며, 초기 4초의 한번 스윙에 대해 분석이 가능합니다.
  • 최대 3MB 용량의 영상, 이미지는 End to End로 업로드와 분석이 한 번에 가능합니다.
  • 스크린 골프장 영상에 적합하게 설계되어, 골프 스윙 준비 자세 외 이미지, 야외, 회전된 이미지 등은 Guideline 이 제대로 추출되지 않을 수 있습니다.
  • REST API만 지원합니다.
  • 요청 시 HTTP Connection Timeout은 5초, read TimeOut 은 20초로 설정합니다.
  • 과도하게 많은 요청을 보내어 초당 요청 한도를 초과하는 경우 오류 응답을 받을 수 있습니다.
  • 해상도는 최소 640 pixel 이상, 최대 1024 pixel 이하여야 합니다.
  • create_analyzer API 요청 시 Response 이후 다음 API 호출을 위한 최대 시간은 15분입니다.
  • 확장자가 mp4, mov 이외의 영상은 결과가 제대로 추출되지 않을 수 있습니다.

400