Arcade: Calculando o Tempo Relativo para Popups e Simbologia

DennisJarrard

<\/HEAD>

Introdução<\/H3>Os campos de Data\/Hora adicionam uma dimensão totalmente nova à análise e visualização de dados espaciais. Eles especificam um ponto exato no tempo, semelhante a como as coordenadas especificam um ponto exato no espaço. Ao trabalhar com dados espaciais, gerar conteúdo relativo é algo que fazemos naturalmente o tempo todo. Por exemplo, podemos calcular uma área (como um buffer) que está ancorada em um ponto de entrada. Ou podemos medir uma distância de um ponto até outro objeto. Os resultados dessas análises são relativos, ou seja, são representações relativas baseadas em um ponto inicial exato. Por si só, as coordenadas exatas podem não significar muito, mas podemos derivar algo de significado e valor a partir delas.<\/P><\/P>O tempo funciona da mesma maneira. Ao falar sobre sua festa de aniversário, você poderia dizer “minha festa de aniversário em 15 de fevereiroº<\/SUP> de 2020, 18:00”<\/EM>... mas é mais fácil para a pessoa com quem você está falando entender se você simplesmente disser “minha festa de aniversário na noite passada”<\/EM>. Ou quando seu amigo pergunta “Quando os hambúrgueres estarão prontos?”, você poderia dizer “26 de fevereiroº<\/SUP>, 17:30”<\/EM>, quando “em cerca de 30 minutos”<\/EM> será muito mais eficaz para transmitir sua mensagem. Essas expressões são relativas a um ponto preciso no tempo: agora mesmo. No ArcGIS, datas e horas são especificadas precisamente, mas você pode incorporar representações relativas dessas datas e horas em seus mapas para torná-los mais fáceis de entender. Neste post, vamos olhar para manipular símbolos e popups para refletir o tempo relativo.<\/P><\/P>Incorporando Tempo Relativo na Simbologia<\/H3>Ao visualizar um feed ao vivo, podemos querer simbolizar os dados de tal forma que, à medida que os eventos envelhecem, eles se tornam cada vez menos visualmente significativos até desaparecerem completamente. Por exemplo, dê uma olhada no mapa abaixo. Importamos os MODIS Hotspots do Living Atlas, aplicamos um filtro para mostrar apenas as últimas 24 horas e então usamos Arcade para categorizar cada hotspot em uma categoria de "recência". À medida que esses hotspots envelhecem, eles diminuirão e finalmente desaparecerão da vista.<\/P><\/P><\/A><\/P>

<\/P>

Com Arcade, você tem a flexibilidade de trabalhar com seus campos de data de várias maneiras, personalizar limites e até calcular suas próprias novas datas derivadas. Continue lendo para aprender como construir este mapa exato para você começar.<\/P>

<\/P>

Primeiro, vamos configurar o mapa. Abra um novo webmap, clique em Adicionar >> Navegar Camadas do Living Atlas >> e pesquise "MODIS". O primeiro resultado deve ser uma camada de feição "Satellite (MODIS) Thermal Hotspots and Fire Activity" da Esri. Vá em frente e adicione essa camada ao seu mapa. No painel Conteúdo, clique no botão filtro para a camada MODIS e defina um filtro para "Data de Aquisição nos últimos 1 dia(s)". Aplicar Filtro. Isso filtrará os hotspots para estarem nas últimas 24 horas. Agora clique em Mapa Base no topo e selecione o mapa base Dark Gray Canvas.  Agora é hora de usar Arcade para construir nossa própria simbologia de tempo relativo para os hotspots.<\/P>

<\/P>

Para a camada MODIS, clique no botão Alterar Estilo. Expanda "Escolher um atributo para mostrar", role até o final da lista de campos e clique em "Nova Expressão". Isso abrirá o construtor de Expressão Arcade. Cole o seguinte código no corpo da Expressão.<\/P>

<\/P>

function<\/SPAN> determineCategory<\/SPAN>(<\/SPAN>value)<\/SPAN>{<\/SPAN>
if<\/SPAN> (<\/SPAN>value <=<\/SPAN> 4<\/SPAN> )<\/SPAN>{<\/SPAN>
return<\/SPAN> "1"<\/SPAN>
}<\/SPAN>
else<\/SPAN> if<\/SPAN> (<\/SPAN>value ><\/SPAN> 4<\/SPAN> &&<\/SPAN> value <=<\/SPAN> 8<\/SPAN>)<\/SPAN>{<\/SPAN>
return<\/SPAN> "2"<\/SPAN>
}<\/SPAN>
else<\/SPAN> if<\/SPAN> (<\/Span>value ><\//span> 8<\//span> &&<\//span> value <=<\//span> 12<\//span>)<\//span>{<\//span>
return<\//span> \"3\"<\//span>
}<\//span>
else<\//span> if<\//span> (<\//span>value ><\//span> 12<\//span> &&<\//span> value <=<\//span> 16<\//span>)<\//span>{<\//span>
return<\//span> \"4\"<\//span>
}<\//span>
else<\//span> if16 && value <=20){
        return 6"
    }
    else {
        return "6"
    }
}

var hours = DateDiff(now(),$feature["ACQ_DATE"] , "hours")
determineCategory(hours)‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍<SPaN cLass=line-numbers-rows>}  image-2 j-img-centered j-img-original" src="https:\/\/us.v-cdn.net\/6038851\/uploads\/legacyfs\/online\/483413_firefly.jpg" style="display: block; margin-left: auto; margin-right: auto;" \/><\/P>Selecione o mais intenso na rampa (o mais à direita) e defina o tamanho para 36. Repita esse processo para as outras categorias, trabalhando da direita para a esquerda na rampa, diminuindo o tamanho a cada vez em 6 (ex.: 36, 30, 24, 18, 12 e 6). Depois que todos os seus símbolos estiverem configurados como desejar, vá em frente e brinque com o controle deslizante de Transparência no painel Estilo para ajustar a aparência que você deseja. Quando tudo estiver pronto, seu painel Estilo deve ficar parecido com isto:<\/P><\/P><\/P>Clique em OK para confirmar tudo. E, voila!<\/EM> Agora você deve ter um mapa dos hotspots MODIS que envelhecem ao longo do tempo com base no tempo atual. Ótimo trabalho! Além disso, não se esqueça de salvar seu mapa!<\/P><\/P>

