---
schema_version: "1"
id: c10b3f912f54e3f5a841a5624c1ef348fa4d517b55ca60646d94b4d185d6dac1
title: 공간 함수
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/public/desktop/functions_functions_spatial.md
canonical_url: https://help.tableau.com/current/public/desktop/ko-kr/functions_functions_spatial.htm
source_site: help.tableau.com
content_type: documentation
content_hash: e274a1d4f1ced83b99c5b4a7aa11acfbdae6584fb4f408a5deafe2f61af86144
description: Reference for spatial functions such as BUFFER, DISTANCE, and INTERSECTS.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 공간 함수

공간 함수를 사용하면 고급 공간 분석을 수행하고 공간 파일을 텍스트 파일이나 스프레드시트와 같은 다른 형식의 데이터와 결합할 수 있습니다. 예를 들어, 시 구획에 대한 공간 파일과 보고된 파인 도로의 위도 및 경도 좌표를 포함하는 텍스트 파일이 있다고 가정합니다. 이러한 파일을 조인하고 파인 도로를 복구하는 데 가장 오래 걸리는 구획을 분석하기 위한 데이터 원본을 만들 때 공간 계산을 사용할 수 있습니다.

기점-종점 맵에 대한 두 데이터 요소를 연결하는 선을 만들 수도 있습니다. 예를 들어 통근자의 출발 위치와 종착 위치를 알려주는 대중 교통 데이터 스프레드시트가 있다고 가정합니다. 이 경우 공간 함수를 사용하여 통근자가 택하는 경로를 볼 수 있습니다.

## Tableau에서 사용할 수 있는 공간 함수

### AREA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>AREA(Spatial Polygon, 'units')</code></td></tr><tr><td>출력</td><td>숫자</td></tr><tr><td>정의</td><td><code>&lt;spatial polygon&gt;</code>의 총 표면 면적을 반환합니다.</td></tr><tr><td>예</td><td><pre xml:space="preserve">AREA([Geometry], 'feet')</pre></td></tr><tr><td>참고</td><td><p>지원되는 단위 이름(예: <code>'miles'</code>와 같이 계산 시 따옴표로 묶어야 함):</p><ul><li><i>meters</i>: 미터, m</li><li><i>kilometers</i>: 킬로미터, km</li><li><i>miles</i>: 마일, mi</li><li><i>feet</i>: 피트, ft</li></ul><p></p></td></tr></tbody></table>

### BUFFER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>BUFFER(Spatial point, distance, 'units')</code><p><code>BUFFER(Spatial linestring, distance, 'units')</code></p><p><code>BUFFER(Spatial polygon, distance, 'units')</code></p><ul><li><i>meters</i>: 미터, m</li><li><i>kilometers</i>: 킬로미터, km</li><li><i>miles</i>: 마일, mi</li><li><i>feet</i>: 피트, ft</li></ul></td></tr><tr><td>출력</td><td>기하 도형</td></tr><tr><td>정의</td><td><p>공간 점의 경우 <code>&lt;spatial point&gt;</code>를 중심으로 <code>&lt;distance&gt;</code> 및 <code>&lt;unit&gt;</code> 값에 따라 반경이 결정되는 다각형 모양을 반환합니다.</p><p>LineString의 경우 LineString으로부터 반경 거리 내에 있는 모든 점을 포함하여 형성된 다각형을 계산합니다.</p><p>다각형의 경우 주어진 각 다각형의 내접(음의 거리) 또는 외접(양의 거리)인 다각형을 계산합니다.</p></td></tr><tr><td>예</td><td><pre xml:space="preserve">BUFFER([Spatial Point Geometry], 25, 'mi')</pre><pre xml:space="preserve">BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')</pre><pre xml:space="preserve">BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))</pre></td></tr><tr><td>참고</td><td><p>지원되는 단위 이름(예: <code>'miles'</code>와 같이 계산 시 따옴표로 묶어야 함):</p><ul><li><i>meters</i>: 미터, m</li><li><i>kilometers</i>: 킬로미터, km</li><li><i>miles</i>: 마일, mi</li><li><i>feet</i>: 피트, ft</li></ul></td></tr></tbody></table>

### DIFFERENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>DIFFERENCE(Spatial, Spatial)</code></td></tr><tr><td>출력</td><td>공간 다각형</td></tr><tr><td>정의</td><td>겹치는 구역에서는 두 번째 인수의 모든 영역을 첫 번째 인수에서 제거하고 남은 영역의 부분을 계산합니다.겹치지 않는 구역에서는 두 번째 인수의 영역을 삭제합니다.</td></tr><tr><td>예</td><td><pre xml:space="preserve">DIFFERENCE(Spatial Polygon1, Spatial Polygon2)</pre></td></tr><tr><td>참고</td><td><p>공간 점이나 선이 아닌 공간 다각형과 다각형을 지원합니다.</p></td></tr></tbody></table>

### DISTANCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>DISTANCE(SpatialPoint1, SpatialPoint2, 'units')</code></td></tr><tr><td>출력</td><td>숫자</td></tr><tr><td>정의</td><td>지정된 <code>&lt;unit&gt;</code>으로 두 점 사이의 거리 측정값을 반환합니다.</td></tr><tr><td>예</td><td><pre>DISTANCE([Origin Point],[Destination Point], 'km')</pre></td></tr><tr><td>참고</td><td><p>지원되는 단위 이름(예: <code>'miles'</code>와 같이 계산 시 따옴표로 묶어야 함):</p><ul><li><i>meters</i>: 미터, m</li><li><i>kilometers</i>: 킬로미터, km</li><li><i>miles</i>: 마일, mi</li><li><i>feet</i>: 피트, ft</li></ul></td></tr><tr><td>데이터베이스 제한 사항</td><td>이 함수는 라이브 연결로만 만들 수 있지만 데이터 원본이 추출로 변환될 경우 계속 작동합니다.</td></tr></tbody></table>

### INTERSECTION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>INTERSECTION (spatial, spatial)</code></td></tr><tr><td>출력</td><td>다각형</td></tr><tr><td>정의</td><td>두 번째 인수의 영역에서 첫 번째 인수의 영역과 겹치는 부분을 계산하여 반환합니다.</td></tr><tr><td>예</td><td><tt>INTERSECTION(공간 다각형1, 공간 다각형2)</tt></td></tr><tr><td>참고</td><td>공간 점이나 선이 아닌 공간 다각형과 다각형을 지원합니다.</td></tr></tbody></table>

### INTERSECTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>INTERSECTS (geometry1, geometry2)</code></td></tr><tr><td>출력</td><td>부울</td></tr><tr><td>정의</td><td>공간에서 두 기하 도형이 겹치는지 여부를 나타내는 true 또는 false를 반환합니다.</td></tr><tr><td>참고</td><td>지원되는 조합: 점/다각형, 선/다각형 및 다각형/다각형</td></tr></tbody></table>

### LENGTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>LENGTH(geometry, 'units')</code></td></tr><tr><td>출력</td><td>숫자</td></tr><tr><td>정의</td><td><code>&lt;geometry&gt;</code>에 있는 LineString의 최단 경로 길이를 지정된 <code>&lt;units&gt;</code>를 사용하여 반환합니다.</td></tr><tr><td>예</td><td><pre xml:space="preserve">LENGTH([Spatial], 'metres')</pre></td></tr><tr><td>참고</td><td>다른 요소는 허용되지만 기하학 인수에 LineString이 없으면 결과는 <code>&lt;NaN&gt;</code>입니다.</td></tr></tbody></table>

### MAKELINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>MAKELINE(SpatialPoint1, SpatialPoint2)</code></td></tr><tr><td>출력</td><td>기하 도형(라인)</td></tr><tr><td>정의</td><td>두 점 사이에 라인 마크를 생성합니다.</td></tr><tr><td>예</td><td><pre>MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))</pre></td></tr><tr><td>참고</td><td>기점-종점 맵을 구축하는 데 유용합니다.</td></tr></tbody></table>

