🗺️QR 하나로,
함께 걷는 지도

💚 About

모여맵이란? 🤝

모여맵은 일회성 그룹 세션을 중심으로 설계된 실시간 위치 공유 앱입니다. 카카오톡 방을 만들고 링크를 돌리는 것처럼 간단하지만, 🗺️ 지도 위에서 참가자들의 현재 위치를 한눈에 보고, 위급 상황이나 집결·이탈에 맞는 전용 알림 기능을 제공합니다.

🗺️

실시간 지도 공유

MapLibre 지도에서 참가자별 마커, 내 이동 경로, 집결 지점, SOS·길 잃음 위치를 한눈에! Supabase Realtime으로 위치가 자동 갱신됩니다.

📱

QR · 링크 초대

방을 만들면 QR과 HTTPS 링크가 생성돼요. 링크를 누르면 앱이 열리고, 닉네임이 있으면 자동 입장까지 진행됩니다.

🆘

네 가지 안전망

SOS(긴급) · 길 잃음(개인) · 집결(방장) · 이탈(그룹) 알림으로 상황별 대응! FCM 푸시와 앱 내 배지·마커로 전달됩니다.

🔐

프라이버시 우선

서버에는 현재 위치만 저장, 방 종료 시 삭제. 이동 거리·경로·방문 지점은 기기(Room DB)에만 보관됩니다.

⚡ Features

주요 기능 상세 📋

모여맵의 모든 사용자 기능을 화면별로 정리했습니다. 👑 방장과 👤 참가자의 권한 차이도 함께 확인하세요.

🏠 메인 화면

• 방 만들기 — 방 이름(최대 40자)과 닉네임(최대 20자) 입력. 이름을 비우면 {닉네임}의 방이 기본값입니다.
• QR 스캔 — 카메라로 초대 QR을 스캔해 방 토큰을 읽고 참여합니다.
• 딥링크 자동 참여 — joinmap://join?room=토큰 또는 초대 HTTPS 링크로 앱 실행 시 자동 참여를 시도합니다.
• 진행 중인 방 카드 — 이미 방에 있으면 방 이름·참가자 수·방장 여부를 표시하고 「지도로 돌아가기」로 복귀합니다.
• 활성 세션 차단 — 한 번에 하나의 방만 참여 가능. 다른 방 생성·참여는 현재 방을 나간 뒤에만 가능합니다.
• 최근 이동 기록 — 완료된 기록 최대 5건 미리보기, 이름 변경·삭제·상세 보기.
• 프라이버시 안내 — 화면 상단에 데이터 보관 정책이 항상 표시됩니다.

🗺️ 지도(방) 화면

• 참가자 마커 — 닉네임 이니셜이 들어간 원형 마커. 나(파랑), 방장(보라), 일반(초록), SOS(빨강), 길 잃음(주황)으로 구분됩니다.
• 내 이동 경로 — 방에 있는 동안 지나온 경로가 지도에 선으로 표시됩니다.
• 집결 지점 — 방장이 보낸 집결 위치가 마커·상단 배너로 표시되며, 탭하면 해당 위치로 지도가 이동합니다.
• SOS · 길 잃음 배지 — 좌하단에 {닉네임} — 🆘 SOS 형태로 활성 알림이 표시됩니다.
• 내 위치 추적 — 우측 상단 GPS 버튼으로 내 위치 자동 추적 ON/OFF. 지도를 손가락으로 움직이면 추적이 해제됩니다.
• 초대 QR · 링크 — 모든 참가자가 QR과 HTTPS 링크를 확인·복사할 수 있습니다.
• 참가자 목록 — 바텀시트에서 참가자 상태, 이탈 알림 거리, 최근 업데이트 시각을 확인합니다.

🔔 알림 · 이벤트 기능

📊 이동 기록

• 방 참여 시 자동 기록 시작, 나가기·종료 시 저장.
• 기록 제목 기본값: {방 이름} · {날짜 시각}
• 저장 데이터: 총 이동 거리(km), 이동 시간(분), GPS 동선 포인트, 방문 지점(속도 0.5m/s 미만으로 30초 이상 체류한 위치).
• 상세 화면에서 지도에 경로 시각화(출발·도착 마커), 방문 지점 목록 확인.
• 이름 변경·삭제 가능(삭제는 되돌릴 수 없음).

⚙️ 설정

• 언어 — 시스템 기본 / 한국어 / English / 日本語
• 닉네임 — 방 생성·참여 시 기본값으로 사용
• GPS 정확도 필터 — 5m~100m 슬라이더. 설정 오차 이하인 위치만 이동 기록·지도 경로에 저장. 실시간 위치 공유는 필터와 무관하게 계속됩니다.

👑 방장 vs 👤 참가자 권한

📖 Guide

사용 방법 — 단계별 상세 가이드 🧭

처음 사용하는 분도 따라 할 수 있도록 설치부터 방 종료·기록 확인까지 전 과정을 설명합니다.

