이동 스팟 배치 규칙 — 평장묘·미카엘 작업 기준

2026-11-03에 평장묘와 미카엘(1~4) 구역의 이동 스팟을 정리하면서 세운 기준입니다. 다른 구역도 같은 기준으로 고치면 결과가 맞춰집니다.

1. 먼저 알아 둘 것

• yaw: 좌우 방향(도)입니다. 스팟이 대상 씬 쪽을 가리켜야 합니다.
• pitch: 높이(도)입니다. 음수는 수평선보다 위, 양수는 수평선보다 아래입니다.
  • pitch가 0보다 크면 디스크가 바닥에 눕고, 0 이하면 서 있는 모양으로 그려집니다.
  • 그래서 위 단(석축 위)으로 가는 스팟은 보통 음수, 같은 단이나 아래 단은 양수가 됩니다.
• 에디터(space-editor)에서 스팟을 끌어 놓으면 바로 서버에 저장됩니다. 되돌리기 버튼이 없으니, 고치기 전 값을 꼭 기록해 두세요(6번 참고).
• 스팟 위치(yaw/pitch)와 이름만 고칩니다. 씬 id, 구역(카테고리), 다른 구역의 데이터는 건드리지 않습니다.

2. 스팟을 놓는 자리

• 벽 아래에 그려지는 문제: 위 단으로 가는 스팟을 같은 단처럼 바닥(양수 pitch)에 두면 벽 아래에 붙어 보입니다. 벽 윗선으로 올려 주세요. 미카엘에서 가장 많이 고친 경우입니다.
• 미카엘2 줄 번호: 위로 갈수록 단이 높습니다. 번호가 10~20 차이 나는 씬(예: 2 039→2 029)은 한두 단 위라 높은 벽 윗선(−20°대), 1 차이 나는 이웃은 바로 위 낮은 단(−5 ~ −14°)인 경우가 많습니다. 줄마다 다르니 꼭 화면으로 확인하세요.
• 하늘·건물·나무 위에 뜬 스팟은 실제 바닥이나 단 윗선으로 내립니다.
• 나무·트럭에 가려진 자리는 yaw를 조금 돌려 보이는 쪽에 둡니다(예: 2 010→2 018, 3 061→4 064).
• 같은 자리에 두 스팟이 겹치면 하나를 옆으로 조금 떼어 놓습니다(예: 4 040의 4 033·4 034).

평지 묘역(단 높이가 없는 곳, 예: 천지애)

• 석축·단이 없으므로 "벽 윗선" 규칙은 쓰지 않습니다. 스팟은 항상 다음 카메라가 서 있던 바닥(잔디 길, 자갈길, 흙길, 판석)에 둡니다.
• 묘 윗면·비석 면·기념비·생울타리 위에 그려지면 잘못된 것입니다. 대상이 묘에 가려 안 보이면, 그 방향에서 보이는 가장 가까운 길(묘 사이 잔디 통로, 묘 줄 끝의 잔디)로 옮깁니다. 이때 yaw가 조금(10~20°) 바뀌어도 괜찮습니다.
• 묘역 사이 길(잔디·자갈 줄)을 따라 씬이 이어져 있으므로, 반대쪽 씬에서 이 씬이 어느 길 위에 보이는지 먼저 봅니다. 반대쪽에서 같은 길 끝에 보이면, 이쪽에서도 그 길 위에 둡니다(예: 천지애 013↔014, 013↔022, 014↔023).
• 높이(pitch)는 거리만으로 정해집니다. 평지에서 A→B와 B→A의 pitch는 거의 같아야 하고, 대략 3m≈30°, 5m≈20°, 10m≈10°, 20m≈5°, 30m≈3.5° 입니다. 한쪽만 크게 다르면 그쪽이 잘못 놓였을 가능성이 큽니다.
• pitch가 0 이하가 되면 스팟이 서 있는 모양으로 바뀌므로, 평지에서는 먼 대상도 2° 이상으로 둡니다.
• 완만한 묘역(바닥이 고른 곳)은 바닥에 두는 것이 맞습니다. 미카엘1 1 026~1 036, 미카엘3 3 008~3 026·3 031~3 033, 미카엘4 4 003·4 009·4 010은 그대로 두었습니다.

2-1. 화면에서 확인하는 법

보는 요령

