Skip to content

How to use the app

EYELAND is an innovative app designed to collect georeferenced data on land cover, linear landscape elements, rural buildings and historic or culturally significant constructions to contribute to landscape conservation and to promote knowledge of our landscape and environment.

In this guide you’ll find all the necessary information to download, configure and use the app efficiently. We will guide you step by step from user registration to adding your data, allowing you to actively contribute to landscape monitoring.

Recordable elements

In order to ensure an organized and detailed data collection process, EYELAND divides recordable elements by category.
Each category allows users to monitor and record specific aspects of the rural landscape, contributing a more indepth analysis of our environment.

Below are our main categories:

AGRO FOREST

The Agro Forest category monitors agricultural and forested areas, collecting data on crops, pastures, forests and transitional spaces between natural and agricultural areas.

RECORDABLE ELEMENTS:

  • Agricultural crops (fields, vinyards, orchards, vegetable gardens)
  • Forests (Hardwood, conifers, mixed forests)
  • Transitional areas between forests and crops
  • Fallow or abandoned fields
  • Wetlands and riparian zones

How to distinguish each category:

  • Agricultural fields can be distinguished by the regular placement of crops and the presence of agricultural machinery or irrigation systems.
  • Forests can be distinguisehed by their dense vegetation and the presence of native and introduced arboreal species.
  • Wetlands and riparian zones can be found near bodies of water and are essential reservoires for biodiversity
RURAL BUILDINGS

Rural buildings represent our rural architectural heritage and provide fundamental information on the history and evolution of landuse.

RECORDABLE ELEMENTS:

  • Farmhouses and farms
  • Barns and silos
  • Other rural outbuildings
  • Buildings intended for agricultural production (olive-presses, cellars, dairies)
  • Abbandoned farmhouses and ruins

How to distinguish each category:

  • Farmhouses and farms generally have large internal courtyards and stalls.
  • Wind or water-powered mills.
  • Ruins are the remains of abandoned buildings, often covered by plant growth.
GREEN ELEMENTS

This category collects data on Linear and areal plant elements that play an essential role in biodiversity and the rural landscape.

RECORDABLE ELEMENTS:

  • Hedgerows (bushes and small trees in a linear structure)
  • Tree rows (single row of trees along roads or fields)
  • Wooded strips (linear formations wider than hedgerows or tree rows)
  • Wooded areas (large tree-covered areas)

How to distinguish each category?

  • Hedgerows are long and narrow, often used as windbreaks or natural borders.
  • Tree rows are composed of a single row of trees, often planted along roads or canals.
  • Wooded strips are denser and wider, with multiple rows of trees and bushes.
  • Wooded areas are portions of woodland, sometimes small in size, characterized by denser vegetation, including both trees and shrubs.
PAGGHIARI

Pagghiari are ancient stone buildings typical of the mediterannean, often used as shelters or agricultural storage.

Recordable elements::

  • Pagghiari in dry stone

