FAQ 및 설명서

한 문장으로 설명하면?

marit.es는 Tesla를 실시간으로 지켜봅니다 — Sentry 활동, 주행, 충전, 배터리까지. 차량을 직접 제어할 수도 있고, 무언가 일어나면 즉시 알림도 받습니다.Android와 iOS 앱(앱과 Lite)과 app.marit.es의웹 대시보드로 이용할 수 있습니다.

무엇을 할 수 있나요?

실시간 차량 상태와 위치, 지도가 있는 주행 기록, 충전 기록과 통계, 배터리 감시, 알림이 있는 Sentry 모드 제어, 예약된 Sentry, 자동 경고 대응(클랙슨 & 점멸), 그리고 클랙슨·점멸 같은 원격 명령까지 — 모두 휴대폰에서 가능합니다.

어떤 차량을 지원하나요?

Tesla 공식 Fleet API가 지원하는 모든 Tesla(Model 3, Y, S, X)입니다. 본인 Tesla 계정으로 로그인하며, marit.es는 Tesla 비밀번호를 묻지 않습니다.

데이터는 어디서 오나요?

marit.es는 Tesla 공식 Fleet API와 Fleet Telemetry를 사용합니다. 차량이 실시간 데이터(배터리, 위치, Sentry 상태, 충전, 속도)를 암호화된 연결로 marit.es 백엔드에 바로 스트리밍하고, 앱은 거기서 읽어옵니다. 비공식 스크레이핑도, 제3자 데이터 중개업체도 없습니다.

실시간인가요?

네 — 차량이 깨어 있는 동안에는 텔레메트리를 계속 스트리밍하므로 상태와 Sentry 알림이 수 초 안에 도착합니다. 차량이 잠들면 스트리밍을 멈춥니다(12 V 배터리 보호를 위해); 그때는 앱이 차량이 다시 깨날 때까지 마지막 알려진 상태를 보여줍니다.

휴대폰에 무언가 계속 실행해 두어야 하나요?

아니요. 감시는 휴대폰이 아니라 백엔드에서 이루어집니다. 앱이 닫혀 있어도 push 알림은 계속 받습니다. 앱은 데이터를 보는 창일 뿐입니다.

가끔 조금 지난 데이터가 표시되는 이유는 무엇인가요?

차량이 잠들었거나 통신 음영 지역이면 스트리밍을 하지 않습니다. 상태 아래에 있는 시간 표시(“업데이트 …”)가 현재 수치가 얼마나 최신인지 알려줍니다.

차이점이 무엇인가요?

함께 사용할 수 있나요?

네 — 어느 곳에서나 하나의 계정입니다. App(또는 웹) 구독이면 App 앱과 웹 대시보드가 모두 열립니다. 같은 Tesla 계정으로 로그인하면 차량, 기록, 설정이 따라옵니다. Lite는 가벼운 뷰어로 계속 동작합니다. Lite에서는 감시할 차량 1대를 직접 고를 수 있고, 이 선택은 7일에 한 번 바꿀 수 있습니다.

앱을 설치하지 않고도 쓸 수 있나요?

네 — app.marit.es는 iPhone, Mac, Windows, Android의 모든 최신 브라우저에서 돌아가는 완전한 웹 대시보드입니다. 설치할 것이 없습니다. 7일 무료 체험이 포함된 구독제입니다 ( 구독).

웹에서는 무엇을 할 수 있나요?

앱이 하는 일의 거의 전부입니다:

웹에서는 알림을 어떻게 받나요?

Telegram으로 받습니다. 브라우저는 휴대폰처럼 push 알림을 안정적으로 받을 수 없어서, 웹 버전은 Sentry 알림(차량 위치의 지도 pin 포함)을 Telegram으로 보냅니다. 설정 → Telegram 알림 → Telegram 연결을 열고 저희 봇@MaritesAppBot에서 Start를 누르세요. 알림 항목에서 더 확인할 수 있습니다.

웹에서는 어떻게 로그인하나요?

두 가지입니다. (1) app.marit.es에서Log in with Tesla를 누릅니다 — 안전하고 똑같은 Tesla 로그인이며, 저희가 비밀번호를 받아가지 않습니다. (2) 앱에서 페어링: 앱의 설정 → 브라우저 페어링을 열면 QR(또는 짧은 코드)이 표시됩니다. 새 브라우저에서 스캔하거나 입력하면 그 기기가 Tesla 로그인 없이 로그인됩니다. 세션은 몇 주간 로그인 상태가 유지됩니다.

웹에서 명령을 쓰려면 특별한 것이 필요 있나요?

휴대폰과 동일합니다 — 클랙슨, 점멸, Sentry 명령이 동작하려면 Tesla의 가상 키가 차량에 페어링되어 있어야 합니다. 데이터를 보는 것에는 키가 필요 없습니다.