• 대상 스팟 쪽으로 화면을 돌리고, 시선을 조금 아래로 내려 바닥과 단·벽이 함께 보이게 합니다. 수평선만 보고 있으면 높이가 맞는지 판단하기 어렵습니다.
• 스팟이 놓인 자리가 "그 씬에 가려면 실제로 밟고 지나갈 곳"인지 봅니다. 사람이 걸어갈 수 없는 곳(하늘, 벽면, 나무 위)에 있으면 잘못된 것입니다.
• 대상 씬을 한 번 열어 어떤 풍경인지(같은 단인지, 위 단인지, 석축 너머인지) 확인한 뒤 돌아와서 비교하면 판단이 쉽습니다.
• 끌어 옮긴 뒤에는 새로고침해서 다시 봅니다. 저장된 값으로 다시 그려져야 확실합니다.
• 대상 씬에 가서 돌아오는 스팟도 같은 방법으로 확인합니다.

점검 목록 — 이런 경우 고칩니다

빠르게 의심 스팟 찾기

• 위 단으로 가는 스팟인데 pitch가 양수(바닥에 누움)면 벽 아래에 있을 가능성이 큽니다.
• 반대쪽 스팟과 위·아래가 맞는지 봅니다. 한쪽이 위 단(음수)을 보는데 다른 쪽도 위를 보거나, 한쪽이 위 단으로 가는데 둘 다 바닥(양수)에 있으면 한쪽이 잘못 놓였을 가능성이 큽니다. 평지에서 가까운 두 씬은 서로 둘 다 내려다보는 것이 정상입니다(예: 2~3m 거리면 둘 다 30~40°).
• pitch가 30° 넘게 크거나 −30° 넘게 작으면 발밑이나 하늘일 수 있으니 화면으로 확인합니다.
• 숫자는 의심할 곳을 고르는 데만 쓰고, 고칠지 말지는 반드시 화면을 보고 정합니다.

3. 연결(스팟 쌍) 규칙

• 양방향으로 연결합니다. A→B가 있으면 B→A도 있어야 합니다. 15m 안의 이웃은 돌아오는 스팟이 꼭 있어야 합니다.
• 돌아오는 스팟의 yaw는 아래 식으로 구한 뒤 화면에서 확인합니다(백엔드 createReverse와 같은 식).
  • yaw = 반대쪽 스팟 yaw + 출발 씬 northOffset + 180 − 이 씬 northOffset
• pitch는 반대쪽 값을 그대로 쓰지 않습니다. 반대쪽이 위 단을 보고 있으면 이쪽은 아래를 봐야 합니다. 반대쪽 값을 따라 넣었다가 2 014→2 013이 +39.5°(바로 발밑)로 들어간 적이 있습니다.
  • 처음 값이 필요하면: tan(p) = 2c/d − tan(반대쪽 pitch) (c = 카메라 높이 1.9m, d = 두 씬 사이 거리 3~40m). 그다음 화면을 보고 맞춥니다.
• 같은 방향으로 이미 스팟이 있으면(1~3° 안에서 겹침) 새로 만들지 않습니다.
• 촬영하지 않은 곳을 건너뛰는 연결은 지웁니다(예: 평장묘 011↔061이 천궁평장묘를 건너뛰던 것).
• 에디터에서는 대상 씬 카드를 파노라마로 끌어다 놓으면 스팟이 만들어집니다.

4. 이름·제목

• 스팟 이름(title)은 대상 씬 제목으로 저장합니다. 비워 두면 에디터에 #4740 처럼 씬 id로 보입니다(API로 만든 스팟에서 자주 생깁니다).
• 번호가 빠진 씬 제목(예: "미카엘2")은 앞뒤 씬의 원본 파일 번호로 확인해 채웁니다(예: "미카엘2 026").

5. GPS

• 스팟 방향으로 추정한 위치와 8m 넘게 차이 나는 씬만 고쳤습니다. GPS는 오차가 커서 참고값으로만 쓰고, 방향은 화면을 기준으로 맞춥니다.

6. 작업 순서와 기록

1. 씬을 열고 스팟 하나씩 대상 씬 쪽 풍경과 비교합니다.
2. 고치기 전 값(yaw/pitch)을 기록 표에 적습니다.
3. 에디터에서 스팟을 끌어 옮깁니다. 누르기만 하면 그 씬으로 이동하니, 끌 때 조금 움직인 뒤 놓으세요.
4. 새로고침해서 위치를 다시 보고, 대상 씬에서도 돌아오는 스팟을 확인합니다.
5. 판단이 애매한 스팟도 넘기지 말고, 아래 6-1 방법대로 화면을 보면서 직접 정해 고칩니다.

