!!

Docum

entation

!!

!!info@

terranea.de,,,2,

! ,Cities,are,Europe's,economic,centres.,Today,

more,than,70%

$of$all$Europeans$live$in$cities,,tow

ns,and,suburbs,and,urbanisation,continues.,How

ever,,the,high,concentration,of,people,and,econom

ic,activities,

cause,significant$

environmental$

pressures.,Increasing,

traffic,$waste,,and,noise,are,only,few

,examples,to,

mention.,The,large,and,grow

ing,size,of,the,urban,population,,cities',econom

ic,assets,and,the,com

plexity,of,city,systems,m

ake,urban$areas$highly$vulnerable$to$clim

ate$change.,

To,reduce,the,urban,exposure,and,vulnerability,to,clim

ate,change,,adaptation,measures,are,

required.,Using,

and,expanding,

green$infrastructure,such,as,parks,,forests,,w

etlands,,and,green,roofs,is,one,instrum

ent,increasing,the,urban,resilience.,Especially,street$trees$provide$a$large$num

ber$of$environmental$and$social$

benefits$to$citizens.,,

They,include,the,reduction$of$air$pollution,,tem

perature$regulation,and,a,cooling$effect,,noise$reduction,,flood$protection,,provision$of$oxygen,,

sequestration$of$

CO2,

and,the,

prevention$of$soil$erosion.,

,,Social,benefits,include,the,provision,of,recreational$

areas,,shade,,

aesthetic,pleasure,,and,street,safety.,M

oreover,,studies,have,show

n,that,people,who,live,

in,neighbourhoods,with,a,higher,density,

of,trees,

on,their,

streets,report,

significantly$higher$

health$perception,

and,significantly$less$cardioBmetabolic$

conditions.,,

Nevertheless,$

urban$street$

trees$are$

under$constant$pressure.,Hot$summers,,

storms,,flash,floods,and,drought,put,

trees,under,stress.,Imperviousness,and,

compression,

limit,

the,infiltration,

of,water,into,already,nutrientBpoor$soils.,

Damages,to,the,root,system

,through,construction,,road,salt,,(air)$pollution,,and,pests,reduce,their,vitality,,lead,to,illness,and,the,dying,of,trees.,

The$itreeBapp$aims$at$creating$m

ore$aw

areness$am

ong$citizens$

about$the$

role$of$street$trees$and$the$invaluable$ecosystem

$services$they$provide.$$$

The,app,is,demonstrated,w

ith,data,from,

the,city,of,Hamburg,,Germ

any.,

!!

!!info@

terranea.de,,,3,

! ,!

!

After,starting,the,itreeKapp,you,w

ill,enter,the,map,view

.,

!

By,clicking,on,the,layer,symbol,

in,the,lower,right,corner,,a,

window

,opens,showing,you,all,

layers,available,to,the,app.,They,include:,• O

penStreetMap,

• Copernicus,Satellite,Im

agery,• Air,Q

uality,Index,• Green,Spaces,• Parks,• Trees,• U

ser,Position,All,layers,can,be,show

n,individually,or,overlaid.,

!!

!!info@

terranea.de,,,4,

!

!

This,shows,the,

OpenStreetM

ap,(OSM

),layer.,It,is,used,as,background,inform

ation.,,

!

This,shows,the,Copernicus,very,

high,resolution,satellite,im

agery.,It,is,also,used,as,background,inform

ation.!

!!

!!info@

terranea.de,,,5,

!

!

This,layer,shows,the,Air,

Quality,Index,of,Ham

burg.,The,data,is,read,hourly,from

,the,related,service.,A,heatm

ap,of,the,station,data,is,created,onKtheKfly.,

!

The,Green,Spaces,layer,shows,

the,city’s,cadastre,of,green,spaces.,Different,types,like,gardens,,parks,and,playgrounds,are,available.,

!!

!!

!!

!!info@

terranea.de,,,6,

!

!

The,tree,layer,includes,all,trees,located,on,public,land,that,is,ow

ned,by,the,city.,Each,tree,is,visualised,as,a,green,circle.,The,circle,size,refers,to,the,tree’s,crow

n,size.,,By,clicking,on,a,tree,(green,circle),,the,attribute,w

indow,

opens.,This,includes,inform

ation,on,the,species,,its,year,of,planting,and,age,,treetop,diam

eter,and,trunk,circum

ference,and,location,inform

ation.,,Additional,inform

ation,is,provided,from

,Wikipedia.,By,

clicking,the,READ,MORE…

,link,you,are,forw

arded,to,the,related,W

ikipedia,page.,,,,

!

At,the,bottom,of,the,attribute,

window

,,a,link,forwards,you,to,

the,section,on,ecosystem,

