> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 공간 등록

> 건물과 층 정보를 등록하고 도면을 업로드한 후, 도면을 실제 공간과 매칭합니다.

> [!CAUTION]
>
> 현 단계에서는 도면 업로드(이미지 또는 DXF)와 스케일 설정(도면 실측 크기 확인·입력), 필요한 경우 구글맵 정합만 진행하며, 본 매뉴얼에서 설명하지 않은 다른 영역이나 버튼은 사용하지 않습니다.

## 1) 건물 등록

\[건물 리스트] 메뉴로 진입 후 화면 우측 상단의 \[+ 건물 등록] 버튼을 클릭합니다.

![건물 등록 팝업 — 건물명·위치·주소·위도·경도 입력](https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/3.spaces-building-register.png?fit=max\&auto=format\&n=v-NNoPHtuKTLba-D\&q=85\&s=89853abcf9b26bc8049df052ea370c51)

아래 항목을 입력한 후 \[등록]을 클릭합니다.

| 항목 | 입력 값 |
| - | - |
| 건물명 | ·식별할 수 있는 매장명 또는 건물 명칭을 입력합니다. |
| 지도에서 위치 선택 | ·검색창에 주소를 입력한 후 목록에서 선택하거나, 지도에서 직접 클릭하거나, 마커를 드래그하여 위치를 지정합니다. |
| 주소 | ·위치를 지정하면 주소가 자동으로 입력됩니다.·입력된 주소가 실제 위치와 일치하는지 확인하고, 일치하지 않는 경우 지도에서 정확한 위치를 다시 지정합니다. |
| 위도 · 경도 | ·위치를 지정하면 자동으로 입력됩니다. |

## 2) 층 등록

![건물 리스트 화면 — 건물 카드의 층별 작업 버튼](https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/3.spaces-building-floor-entry.png?fit=max\&auto=format\&n=v-NNoPHtuKTLba-D\&q=85\&s=8a8cc6b8e7e85bc5159afb97cd983bec)

건물 등록을 완료하면 건물 리스트에서 등록한 건물 카드를 확인할 수 있습니다. 해당 카드의 \[층별 작업] 버튼을 클릭합니다.

![층별 작업 화면과 층 추가 팝업 — 층 추가 버튼, 층 이름·층 선택·설명 입력](https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/3.spaces-floor-add-popup.png?fit=max\&auto=format\&n=v-NNoPHtuKTLba-D\&q=85\&s=ce2191c18a0de795cf47260875bb009c)

층별 작업 화면 우측 상단의 \[+ 층 추가] 버튼을 클릭한 후 아래 항목을 입력합니다.

| 항목 | 입력 값 |
| - | - |
| 층 이름 | ·층 이름을 입력합니다. (예: 3F, B1, 622호) |
| 층 선택 | ·층을 클릭하여 선택합니다. 지하는 B를 클릭합니다. |
| 설명 (선택) | ·필요한 경우 층에 대한 설명을 입력합니다. |

## 3) 도면 등록 및 설정(선택)

> [!NOTE]
>
> 등록할 도면이 없는 경우 이 절을 건너뛰고 [로케이터 현장 설치](/locator/install)으로
> 진행할 수 있습니다. 로케이터 위치는 [측위 기능 활성화](/locator/placement)에서
> 좌표로 직접 입력합니다. 이 경우 층 목록에서 해당 층은 '도면 완료' 대신 '미완료'로 표시되며,
> 다음 단계 진행에는 영향이 없습니다.

도면과 실제 공간의 크기를 매칭해야 합니다. 이미지 파일(PNG·JPG)에는 실제 공간의 크기 정보가 없으므로 실측한 공간의 가로·세로 길이(m)를 직접 입력하고,
CAD 파일(DXF)은 도면에 담긴 크기가 '도면 실측 크기'에 자동으로 입력되므로 실측값과 맞는지 확인합니다. 이 값이 도면의 좌표 기준이 됩니다.
이 기준에 따라 로케이터, Zone 및 측위 좌표가 정의되므로 정확한 거리값을 입력해야 합니다.

**이미지와 DXF의 차이**

이미지(PNG·JPG)는 도면을 찍은 그림이고, DXF는 CAD에서 도면을 그린 데이터입니다.

