Skip To Content

조인 피처에 Arcade 식 사용

식을 적용할 수 있는 GeoAnalytics Tools 도구 상자에 여러 도구가 있습니다.

식을 사용하는 GeoAnalytics Tools에 다양한 사용법이 있으며 식을 적용할 수 있는 제한 사항도 있습니다. ArcGIS GeoAnalytics Server에서 사용되는 모든 식에 아케이드가 지원됩니다.

Arcade 함수에 대한 자세한 정보

조인 피처의 식

식은 조인 조건을 지정하도록 조인 피처 도구에서 사용됩니다.

어떤 경우에는 조인에 포함해야 하는 피처를 선택하도록 조건을 지정할 수 있습니다. 단순 조인 조건(예시: 필드 a > 필드 c)을 비롯하여 고급 조건도 수행할 수 있습니다. 조건은 분석되는 항목을 확인하도록 각 피처에 대해 테스트됩니다. 계산은 분석이 ArcGIS GeoAnalytics Server에서 실행되는 경우 수행됩니다.

비고:
조인 피처에는 2개의 입력 즉, 대상 레이어와 조인 레이어가 필요합니다. 따라서 조인 피처의 Arcade 식에서는 사용 중인 데이터셋을 나타내야 합니다. 예를 들어 대상 레이어의 field1이라는 필드가 조인 레이어의 field2라는 필드보다 큰 것인지 계산하는 연산은 $target["field1"] > $join["field2"]로 나타낼 수 있습니다. 해당 식은 $feature["fieldname"] 형식이 사용되는 다른 GeoAnalytics Tools의 식과 다릅니다.

조인 조건의 결과는 항상 true 또는 false입니다. 식의 예시가 아래 섹션에 포함되어 있습니다.

수학 연산 및 함수 예시

식은 수학적으로 숫자를 처리할 수 있습니다. 다음 테이블은 사용 가능한 연산 샘플을 보여줍니다.

Arcade에서 사용할 수 있는 수학 연산 및 함수에 대한 자세한 정보

연산자설명예시결과

a + b

a와 b를 더합니다.

fieldname 값으로 1.5를 포함합니다.

$target["fieldname"] + 2.5

4.0

a - b

a에서 b를 뺍니다.

fieldname 값으로 3.3을 포함합니다.

$target["fieldname"]- 2.2

1.1

a * b

a와 b를 곱합니다.

fieldname 값으로 2.0을 포함합니다.

$join["fieldname"] * 2.2

4.4

a / b

a를 b로 나눕니다.

fieldname 값으로 4.0을 포함합니다.

$join["fieldname"] / 1.25

3.2

abs( a )

a의 절대 값(양수)을 반환합니다.

fieldname 값으로 -1.5를 포함합니다.

abs($target["fieldname"])

1.5

log( a )

A의 자연 로그(밑 E)를 반환합니다.

fieldname 값으로 1을 포함합니다.

log($join["fieldname"])

0

sin( a )

a의 사인 값을 반환합니다. 입력은 라디안의 각도로 간주됩니다.

fieldname 값으로 1.5707을 포함합니다.

sin($target["fieldname"])

1

cos( a )

a의 코사인 값을 반환합니다. 입력은 라디안의 각도로 간주됩니다.

fieldname 값으로 0을 포함합니다.

cos($join["fieldname"])

1

tan( a )

a의 탄젠트를 반환합니다. 입력은 라디안의 각도로 간주됩니다.

fieldname 값으로 0을 포함합니다.

tan($target["fieldname"])

0

sqrt( a )

a의 제곱근을 반환합니다.

fieldname 값으로 9를 포함합니다.

sqrt($join["fieldname"])

3

min( a, b )

a와 b 중 가장 낮은 숫자 값을 반환합니다.

fieldname 값으로 1.5 및 -3을 포함합니다.

min($join["fieldname"], -3)

-3

max( a, b )

a와 b 중 가장 높은 숫자 값을 반환합니다.

fieldname1 값으로 1.5를 포함하고 fieldname2에 값으로 -3을 포함합니다.

max($target["fieldname1"], $join["fieldname2"])

1.5

constrain(<value>,<low>,<high>)

포함하는 경계 내에 있는 경우 입력 값을 반환합니다. 입력 값이 낮은 값보다 작은 경우 낮은 값을 반환합니다. 입력 값이 높은 값보다 큰 경우 높은 값을 반환합니다.

constrain($target["distance"], 0, 10)

constrain($join['Store dist'], 6, distance)

distance가 0보다 작은 경우 0을 반환하며 distance가 10보다 작은 경우 10을 반환하고, 그 외에는 distance입니다.

