MVT 디버거
벡터 타일(.pbf) 주소나 파일을 넣으면 레이어·속성·도형을 뜯어봐요. 타일이 왜 안 보이는지 여기서 확인.
타일은 브라우저가 직접 받아 브라우저 안에서 해석해요. 이 사이트를 거치지 않아요.
타일 불러오기
{z}/{x}/{y} 자리표시자를 쓰면 아래 좌표가 채워져요.
MVT 디버거 소개
벡터 타일(.pbf·.mvt) 주소나 파일을 넣으면 안에 든 레이어와 속성, 도형을 뜯어봐요. 타일 크기와 피처 수, extent와 버퍼 영역까지 보여줘서 지도에 타일이 왜 안 그려지는지 확인할 때 써요. 주소에 {z}/{x}/{y} 자리표시자를 쓰면 좌표를 채워 넣을 수 있어요.
벡터 타일은 어떻게 생겼나요
지도를 정사각형으로 잘라 놓은 조각이 타일이에요. 이미지 타일은 그림이 들어 있지만, 벡터 타일 안에는 도형과 속성 데이터가 들어 있어요.
주소는 보통 z/x/y 형태예요. z는 확대 수준, x와 y는 그 수준에서의 가로세로 위치예요. z가 1 올라갈 때마다 타일 개수는 네 배가 돼요.
타일 하나 안의 좌표는 실제 경위도가 아니라 0부터 extent까지의 값으로 표현돼요. 보통 extent는 4096이에요. 지도 라이브러리가 이 값을 화면 좌표로 바꿔 그려요.
타일이 안 보일 때 확인할 것
가장 흔한 원인은 레이어 이름이에요. 스타일에 적은 source-layer가 타일 안 레이어 이름과 정확히 같아야 해요. 대소문자 하나만 달라도 안 그려져요. 여기서 실제 이름을 확인하면 바로 해결되는 경우가 많아요.
그다음은 좌표예요. 그 확대 수준에 데이터가 없거나 z/x/y가 어긋나면 타일이 비어 있어요. 경위도로 좌표 찾기를 쓰면 원하는 위치의 타일 좌표를 구할 수 있어요.
속성 이름도 봐야 해요. 스타일에서 필터나 색을 속성으로 정하는데, 그 키가 실제로 들어 있지 않으면 아무것도 안 나와요. 속성 키 목록에서 확인할 수 있어요.
버퍼 영역이 뭔가요
분석 결과에서 점선 밖으로 나간 도형이 보일 거예요. 그게 버퍼 영역이에요.
도로나 건물이 타일 경계에 걸치면 조각마다 잘린 채로 그려져서 이음매가 보여요. 이걸 막으려고 경계 바깥까지 조금 더 담아 두는데, 그 여유분이 버퍼예요.
라벨이 타일 경계에서 사라지거나 중복되는 문제도 버퍼와 관련이 있어요. 버퍼가 너무 작으면 잘리고, 너무 크면 타일 용량이 커져요.
MVT 디버거 사용 방법
- 타일 주소를 넣어요. {z}/{x}/{y} 자리표시자를 쓰면 좌표가 채워져요.
- 경위도로 좌표 찾기나 프리셋으로 위치를 정해요.
- 불러와서 분석을 누르거나, 막히면 타일 파일을 직접 올려요.
- 레이어와 속성 키, 피처 목록에서 도형과 값을 확인해요.
자주 묻는 질문
- 타일이 비어 있다고 나와요.
- 해당 확대 수준에 데이터가 없거나 타일 좌표가 어긋난 경우예요. 다른 z/x/y로 바꿔 확인해 보세요.
- 스타일에서 레이어가 안 보여요.
- 스타일의 source-layer 이름이 타일 안 레이어 이름과 정확히 같아야 해요. 여기서 실제 이름을 확인하면 돼요.
- 주소로 불러오니 오류가 나요.
- 그 서버가 다른 사이트의 요청을 허용하지 않는 경우예요. 타일 파일을 내려받아 올리면 그대로 분석돼요.
- extent는 무슨 값인가요?
- 타일 안 좌표계의 크기예요. 보통 4096이고, 지도 라이브러리가 이 값을 화면 좌표로 바꿔 그려요.
- 속성 키 수가 피처 수보다 적어요.
- 모든 피처가 같은 속성을 갖지는 않아서예요. 일부 피처에만 들어 있는 키는 그만큼 적게 세어져요.
- gzip으로 압축된 파일도 되나요?
- 네트워크로 받아올 때는 브라우저가 알아서 풀어요. 다만 이미 압축된 파일을 직접 올리면 읽지 못해요.
알아 두면 좋은 점
- 피처 목록은 앞부분만 보여줘요. 전체를 확인하려면 도구를 따로 쓰셔야 해요.
- 타일 파일은 브라우저 안에서만 읽어요.