6-1. 판단이 애매할 때 — 화면을 보며 직접 정하기

애매한 스팟은 대부분 "같은 단인지 위 단인지", "바닥에 둘지 벽 윗선에 둘지"가 헷갈리는 경우입니다. 아래 순서로 브라우저 화면에서 직접 확인하고 정합니다.

1. 두 씬을 번갈아 봅니다. 출발 씬에서 스팟을 눌러 대상 씬으로 넘어간 뒤, 대상 씬에서 출발 씬 쪽(돌아오는 스팟 방향)을 봅니다. 대상 씬의 카메라가 출발 씬보다 높은 곳에 있으면 위 단, 비슷하면 같은 단, 낮으면 아래 단입니다.
2. 대상 씬에서 보이는 지형을 출발 씬에서 찾습니다. 대상 씬 바로 앞의 비석, 나무, 석축, 계단 같은 눈에 띄는 것을 기억했다가, 출발 씬에서 같은 물체를 찾아 그 발치에 스팟을 놓습니다.
3. 이어지는 길을 따라가 봅니다. 계단·경사로·통로가 어디로 이어지는지 보고, 실제로 걸어서 대상 씬에 닿는 자리(계단 끝, 경사로가 위 단에 닿는 곳, 통로 위)에 둡니다.
4. 한 번 놓아 보고 비교합니다. 후보 자리가 두 곳이면 하나에 놓고 새로고침해 보고, 어색하면 다른 자리로 옮겨 봅니다. 고치기 전 값을 기록해 두었으니 언제든 되돌릴 수 있습니다.
5. 스팟을 눌러 이동해 봅니다. 이동했을 때 "그 자리로 걸어간 느낌"이 나면 맞는 자리입니다. 도착한 화면이 스팟 자리와 전혀 다른 곳(벽 너머, 다른 단)이면 다시 옮깁니다.
6. 반대쪽과 짝을 맞춥니다. A에서 B가 위 단 벽 윗선에 있으면, B에서 A는 아래쪽(벽 아래 단의 바닥)에 있어야 자연스럽습니다. 둘이 서로 맞지 않으면 한쪽이 틀린 것입니다.
7. 그래도 정하기 어려우면, 실제 걸어가는 길에 더 가까운 쪽을 고르고 기록 표의 "이유" 칸에 어떻게 판단했는지 적어 둡니다. 나중에 다른 분이 같은 스팟을 볼 때 참고가 됩니다.

애매했던 예와 판단 방법:

기록 표 양식:

7. 매화1 작업 기록 (2026-11-04)

씬 정합(northOffset)

• 정사영상 지도의 디딤돌 길(약 173°)·묘 줄(약 82°)·하단 도로 배수로 방향과 비교해 보니, 매화1 15개 씬 모두 northOffset이 약 22.5° 작게 들어가 있었습니다. 씬끼리의 상대 정합은 원거리 굴뚝 위치로 확인했고 ±2° 안에서 맞습니다.
• 그래서 15개 씬 모두 +22.5° 했습니다. 서버 범위(−180~180)에 맞춰 009는 166.61 → −170.89로 넣었습니다.
• 이전 값: 009 166.61, 001 −177.91, 002 −177.19, 003 −174.96, 004 −178.25, 005 −172.41, 006 −168.39, 007 −171.95, 008 −172.6, 010 −167.52, 011 −172.39, 012 −166.55, 013 −170.75, 014 −176.43, 015 −178.24

GPS

• 005와 011은 GPS가 직전 씬(004, 010) 값에 멈춰 1.7~1.8m로 기록돼 있었습니다. 화면으로 보면 둘 다 가운데 디딤돌 길 위입니다.
  • 005: 35.1452386, 128.5243676 → 35.1452523, 128.5245206 (14.0m 이동)
  • 011: 35.1451093, 128.5244447 → 35.1451902, 128.5245285 (11.8m 이동)
• 다른 씬은 8m 기준 이하이거나 화면만으로 위치를 확정할 수 없어 그대로 두었습니다. 002·008은 디딤돌 길에서 약 7m, 013은 동남쪽 모서리 잔디밭으로 보여 약 10m 차이가 날 수 있으니 다음에 확인이 필요합니다.

제목

• 원본 _183 씬 제목 "매화1" → "매화1 009". 이 씬으로 가는 스팟 이름도 "매화1 009"로 바꿨습니다.

스팟 기록 표