구독 요금은 어떻게 되나요?

€3/월(2027년 6월까지, 이후 €4.99)에 7일 무료 체험이 제공됩니다. 체험 기간에는 요금이 청구되지 않으며, 기간이 끝나기 전이라면 언제든 무료로 취소할 수 있습니다.

구독은 어떻게 하나요?

app.marit.es에 로그인한 뒤Subscribe 안내를 따르거나 Google Play에서 App를 구독하세요. 웹 결제는Stripe가 안전하게 처리합니다 — marit.es는 카드 정보를 알지 않습니다.

취소하거나 요금제는 어떻게 바꾸나요?

웹에서는 설정 → 구독 → 결제 관리를 열면 Stripe 결제 포털로 연결됩니다. 거기서 취소, 카드 변경, 세금계산서 다운로드를 할 수 있습니다. 취소해도 이미 결제한 기간의 끝까지는 계속 이용할 수 있습니다. (Play 구독은 Google Play에서 관리합니다.)

Google Play로 이미 결제 중인데 웹도 쓸 수 있나요?

네. App 구독이면 웹 대시보드도 함께 열립니다 — 같은 Tesla 계정으로 app.marit.es에 로그인하기만 하면 됩니다. 요금을 두 번 내지 않습니다.

상태 라벨은 무엇을 의미하나요?

점 옆의 상태 표시는 차량이 지금 실제로 하고 있는 일을 그대로 나타냅니다:

“Plugged in”과 “Charging”은 왜 다른가요?

실제로 서로 다른 상태이기 때문입니다. Tesla는 이미 충전이 끝나거나 예약된 시작을 기다리는 동안 케이블을 몇 시간째 연결해 둘 수 있는데, 그때는 충전 중인 것이 아닙니다. marit.es는 Charging을 전력이 실제로 흐를 때만 표시하고, 케이블이 연결된 나머지 시간에는Plugged in을 표시합니다.

주행이 기록되나요?

네. 모든 주행은 날짜, 거리, 소요 시간, 최고 속도와 함께 자동으로 기록되며, 주행을 열면 경로를 지도로 볼 수 있습니다. 설정은 필요 없습니다 — 그냥 운전하면 주행에 나타납니다.

충전도 기록되나요?

네. 각 충전 세션은 시작/종료 시각, 소요 시간, 충전 전과 후의 배터리 수준, 그리고 차량이 보고하는 충전된 에너지(kWh)까지 기록됩니다. 충전에서 확인할 수 있습니다.

갓 마친 주행이나 충전이 아직 없는 이유는 무엇인가요?

기록은 세션이 끝날 때(주차를 하거나 충전이 멈출 때) 작성됩니다. 끝나고 1분쯤 뒤에 당겨서 새로고침하세요.

배터리 건강도는 무엇을 보여주나요?

통계에서 배터리 건강도는 시간 경과에 따라 배터리 용량을 얼마나 유지했는지를 추정합니다. 주행 가능 거리를 충전 수준에 대해 정규화해서(배터리가 적다고 속지 않도록) 유지율 백분율과 추세선을 보여줍니다. 의미가 있으려면 몇 주간의 데이터가 필요합니다.

충전 비용은 어디서 확인하나요?

설정 → 충전 요금제에서 kWh당 전기 요금과 통화를 입력하세요. 그러면 각 충전의 비용(에너지 × 요금)이 충전에 표시됩니다.

주간/야간 전기 요금제를 쓰는데 지원되나요?

네. 같은 충전 요금제 설정에서 야간/경부하 요금과 적용 시간대를 입력하면(자정을 넘어 이어져도 됩니다) 각 충전 세션의 비용이 야간 시간대에 얼마나 충전되었는지에 따라 주간 요율과 야간 요율로 나뉩니다.

팬텀 드레인이란 무엇인가요?

주차 중에(주행도 충전도 하지 않을 때) 줄어드는 배터리입니다. 통계에서 팬텀 드레인은 평균 %/일, 일별 추세, 그리고 가장 심한 주차 장소를 보여줍니다 — 모두 주차 데이터를 기준으로 계산하며 별도로 켤 것은 없습니다.

km/mile, °C/°F와 시간·날짜 형식을 고를 수 있나요?

네, 설정에서 가능합니다. Auto(차량과 동일)를 두면 차량 자체 설정을 따르고, Auto를 끄면 단위(미터법/야드파운드법), 12시간제 또는 24시간제, 날짜 형식(DD/MM, MM/DD, YYYY-MM-DD)을 각각 따로 선택할 수 있습니다.

Lite 앱은 어떤가요?

Lite는 단순하게 유지하기 위해 항상 차량의 단위를 자동으로 따릅니다.

주행과 충전 데이터를 다운로드할 수 있나요?