Store dist가 6보다 작은 경우 6을 반환하며 distanceStore dist보다 작은 경우 distance를 반환하고, 그 외에는 Store dist입니다.

대상 데이터셋의 필드가 사용된 조인 조건 식의 곱셈 예시입니다.

$target["Distance"] * 2 > $join["DistField"]

텍스트 함수 예시

조인 조건 식은 텍스트를 처리할 수 있습니다. 다음 테이블은 사용 가능한 연산 샘플을 보여줍니다.

Arcade에서 사용할 수 있는 텍스트 함수에 대한 자세한 정보

연산자설명예시결과

concatenate( <values>, <separator>)

값을 함께 연결하여 문자열을 반환합니다.

  • values - 연결할 문자열 값의 배열입니다.
  • separator(선택) - values 매개변수가 배열인 경우 연결에 사용될 구분 기호입니다. 또는 단일 값이 첫 번째 매개변수로 제공된 경우 연결할 문자열입니다. 이 매개변수가 제공되지 않으면 빈 값이 출력됩니다.

fieldname 값으로 GeoAnalytics 포함

Concatenate([$target["fieldname"], "is", "great!"], ' ')

GeoAnalytics is great!

find(<searchText>, <text>, <startPos>)

문자열 내에서 문자열을 찾습니다. 와일드 카드를 지원하지 않습니다.

  • searchText - 검색할 하위 문자열입니다.
  • text - 검색할 텍스트입니다.
  • startPos(선택) - 검색이 수행될 문자열 내의 위치에 대한 0 기반 색인입니다.

fieldname1 값으로 14NorthStreet를 포함하고 fieldname2에 값으로 North를 포함합니다.

find($target["fieldname2"], $join["fieldname1"])

2

lower(<value>)

문자열을 소문자로 전환합니다.

  • value - 소문자로 전환할 문자열입니다.

fieldname 값으로 GEOANALYTICS를 포함합니다.

lower($join["fieldname"])

GeoAnalytics

findlower가 사용된 텍스트 예시

find(("north"), lower("146NorthStreet")) == False

날짜 함수 예시

조인 식은 날짜를 처리할 수 있습니다. 다음 테이블은 사용 가능한 연산 샘플을 보여줍니다.

Arcade에서 사용할 수 있는 날짜 함수에 대한 자세한 정보

Arcade에서 월의 값은 0(1월)~11(12월), 일은 1~31, 시간은 0(오전 12:00)~23(오후 11:00), 분과 초는 0~59, 밀리초는 0~999입니다. Arcade 날짜는 GeoAnalytics Server 위치의 시간 값을 반환합니다.

연산자설명예시결과

date( <value>, <month>, <day>, <hour>, <minute>)

단일 값 또는 일련의 값을 날짜 문자열로 구문 분석합니다.

  • value(선택) - 1970년 1월 1일 UTC로부터 밀리초 수 또는 연도를 나타내는 수입니다. 연도가 지정되면 월 및 일도 후속 매개변수에서 제공되어야 합니다. 이 값은 날짜로 변환되는 ISO 8601 문자열 또는 날짜 문자열일 수도 있습니다.
  • month(선택) - 월(0~11), 여기서 0은 1월이며 11은 12월입니다.
  • day(선택) - 날짜(1~31)입니다.
  • hour(선택) - 시간(0~23)입니다.
  • minute(선택) - 분(0~59)입니다.
  • second(선택) - 초(0~59)입니다.
  • millisecond(선택) - 밀리초(0~999)입니다.

fieldname 값으로 1476987783555를 포함합니다.

예시 1: Date($target["fieldname"])

예시 2: Date(2017,0,14,0)

예시 3: Date()

예시 1: 2016년 10월 20일 11:23:03am

예시 2: 2017년 1월 14일 12:00:00 am

예시 3: 현재 시간이 반환됨

DateDiff(<date1>, <date2>, <units>)

두 날짜를 뺀 차이를 지정된 단위로 반환합니다.

  • date1 - 두 번째 날짜를 뺄 날짜 값입니다.
  • date2 - 첫 번째 지정 날짜에서 뺄 날짜 값입니다.
  • units(선택) - 두 지정 날짜의 차이가 반환될 때 사용되는 단위입니다. 지원되는 단위 유형은 milliseconds, seconds, minutes, hours, days, months, years입니다. 기본값은 밀리초입니다.

예시 1: DateDiff(Date(2017,1,14,0), Date())

예시 2: DateDiff(Date(2017,1,14,0), Date(), "Years")

이 명령을 실행한 날짜에 따라 결과가 달라집니다.

예시 1: -20532129137

예시 2: -0.6546783768647119

Year(<dateValue>)

