[Walkmate] Day 4 TMAP API, 방향 안내

“사용자의 방향을 이해하는 것, 그것이 진정한 보행 안내의 시작이었다.”

프로젝트 4일 차. 오늘은 기술적인 구현만큼이나 ‘사용자가 실제로 어떻게 느끼는가’에 대한 고민이 깊었던 하루였다. Google Maps의 국내 도보 경로 미지원 문제를 TMAP으로 해결하고, 시각 장애인에게 가장 직관적인 ‘시계 방향’ 안내 시스템을 도입했다.

🚀 Today’s Mission & Results

보행 네비게이션의 정밀도를 높이고, 시각 장애인 사용자가 정면을 향할 수 있도록 돕는 방향 보정 시스템을 완성했다.

💻 GitHub Commit History

TMAP API 전환과 시계 방향 안내 로직 고도화를 위해 총 7건의 커밋이 이루어졌다.

🛠 Tech Stack & Implementation

1. TMAP API 전환 및 환경 구축

Google Maps API가 국내 도보 경로 미지원을 확인한 후, 즉시 TMAP API로 전환을 결정했다. CapacitorHttp를 활용해 안드로이드 스튜디오 환경에서 안정적인 API 통신을 구현했으며, 실시간으로 경로 포인트를 수신하는 로직을 구축했다.

2. 시각 장애인 맞춤형 ‘시계 방향’ 안내

단순한 “좌회전”, “우회전” 안내는 사용자가 현재 어느 방향을 보고 있는지 모를 때 무의미할 수 있다. 이를 해결하기 위해:

• 웹 표준 API: 기기의 나침반 센서(DeviceOrientation) 데이터를 활용했다.
• 방위각 계산: 사용자의 현재 방향과 목적지 방위각을 비교하여 “2시 방향으로 도세요”와 같이 시계 방향으로 안내를 구체화했다.
• 방향 보정: 사용자가 정확한 방향을 잡았을 때 “방향이 맞습니다”라는 피드백을 주어 심리적 안정감을 제공했다.

3. 음성 안내(TTS) 최적화

안내 멘트가 겹치거나 잘리는 현상을 방지하기 위해 큐잉(Queuing) 로직을 도입했다. 여러 안내가 동시에 발생할 경우 순차적으로 출력되도록 제어하여 정보 전달의 명확성을 높였다.

⚠️ Issue Situation & Troubleshooting

이슈 1: TMAP API 403 Forbidden 에러

• 문제: API 키가 유효함에도 INVALID_API_KEY 에러가 발생하며 경로 정보를 불러오지 못했다.
• 해결: TMAP 대시보드의 ‘상품 관리’ 탭에서 ‘보행자 경로 안내’ 서비스를 별도로 구독해야 함을 발견했다. 외부 API 사용 시 단순 키 발급 외에 서비스 활성화 상태 확인의 중요성을 깨달았다.

이슈 2: 센서 데이터의 민감도와 안내 간격

• 문제: 나침반 센서의 미세한 떨림으로 인해 안내가 너무 자주 바뀌고, 2초 간격의 안내는 사용자에게 조급함을 주었다.
• 해결: 저역 통과 필터(Low-pass filter)와 유사한 보정 로직을 적용해 떨림을 잡았고, 안내 간격을 3초로 상향 조정하여 사용자가 반응할 여유를 주었다.

💭 Reflections

Google API 미지원 소식에 잠깐 당황했지만, TMAP으로 전환 후 첫 음성 안내가 성공했을 때는 확실히 기분이 좋았다. “방향이 맞습니다”라는 멘트가 처음 흘러나왔을 때 이 프로젝트의 가치가 실감이 됐다.

안내 간격을 2초에서 3초로 늘린 것이 생각보다 체감 차이가 컸다. 개발자 입장에서 “2초도 충분하지 않나” 싶었는데, 실제 써보니 1초의 여유가 사용자한테는 꽤 달랐다.

Next Plan: 내일은 실제 야외 환경에서 GPS 오차 보정 로직을 정밀화하고 필드 테스트를 진행할 예정이다. 또한, 관리자용 대시보드 설계를 시작하여 시스템의 관리 측면도 보충할 계획이다. 🚧

길안내 UX를 설계하면서 중요했던 판단

보행 내비게이션은 자동차 내비게이션과 전제가 다르다. 자동차는 차선과 속도를 중심으로 안내하지만, 보행은 방향 감각과 주변 위험 요소가 훨씬 중요하다. 그래서 TMAP API를 붙이는 과정에서도 단순히 경로를 받아 오는 것만으로는 충분하지 않았다. 사용자가 지금 어느 방향을 보고 있는지, 다음 행동이 좌회전인지 직진인지, 안내 문장이 너무 길지는 않은지 같은 요소가 실제 체감 품질을 결정했다.

특히 시각장애인을 위한 보행 보조라는 목적을 생각하면 “몇 미터 앞에서 우회전” 같은 일반적인 문구도 다시 설계해야 했다. 수치 중심 안내보다 방향과 즉시 행동 중심 안내가 더 적합할 수 있고, 상황에 따라서는 “왼쪽으로 조금 이동 후 직진”처럼 더 세분화된 표현이 필요할 수도 있다. Day 4는 API 연동 자체보다, 이런 문장 단위의 안내 UX를 고민하게 된 날에 더 가까웠다.

이후 보완이 필요하다고 본 지점

• 안내 문구 길이와 반복 주기를 사용자 테스트로 조정할 것
• 나침반 오차와 GPS 튐 현상이 결합될 때의 예외 상황을 따로 처리할 것
• 횡단보도, 계단, 공사 구간 등 위험 맥락을 경로 안내와 연결할 것

이런 보완이 쌓여야 경로 안내가 단순 지도 기능이 아니라 실제 보행 지원 경험이 된다.