### MAKEPOINT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>MAKEPOINT(latitude, longitude, [SRID])</code></td></tr><tr><td>출력</td><td>기하 도형(점)</td></tr><tr><td>정의</td><td><p><code>&lt;latitude&gt;</code> 및 <code>&lt;longitude&gt;</code> 열의 데이터를 공간 개체로 변환합니다.</p><p>선택적 <code>&lt;SRID&gt;</code> 인수가 추가되면 입력은 다른 투영된 지리적 좌표가 될 수 있습니다.</p></td></tr><tr><td>예</td><td><pre>MAKEPOINT(48.5, -123.1)</pre><pre xml:space="preserve">MAKEPOINT([AirportLatitude], [AirportLongitude])</pre><pre xml:space="preserve">MAKEPOINT([Xcoord],[Ycoord], 3493)</pre></td></tr><tr><td>참고</td><td><p><code>MAKEPOINT</code>는 자동으로 생성된 위도 및 경도 필드를 사용할 수 없습니다.데이터 원본에는 기본적으로 좌표가 포함되어 있어야 합니다.</p><p><code>SRID</code>는 <a href="https://epsg.io/" target="_blank">ESPG 기준계 코드</a>를 사용하여 좌표계를 지정하는 공간 기준 식별자입니다.<code>SRID</code>를 지정하지 않으면 WGS84가 사용되고 매개 변수는 도 단위의 위도/경도로 처리됩니다.</p><p><code>MAKEPOINT</code>를 사용하면 공간 조인을 사용하여 공간 파일과 조인할 수 있도록 데이터 원본을 공간적으로 사용할 수 있습니다.자세한 내용은 <a href="https://help.tableau.com/current/public/desktop/ko-kr/maps_spatial_join.htm" class="xref">Tableau에서 공간 파일 조인</a>을 참조하십시오.</p></td></tr></tbody></table>

### NO\_CUTOUTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>NO_CUTOUTS (spatial)</code></td></tr><tr><td>출력</td><td>수정된 공간 다각형</td></tr><tr><td>정의</td><td>평평한 지구 해석에 따라 다각형의 방향이 반전되어야 하는 경우, 수정된 공간 다각형을 반환하고, 그렇지 않은 경우 원래 값을 반환합니다.</td></tr><tr><td>참고</td><td><p>Keyhole Markup Language(.kml)와 같은 공간 파일 형식에서는 다각형 경계가 특정 좌표 방향을 따라야 합니다.데이터 집합이 경계를 반대 방향으로 그릴 경우, Tableau는 바깥쪽 공간을 도형으로 해석합니다.<code>NO_CUTOUTS</code>가 이러한 좌표를 다시 정렬하여 올바른 레이아웃을 복원합니다.</p></td></tr></tbody></table>

### OUTLINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>OUTLINE(spatial polygon)</code></td></tr><tr><td>출력</td><td>기하 도형</td></tr><tr><td>정의</td><td>다각형 기하 도형을 LineString으로 변환합니다.</td></tr><tr><td>참고</td><td><p>채우기와 다르게 스타일을 지정할 수 있는 윤곽선에 대해 별도의 레이어를 만드는 데 유용합니다.</p><p>다중 다각형 내의 다각형을 지원합니다.</p></td></tr></tbody></table>

### PARSE\_WKT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>PARSE_WKT (String)</code></td></tr><tr><td>출력</td><td>공간(지리)</td></tr><tr><td>정의</td><td>점, 선분 또는 다각형과 같은 지리적 엔터티의 WKT(Well-Known Text) 표현이 포함된 텍스트 문자열 필드를 공간 값으로 변환합니다.</td></tr><tr><td>참고</td><td><p>좌표는 WGS-84 위도 및 경도를 사용하는 것을 전제로 합니다.WKT에 대한 자세한 내용은 <a href="https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry">기하 도형의 WKT(Well-Known Text) 표현(영문)</a>을 참조하십시오.</p></td></tr></tbody></table>

### SHAPETYPE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>SHAPETYPE(geometry)</code></td></tr><tr><td>출력</td><td>문자열</td></tr><tr><td>정의</td><td>Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed, unsupported 등 공간 <code>&lt;geometry&gt;</code>의 구조를 설명하는 문자열을 반환합니다.</td></tr><tr><td>예</td><td><pre xml:space="preserve">SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"</pre></td></tr></tbody></table>

### SYMDIFFERENCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>SYMDIFFERENCE(spatial, spatial)</code></td></tr><tr><td>출력</td><td>기하 도형</td></tr><tr><td>정의</td><td>두 번째 인수의 영역에서 첫 번째 인수의 영역과 겹치는 부분을 계산하고 두 부분 모두에서 삭제합니다.두 인수 모두에서 영역의 나머지 부분을 반환합니다.</td></tr><tr><td>예</td><td><p><code>SYMDIFFERENCE(Spatial Polygon1, Spatial Polygon2)</code></p></td></tr></tbody></table>