지정 날짜의 연도를 반환합니다.

  • value - 연도를 가져올 날짜 값입니다.

예시 1: fieldname09 Oct 2017 04:30:43 pm 값을 갖는 Date 유형의 필드입니다.

Year($join["fieldname"])

예시 2: fieldname2012-09-27 값을 갖는 ISO 8601 문자열 형식의 문자열 필드입니다.

예시 2: fieldnameYear(Date($target["fieldname"])) 값을 갖는 ISO 8601 문자열 형식의 문자열 필드입니다.

예시 1: 2017

예시 2: 2012

조건 연산자

조건문은 다음 연산자를 사용할 수 있습니다.

연산자설명예시결과

a > b

a < b

a가 b보다 큼

a가 b보다 작음

10 > 2

False

a >= b

a <= b

a가 b보다 크거나 동일함

a가 b보다 작거나 동일함

abs(-10) >= 10

True

a != b

a가 b와 같지 않음

abs(-3) != -3

True

a == b

a가 b와 같음

abs(-5) == 5

True

<condition1> || <condition2>

조건 1 또는 조건 2가 충족됩니다.

(abs(-5) == 5) || (10 < 2)

True

<condition1> && <condition2>

조건 1과 조건 2가 충족됩니다.

(abs(-5) == 5) && (10 < 2)

False

논리 연산자 예시

조건 연산자 이외에 고급 논리 연산자를 사용하여 피처를 조인할 수 있습니다.

Arcade에서 사용할 수 있는 논리 함수에 대해 대한 자세한 정보

함수설명예시결과

constrain(<value>,<low>,<high>)

포함하는 경계 내에 있는 경우 입력 값을 반환합니다. 입력 값이 낮은 값보다 작은 경우 낮은 값을 반환합니다. 입력 값이 높은 값보다 큰 경우 높은 값을 반환합니다.

constrain($target["distance"], 0, 10)

constrain($join['Store dist'], 6, distance)

distance가 0보다 작은 경우 0을 반환하며 distance가 10보다 작은 경우 10을 반환하고, 그 외에는 distance입니다.

Store dist가 6보다 작은 경우 6을 반환하며 distanceStore dist보다 작은 경우 distance를 반환하고, 그 외에는 Store dist입니다.

iif(<condition>,<true value>,<false value>)

조건이 true로 평가되면 그 값을 반환하고 조건이 false로 평가되면 다른 값을 반환합니다.

<true value><false value>은(는) 다음과 같을 수 있습니다.

  • 숫자 필드입니다. 필드 이름에 공백이 있는 경우 대괄호를 사용합니다.
  • 숫자입니다.
  • 기능입니다.

iif($target["field1"] > $join["field2"], $join["field1"], 0)

iif($target["field1"] > $join["field2"], iif($target["field2"] = 0, $join["field3"], $target["field4"]), 0)

field1field1보다 큰 경우 field2를 반환하고 그 외에는 0입니다.

iif이(가) field1보다 큰 경우 두 번째 field2 기능의 결과를 반환하고 그 외에는 0입니다.

when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>)

true로 평가되는 식이 나올 때까지 일련의 식을 차례로 평가합니다.

  • expression - 식입니다.
  • result - 숫자 또는 필드일 수 있습니다.
  • default - 식이 일치하지 않는 경우 옵션 값입니다.

when(($target["field1"] + 10) > 1, 1,($join["field2"] + 10) > 2 , 2, $target["field3"])

field1 + 10이 1보다 큰 경우 1을 반환합니다. 그렇지 않은 경우 field2 + 10이 2보다 큰지 확인합니다. 그렇다면 2를 반환합니다. 그렇지 않은 경우 field3을 반환합니다.

decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> )

decode 함수가 식을 평가하고 값을 이후 매개변수와 비교합니다. 식이 일치하는 경우 다음 매개변수 값을 반환합니다. 아무것도 일치하지 않는 경우 마지막 매개변수가 기본 반환 값이 되는 옵션이 있습니다.

  • conditional val - 필드 또는 식일 수 있습니다.
  • case - conditional val와(과) 비교하는 값입니다.
  • result - 해당 사례가 conditional val와(과) 일치하는 경우의 결과입니다.
  • defaultValue - 다른 값이 true가 아닌 경우 옵션 값입니다.

decode($target["field1"] + 3 , $join["field1"], 1, $target["field2"], 2, 0)

conditionl val field1 + 3 및 case1 field1의 동등을 비교합니다. true인 경우 1을 반환합니다. false인 경우 field1 + 3field2의 동등을 비교합니다. true인 경우 2를 반환합니다. 그 외의 경우 0을 반환합니다.