MonstarX 앱에 Mapbox 연결하기

핵심 요약앱의 지도는 Mapbox 없이도 무료로 작동합니다. Mapbox 공개 토큰(pk.…)을 백엔드 → 클라우드에 붙여 넣으면 거리 지도가 위성 지도를 포함한 Mapbox 스타일로 자동으로 바뀝니다. MonstarX에 주소 검색이나 길찾기를 요청하면 같은 토큰을 사용합니다.

원하는 스타일의 지도, 지오코딩, 경로 안내를 제공합니다.

유형: 내 앱에서 사용
카테고리: 지도와 장소
연결 방법: API 키

Mapbox는 아름다운 지도 스타일과 위성 이미지로 잘 알려진 지도 서비스 회사입니다. 모든 MonstarX 앱은 이미 거리 지도를 무료로 보여 줄 수 있습니다(앱에 지도 넣기 참고). Mapbox를 연결하면 이 지도가 한 단계 좋아지고, 주소 검색과 경로 안내가 추가됩니다.

무엇을 만들 수 있나요?

부동산, 농장, 행사장, 야외 산책로를 보여 주는 위성 지도
앱의 모든 지도에 적용되는 Mapbox 지도 스타일(거리, 밝은 테마, 어두운 테마, 아웃도어)
지도 위의 주소: 주소를 입력하면 핀으로 표시하고(지오코딩), 지도를 클릭하면 가장 가까운 주소를 알려 줍니다.
거리와 이동 시간이 함께 나오는 길찾기와 경로

연결하면 무엇이 바뀌나요?

토큰을 넣는 즉시 앱의 거리 지도가 자동으로 Mapbox 스타일로 바뀝니다. 다시 만들 필요가 없습니다. MonstarX가 위성 스타일로 만든 지도는 그때부터 실제 위성 이미지를 보여 줍니다. 주소 검색과 길찾기는 새 기능이므로 따로 요청해야 합니다.

시작하기 전에

Mapbox 계정이 필요합니다. Mapbox는 지도 로드와 검색에 매월 무료 사용량을 제공하고, 이를 넘으면 사용한 만큼 요금을 받습니다(Mapbox 요금 참고).

토큰 발급받기

Mapbox에 로그인하고 Access tokens를 여세요.
Default public token을 복사하거나, Create a token을 클릭해 이 앱 전용 토큰을 만드세요. 공개 토큰은 pk.로 시작합니다.

MonstarX에서 연결하기

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터에서 Mapbox 옆의 연결을 클릭하세요.
공개 액세스 토큰에 토큰을 붙여 넣으세요.
Mapbox 연결을 클릭하세요. 행에 연결됨이 표시되고, 미리보기가 다시 시작되면서 지도에 Mapbox 스타일이 적용됩니다.

MonstarX에 사용 요청하기

입력 예시	결과
“매물 지도를 위성 지도로 보여 주세요.”	지도가 Mapbox 위성 이미지로 바뀝니다.
“회원가입 때 입력한 주소를 지도에 핀으로 표시해 주세요.”	주소를 한 번 검색해 위치와 함께 저장하고 핀으로 표시합니다.
“스튜디오에서 회원 주소까지 가는 자동차 경로와 시간을 보여 주세요.”	지도에 경로가 그려지고 거리와 소요 시간(분)이 표시됩니다.
“지도에 Mapbox 어두운 스타일을 적용해 주세요.”	모든 지도에 어두운 스타일이 적용됩니다.

보안과 개인정보 보호

이 토큰은 공개 토큰입니다. 원래 브라우저에서 쓰도록 만들어져 숨기지 않습니다. 이 토큰으로는 Mapbox 계정을 변경할 수 없습니다.
토큰은 이 앱에만 저장되고, 앱은 토큰을 Mapbox에만 보냅니다.
Mapbox 연결, 키 업데이트, 연결 해제는 프로젝트 소유자만 할 수 있습니다. 연결 해제를 하면 지도는 MonstarX 무료 지도로 돌아가고, 주소 검색과 길찾기는 작동하지 않습니다.
토큰을 바꾸려면 새 토큰을 만들고 Mapbox 행의 키 업데이트를 클릭해 붙여 넣은 뒤 키 저장을 클릭하세요. 다시 게시한 다음 이전 토큰을 삭제하세요.

알아 두면 좋은 점

공개 토큰(pk.)을 쓰세요. 비밀 토큰(sk.)은 Mapbox 계정 관리용이라 앱에 넣으면 안 됩니다.
미리보기를 포함해 모든 지도 로드와 검색이 Mapbox 사용량에 포함됩니다.
장소 검색, 업체 정보, 리뷰가 필요하다면 Google Maps의 데이터가 더 풍부합니다.

자주 묻는 질문

지도를 보여 주려면 Mapbox가 필요한가요?

아니요. 모든 MonstarX 앱에는 키 없이 쓰는 무료 거리 지도와 세계 지도가 있습니다. Mapbox는 Mapbox 스타일, 위성 지도, 주소 검색, 길찾기를 더해 줍니다.

연결한 뒤 지도를 다시 만들어야 하나요?

아니요. 토큰을 저장하는 즉시 거리 지도가 자동으로 Mapbox 스타일로 바뀝니다.

토큰을 제한한 뒤로 지도가 안 나오는 이유는 무엇인가요?

URL을 제한한 토큰은 등록한 주소에서만 작동합니다. 앱 주소를 추가하거나, 앱을 만드는 동안에는 제한 없는 토큰을 쓰세요.

토큰이 브라우저에 노출되어도 안전한가요?

네. 공개 토큰은 웹페이지용으로 만들어졌습니다. 지도를 불러오고 주소를 찾을 수는 있지만 계정을 변경할 수는 없습니다.