Incorporando Tempo Relativo nos Popups<\/H3>Você também pode configurar expressões de tempo relativo em seus popups e transformar uma data e hora precisas em algo um pouco mais amigável para humanos. Por exemplo, volte ao mapa de exemplo fornecido no início deste post. Se você clicar em um hotspot, no popup verá a data e hora exatas, bem como uma expressão relativa como "há 2 horas e 5 minutos". Essa segunda parte também está sendo calculada pelo Arcade dinamicamente. <\/P><\/P>Para configurar isso em seu próprio mapa, abra o painel "Configurar Popup" para a camada MODIS Hotspot. Clique em "ADICIONAR" na seção Expressões de Atributo. Isso abrirá outro construtor de Expressão Arcade. Cole o seguinte código no bloco de Expressão:<\/P><\/P>var<\/SPAN> myDateField =<\/SPAN> $feature[<\/SPAN>"ACQ_DATE"<\/SPAN>]<\/SPAN>;<\/SPAN>\n\nfunction<\/SPAN> getTimeDelta<\/SPAN>(<\/SPAN>alertDate)<\/SPAN>{<\/SPAN>\n var<\/SPAN> minutes =<\/SPAN> DateDiff<\/SPAN>(<\/SPAN>now<\/SPAN>(<\/SPAN>)<\/SPAN>,<\/SPAN>alertDate,<\/SPAN> "minutes"<\/SPAN>)<\/SPAN>\n var<\/SPAN> hours =<\/SPAN> DateDiff<\/SPAN>(<\/SPAN>now<\/Span>(),alertDate,"hours")
var days = DateDiff(now(),alertDate,"days")
if ((minutes <= 120<span class="punctuation token">){
return round(minutes) + " minutos atrás"
}
if ((minutes > 120){
if ((hours <= 48<span class="punctuation token">){
var tFloor = floor(hours)
var deltaMin = datediff(now(),dateadd(alertDate,tFloor,'hours'),'minutes')
return round(tFloor) + " horas e " + round(deltaMin) + " minutos atrás"
}
if ((hours > 48){
var dFloor = floor(days)
var deltaHour = datediff(now(),dateadd(alertDate,dFloor,'days'),'hours')
return round(dFloor) + " dias e " + round(deltaHour) + " horas atrás"
}
}
}
return </ span > getTimeDelta(myDateField)<<EMOJI_0 > >< spanclass='line-numbers-rows'>< span > <<EMOJI_1 > >< / span >< span > <<EMOJI_2 > >< / span >< span > <<EMOJI_3 > >< / span >< span > <<EMOJI_4 > >< / span >< span > <<EMOJI_5 > >< / span >< span > <<EMOJI_6 > >< / span >< span > <<EMOJI_7 > >< / span >< span > <<EMOJI_8 > >< / span >< span > <<EMOJI_9 > >< / span >< span > <<EMOJI_10 > >< / span >< span > <<EMOJI_11 > >< / span >< span > <<EMOJI_12 > >< / span >< span > <<EMOJI_13 > >< / span >< span > <<EMOJI_14 > >< / span >< span > <<EMOJI_15 > >< / span >< span > <<EMOJI_16 > >< / span >< span > <<EMOJI_17 > >< / span >< span > <<EMOJI_18 > >< / span >< span > <<EMOJI_19 > >< / span >< span > <<EMOJI_20 > >< / span >< span > <<EMOJI_21 > >< / span >< span > <<EMOJI_22 > >< / span >< span > <<EMOJI_23 >> </ Span ></ Span ></ CODE ></ PRE ></ P ></ P >< P >Esta expressão irá analisar o delta de tempo entre o tempo atual e a data no campo e usar alguma lógica condicional para construir uma expressão amigável para humanos desse delta. Esta expressão também foi construída para funcionar com Dias, mas como configuramos nossos hotspots para ver apenas as últimas 24 horas, não veremos isso. Mas você pode usar esta expressão como um modelo para outras camadas com as quais deseja trabalhar. Nesse caso, a única coisa que você terá que fazer é alterar a parte $feature["ACQ_DATE"] <\/_EM> para apontar para um campo de data na sua camada. <\/_P><\/_P>Clique em Testar para verificar se funciona, seguido por um clique exuberante no botão "OK". A partir daqui, configure os popups como quiser, certificando-se de que a expressão que você criou esteja visível. A expressão funciona como um campo, então você pode vê-la como parte de um estilo padrão de popup ou configurá-la como parte de um exibição de atributo personalizado.<\/P><\/P><\/P><\/P>Arcade oferece a flexibilidade de personalizar como as coisas são transmitidas ao seu público sem exigir que você modifique o esquema dos seus dados ou execute cálculos constantes de campo. Representações temporais são apenas um caso de uso disso. Esperamos que isso lhe dê um ponto de partida para explorar o que é possível. Obrigado por ler!<\/P><\/BODY><\/HTML>

MatthewKing

@DennisJarrard  Thanks for posting this.  I'm trying this out word for word in order to try/learn for a map that I'm working on.  When I paste the code that's in the "Incorporating Relative Time in Symbology" section I'm getting an "Unexpected identifier" error.  Would you happen to know why?