네, app.marit.es의 웹 대시보드에서 가능합니다. 주행과 충전 페이지에 내보내기 바가 있습니다: 기간과 정렬 순서를 고른 뒤 CSV, Excel, PDF로 다운로드하세요.

Sentry 감시는 어떻게 동작하나요?

차량이 Sentry 이벤트를 보고하면 marit.es가 실시간 텔레메트리에서 이를 감지해 push 알림을 즉시 보냅니다 — 앱이 열려 있을 필요는 없습니다.

Sentry 이벤트는 어떤 종류가 있나요?

Tesla는 두 단계의 활동을 보고합니다: Aware(주변에서 움직임이나 사람을 감지)와Panic(실제로 경고음이 울리는 상태). marit.es는 두 경우 모두 알림을 보냅니다. 혼잡한 지역에서 알림이 넘치지 않도록 반복되는 “Aware” 이벤트에는 횟수 제한이 걸리며, 실제 경고음은 항상 즉시 도착합니다.

Sentry를 켜고 끌 수 있나요?

네 — 앱과 Lite 모두 홈 화면에 Sentry 토글이 하나 있고, 웹에도 대시보드와 Sentry 페이지에 같은 제어가 있습니다. 앱과 웹에서는 주간 예약과 자동 경고 대응(클랙슨, 점멸, Boombox)도 가능합니다.

장소와 시각도 기록되나요?

네. 앱과 웹 모두 각 Sentry 경고음을 시각과 위치(지도에 표시)로 기록하므로, 나중에 무슨 일이 있었는지 확인할 수 있습니다.

차량이 잠든 동안 알림을 못 받은 이유는 무엇인가요?

Sentry 감지는 차량이 텔레메트리를 스트리밍하는 것에 의존합니다. 잠든 차량은 아무것도 스트리밍하지 않으므로, 자는 동안에만 짧게 일어나고 끝난 이벤트는 놓칠 수 있습니다. 이것은 Tesla 텔레메트리의 한계로, 이런 종류의 앱 모두에 해당하며 marit.es의 버그가 아닙니다.

push 알림으로는 실제로 무엇을 받나요?

marit.es는 의도적으로 조용합니다. push는 두 가지뿐입니다:

Sentry 켜기/끄기나 모든 주행·충전까지 자꾸 알리나요?

아니요. 일상적인 켜기/끄기, 주행, 충전 알림은 없앴습니다 — 그냥 소음만 만들기 때문입니다. Sentry 알림과 재연결 안내만 받습니다. (Lite는 오랫동안 앱을 열지 않았으면 앱을 열라는 부드러운 리마인더를 한 번 표시할 수 있습니다.)

Android와 iOS에서 알림은 어떻게 분류되나요?

Android에서는 앱의 알림 설정 안에 Sentry Alerts(높은 우선순위)와Account & alerts(재연결 안내와 리마인더) 카테고리가 보입니다. Android 설정에서 각 카테고리를 세밀하게 조정하거나 음소거할 수 있습니다. iOS에서는 설정 → 알림 → marit.es를 열고 알림을 켜세요. Sentry Alerts가 주요 카테고리이며, 재연결 안내는 일반 알림으로 표시됩니다.

Telegram으로 알림을 받을 수 있나요?

네. 앱에서 설정 → 알림 → Telegram 연결을 열거나, 웹에서설정 → Telegram 알림 → Telegram 연결을 여세요. 둘 다 저희 봇@MaritesAppBot이 열리며 Start를 누르면 계정이 연결됩니다. Tesla 로그인이나 비밀번호는 필요 없고, 봇에게 일회용 코드만 넘겨줍니다. 웹에서는 Telegram으로 Sentry 알림을 받습니다(브라우저에는 신뢰할 만한 push가 없습니다).

휴대폰 알림, Telegram, 아니면 둘 다?

원하는 대로 하세요. 같은 알림 화면에 Push와 Telegram 스위치가 서로 독립적으로 있습니다 — 둘 중 하나만 또는 둘 다 켜면 됩니다. Telegram은 휴대폰으로 받을 내용을 그대로 옮겨 줍니다 — Sentry 알림을 일시 정지하거나 알림 종류를 음소거하면 Telegram도 조용해집니다.

Telegram 알림은 어떤 모습인가요?

알림 메시지 뒤에 차량 위치의 지도 pin이 옵니다. 어디 있는지 보고 눌러서 길찾기로 이어갈 수도 있습니다. 컴퓨터나 Telegram이 있는 어떤 기기에서든 차량을 살피기에 좋습니다.

Telegram 연결은 어떻게 해제하나요?

같은 설정 → 알림 카드에서 Unlink를 누르세요. 봇이 곧바로 메시지를 멈춥니다. 언제든 다시 연결할 수 있습니다.