How to distinguish each category?

  • Dry stone structures without mortar.
  • Usually round or quadrangular in shape.
  • Often found in the countryside, by vineyards or in hilly areas.
    TREES

    This category focuses on singular trees that may have particular environmental, historical or ecological importance.

    Recordable elements::

    • Monumental or centuries-old trees
    • Isolated trees of notable ecological value
    • Trees at high risk for cutting or disease
      LANDSCAPE

      This category examines the structure and visual impact of the rural landscape, taking into considerationboth natural and man-made elements

      RECORDABLE ELEMENTS:

      • Scenic areas and overviews
      • Structures with notable aesthetic or historic value
      • Combinations of green elements, buidlings and bodies of water that define the local landscape

        Recordable element interface

        The interface of the application for recording elements varies depending on the category of element selected during the registration phase.

        The only element that does not change across the different recordable elements is the application header during the registration process, which indicates the following points:

        A) Position: When clicked, it visually indicates the user’s location on the map through a blue icon.

        B) Geometric survey with point: Allows the user to visually mark the position of the element to be recorded on the map.

        C) Geometric survey with line: Allows the user to draw a line on the map—through multiple screen taps—to define the element to be recorded.

        D) Geometric survey with polygon or area: Allows the user to highlight the element to be recorded by drawing a geometric shape directly on the map through repeated screen taps.

        All variable interfaces for the recordable elements are shown below, each with its corresponding explanation.

        AGRO FOREST

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries.

        C) Photo: By clicking on the camera icon, the app will open your phone’s camera to allow you to take a photo of what you are recording.

        More information can be found in the tutorial at the bottom of this page.

        D) Landscape: Allows the user to indicate the type of landscape observed. This selection will determine the following options. For example, by choosing “Forest“, the app will display options specific to forest environments.

        Please note: The screen will display different options depending on which “Landscape” category was selected. Example: If “Landscape: Forest” was selected, the app will display choices relative to forest landscapes. For this example we will use the forest landscape option.

        E) Type of forest: Allows for a more precise classification of forest type. Only one option can be selected.

        F) Woods: If “Woods” was selected, this option specifies the type of wood according to its composition: Conifer or Hardwood. 

        G) Canopy cover estimate: Allows for an estimate of the density of the canopy cover (to what degree the sky is blocked by the canopy).

        H) Predominant vertical structure: Describes the vertical structure of the vegetation, or the overall distribution of height and development among individual plants

        I) Cultivation category: Indicates the type of cultivation, useful for management purposes.

        L) Terrain attitude: Specifies the topographical position of the observed area, which is important to determine water flow and landscape morphology.

        M) Presence of grounded deadwood: Used to indicate deadwood on the ground level, which can be useful as an indicator for ecology and biodiversity.

        N) Presence of leaves on trees: Specifies whether leaves are still present on trees, important for phenological purposes.

        O) Cancel button: Eliminates all information entered. Useful if you would like to start over.

        P) Enter button: Confirms and enters all data. This is the last step to complete the recording process.

        RURAL BUILDINGS

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries. 

        C) Photo: By clicking on the camera icon, the app will open your phone’s camera to allow you to take a photo of what you are recording.

        D) Address: Manually enter the building’s address. You may enter a street name, township or local landmark to identify the location. This information is complementary to the GPS data (already recorded above) and helps give an idea of location.

        E) Building type: Classifies the building according to their construction type. This information is necessary when considering any repair work from an architectural and cultural point of view. 

        F) State of conservation: Indicates the actual state of the building, useful when considering restoration, safeguarding or cataloguing of rural construction heritage. This classification is important for both tecnical and administrative purposes.

        G) In Use: Allows the user to specify if the building is currently in use or not. Useful to determine abandonment, decline or current activity.

        H) Type of use: Describes what the building is used for.

        I) Floor surface area: Text field where the user can manually insert the total floor surface area in square meters (m²). This is quantifiable data useful for volumetric classification.

        L) Max building height: Indicates the maximum height of the building, or the distance between the ground and the building’s tallest point (in meters).
        This must also be entereed manually. 

        M) Number of floors: Indicates the total number of floors in the building.

        N) Building type: Classifies the building according to its original or predominant use. 

        O) Materials: Specifies the main building materials used.

        P) Type of fixtures: Indicates the type of fixtures (on windows, doors, joints) 

        Q) Renewable energy presence: Allows users to indicate the presence of renewable energy systems (ex: solar panels, solar thermal panels, mini wind turbines). 

        R) Landscape information: The user can input observations on the landscape surrounding the building. Example: “hilly landscape”, “surrounded by vineyards”, etc. 

        S) Cancel button: Eliminates all information entered. Useful if you would like to start over. 

        T) Enter button: Confirms and enters all data. This is the last step to complete the recording process. 

        GREEN ELEMENTS

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries.

        C) Photo: By clicking on the camera icon, the app will open your phone’s camera to allow you to take a photo of what you are recording.

        D) Landscape context photo: This function allows the user to take two additional photos, useful for contextualizing the element recorded within the surrounding landscape. The user can photograph, for example, the surrounding view, the insertion into the landscape, or nearby plants.
        By clicking on these buttons, the app will open your phone’s camera.

        E) Object type: Classifies the green element into categories defined by the typology and organization of the plants.

        F) Complexity: Defines the vertical structure of the vegetation.

        G) Presence of invasive species: Allows users to indicate if there are invasive species present within the green element, which can alter its ecological balance.

        H) “If yes, which?”: Only needs to be filled if “yes” was selected for the previous option on invasive species. Allows the user to specify what type of invasive species are present, with photos to assisst in identification.

        I) Note: A space to indicate additional annotations on the recorded element or teh surrounding area. Can be used to indicate tecnical details, specific informatio or environmantal notes not considered in the standard options.

        L) Cancel button: Eliminates all information entered. Useful if you would like to start over.

        M) Enter button: Confirms and enters all data. This is the last step to complete the recording process.

        Pagghiari

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries. 

        C) Front-facing photo: By clicking on the camera icon, the app will open your phone’s camera to allow you to take a photo of the front of the entrance.

        D) Entrance detail: Used to take a close-up photo of architectural or decorative details on the doorway. This is useful for emphasizing materials, carvings, construction techniques or other artistically or historically significant details.

        E) Lateral view: Allows users to take a photo from a lateral view to document the building depth, wall thickness, and relationship between the entrance and the rest of the structure. This image adds to the visual documentation.

        F) Entrance: Here users can select the type of pagghiaru entrance observed. Each option is accompanied by illustrations for ease of identification.

        This section is important for morpholgical and type analysis of traditional building heritage.

        G) Notes: A space to indicate additional observations not covered by the previous options. Examples: “entrance is partially collapsed”, “no decorative elements”, “recent modifications to the structure”.

        H) Cancel button: Eliminates all information entered. Useful if you would like to start over.

        I) Enter button: Confirms and enters all data. This is the last step to complete the recording process. 

        TREES

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries.

        C) Photo: You can take two photos of the tree you wish to record. 

        • The first should be a picture of the whole tree.

        • The second foto can be of a significant detail (ex: leaf, bark, fruit or base of the trunk)

        Both photos are needed to correctly document the individual tree.

        D) Species: Type in the scientific name of the tree species (ex: Quercus robur). The use of correct botanical nomenclature is preferrred to maintain uniform data.

        E) Common name: Indicates the commonly used name for the species (ex: “Oak”, “Olive”, “Cherry”). Useful if the user does not know the tree’s scientific name.

        F) Trunk circumference in meters: Insert the trunk circumference in meters, generally measured at 1,30 m from the ground (a standard height also known as “chest height”). This information is important in order to estimate the tree’s age and volume. 

        G) Height in meters: Enter the estimated height of the tree in meters. This can be determined visually or using specific tools (inclinometer or specific app).

        H) Canopy diameter in meters: Indicate the maximum width of the tree canopy in meters (or the diameter of the canopy’s projection on the ground) This is useful for calculating shade cover and the space taken up by the tree.

        I) Notes: Free space to enter any additional observations about the tree.

        L) Cancel button: Eliminates all information entered. Useful if you would like to start over.

        M) Enter button: Confirms and enters all data. This is the last step to complete the recording process. 

        LANDSCAPE

        A) Position: Indicates the coordinates of your position and of the element you wish to record.

        B) Date and time: Indicates the date and time of the entry. This is necessary to maintain a timeline for all entries.

        C) Photo of the object: By clicking on the camera icon, you can take a picture of the natural element you wish to record. The photo should clearly show the object in center field (ex: vineyard, field, orchard). 

        D) Context photo: Allows the user to take a picture of the surrounding environment. This helps to understand the object’s placement within the landscape and its interaction with the landscape (ex: urban outskirts, hilly context, coastal area, etc.).

        E) Context: Allows the user to select the type of landscape the object is found in.

        F) Species: Classifies the type of agricultural element present. 

        G) Subspecies: Allows a more detailed crop classification.

        H) Landscape: Records a subjective aesthetic opinion on the observed landscape. This is used to record qualitative data

        I) Notes: Free pace in which the user can add observations not covered by the previous options.

        L) Cancel button: Eliminates all information entered. Useful if you would like to start over.

        M) Enter button: Confirms and enters all data. This is the last step to complete the recording process. 

        Our guide to using the app

        1. Introduction

        Eyeland is an application designed to facilitate the collection of environmental, landscape, and architectural data in the field through a simple and intuitive system.

        It is a tool developed within the framework of a university research project and intended for a selected audience: students, researchers, professors, or professionals directly involved in survey activities.

        The app allows users to record geolocated data, accompanied by photographs, and to classify them according to predefined categories. This contributes to the creation of a database useful for the classification of satellite images derived from remote sensing technologies, as well as for the analysis of the landscape and local heritage.

        2. Download and Installation

        To use Eyeland, you must install it on your mobile device. The app is available for both Android and iOS devices and can be downloaded directly from the official stores:

        It is important to ensure that:

        • Data connection or Wi-Fi is active
        • GPS is enabled
        • The app has access to the camera

        Once installed, the app will be ready for configuration.

        3. Login and Account Creation

        As a restricted-access application, Eyeland does not allow open registration or account creation for anyone who downloads it. To activate the app, users must request a personal password.

        This request should be made by contacting:

        Prof. Nicoletta Ripa
        University of Tuscia – Viterbo
        Email: nripa@unitus.it

        The professor will provide login credentials only to users involved in the project. Once the password is received, users will be able to log into the app.

        4. Interface Overview

        Once logged in, the user is welcomed by a simple interface, consisting of:

        • A geolocated Google Maps view, which displays the user’s real-time position in the field, making it easier to correctly place the data to be recorded.

        • The first button in the top right corner, used to search for nearby recorded elements.

        • The second button in the top right corner, used to geolocate your current position.

        • A “+” button in the bottom right corner, which allows the user to start a new survey form. Once clicked, the user can choose which module to fill out.

        • The side menu, accessible by clicking the three-line icon in the top left corner. This section provides access to additional functions essential for using the app.

        Side Menu Options in Detail:

        • Login: Allows you to enter or update your login credentials. If the app has been closed or updated, logging in again may be necessary.

        • User Type: Allows you to select the profile you want to use the app with: Beginner or Expert. This choice changes the visual appearance and functionality of the interface. The beginner interface is simplified, with reduced menus, to assist those less familiar with data collection. Expert users, on the other hand, have access to all features with extended options.

        • Method: This section allows users to consult the official data collection methodology adopted by the Eyeland project. By clicking this option, users can select the type of element to be recorded from those available in the app and previously listed on the following page (Agro-Forest, Rural Buildings, Green Elements, Pagghiari, Trees, and Landscape).
          In particular, Eyeland distinguishes three main types of data collection: point, line, and polygon or area.

        • Google Maps: Opens your current position in Google Maps, offering an alternative and more detailed view of the surrounding area, useful for orientation.

        • Gallery: Collects all completed and saved survey forms. Each item is accompanied by images, date, and GPS coordinates. The gallery can be used to review collected data.

        • Export Data: Allows users to export the locally collected data in CSV or other useful formats for statistical or cartographic processing. This is an important function for the analysis phase.

        • Update Data: Updates the application with any server-side changes (e.g., new dropdown menu categories, methodological adjustments, technical updates).

        • Connection Mode: Here, users can choose to work in online or offline mode. The offline mode is useful in areas with poor coverage, still allowing data to be saved locally for later submission.

        5. Data Collection – The Modules

        The app allows users to collect information divided into six thematic modules.
        Each module guides the user through the input of specific data using a combination of multiple-choice selections and descriptive fields.

        AGRO-FORESTRY
        Used to map landscape features, distinguishing between agricultural and forested areas. After taking a photo of the landscape, the user selects:

        • The type of landscape (agricultural or forested)

        • The following sections vary depending on the selected landscape type.

        • The type of forest or crop

        • The type of vegetation (Herbaceous or Arboreal) depending on previous selections

        • Fertilization status (only for agricultural landscapes)

        • Irrigation system (only for forested landscapes)

        • Estimated canopy cover (only for forested landscapes)

        • Dominant vertical structure (only for forested landscapes)

        • Crop class (only for forested landscapes)

        • Slope of the terrain (only for forested landscapes)

        • Presence or absence of deadwood and leaf litter (only for forested landscapes)

        RURAL BUILDINGS
        Used to collect information on buildings in an agricultural context. After photographing the structure, users enter data about:

        • Address

        • Type (modern, traditional, other)

        • State of preservation (from ruined to excellent)

        • Use (residential, warehouse, services, etc.)

        • Number of floors, height, surface area

        • Type of structure, materials, window frames

        • Presence of renewable energy sources

        GREEN ELEMENTS
        Designed for mapping hedges, tree lines, and wooded areas. After taking photos, the user specifies:

        • Type of object (hedge, tree line, wooded strip or area)

        • Complexity (single-layer, two-layer, multi-layer)

        • Composition (monospecific, multispecific)

        • Presence of herbaceous layer

        • Predominant species (herbaceous, shrub, tree)

        • Presence of invasive species (e.g., tree of heaven, false indigo) and a field to specify which species, if applicable

        PAGGHIARI
        This module is dedicated to traditional stone shelters. The user takes three photos (front, side, entrance detail) and selects the entrance type from eight categories illustrated in the relevant section of this guide. Notes can also be added.

        TREES
        Allows the recording of a single tree. Two freely framed photos are taken, and the following data is entered:

        • Species (scientific name)

        • Common name

        • Trunk circumference (in meters)

        • Tree height (estimated)

        • Canopy diameter

        • Optional descriptive note

        LANDSCAPE
        Intended for surveys in agricultural or natural contexts. Requires:

        • Photo of the object and its context

        • Context (Agricultural Production or Spontaneous Vegetation)

        • Depending on the selected context, the subsequent fields change.

        • Productive species or Vegetation species

        • Subspecies that vary based on the previous selection

        • Phenological state

        • Optional notes

        All modules end with a SUBMIT button to save the record, or a DELETE button to discard it.

        6. Data Consultation

        From the Gallery section in the side menu, users can access a list of completed survey forms, sorted by date. It is possible to view the associated images, read the entered details, and check the geolocation.

        The Google Maps option, on the other hand, provides a spatial view of the recorded points on the map.

        7. Profile Management and Settings

        In the side menu, users can configure the following:

        • Select the user type (Beginner or Expert)

        • Choose the thematic data collection module

        • Update local data

        • Enable or disable the connection for offline use

        There is no actual “user profile” since login credentials are provided and generated upon request.

        8. Support and Contacts

        For technical support, to report malfunctions, or to receive further instructions, please refer to the “CONTACTS” page on the following website.