### UNION

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>UNION(spatial 1, [spatial 2])</code></td></tr><tr><td>출력</td><td>기하 도형</td></tr><tr><td>정의</td><td>인접하거나 겹치는 경계를 해제하여 공간 기하 도형을 단일 공간 기하 도형으로 결합합니다.</td></tr><tr><td>참고</td><td><p>하나의 인수(<code>UNION(spatial)</code>)와 함께 사용하면 <code>UNION </code>함수는 행 전체에서 필드의 모든 공간 개체를 병합하는 집계 함수로 작동합니다.</p><p>두 개의 인수(<code>UNION(spatial1, spatial2)</code>)와 함께 사용하면 <code>UNION </code>함수는 서로 다른 두 공간 필드 또는 기하 도형을 병합합니다.</p><p>점 및 선분의 경우 <code>UNION </code>함수는 모든 요소를 단일 모음으로 결합합니다.다각형의 경우 서로 겹치거나 맞닿은 도형이 하나의 다각형 또는 다중 다각형으로 합해집니다.</p></td></tr></tbody></table>

### VALIDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>구문</td><td><code>VALIDATE(spatial geometry)</code></td></tr><tr><td>출력</td><td>기하 도형</td></tr><tr><td>정의</td><td>공간 값에서 기하 도형의 위상적 정확성을 확인합니다.다각형의 둘레가 서로 교차하는 등의 문제로 인해 해당 값을 분석에 사용할 수 없는 경우 결과는 null이 됩니다.기하 도형이 올바르다면 그 결과는 원래의 기하 도형이 될 것입니다.</td></tr><tr><td>예</td><td><p><code>UNION(VALIDATE([Geometry]))</code></p></td></tr></tbody></table>

## 공간 계산 사용

### MAKEPOINT를 사용하여 공간 데이터 원본 만들기

MAKEPOINT를 사용하면 공간 조인을 사용하여 공간 파일과 조인할 수 있도록 데이터 원본을 공간적으로 사용할 수 있습니다. MAKEPOINT를 사용하려면 데이터에 위도 및 경도 좌표가 포함되어야 합니다.

1. Tableau를 열고 공간 데이터 원본에 연결합니다.
2. 연결에서 추가를 클릭하여 두 번째 비공간 데이터 원본을 추가합니다.
    
    두 데이터 원본이 캔버스에 추가됩니다.
    
    > [!TIP]
    > 
    > 팁: 조인 대화 상자를 표시하려면 캔버스에서 데이터 원본을 두 번 클릭(Mac에서 Control 클릭)합니다.
3. 비공간 데이터 원본을 조인 대화 상자로 끌어옵니다.
4. 조인 아이콘을 클릭합니다.
5. 조인 대화 상자가 나타나면 다음을 수행합니다.
    - 조인 유형을 선택합니다.
    - 데이터 원본 아래에서 조인에 사용할 공간 파일의 공간 필드를 선택합니다. 공간 필드에는 지구본 아이콘이 필드 옆에 표시됩니다.
6. 비공간 데이터 원본의 경우 조인 절로 조인 계산 만들기를 선택합니다.  
    ![조인 계산 만들기 옵션이 있는 조인 대화 상자입니다.](/tableau/current/ko-kr/public/desktop/ko-kr/Img/maps_spatialcalcs_csvspatial.png)
    
    계산은 다음과 유사합니다.
    
    `MAKEPOINT(Latitude,Longitude)`
7. 확인을 선택합니다.
8. Intersects 조인 절 연산자를 선택하여 공간 분석을 위한 데이터 원본을 만듭니다.
9. 완료되면 조인 대화 상자를 닫습니다.