1. 1. 앱 설치 및 첫 실행

   Google Play에서 모여맵을 설치한 뒤 앱을 실행합니다.

   1. 앱을 처음 열면 위치 권한 요청이 표시됩니다. 지도 표시와 실시간 위치 공유를 위해 허용해 주세요.
   2. 알림 권한(Android 13+)도 요청됩니다. SOS·집결 등 그룹 알림을 받으려면 허용을 권장합니다.
   3. 메인 화면 상단에 프라이버시 안내 문구가 표시됩니다. 서버 보관 정책을 확인하세요.

   팁: 위치를 「앱 사용 중에만」으로 제한하면 백그라운드 공유가 제한될 수 있습니다. 그룹 이동 중에는 「항상 허용」을 권장합니다.

2. 2. 설정 — 닉네임 · 언어 · GPS 필터

   메인 화면 우측 상단 설정(톱니바퀴)을 탭합니다.

   • 언어 — 시스템 기본 / 한국어 / English / 日本語 중 선택. 선택 즉시 앱 UI 언어가 변경됩니다.
   • 닉네임 — 방 입장·생성 시 기본으로 쓰입니다. 예: 「모니」. 빈 값은 저장할 수 없습니다.
   • GPS 정확도 필터 — 필터를 켜면 설정한 미터(5~100m) 이하 정확도의 위치만 이동 기록과 지도 경로에 저장됩니다. 실시간 위치 공유는 계속됩니다.

   권장: 초대 링크로 자동 참여를 원하면 미리 닉네임을 저장해 두세요. 닉네임이 있으면 링크 클릭 시 확인 없이 입장이 진행됩니다.

3. 3. 방 만들기 (방장)

   1. 메인 화면에서 「방 만들기」를 탭합니다. (이미 진행 중인 방이 있으면 버튼이 비활성화됩니다.)
   2. 다이얼로그에서 방 이름을 입력합니다. 비워 두면 {닉네임}의 방이 자동으로 들어갑니다.
   3. 닉네임을 확인·수정합니다. 설정에 저장된 값이 기본으로 채워집니다.
   4. 「만들기」를 탭하면 방이 생성되고 지도 화면으로 이동합니다.
   5. 방장으로 입장하면 초대 QR 다이얼로그가 자동으로 열립니다.

   방장 역할: 집결 요청, 이탈 알림 거리 설정, 방 이름 변경, 방 종료 권한이 있습니다.

4. 4. 방 참여 — QR 스캔 · 초대 링크

   방법 A: QR 스캔

   1. 메인 화면 「QR 스캔」 탭 → 카메라 권한 허용.
   2. 방장이 보여 주는 QR 코드를 스캔합니다.
   3. 닉네임이 설정에 없으면 「방 참여」 다이얼로그에서 닉네임 입력 후 「입장」.
   4. 위치 권한 확인 후 지도 화면으로 이동합니다.

   방법 B: 초대 링크

   1. 방장·참가자가 보낸 HTTPS 초대 링크를 탭합니다.
   2. 모여맵이 설치되어 있으면 앱이 열리며 방 토큰을 읽어 자동 참여를 시도합니다.
   3. 닉네임이 미리 저장되어 있으면 별도 입력 없이 입장할 수 있습니다.

   방법 C: 딥링크

   joinmap://join?room=ROOM_TOKEN 형식의 링크로도 참여할 수 있습니다.

   주의: 이미 다른 방에 참여 중이면 「이미 진행 중인 방이 있습니다」 메시지가 표시됩니다. 현재 방을 나간 뒤 다시 시도하세요.

5. 5. 지도 화면 사용법

   • 입장 시 — 내 위치를 중심으로 지도가 자동 이동합니다.
   • 참가자 마커 — 각 참가자의 닉네임 첫 글자가 표시됩니다. 색으로 역할·상태를 구분합니다.
   • 내 경로 — 방에 있는 동안 이동한 경로가 파란 선으로 그려집니다.
   • GPS 추적 버튼(우측 상단) — 켜면 내 위치를 따라 지도가 이동합니다. 지도를 직접 드래그하면 추적이 꺼집니다.
   • 집결 배너 — 집결 요청이 있으면 상단에 메시지가 표시됩니다. 탭하면 집결 지점으로 이동합니다.
   • 상단 앱바 — 방 이름, 참가자 수, QR 초대, 참가자 목록, 나가기/종료 메뉴.

