2026년 10월 14일
GPS 방문 스탬프와 패스포트
GPS 방문 스탬프와 지도·통계를 모은 패스포트 도입.
도입
참여와 신뢰
#패스포트
eric

여행을 준비하며 지도로 살펴본 오락실과 직접 다녀온 오락실을 나중에 구분하고 싶을 때가 있다. 검색이나 즐겨찾기만으로는 방문 여부와 날짜를 알기 어렵다. 10월에는 현장 GPS로 확인한 방문을 계정의 스탬프로 모으고, 통계와 지도로 돌아보는 패스포트를 연결했다.

프로필 패스포트의 실제 UI에 연결한 샘플 방문 데이터(42회·6곳·3개국).

장소 탐색과 방문 스탬프

뮤즈캣의 지역 선택과 지도 탐색은 가 볼 만한 장소를 찾는 기능이다. 예를 들어 다른 나라의 여행 경로를 미리 살펴보며 여러 오락실을 열어 봐도, 그 장소들을 모두 방문한 것은 아니다. 즐겨찾기에도 가고 싶은 곳과 자주 가는 곳이 함께 들어갈 수 있다.

Mermaid
flowchart TD
    accTitle: 탐색과 방문 기록의 서로 다른 입력
    accDescr: 수동으로 고른 지역은 방문 후보를 찾는 데 쓰고 현장에서 얻은 GPS는 실제 방문 요청을 준비하는 데 쓴다.
    A[찾아볼 지역 선택] --> B[방문 후보 탐색]
    C[현장의 GPS] --> D[방문할 장소 확인]
    D --> E[내 계정에 스탬프 요청]

방문 스탬프는 현장에서 장소를 확인해 남기는 계정별 자료다. 링크 조회를 세는 대신 실제 위치를 이용하면 처음 간 곳과 다시 간 날짜를 모아 볼 수 있다. 수동 탐색 위치는 후보 검색에, 현재 GPS는 현장 방문 요청에 사용하도록 구분했다.

계정별 스탬프와 기간 조회

스탬프는 로그인 계정, 오락실과 날짜에 연결한다. 홈에서 다른 지역을 탐색하고 있었더라도 패스포트는 실제 GPS로 가까운 후보를 찾아 지금 서 있는 장소를 확인하게 한다.

실제 프로필 패스포트 화면 · 샘플 방문 데이터의 날짜별 활동과 요일별 집계.

저장한 뒤에는 전체 기간이나 특정 연도를 골라 통계와 목록을 읽는다. 방문 횟수와 장소, 날짜별 활동이 같은 자료에서 나오므로 기간을 바꿔도 서로 대응한다. 본인이 관리하는 전체 패스포트와 다른 사람이 보는 공개 프로필에는 각기 맞는 조회 범위를 적용한다.

GPS 확인과 현지 날짜 계산

화면은 위치 권한과 GPS 상태를 확인해 후보를 보여 준다. 이용자가 장소를 고르면 서버가 인증, 장소의 공개·영업 상태와 좌표를 다시 검사한다. 화면을 열었을 때와 저장할 때의 조건이 달라질 수 있기 때문이다.

Mermaid
sequenceDiagram
    accTitle: 현장에서 남긴 방문이 스탬프가 되는 과정
    accDescr: 화면에서 실제 GPS와 장소를 확인해 요청하면 서버가 계정과 위치를 재확인하고 현지 날짜의 기존 방문을 찾아 저장 또는 기존 스탬프를 반환한다.
    participant U as 이용자 화면
    participant S as 방문 서버
    participant D as 방문 기록
    U->>S: 계정·오락실·현장 위치로 방문 요청
    S->>S: 장소와 위치 재확인
    S->>D: 오락실 현지 날짜의 기존 방문 확인
    D-->>S: 새 기록 또는 기존 기록
    S-->>U: 저장된 스탬프

방문 날짜에는 서버 시각을 오락실의 시간대로 바꾼 값을 사용한다. 같은 계정이 같은 장소의 같은 현지 날짜에 다시 요청하면 기존 방문을 돌려준다. 통계와 날짜별 방문 수, 지도에 표시할 장소 요약도 서버에서 계산해 화면마다 원시 행을 다르게 합산하지 않도록 했다.

패스포트 통계와 프로필 공개

이용자는 방문했던 지역과 장소를 통계, 날짜별 목록과 지도에서 돌아볼 수 있게 됐다. 재방문도 날짜에 따라 남아 검색 이력만으로는 알 수 없던 방문 흐름을 살펴볼 수 있다. 그림의 수치는 기능을 보여 주기 위한 샘플 방문 데이터다.

실제 프로필 패스포트 화면 · 샘플 방문 데이터로 채운 스탬프 북.

방문했다고 해서 그 자료를 모두 공개하는 것은 아니다. 공개 프로필 조회는 설정에 맞는 범위만 반환한다. 실내 GPS가 불안정하면 현장에서도 확인이 어려울 수 있고, 스탬프가 그 오락실 문서의 정확성을 보증하지도 않는다. 패스포트는 이런 위치 확인 조건 안에서 본인이 다녀온 장소를 모아 보는 기능으로 제공한다.

Mermaid
flowchart TD
    accTitle: 방문 자료에서 개인 기록과 공개 표시로
    accDescr: 같은 방문 자료를 내 통계와 스탬프 및 지도에 사용하고, 다른 사람에게 보여주는 조회는 공개 설정을 적용한다.
    V[서버의 방문 자료] --> P[내 통계와 스탬프]
    V --> M[다녀온 장소 지도]
    V --> G[방문 공개 설정]
    G --> O[공개 프로필에 허용된 범위]
뮤즈캣
리듬게이머의 최고의 파트너