Há múltiplas ferramentas na caixa de ferramentas do Ferramentas de GeoAnalytics que permitem a você aplicar uma expressão.
- Expressões de buffer em Criar Buffers e Reconstruir Caminhos
- Condições de ligação em Ligar Feições
- Condições de incidentes em Detectar Incidentes
Obtenha mais informações sobre expressões em Detectar Incidentes
- Para calcular valores de campo em Calcular Campo
As Ferramentas de GeoAnalytics que utilizam expressões têm diferentes usos, como também, limitações sobre quais expressões podem ser aplicadas. Todas as expressões utilizadas no ArcGIS GeoAnalytics Server suportam Arcade.
Obtenha mais informações sobre Funções Arcade
Expressões em Ligar Feições
As expressões são utilizadas na ferramenta Ligar Feições para especificar condições de ligação.
Em alguns casos, convém especificar uma condição para selecionar as feições que devem ser incluídas na ligação. Você pode executar condições de ligação simples (como campo a > campo c), como também, condições avançadas. As condições são testadas em relação a cada feição para determinar o que é analisado. Os cálculos são realizados quando a análise é executada no ArcGIS GeoAnalytics Server.
Anotação:
Ligar Feições exige duas entradas, uma camada de destino e uma camada de ligação. Consequentemente, qualquer expressão Arcade em Ligar Feições deve esboçar qual conjunto de dados está sendo utilizado. Por exemplo, uma operação para calcular se um campo na camada alvo nomeada field1 é maior que um campo na opção ligar camada nomeada field2 seria expressa como $target["field1"] > $join["field2"]. Isto é diferente de expressões em outras Ferramentas de GeoAnalytics, que utilizam o formato $feature["fieldname"].Uma condição de ligação deve sempre resultar em true ou false. Os exemplos de expressão estão incluídos nas seções abaixo.
Exemplos de operador matemático e função
As expressões podem processar números matematicamente. A seguinte tabela exibe uma amostra de operações disponíveis.
Obtenha mais informações sobre operações matemáticas e funções disponíveis no Arcade
| Operador | Explanação | Exemplo | Resultado |
|---|---|---|---|
a + b | a mais b. | fieldname contém um valor de 1.5 $target["fieldname"] + 2.5 | 4.0 |
a - b | a menos b. | fieldname contém um valor de 3.3 $target["fieldname"]- 2.2 | 1.1 |
a * b | a vezes b. | fieldname contém um valor de 2.0 $join["fieldname"] * 2.2 | 4.4 |
a / b | a dividido por b. | fieldname contém um valor de 4.0 $join["fieldname"] / 1.25 | 3.2 |
abs( a ) | Retorna o valor absoluto (positivo) de a. | fieldname contém um valor de -1,5 abs($target["fieldname"]) | 1.5 |
log( a ) | Retorna o logaritmo natural (base E) de a. | fieldname contém um valor de 1 log($join["fieldname"]) | 0 |
sin( a ) | Retorna o seno trigonométrico de a. A entrada é assumida como sendo um ângulo em radianos. | fieldname contém um valor de 1.5707 sin($target["fieldname"]) | 1 |
cos( a ) | Retorna o co-seno trigonométrico de a. A entrada é assumida como sendo um ângulo em radianos. | fieldname contém um valor de 0 cos($join["fieldname"]) | 1 |
tan( a ) | Retorna a tangente de a. A entrada é assumida como sendo um ângulo em radianos. | fieldname contém um valor de 0 tan($target["fieldname"]) | 0 |
sqrt( a ) | Retorna a raiz quadrada de a. | fieldname contém um valor de 9 sqrt($join["fieldname"]) | 3 |
min( a, b ) | Retorna o número estimado mais baixo entre a e b. | fieldname contém um valor de 1.5 e um valor de -3 min($join["fieldname"], -3) | -3 |
max( a, b ) | Retorna o número estimado mais alto entre a ou b. | fieldname1 contém um valor de 1.5 e fieldname2 contém um valor de -3 max($target["fieldname1"], $join["fieldname2"]) | 1.5 |
constrain(<value>,<low>,<high>) | Retorna o valor de entrada se ele estiver dentro dos limites determinados. Se o valor de entrada for menor que o valor baixo, retorna o valor baixo. Se o de entrada valor for maior que o valor alto, retorna o valor alto. | constrain($target["distance"], 0, 10) constrain($join['Store dist'], 6, distância) | Retorna 0 se distance for menor que 0, 10 se distance for maior que 10, e caso contrário, distance. Retorna 6 se Store dist for menor que 6, distance se Store dist for maior que distance, e caso contrário, Store dist. |
Exemplo de multiplicação para uma expressão de condição de ligação utilizando um campo a partir do conjunto de dados alvo.
$target["Distance"] * 2 > $join["DistField"]Exemplos de função de texto
As expressões de condição de ligação podem processar textos. A seguinte tabela exibe uma amostra de operações disponíveis.
Obtenha mais informações sobre funções de texto disponíveis no Arcade
| Operador | Explanação | Exemplo | Resultado |
|---|---|---|---|
concatenate( <values>, <separator>) | Concatena valores e retorna uma string.
| fieldname contém um valor de GeoAnalytics Concatenar ([$target["fieldname"], "is", "great!"], ' ') | GeoAnalytics é ótimo! |
find(<searchText>, <text>, <startPos>) | Localiza uma string dentro de uma string. Curingas não são suportados.
| fieldname1 contém um valor de 14NorthStreet e fieldname2 contém um valor de North find($target["fieldname2"], $join["fieldname1"]) | 2 |
lower(<value>) | Torna uma string com letra minúscula.
| fieldname contém um valor de GEOANALYTICS lower($join["fieldname"]) | geoanalytics |
Exemplo de texto utilizando find e lower.
find(("north"), lower("146NorthStreet")) == FalseExemplos de função de data
As expressões de ligação podem processar textos. A seguinte tabela exibe uma amostra de operações disponíveis.
Obtenha mais informações sobre funções de datas disponíveis no Arcade
No Arcade, valores de mês variam de 0 (Janeiro) até 11 (Dezembro), dias a partir de 1 ao 31, horas de 0 (12:00 am) até 23 (11:00 pm), minutos e segundos de 0 a 59 e milissegundos de 0 a 999. As datas do Arcade retornam valores de tempo na localização do seu GeoAnalytics Server.
| Operador | Explanação | Exemplo | Resultado |
|---|---|---|---|
date( <value>, <month>, <day>, <hour>, <minute>) | Analisa um valor ou conjunto de valores em uma string de data.
| fieldname contém um valor de 1476987783555 Exemplo 1: Date($target["fieldname"]) Exemplo 2: Date(2017,0,14,0) Exemplo 3: Date() | Exemplo 1: 20 de Outubro de 2016 11:23:03 am Exemplo 2: 14 Jan 2017 12:00:00 am Exemplo 3: Retorna a hora atual |
DateDiff(<date1>, <date2>, <units>) | Subtrai duas datas, e retorna a diferença nas unidades especificadas.
| Exemplo 1: Date(2017,1,14,0) Exemplo 2: DateDiff(Date(2017,1,14,0), Date(), "Years") | O resultado variará dependendo de quando você executar este comando. Exemplo 1: -20532129137 Exemplo 2: -0.6546783768647119 |
Year(<dateValue>) | Retorna o ano da data fornecida
| Exemplo 1: fieldname é um campo de tipo Date com um valor de 09 Oct 2017 04:30:43 pm Year($join["fieldname"]) Exemplo 2: fieldname é um campo de string formatado como uma string ISO 8601 com um valor de 2012-09-27 Exemplo 2: fieldname é um campo de string formatado como uma string ISO 8601 com um valor de Year(Date($target["fieldname"])) | Exemplo 1: 2017 Exemplo 2: 2012 |
Operadores condicionais
As declarações condicionais podem utilizar os seguintes operadores:
| Operador | Explanação | Exemplo | Resultados |
|---|---|---|---|
a > b a < b | a é maior que b a é menor que b | 10 > 2 | Falso |
a >= b a <= b | a é maior ou igual a b a é menor ou igual a b | abs(-10) >= 10 | Verdadeiro |
a != b | a não é igual a b | abs(-3) != -3 | Verdadeiro |
a == b | a é igual a b | abs(-5) == 5 | Verdadeiro |
<condition1> || <condition2> | Condição 1 ou condição 2 é atendida. | (abs(-5) == 5) || (10 < 2) | Verdadeiro |
<condition1> && <condition2> | Condição 1 e condição 2 são atendidas. | (abs(-5) == 5) && (10 < 2) | Falso |
Exemplos de operador lógico
Além dos operadores condicionais, operadores mais avançados lógicos podem ser utilizados para ligar feições.
Obtenha mais informações sobre funções lógicas disponíveis no Arcade
| Função | Explanação | Exemplo | Resultado |
|---|---|---|---|
constrain(<value>,<low>,<high>) | Retorna o valor de entrada se ele estiver dentro dos limites determinados. Se o valor de entrada for menor que o valor baixo, retorna o valor baixo. Se o de entrada valor for maior que o valor alto, retorna o valor alto. | constrain( $target["distance"], 0, 10) constrain($join['Store dist'], 6, distância) | Retorna 0 se distance for menor que 0, 10 se distance for maior que 10, e caso contrário, distance. Retorna 6 se Store dist for menor que 6, distance se Store dist for maior que distance, e caso contrário, Store dist. |
iif(<condition>,<true value>,<false value>) | Retorna um valor se uma condição avaliar para true, e outro valor se esta condição avaliar para false. <true value> e <false value> podem ser o seguinte:
| iif($target["field1"] > $join["field2"], $join["field1"], 0) iif($target["field1"] > $join["field2"], iif($target["field2"] = 0, $join["field3"], $target["field4"]), 0) | Retorna field1 se field1 for maior que field2, e caso contrário, 0. Retorna o resultado da segunda função iif se field1 for maior que field2, e caso contrário, 0. |
when(<expression1> , <result1> , <expression2> , <result2> , ... , <expressionN> , <resultN>, <default>) | Avalia uma série de expressões na sua vez, até que uma avalie para true.
| when(($target["field1"] + 10) > 1, 1,($join["field2"] + 10) > 2 , 2, $target["field3"]) | Se field1 + 10 for maior que 1, retorna 1. Se não, marque se field2 + 10 for maior que 2. Se for, retorna 2. Se não, retorna field3. |
decode(<conditional val> , <case1> , <result1>, <case2>, <result2>, ... <caseN>, <resultN>, <defaultValue> ) | A função decode avalia uma expressão e compara seu valor com os parâmetros subsequentes. Se a expressão corresponder, ela retorna o próximo valor de parâmetro. Se nenhuma corresponder, há a opção do último parâmetro para ser um valor de retorno padrão.
| decode($target["field1"] + 3 , $join["field1"], 1, $target["field2"], 2, 0) | Compara a igualdade entre o valor condicional field1 + 3 e case1 field1. Se true, retorna 1. Se false, compara a igualdade entre field1 + 3 e field2. Se true, retorna 2; caso contrário, retorna 0. |