6. 6. SOS · 길 잃음 · 집결 요청

   지도 화면 우측 하단 FAB 버튼을 사용합니다.

   • 집결 요청 / 집결 해제 (방장만) — 「집결 요청」탭 → 메시지 확인(기본 「여기로 모여주세요」) → 전송. 그룹 전원에게 집결 위치가 공유됩니다. 다시 탭하면 해제됩니다.
   • 길 잃음 / 길 잃음 해제 (모든 참가자) — 길을 잃었을 때 ON. 그룹에 주황색 알림·마커가 표시됩니다.
   • SOS / SOS 해제 (모든 참가자) — 긴급 상황 시 ON. 빨간색 알림·마커·푸시(방 밖일 때 진동·알림음)가 전달됩니다.

   위치 필요: SOS·길 잃음·집결은 현재 GPS 위치가 필요합니다. 위치 권한이 없으면 동작하지 않을 수 있습니다.

7. 7. 이탈 알림 거리 설정 (방장)

   1. 지도 화면에서 참가자 목록 바텀시트를 엽니다.
   2. 「이탈 알림 거리」 섹션에서 꺼짐 / 500m / 1km / 2km / 3km 중 선택합니다.
   3. 다른 참가자들의 평균 위치에서 설정 거리 이상 멀어지면 해당 참가자에게 이탈 알림이 전송됩니다.
   4. 동일 참가자에게는 5분 쿨다운이 적용되어 중복 알림을 줄입니다.

   참가자는 방장이 설정한 거리를 열람만 할 수 있습니다.

8. 8. 초대 — QR · 링크 복사

   1. 지도 화면 상단 QR 아이콘을 탭합니다.
   2. QR 코드와 HTTPS 초대 URL이 표시됩니다.
   3. 「초대 링크 복사」로 클립보드에 URL을 복사해 카카오톡·문자 등으로 공유합니다.
   4. 상대방은 링크를 누르거나 QR을 스캔해 참여합니다.

   앱이 설치되지 않은 기기에서는 초대 링크가 설치 안내 페이지로 연결될 수 있습니다.

9. 9. 방 나가기 · 방 종료

   참가자 — 방 나가기

   1. 상단 메뉴에서 「방 나가기」 선택.
   2. 확인 다이얼로그: 「방에서 나가면 이동 기록이 저장되고 메인 화면으로 돌아갑니다.」
   3. 확인 시 이동 기록이 기기에 저장되고 메인 화면으로 이동합니다.

   방장 — 방 종료

   1. 상단 메뉴에서 「방 종료」 선택.
   2. 확인: 「방을 종료하면 모든 데이터가 삭제됩니다.」
   3. 확인 시 서버의 방·참가자·위치 데이터가 삭제되고 모든 참가자 세션이 종료됩니다.

10. 10. 이동 기록 보기

    1. 메인 화면 「최근 기록」 또는 목록의 기록 항목을 탭합니다.
    2. 기록 상세에서 거리(km), 시간(분), 동선 포인트 수를 확인합니다.
    3. 지도에 출발·도착 마커와 이동 경로가 표시됩니다.
    4. 방문 지점 — 30초 이상 머문 위치가 목록으로 표시됩니다.
    5. 이름 변경·삭제는 메인 또는 목록 화면에서 가능합니다.

    GPS 필터: 설정에서 필터를 켜 두면 정확도가 낮은 포인트는 기록·경로에서 제외될 수 있습니다.

11. 11. 알림 · 백그라운드 동작

    • 포그라운드 서비스 — 방에 있는 동안 「위치 공유 중」 알림이 표시되며 백그라운드에서도 위치가 공유됩니다.
    • 그룹 알림 채널 — SOS, 집결, 길 잃음, 이탈, 입장·퇴장 알림.
    • 긴급 알림(SOS·집결·길 잃음) — 방 밖에 있을 때 진동·알림음. 「확인」으로 해제.
    • 알림 탭 — 해당 방이 활성 세션이면 지도 화면으로 자동 이동합니다.
    • 방 안에 있을 때는 중복 푸시를 줄이고 인앱 스낵바로 안내합니다.

🔐 Privacy

데이터 · 프라이버시 🛡️

모여맵은 최소한의 서버 데이터와 기기 로컬 저장을 분리하는 구조입니다.

인증

회원가입·로그인이 없습니다. 기기별 고유 device_id와 세션 JWT로 방에 참여합니다.

서버에 저장되는 데이터 (방 진행 중)

• 참가자 현재 위치 (위도·경도)
• 닉네임, 방 이름, 방장 여부
• 집결 위치·메시지, SOS/길 잃음/이탈 이벤트 상태
• FCM 푸시 토큰

방 종료 시

방장이 방을 종료하거나 만료되면 서버의 방·참가자·위치·이벤트 데이터가 삭제됩니다.

기기에만 저장 (Room DB)

• 이동 경로 GPS 포인트
• 총 거리, 이동 시간, 방문 지점
• 기록 제목 (사용자가 변경 가능)
• 닉네임, 언어 설정, GPS 필터 설정

이동 기록은 사용자가 직접 삭제할 때까지 기기에 남습니다.

상세 내용은 개인정보 처리방침, 이용약관, 위치기반서비스 이용약관을 참고해 주세요.

필요 권한

❓ FAQ

자주 묻는 질문 💬