> For the complete documentation index, see [llms.txt](https://docs.uvify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uvify.com/05-map.md).

# 5. 지도 조작과 위치 메뉴

지도에는 기체 위치, 홈, 임무 경로와 지원되는 위치 표식이 표시됩니다. 지도 이동은 화면을 보는 위치를 바꾸는 조작입니다. 기체를 이동시키려면 별도의 비행 명령이 필요합니다.

지도에서 한 위치를 **0.6초 동안 누르면** 길게 누르기 동작이 인식됩니다. 터치와 마우스 왼쪽 버튼 모두 같은 시간이며, 누르는 동안 끌기 동작을 하면 해당 길게 누르기 요청은 취소됩니다.

## 5.1 지도 보기 <a href="#section-51" id="section-51"></a>

지도를 끌어 보는 위치를 바꾸고, 확대·축소 버튼 또는 지원되는 휠·터치 조작으로 배율을 조절합니다. 기체 따라가기를 켠 상태에서는 기체 이동에 맞춰 지도 중심이 갱신될 수 있습니다.

**2D/3D** 버튼과 나침반이 제공되는 지도에서는 버튼으로 표시 모드를 전환하고 나침반을 눌러 북쪽 기준으로 방향을 되돌립니다. 버튼의 글자는 누른 뒤 전환할 모드를 나타냅니다.

## 5.2 지도 중심 선택 <a href="#section-52" id="section-52"></a>

[미션](#521-미션) · [모든 항목](#522-모든-항목) · [시작](#523-시작) · [현재 위치](#524-현재-위치) · [지정된 위치](#525-지정된-위치) · [기체](#526-기체) · [기체 추적](#527-기체-추적)

지도 중심 버튼을 누르면 중심을 맞출 대상을 선택합니다.

![지도 중심 선택 메뉴](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-c2f2dc0c6bc58eb4ed3cab58ff9e846bd283240a%2Fmap-center.png?alt=media)

*그림 5-1. 지도 중심과 기체 따라가기 선택 항목.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목      | 설명                                                        |
| :---: | ---------- | --------------------------------------------------------- |
| **1** | **지도 중심**  | 이동할 지도 중심 기준을 선택하는 메뉴입니다.                                 |
| **2** | **미션**     | 지도 중심을 미션 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.     |
| **3** | **모든 항목**  | 지도 중심을 모든 항목 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.  |
| **4** | **시작**     | 지도 중심을 시작 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.     |
| **5** | **현재 위치**  | 지도 중심을 현재 위치 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.  |
| **6** | **지정된 위치** | 지도 중심을 지정된 위치 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다. |
| **7** | **기체**     | 지도 중심을 기체 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.     |
| **8** | **기체 추적**  | 지도 중심을 기체 추적 기준으로 이동하거나 해당 추적 표시를 선택합니다. 기체 이동 명령이 아닙니다.  |

**미션**

임무 지점들이 보이도록 지도 범위를 맞춥니다.

**모든 항목**

임무·제한구역 등 표시 대상이 함께 보이도록 범위를 맞춥니다.

**시작**

홈 또는 계획된 이륙 지점을 중심으로 봅니다.

**현재 위치**

단말의 위치가 유효할 때 위치로 이동합니다.

**지정된 위치**

좌표를 지정하는 창을 엽니다.

**기체**

활성 기체의 위치를 중심으로 봅니다.

**기체 추적**

표시되는 구성에서 기체 위치를 계속 따라갑니다.

단말 위치와 기체 위치는 서로 다를 수 있습니다.

![지정된 위치의 좌표 입력](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-9a70bea4df354120d480f09fd8b42eacd2d54d50%2Fmap-coordinate.png?alt=media)

*그림 5-1a. **지정된 위치**의 좌표 입력창. 위도·경도 또는 MGRS로 위치를 지정하고, 필요하면 UTM을 펼칩니다. **기체 위치 → 현재 위치 사용**은 기체 좌표를 사용합니다. 그림의 좌표는 예시입니다.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목      | 설명                                    |
| :---: | ---------- | ------------------------------------- |
| **1** | **위치 지정**  | 지도 중심에 사용할 좌표를 입력하는 창입니다.             |
| **2** | **닫기**     | 좌표 입력창을 닫습니다.                         |
| **3** | **위도**     | 위도 숫자와 부호를 입력합니다. −·+로 값을 조절할 수 있습니다. |
| **4** | **경도**     | 경도 숫자와 부호를 입력합니다. −·+로 값을 조절할 수 있습니다. |
| **5** | **MGRS**   | 격자 좌표를 직접 입력합니다.                      |
| **6** | **UTM 좌표** | UTM 입력을 선택하고 구역·좌표를 설정합니다.            |
| **7** | **기체 위치**  | 현재 기체의 위치를 입력 기준으로 사용합니다.             |
| **8** | **사용**     | 입력한 좌표를 지도 중심에 적용합니다.                 |

## 5.3 지도 위치를 눌렀을 때 <a href="#section-53" id="section-53"></a>

[지도 클릭 위치에 참고 마커 추가](#531-지도-클릭-위치에-참고-마커-추가) · [현재 기체 위치를 계획에 추가](#532-현재-기체-위치를-계획에-추가) · [위치로 이동](#533-위치로-이동) · [해당 위치 선회](#534-해당-위치-선회) · [해당 위치 ROI](#535-해당-위치-roi) · [여기를 홈으로 설정](#536-여기를-홈으로-설정) · [하단 위도·경도](#537-하단-위도경도)

![지도 위치를 눌렀을 때의 메뉴](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-b9bc7374103fa7b3657878928e25de8b99214633%2Fmap-click.png?alt=media)

*그림 5-2. 기체와 관련 기능을 사용할 수 있는 상태의 위치 메뉴. 좌표는 예시입니다.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목                  | 설명                                           |
| :---: | ---------------------- | -------------------------------------------- |
| **1** | **지도 클릭 위치에 참고 마커 추가** | 선택한 지도 위치에 참조 표식을 추가합니다. 기체 이동 명령을 보내지 않습니다. |
| **2** | **현재 기체 위치를 계획에 추가**   | 클릭한 위치 대신 현재 기체 위치를 사용해 계획에 지점을 추가합니다.       |
| **3** | **위치로 이동**             | 선택한 위치로 이동하는 요청의 확인 단계로 이동합니다.               |
| **4** | **해당 위치 선회**           | 선회 기능과 지도 선회 표시를 지원하는 환경에서 선회를 요청합니다.        |
| **5** | **해당 위치 ROI**          | 해당 위치를 관심 지점으로 지정하는 확인 단계로 이동합니다.            |
| **6** | **여기를 홈으로 설정**         | 홈 위치 변경 확인 단계로 이동합니다.                        |
| **7** | **선택 위치의 좌표**          | 메뉴를 연 지점의 위도와 경도입니다. 기체 현재 위치와 구분합니다.        |

**지도 클릭 위치에 참고 마커 추가**

선택한 지도 위치에 참조 표식을 추가합니다. 기체 이동 명령을 보내지 않습니다.

**현재 기체 위치를 계획에 추가**

클릭한 위치 대신 현재 기체 위치를 사용해 계획에 지점을 추가합니다.

**위치로 이동**

선택한 위치로 이동하는 요청의 확인 단계로 이동합니다.

**해당 위치 선회**

선회 기능과 지도 선회 표시를 지원하는 환경에서 선회를 요청합니다.

**해당 위치 ROI**

해당 위치를 관심 지점으로 지정하는 확인 단계로 이동합니다.

**여기를 홈으로 설정**

홈 위치 변경 확인 단계로 이동합니다.

**하단 위도·경도**

이번에 지도에서 선택한 좌표입니다.

메뉴에 없는 기능은 현재 기체 상태 또는 지도 구성에서 사용할 수 없는 기능입니다. 특히 이동·선회 등은 비행 상태에 따라 달라집니다.

![위치 이동 확인](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-43e752c1a0235fb2e98493bf3e29eee211451496%2Fconfirm-goto.png?alt=media)

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목         | 설명                                              |
| :---: | ------------- | ----------------------------------------------- |
| **1** | **위치로 이동 확인** | 표시된 동작이 위치로 이동인지 확인하고 버튼을 **0.5초 동안 눌러** 요청합니다. |
| **2** | **취소 ×**      | 확인 영역을 닫고 요청을 취소합니다.                            |

![홈 위치 변경 확인](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-ebddf9660dde35485ce5252c489cbf879e71d964%2Fconfirm-home.png?alt=media)

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목       | 설명                                            |
| :---: | ----------- | --------------------------------------------- |
| **1** | **홈 설정 확인** | 표시된 동작이 홈 설정인지 확인하고 버튼을 **0.5초 동안 눌러** 요청합니다. |
| **2** | **취소 ×**    | 확인 영역을 닫고 요청을 취소합니다.                          |

![ROI 지정 확인](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-029c470a7346c1ad46ab309e9cbc6a321e25aafc%2Fconfirm-roi.png?alt=media)

*그림 5-3\~5. 지도 명령의 확인 버튼 예시.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목      | 설명                                           |
| :---: | ---------- | -------------------------------------------- |
| **1** | **ROI 확인** | 표시된 동작이 ROI인지 확인하고 버튼을 **0.5초 동안 눌러** 요청합니다. |
| **2** | **취소 ×**   | 확인 영역을 닫고 요청을 취소합니다.                         |

**유도 비행에서 이동 확인 생략**을 허용한 설정에서는, 이미 해당 이동 모드인 기체에 **위치로 이동**을 누를 때 추가 확인 없이 요청이 전송될 수 있습니다. 지도 메뉴를 사용하기 전에 해당 확인 설정을 확인합니다.

![고급 UI의 위치 메뉴](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-64f336a195789088c8fc10a75a558f8f26108c42%2Fmap-click-advanced.png?alt=media)

*그림 5-3. 고급 UI에서 추가되는 위치·방향 관련 항목.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목                  | 설명                                           |
| :---: | ---------------------- | -------------------------------------------- |
| **1** | **지도 클릭 위치에 참고 마커 추가** | 선택한 지도 위치에 참조 표식을 추가합니다. 기체 이동 명령을 보내지 않습니다. |
| **2** | **현재 기체 위치를 계획에 추가**   | 클릭한 위치 대신 현재 기체 위치를 사용해 계획에 지점을 추가합니다.       |
| **3** | **위치로 이동**             | 선택한 위치로 이동하는 요청의 확인 단계로 이동합니다.               |
| **4** | **해당 위치 선회**           | 선회 기능과 지도 선회 표시를 지원하는 환경에서 선회를 요청합니다.        |
| **5** | **해당 위치 ROI**          | 해당 위치를 관심 지점으로 지정하는 확인 단계로 이동합니다.            |
| **6** | **여기를 홈으로 설정**         | 홈 위치 변경 확인 단계로 이동합니다.                        |
| **7** | **추정기 원점 설정**          | 선택한 지도 위치를 대상으로 이 동작의 설정 또는 확인 단계를 엽니다.      |
| **8** | **기수 방향 설정**           | 선택한 지도 위치를 대상으로 이 동작의 설정 또는 확인 단계를 엽니다.      |
| **9** | **선택 위치의 좌표**          | 메뉴를 연 지점의 위도와 경도입니다. 기체 현재 위치와 구분합니다.        |

고급 UI의 **추정기 원점 설정**과 **기수 방향 설정**은 지도 중심 변경과 다릅니다. 위치 추정 기준 또는 기체 방향에 영향을 주는 요청이므로 일반 지도 보기 용도로 사용하지 않습니다.

## 5.4 참조점 <a href="#section-54" id="section-54"></a>

지도에서 추가한 **참조점**을 누르면 해당 점의 메뉴가 열립니다.

![참조점 메뉴](https://2135067884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRTD1rHcwgEwV7WjHFGiw%2Fuploads%2Fgit-blob-3a7a1b1f47919f9b0768ef6d303b47fd2a3c14e9%2Freference-marker.png?alt=media)

*그림 5-4. 비행 화면의 참조점 메뉴.*

**그림 번호별 설명** — 번호는 이 그림 안에서 1번부터 읽습니다.

|   번호  | 화면 항목        | 설명                              |
| :---: | ------------ | ------------------------------- |
| **1** | **참조 마커**    | 선택된 지도 참조점의 메뉴입니다.              |
| **2** | **ROI로 사용**  | 이 참조점을 관심 영역으로 지정하는 확인 단계를 엽니다. |
| **3** | **참고 마커 삭제** | 참조 마커를 지도에서 지웁니다.               |

**ROI로 사용**은 참조점의 좌표를 이용해 ROI 요청 확인으로 이동합니다. **참고 마커 삭제**는 해당 표식을 지도에서 지웁니다. 표식을 삭제하는 것과 이미 기체에 설정된 ROI를 해제하는 것은 별도 조작입니다.

다음: [6. 빠른 설정](/06-quick-settings.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.uvify.com/05-map.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