| 구분 | 이미지 (PNG·JPG) | DXF (CAD) |
| - | - | - |
| 적합한 경우 | CAD 원본이 없을 때, 빠르게 설정할 때 | CAD 도면이 있고 정확한 벽 선이 필요할 때 |
| 도면 실측 크기 | 공간을 실측해 직접 입력 | 파일에서 읽어 자동 입력. 도면 전체 범위 기준이라 벽 사이 거리와 다를 수 있음 |
| 배경 도면 | 올린 그림을 그대로 표시 | 파일의 선을 그대로 읽어 다시 그림. 벽 등 구조가 정확하고 확대해도 선명 |

CAD 도면이 없거나 빠르게 설정하려면 이미지로 진행합니다. CAD 도면이 있으면 DXF로 진행해 벽 선을 정확하게 표시할 수 있습니다. 어느 쪽이든 스케일만 맞으면 측위 결과는 같습니다.

![층별 작업 화면의 층 목록 — 해당 층의 도면 배치 버튼](https://mintcdn.com/onecheck/v-NNoPHtuKTLba-D/images/geospace/3.spaces-plan-entry.png?fit=max\&auto=format\&n=v-NNoPHtuKTLba-D\&q=85\&s=fa1fd1a1076d328cd7440f942cd48443)

1. 층 목록에서 \[도면 배치 →]를 클릭합니다.

도면 배치 화면 왼쪽 위에는 \[배치 · 분석]과 \[구글맵 정합] 두 개의 탭이 있습니다.
도면 등록과 스케일 설정은 \[배치 · 분석] 탭에서 진행하고, \[구글맵 정합]은 DXF 도면을 위성지도 위 실제 위치에 등록하려는 경우에만 사용합니다(DXF 탭 2단계 참고).

준비한 도면 형식에 맞는 탭을 선택하고, 탭 안의 순서대로 진행합니다.

**이미지 (PNG·JPG) · 기본**

![도면 배치 화면 — 이미지 업로드, 도면 실측 크기 입력, 거리 측정(줄자), 두 점으로 스케일 설정, 층정보 저장, 층별 작업 버튼](https://mintcdn.com/onecheck/9BTDfSqdy9fBmDyx/images/geospace/3.spaces-plan-deploy.png?fit=max\&auto=format\&n=9BTDfSqdy9fBmDyx\&q=85\&s=22c6e8fef19e50dc93e5bd9ea0404250)

2. \[이미지] 버튼을 클릭하여 도면 파일(PNG 또는 JPG)을 업로드한 후,
   '도면 실측 크기'에 현장에서 실측한 공간의 가로·세로 길이(m)를 입력합니다.
   * 업로드가 완료되면 \[도면 분석] 버튼 아래에 이미지 파일명 · 용량 · 픽셀 크기(px)와
     초기 이미지에 맞는 실측 정보가 라벨로 표시됩니다.

3. 도면 우측 상단의 줄자(거리 측정) 버튼을 클릭합니다.

4. 실제 거리를 알고 있는 대표 구간(예: 벽과 맞은편 벽 사이)의 두 점을 클릭한 후 **Enter**를 눌러 거리를 측정합니다.
   * 측정한 거리가 실제 공간 크기와 일치하는지 가로·세로 방향으로 각각 확인합니다.
   * 확인을 마치면 줄자 옆의 \[X] 버튼을 누르거나 **ESC**를 눌러 측정을 종료합니다.

> [!NOTE]
>
> **측정으로 확인하는 이유** \\
>
> '도면 실측 크기'는 도면 이미지 전체의 가로·세로에 적용됩니다. 도면 이미지에 실제 공간 바깥의
> 여백이 포함되어 있으면, 이미지 전체 크기와 실제 공간 크기가 달라져 도면 위 거리가 실측값과
> 어긋날 수 있습니다. 이 때문에 실제 거리를 알고 있는 구간을 직접 측정하여 어긋남이 없는지
> 확인한 후 조정합니다.

5. 측정한 거리가 실측값과 다른 경우, 실측값에 맞게 '도면 실측 크기'를 다시 입력하거나
   \[두 점으로 스케일 설정]으로 스케일을 조정합니다.
   * 입력한 실측값의 비율에 맞춰 도면 이미지의 비율이 자동으로 조정됩니다.
   * 가로 값을 입력하면 도면 이미지의 비율을 기준으로 세로 값이 자동으로 계산됩니다.
     세로 값을 직접 수정한 경우 \[자동] 버튼을 클릭하면 가로 값을 기준으로 세로 값이 다시 자동 계산됩니다.

> [!NOTE]
>
> **\[두 점으로 스케일 설정] 버튼 (참고)** \\
>
> 실제 거리를 알고 있는 두 점을 도면에서 클릭하고 그 거리(m)를 입력하면, 입력한 거리에 맞춰 '도면 실측 크기'를 다시 계산하는 기능입니다.
> 줄자로 측정한 거리가 실측값과 맞으면 사용하지 않습니다.
> 버튼을 클릭하면 \[스케일 측정 취소]로 바뀌고, 도면에서 두 점을 클릭하면 다음 버튼과 '실제 거리 (m)' 입력칸이 나타납니다.
>
> | 버튼 | 기능 |
> | - | - |
> | \[가로+세로] | ·두 점 사이 거리를 기준으로 가로와 세로를 같은 비율로 맞춤·처음에 선택되어 있으며, 보통 이 버튼을 그대로 사용 |
> | \[가로만] | ·두 점의 가로 방향 거리만 기준으로 가로를 맞춤. 세로는 그대로·도면의 가로·세로 비율이 실제와 다를 때 사용 |
> | \[세로만] | ·두 점의 세로 방향 거리만 기준으로 세로를 맞춤. 가로는 그대로·도면의 가로·세로 비율이 실제와 다를 때 사용 |
> | \[적용] | ·입력한 실제 거리로 다시 계산한 값을 '도면 실측 크기'에 반영하고 '스케일 적용' 메시지를 표시·저장은 되지 않으므로 \[층정보 저장]을 클릭해야 반영 |
> | \[스케일 측정 취소] | ·클릭한 두 점을 지우고 측정을 종료 |

6. 우측 상단의 \[층정보 저장]을 클릭하여 도면 설정을 저장합니다.

7. 우측 상단의 \[층별 작업] 버튼을 클릭해 층 목록으로 돌아갑니다.

![층별 작업 화면 — 도면이 저장된 층에 도면 완료 배지가 표시된 층 목록](https://mintcdn.com/onecheck/-xedZvl_3zPlCfJP/images/geospace/3.spaces-floor-complete.png?fit=max\&auto=format\&n=-xedZvl_3zPlCfJP\&q=85\&s=ea080eadd96c90974587436e3ae30af0)

8. 해당 층이 '도면 완료'로 표시되는지 확인합니다.

**DXF (CAD) · CAD 도면이 있는 경우**

DXF는 CAD의 벽 선을 그대로 사용하므로 도면이 선명하게 표시됩니다. CAD 도면이 없거나 빠르게 설정하려면 이미지 탭으로 진행해도 측위에는 차이가 없습니다.

![DXF 업로드 직후 화면 — DXF 버튼, 캔버스에 미리보기로 표시된 도면 선](https://mintcdn.com/onecheck/9BTDfSqdy9fBmDyx/images/geospace/3.spaces-plan-dxf-upload.png?fit=max\&auto=format\&n=9BTDfSqdy9fBmDyx\&q=85\&s=bf340d6386dce96093a4de81147fbeaf)

2. \[DXF] 버튼(②)을 클릭하여 도면 파일을 업로드합니다. 캔버스에 도면 선이 미리보기(③)로 표시되며, 아직 저장된 상태는 아닙니다.

> **(선택) \[구글맵 정합]: 도면을 위성지도 위 실제 위치에 등록**
>
> \[구글맵 정합]은 위성지도 위에 도면을 겹쳐 위치와 방향을 맞추는 기능입니다.
> 지도 표시용 참고 기능으로 실내 측위에는 영향을 주지 않으므로, 필요 없으면 건너뛰고 3단계로 진행해도 됩니다.
>
> 설정하는 경우 도면(DXF)을 업로드한 직후, 저장하기 전에 진행합니다.
> 이미 저장한 층은 \[DXF]를 클릭해 파일을 다시 업로드한 뒤 진행합니다. 저장된 도면을 불러온 상태에서는 정합 정보를 저장할 수 없습니다.
>
> ![구글맵 정합 탭 화면(위성지도 위에 겹쳐진 도면, 지도 이동·도면 이동 버튼, 회전 입력란)](https://mintcdn.com/onecheck/9BTDfSqdy9fBmDyx/images/geospace/3.spaces-plan-gmap-align.png?fit=max\&auto=format\&n=9BTDfSqdy9fBmDyx\&q=85\&s=1c4146031845ce58e68890c98a646b5f)
>
> 1. \[구글맵 정합] 탭(①)을 클릭합니다. 건물 등록 때 지정한 위치를 중심으로 위성지도가 표시되고, 그 위에 도면이 겹쳐 보입니다.
> 2. \[도면 이동] 버튼(②)을 선택한 상태에서 도면을 드래그해 실제 건물 위치로 옮깁니다. 지도를 움직이려면 옆의 \[지도 이동]을 선택합니다.
> 3. \[회전 (°)] 입력칸(③)에 각도를 입력해 도면 방향을 건물에 맞춥니다. 필요하면 \[투명도]를 조절해 지도와 도면이 함께 보이게 합니다.
>
> ![GPS 정합 저장 후 화면(GPS 정합 저장 (DXF) 버튼, 왼쪽 위의 'GPS 정합 저장 완료' 메시지)](https://mintcdn.com/onecheck/9BTDfSqdy9fBmDyx/images/geospace/3.spaces-plan-gmap-saved.png?fit=max\&auto=format\&n=9BTDfSqdy9fBmDyx\&q=85\&s=8732a371489234057b028927b94f1c0f)
>
> 4. \[GPS 정합 저장 (DXF)] 버튼(④)을 클릭하고, 'GPS 정합 저장 완료' 메시지(⑤)가 표시되는지 확인합니다.
>
> > [!CAUTION]
> >
> > \[축척 (%)]은 100 그대로 두고, \[이 축척을 배치에 적용]은 클릭하지 않습니다. 위성지도에 맞춘 크기로 도면 실측 크기가 바뀌어, 실측으로 맞춘 스케일이 덮어써집니다.

3. 우측 상단의 \[층정보 저장]을 클릭한 뒤, \[층별 작업]으로 나갑니다.

![저장 후 다시 들어온 도면 배치 화면 — 자동 입력된 도면 실측 크기, 저장된 도면 이미지·벡터 수, 줄자로 측정한 가로·세로 거리](https://mintcdn.com/onecheck/9BTDfSqdy9fBmDyx/images/geospace/3.spaces-plan-dxf-saved.png?fit=max\&auto=format\&n=9BTDfSqdy9fBmDyx\&q=85\&s=324f838364a941e700972e927fb94054)

4. 층 목록에서 해당 층의 \[도면 배치 →]를 다시 클릭합니다. 저장된 도면이 배경으로 표시되고, 버튼 아래에 '저장된 도면 이미지 · 벡터 N'(④)이 나타나며,
   '도면 실측 크기'에 도면 크기가 자동으로 입력되어 있습니다. 이 값은 그대로 둡니다.

> [!NOTE]
>
> '벡터 N'은 프로그램이 DXF 파일에서 정상적으로 인식한 선의 개수입니다.\\
>
> 자동 입력된 '도면 실측 크기'는 도면 전체 범위의 크기입니다. 벽에서 벽까지 잰 거리보다 클 수 있으며, 이는 정상입니다.
> (위 그림: 자동값 87.79 × 106.9 m, 벽 사이 85.47 × 106.34 m)

5. 도면 우측 상단의 줄자(거리 측정) 버튼을 클릭합니다(⑤).

6. 실제 거리를 알고 있는 대표 구간(예: 벽과 맞은편 벽 사이)의 두 점을 클릭한 후 **Enter**를 눌러 거리를 측정합니다(⑥).
   * 측정한 거리가 실제 공간 크기와 일치하는지 가로·세로 방향으로 각각 확인합니다.
   * 확인을 마치면 줄자 옆의 \[X] 버튼을 누르거나 **ESC**를 눌러 측정을 종료합니다.
   * 측정한 거리가 현장에서 잰 값과 다르면 도면이 현장과 다른 것이므로 \[두 점으로 스케일 설정]으로 보정하고, 보정한 경우 \[층정보 저장]을 클릭합니다.

> [!NOTE]
>
> **\[두 점으로 스케일 설정] 버튼 (참고)** \\
>
> 실제 거리를 알고 있는 두 점을 도면에서 클릭하고 그 거리(m)를 입력하면, 입력한 거리에 맞춰 '도면 실측 크기'를 다시 계산하는 기능입니다.
> 줄자로 측정한 거리가 실측값과 맞으면 사용하지 않습니다.
> 버튼을 클릭하면 \[스케일 측정 취소]로 바뀌고, 도면에서 두 점을 클릭하면 다음 버튼과 '실제 거리 (m)' 입력칸이 나타납니다.
>
> | 버튼 | 기능 |
> | - | - |
> | \[가로+세로] | ·두 점 사이 거리를 기준으로 가로와 세로를 같은 비율로 맞춤·처음에 선택되어 있으며, 보통 이 버튼을 그대로 사용 |
> | \[가로만] | ·두 점의 가로 방향 거리만 기준으로 가로를 맞춤. 세로는 그대로·도면의 가로·세로 비율이 실제와 다를 때 사용 |
> | \[세로만] | ·두 점의 세로 방향 거리만 기준으로 세로를 맞춤. 가로는 그대로·도면의 가로·세로 비율이 실제와 다를 때 사용 |
> | \[적용] | ·입력한 실제 거리로 다시 계산한 값을 '도면 실측 크기'에 반영하고 '스케일 적용' 메시지를 표시·저장은 되지 않으므로 \[층정보 저장]을 클릭해야 반영 |
> | \[스케일 측정 취소] | ·클릭한 두 점을 지우고 측정을 종료 |

7. \[층별 작업]으로 돌아갑니다.

![층별 작업 화면 — 도면이 저장된 층에 도면 완료 배지가 표시된 층 목록](https://mintcdn.com/onecheck/-xedZvl_3zPlCfJP/images/geospace/3.spaces-floor-complete.png?fit=max\&auto=format\&n=-xedZvl_3zPlCfJP\&q=85\&s=ea080eadd96c90974587436e3ae30af0)

8. 해당 층이 '도면 완료'로 표시되는지 확인합니다.

> [!NOTE]
>
> **도면 배치 화면의 설계 기능 (참고)** \\
>
> 도면 배치 화면에는 아래 기능도 표시됩니다. 넓은 공간에 여러 대의 로케이터를 배치할 때 설치 위치를 미리 계획하는 보조 도구이며, 측위 결과에는 영향을 주지 않습니다.
> 단순한 정사각형이나 직사각형 공간보다는 벽과 방이 많아 구조가 복잡한 실내에서 유용합니다.
>
> 본 매뉴얼에서는 로케이터 4대를 감지 영역의 네 모서리에 설치하고([로케이터 현장 설치](/locator/install)), 그 위치를 [측위 기능 활성화](/locator/placement)에서 도면에 직접 배치하므로, 아래 기능은 사용하지 않고 다음 단계로 진행합니다.
>
> | 기능 | 설명 |
> | - | - |
> | \[도면 분석 (벡터 추출)] | ·이미지 도면의 그림에서 벽 선과 외곽선을 자동으로 찾아냄. 찾아낸 벽은 \[AI 최적 배치]와 \[무선 설계]에서 사용 |
> | \[배치 영역] | ·\[AI 최적 배치]가 로케이터를 놓을 범위. 두 가지 방법으로 지정·도면 위에 점을 3개 이상 찍어 다각형으로 직접 그림·\[도면 분석] 결과를 \[벡터로 적용]하면 찾아낸 외곽선이 배치 영역으로 지정됨 |
> | \[AI 최적 배치] | ·'앵커 가청 반경 (m)'(로케이터 신호가 닿는 거리)을 입력하면 배치 영역 안에 로케이터 추천 위치를 자동으로 생성·영역 가장자리에서 안쪽으로 최대 2 m 띄운 범위에 모서리와 변을 따라 먼저 놓고, 남는 공간을 격자로 채움. 로케이터 간 간격은 최소 5 m를 유지하고, 벽을 지날수록 신호가 닿는 거리가 줄어드는 것을 반영해 위치를 고름·넓은 공간에 여러 대를 배치할 때 적합. 로케이터 간 5 m 간격을 둘 수 있을 만큼 공간이 넓어야 함 |
> | \[무선 설계] | ·로케이터 신호가 벽을 지날 때 약해지는 정도(벽 한 장당 약 3 dB)를 추정해 색으로 표시 |

## 체크리스트

> [!NOTE]
>
> 아래 항목이 모두 확인되면 다음 단계로 진행할 수 있습니다.
>
> | # | 확인 항목 | 확인 |
> | - | - | :-: |
> | 1 | 건물이 등록되어 있습니다. | ☐ |
> | 2 | 층이 등록되어 있습니다. | ☐ |
> | 3 | 도면 파일(이미지 또는 DXF)이 업로드되어 있습니다. (도면을 등록하는 경우) | ☐ |
> | 4 | '도면 실측 크기'에 실측한 가로·세로(m) 값이 입력되어 있습니다. (도면을 등록하는 경우) | ☐ |
> | 5 | 층 목록에서 해당 층이 '도면 완료'로 표시됩니다. (도면을 등록하는 경우) | ☐ |
> | 6 | 로케이터 좌표를 직접 입력할 실측값(기준점에서 각 로케이터까지의 가로·세로 거리와 설치 높이)을 준비했습니다. (도면을 등록하지 않는 경우) | ☐ |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.