services.,In,the,near,future,,specific,ecosystem

,values,will,

be,published,for,each,tree.,,,You,can,also,take,a,photo,of,the,tree,using,your,sm

artphone.,Click,the,photo,sym

bol,on,the,right,and,your,cam

era,opens.,Take,a,photo,and,w

hen,you,agree,with,the,

data,policy,you,can,upload,the,photo,to,our,server.,Your,photo,is,now

,shown,instead,of,

the,placeholder,image,at,the,

top.,In,case,several,people,take,a,photo,of,the,sam

e,tree,,a,slideshow

,will,show

,all,available,photos.,,,,To,close,the,attribute,w

indow,,

click,the,white,X,in,the,right,

corner,at,the,top.,!

!!

!!info@

terranea.de,,,7,

!

!

The,parks,layer,shows,you,

the,location,of,all,parks,in,Ham

burg.,Click,on,a,park,sym

bol,and,new,window

,will,open.,

!

The,new,window

,tells,you,the,nam

e,of,the,park,and,a,short,description.,By,clicking,the,READ,M

ORE…

,link,you,will,be,

forwarded,to,a,related,page,of,

the,city,with,detailed,

information,about,the,park.,

,To,close,the,attribute,window

,,click,the,w

hite,X,in,the,right,corner,at,the,top.!

!!

!!info@

terranea.de,,,8,

!

!

By,clicking,on,the,three,horizontal,lines,in,the,topKleft,corner,besides,the,itreeKapp,title,you,open,the,appKmenu.,You,can,use,the,

menu,to,go,to,the,different,

pages,available.,These,are:,• M

ap,• About,• Ecosystem

,Services,• Data,Privacy,• References,• Installation,• Feedback,• Settings,,To,close,the,m

enu,just,sw

ipe,with,your,finger,over,

the,window

,to,the,left,or,click,in,the,m

ap,window

.,!

!

The,ABOUT,page,provides,you,

with,som

e,background,inform

ation,about,the,app,and,the,M

yGEOSS,project.!

!!

!!info@

terranea.de,,,9,

!

!

The,page,about,ecosystem,

services,provides,you,with,a,

short,info,about,the,topic,and,few

,references,if,you,would,like,to,learn,m

ore,about,the,subject.,

!

The,feedback,page,allows,you,

sending,us,feedback,on,a,specific,tree,or,on,the,app,in,general.,By,clicking,SEN

D,you,are,asked,w

hich,mail,service,

you,want,to,use,for,sending.,

The,list,of,services,depends,on,your,operating,system

,and,device,(e.g.,Em

ail,,Gmail,,etc.).,

!!

!!info@

terranea.de,,,10,

!

!

The,installation,page,provides,you,w

ith,a,short,description,how

,to,install,and,uninstall,the,app,on,your,device.,!

!

The,data,privacy,page,is,im

portant.,Here,we,inform

,you,about,the,data,policy,that,you,have,to,agree,on,w

hen,sharing,a,photo,w

ith,us.,Please,be,aw

are,,that,our,app,doesn’t,collect,any,private,inform

ation,from

,your,device.,Just,a,photo,,in,case,you,take,one,and,you,agree,to,share,it.!

!!

!!info@

terranea.de,,,11,

!

!

The,itreeKapp,uses,several,open,datasets,from

,different,sources.,The,references,page,provides,you,w

ith,details,about,the,data,and,their,sources,and,licenses.,!

!

The,settings,page,allows,you,to,

activate,your,device’s,GPS.,When,activated,you,can,use,

the,Location,button,in,the,map,

window

,and,your,location,is,show

,on,the,map.,This,allow

s,you,to,identify,the,tree,you,are,just,standing,in,front,of.,,In,the,slideshow

,section,you,can,m

odify,the,speed,of,the,slideshow

.,It,is,the,photos,show

n,for,each,tree,(when,

taken,and,shared,by,app,users),at,the,top,of,the,tree’s,attribute,page.,!

!!!

!!

!!info@

terranea.de,,,12,

! !Setup:$$Prerequisites$$

• Node.js,

• polym

erKcli,$Steps$$

• Clone/dow

nload,the,repository,to,your,machine,

• Change,the,current,directory,to,server,<cd,Server>,

• Start,the,server,w

ith,the,main.js,file,<node,m

ain.js>,,,Install$the$App:$,Open,the,itreeKapp,in,your,brow

ser,,go,to,the,settings,and,click,on,"Add,to,homescreen".,The,app,w

ill,now,be,installed,on,your,

device,as,a,native,app.,$Uninstall$the$App:$

,To,remove,the,itreeKapp,,you,have,to,delete,it,from

,the,homescreen,of,your,device.,

,$