어떤 명령을 보낼 수 있나요?

클랙슨, 점멸, Sentry 제어(켜기/끄기), Boombox, 그리고 지원하는 다른 차량 명령까지 — App 홈 화면이나 웹 대시보드에서 바로 보냅니다. 연결된 가상 키가 필요합니다.

명령이 “car not found”라고 나왔는데 왜 그런가요?

보통 그 차량이 지금 사용하는 계정에 연결되어 있지 않거나, 가상 키가 아직 페어링되지 않은 경우입니다. 두 사람이 차량을 함께 쓰면, 각 명령은 그 차량에 활성 Tesla 세션이 있는 소유자를 통해 처리됩니다. 아래 가상 키 참조.

가상 키가 무엇이며 왜 필요한가요?

어떤 앱이든 차량에 명령(클랙슨, 점멸, Sentry 등)을 보내려면 먼저 Tesla의 “가상 키”가 필요합니다. 데이터를 보는 데는 필요 없지만 명령에는 필요합니다.

가상 키는 어떻게 추가하나요?

앱에서 “Add virtual key” 안내를 누르거나(또는 tesla.com/_ak/app.marit.es을 열고) Tesla 앱에서 승인하세요. 물리 NFC 카드 접근은 필요 없습니다 — 페어링은 Tesla 앱을 통해 소프트웨어로 이루어집니다.

페어링했는데 여전히 안내가 뜨는 경우

잠시 기다렸다가 marit.es를 다시 열어 보세요. Tesla가 확인하면 페어링 상태가 자동으로 새로고침됩니다. 계속 나타난다면 위의 페어링 링크를 다시 열고 승인이 완료되었는지 확인하세요.

marit.es에 Tesla 비밀번호를 주나요?

절대 아닙니다. Tesla 자체 페이지에서 OAuth로 로그인하며, marit.es는 데이터를 읽고 허용한 명령을 보내기 위한 토큰만 받습니다. Tesla 계정에서 접근 권한을 언제든 철회할 수 있습니다.

Tesla로 다시 로그인하라는 이유는 무엇인가요?

Tesla 토큰은 만료되고, 간혹 Tesla가 세션을 무효화하기도 합니다(예: 계정 변경 후). 그러면 알림이 소리 없이 멈추지 않도록 marit.es가 Reconnect needed 알림을 보냅니다. 다시 로그인하는 데 몇 초 걸리지 않습니다.

예전에는 너무 자주 요청했는데, 이제 해결되었나요?

네. 이전 빌드에서는 너무 자주 요청할 수 있었습니다. 세션 처리를 다시 만들어서 훨씬 오래 로그인 상태가 유지됩니다. Google Play에서 최신 버전을 사용 중인지 확인하세요.

내 데이터를 누가 볼 수 있나요?

본인만 볼 수 있습니다. 차량 데이터는 계정에 묶여 있고 앱의 기능을 위해서만 사용됩니다. 전체 내용은 개인정보 처리방침을 보세요.

내 데이터를 삭제할 수 있나요?

네 — [email protected]로 문의하세요. Tesla 계정에서 marit.es 접근을 철회하면 데이터 흐름을 즉시 멈출 수 있습니다.

Sentry 알림이 오지 않아요.

(1) 로그인되어 있는지(“Reconnect needed” 안내가 없는지), (2) Sentry Alerts 알림 카테고리가 켜져 있는지(Android: 설정 → 앱 → marit.es → 알림; iOS: 설정 → 알림 → marit.es), (3) 배터리 최적화가 앱을 막고 있지 않은지, 그리고 (4) 이벤트가 발생할 때 차량이 깨어서 스트리밍 중인지 확인하세요.

웹을 쓰는데 알림이 오지 않아요.

웹은 Telegram으로 알림을 보내므로, (1) 설정 → Telegram 알림에서 Telegram이 연결되고 Send to Telegram 스위치가 켜져 있는지, (2) @MaritesAppBot과 채팅을 시작했는지, 그리고 (3) 이벤트가 발생할 때 차량이 깨어서 스트리밍 중이었는지 확인하세요. 웹의 Sentry 알림은 브라우저 팝업을 사용하지 않습니다.

상태가 오래된 것처럼 보여요.

차량이 잠들었거나 오프라인일 가능성이 큽니다. “업데이트 …” 시각 표시를 확인하세요. 차량이 깨면 데이터가 자동으로 다시 시작됩니다.

명령이 동작하지 않아요.

가상 키가 페어링되어 있는지, 그리고 그 차량이 내 계정에 속해 있는지(또는 내 계정으로 공유되는지) 확인하세요.

그래도 해결이 안 되면?

계정 이메일과 지금 보이는 상황을 적어서 [email protected]로 이메일을 보내거나 Messenger로 채팅하세요.