공간 조인에 대한 자세한 내용은 [Tableau에서 공간 파일 조인](https://help.tableau.com/current/public/desktop/ko-kr/maps_spatial_join.htm)을 참조하십시오.

### MAKELINE을 사용하여 비주얼리제이션 만들기

Tableau Desktop에서 [여기에서 사용할 수 있는](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link) Tableau Public의 Flight Path(비행 경로) 통합 문서를 다운로드합니다.

1. 새 워크시트로 이동합니다.
2. 분석 > 계산된 필드 만들기를 선택합니다.
3. 계산이 열리면 다음을 수행합니다.

- 계산된 필드의 이름을 Flight Paths(비행 경로)로 지정합니다.
- 다음 수식을 입력합니다.

`MAKELINE(MAKEPOINT([Lat],[Lng]),MAKEPOINT([Dest Lat],[Dest Lng]))`

이 수식은 기점 도시와 종점 도시의 위도 및 경도 좌표를 가져와 공간 분석을 위한 지리적 요소로 변환합니다. 이러한 좌표는 기점과 종점 사이에 두 점으로 이루어진 라인을 구성하는 데 사용됩니다.

7. 작업을 마쳤으면 확인을 클릭합니다.

새 계산된 필드가 데이터 패널의 차원 아래에 나타납니다. 다른 필드와 마찬가지로, 하나 이상의 비주얼리제이션에서 이 필드를 사용할 수 있습니다.

9. 데이터 패널에서 Flight Paths(비행 경로)를 두 번 클릭하여 비주얼리제이션에 추가하면 자동으로 맵으로 렌더링됩니다.

![미국과 멕시코 내의 항공 경로를 보여주는 맵입니다.](/tableau/current/ko-kr/public/desktop/ko-kr/Img/maps_spatialcalcs_flight.png)

이 계산은 선이 지구 규모의 긴 길이에 걸쳐 있을 때 자동으로 곡선의 측지선을 생성합니다.

### BUFFER를 사용하여 영역 시각화

Tableau Desktop에서 [여기에서 사용할 수 있는](https://public.tableau.com/views/UseSpatialFunctionsMakeLineExampleWorkbook/FinishedFlightpaths?:embed=y&:display_count=yes&publish=yes&:origin=viz_share_link) Tableau Public의 Flight Path(비행 경로) 통합 문서를 다운로드합니다.

1. 새 워크시트로 이동합니다.
2. 데이터 패널을 오른쪽 클릭하고 매개 변수 만들기를 선택합니다.
3. 매개 변수 대화 상자가 열리면 아래 옵션을 설정합니다.
    
    - 매개 변수의 이름을 Buffer Distance로 지정합니다.
    - 데이터 유형을 정수로 설정합니다.
    - 허용 가능한 값을 범위로 설정합니다.
    - 최소 범위를 100, 최대 범위를 1000, 단계 크기를 100으로 설정합니다.
    
    ![이름을 Buffer Distance(버퍼 거리)로, 데이터 유형을 정수로, 허용 가능한 값을 범위로, 최소 범위를 100으로, 최대 범위를 1000으로, 단계 크기를 100으로 설정한 매개 변수 만들기 대화 상자입니다.](/tableau/current/ko-kr/public/desktop/ko-kr/Img/map_buffer_2.png)
4. 작업을 마쳤으면 확인을 클릭합니다.

이 매개 변수를 사용하여 버퍼의 반지름을 100~1000마일 범위에서 사용자 지정할 수 있습니다. 매개 변수를 오른쪽 클릭하고 매개 변수 표시를 선택합니다.

6. 분석 > 계산된 필드 만들기를 선택합니다.
7. 계산이 열리면 다음을 수행합니다.

- 계산된 필드의 이름을 Buffer로 지정합니다.
- 다음 수식을 입력합니다.

`BUFFER(MAKEPOINT([Dest Lat],[Dest Lng]),[Buffer Distance],"miles")`

BUFFER 계산은 점 공간 데이터를 가져와 Buffer Distance 매개 변수로 결정되는 마일 단위의 반지름을 갖는 모양으로 변환합니다.

참고: BUFFER는 점 공간 데이터에만 사용할 수 있으므로 이전 예제에서 설명한 것처럼 Makepoint를 사용하여 위도 및 경도 데이터를 점으로 변환합니다.

12. 작업을 마쳤으면 확인을 클릭합니다.

새 계산된 필드가 데이터 패널에 나타납니다. 다른 필드와 마찬가지로, 하나 이상의 비주얼리제이션에서 이 필드를 사용할 수 있습니다.

14. 데이터 패널에서 Buffer를 두 번 클릭하여 비주얼리제이션에 추가하면 자동으로 맵으로 렌더링됩니다.
15. Destination(종점)을 마크 카드의 색상 패널로 끌어 놓아 비주얼리제이션을 완성합니다.

![맵 유형 마크가 있는 버퍼 맵입니다.](/tableau/current/ko-kr/public/desktop/ko-kr/Img/map_buffer_1.png)

**참고:** 뷰가 위 이미지처럼 보이지 않는 경우 마크 유형이 원이 아니라 맵으로 설정되어 있는지 확인하십시오. 마크 유형에 대한 자세한 내용은 [뷰의 마크 유형 변경](https://help.tableau.com/current/public/desktop/ko-kr/viewparts_marks_marktypes.htm)을 참조하십시오.