Creating a Project & Configuring Project-Level Settings

Before you can explore further with the WasteHero Platform, the first step is to create your first project on the platform. This article will guide you through everything you need to know to create a project and edit project-level settings.

Table of Contents

Creating Your First Project

Asset Management Settings
- Container Types
- Waste Fractions
- Container Meta Types
- Sensor Measurement Types

Operation Management Settings
- Pickup Settings

Bulk Imports
- Import Containers
- Import Containers Weight


Creating Your First Project

In this section, we'll guide you through creating your first project and what you need to know to make your general settings.

In the main menu, head to Settings > Project > + Create.

Here you can add all the details and preferences for your project. For guidance on each field, refer to the table below.

*Asterisks indicate a required field.

LabelDescription
Project name*Give your project a memorable name, e.g. Aarhus Inner City. Your project name will appear in the project selection pane in the menu.
Address*Enter an address for your project. The map view in Asset Management will be set to the default address you add here. Type in your address and select it from the suggested list, or switch to manual mode to type in the latitude and longitude. If you're using manual mode, be sure to add a custom name label that will show as the address.
Project description (optional)Add a description that explains more about your project.
Upload Logo (optional)Upload an image for your project.
Country*Select your country from the dropdown menu.
CRM Enabled*If you will be using WasteHero's Customer Service System (CRM), toggle on this option.
Time zone*Select your timezone from the dropdown menu.
Currency*Select your currency from the dropdown menu.
Hour format*Select your preferred time format from the dropdown menu.
Distance*This will dictate how the route distance is shown in Operations Management. Choose between Kilometres (KM) and Miles (MI).
Weight*This will dictate which unit of measurement you'll use for any weight information throughout your project, e.g. weight collection data and historical weight data imports. Choose between Kilograms (KG) and Pounds (LBS).
Volume*This dictates which unit of measurement you'll use for any volume information throughout your project, e.g. container volume and vehicle capacity. Choose between Liter (L) and Cubic Foot (FT3).
Temperature*This will dictate how you view any temperature information collected from add-on sensors. Choose between Celcius (CĀ°) and Fahrenheit (FĀ°).


Click Submit to add your first project!

You'll see the message 'project successfully created'.

Now it's time to manage the project-level settings for asset management and operation management.


Asset Management Settings

Within your newly created project, click across to the Asset Management tab.



The project-level asset management settings include:

Container Types

Waste Fractions

Container Meta Types

Sensor Measurement Types

Import Containers

Import Containers Weight

These settings affect everything to do with managing your containers. From the size of the containers to the waste they collect, and which vehicles they are compatible with for collection.

We'll now walk through each of these settings one by one and show you exactly how to set them up!

Note: We will cover Import Containers and Import Containers Weight as the last section of this article. This is because we first need to set up Operation Management settings. More on that later!


Container Types

Container Types are templates for containers that share the same dimensions, volume, emplacement, vehicle coupling and emptying times.

You may have 200 identical containers on the street. With container types, you can create the settings regarding the requirements speeding up the registration for the individual containers later on.

You'll need to create as many container types as you have different types of containers within your project.

Example: Container Type



Let's take a look at how to create a container type:

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Container Types.

Click the blue + button.

Here you can add all the details for your container type. For guidance on each field, refer to the table below:

LabelDescription
Name of the container type*Give your container type a memorable name of your choice, e.g. Frontloader 700L
Emplacement*Choose between surface, semi-underground and underground to indicate where the container is placed.
Vehicle coupling*Select all vehicle coupling methods that apply to this container. This indicates the ways in which the container can be collected by a vehicle. Vehicles will only be assigned to collect containers that share their vehicle coupling setting - so this is very important! Select all vehicle coupling methods that apply: Without, Crane one ring, Crane double ring, Crane mushroom, Front side lift, Side lift.
Emptying time*Set the amount of time it takes to empty the container. Choose from our pre-set options of surface - 2 minutes or underground - 15 minutes, or add a customized emptying time in minutes.
Volume*Enter the volume of the container. Select from the dropdown. Options include 120 L to 36 m3, or customize the volume by entering the volume (magnitude) and desired unit of measurement (unit).
Internal dimensions*If you have selected an existing volume from the list in the previous step, the system will provide the internal dimensions. If you have entered a custom volume for your container, you'll also need to add the internal dimensions for the container. If rectangular, enter = Height, Length, & Width in metres. If cylindrical, enter = Height & Diameter in metres.


Click Submit to save your container type.

All saved container types will appear in the list on the left of the screen.

Repeat this process for all the different types of containers in your project.


Waste Fractions

In Waste Fractions, you'll create the type of waste being collected and determine the method of disposal. There is the option to add the weight to volume ratio in order to calculate the approximate weight of waste.

You will need to create a waste fraction for every type of waste being collected in your project.

Example: Waste Fraction



Let's talk a look at how to create a waste fraction:

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Waste Fractions.

LabelDescription
Name*Enter the name of the type of waste being collected, e.g. Paper
Waste Substance*Select the type of waste substance being collected. Choose between gaseous, liquids, radioactive matter and solid.
Waste Disposal Method*Select the method in which the waste is disposed of; Biological treatment, Chemical treatment, Physical treatment, Combustion, Recycling, Reusable, Landfill, Special, or Other.
Waste Type (optional)Select the type of waste. Choose between beverage and food cartons, hazardous, residual, cardboard, food, glass, metal, paper, plastic, and textile.
Volume to Weight Ratio (optional)If you know it, enter the volume to weight ratio in decimal format for this waste fraction, e.g. 0.78. Otherwise, just leave this section empty.


Click Submit to save your waste fraction.

All saved waste fractions will appear in the list on the left of the screen.

Repeat this process for all the different types of waste being collected in your project.


Container Meta Types

Container Meta Types are like a tagging system for the containers in your project. It allows you to filter a group of containers by the tag of your choice.

You could create meta types such as 'residential' and 'commercial' to be able to identify different groups of containers within the same project.

You can create as many container meta types (tags) as needed for your project! These tags will be attached later on when creating individual containers.

**Example: Container Meta Type**



Let's take a look at how to create a container meta type:

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Container Meta Types.

All that's required for this setting is a name for your tag:

LabelDescription
Name*Give your tag a meaningful name, e.g. 'residential' or 'commercial'


Click Submit to save your Container Meta Type.


Sensor Measurement Types

Sensor Measurement Types is where you'll decide how often the sensor takes a measurement if you're using fill-level sensors. The frequency of measurements directly impacts battery life, so think carefully about how often you need to measure.

WasteHero recommends measuring 2 times per day for low traffic areas and 4 times per day for high traffic areas.

Sensor measurement types will be added to containers later on when attaching a sensor to an individual container.

You can create as many sensor measurement types as needed for your project. Let's take a look at how:

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Sensor Measurement Types.

LabelDescription
Measurement type name*Give your custom measurement a memorable name, e.g. three measurements
Measurements per hour*Choose how many measurements you want the sensor to take per hour (1 - XX:00 or 2 - XX:00, XX:00).
Choose hours*Choose the hours of the day you want the sensor to take a measurement, e.g. 09:00, 13:00, 17:00
Exclude daysAre your containers not used on certain day/s of the week? Select the day/s to be excluded in the dropdown list and a measurement won't be taken on that day.
Exclude periodIs there a recurring period in the year that you want to exclude measurements being taken on? It's possible to exclude it by selecting a date range here.


Click Submit to save your sensor measurement type.

That's it for the Asset Management settings! Keep reading for Operation Management Settings and Bulk Imports.


Operation Management Settings

Now let's take a look at the project-level Operation Management settings.

Within your newly created project, click across to the Operation Management tab.



The project-level operation management settings consist of pickup settings. These pickup settings will eventually be applied to individual containers and can be used in the bulk import of containers.

We'll now walk through exactly how to set up your pickup settings!


Pickup Settings

When we talk about pickup settings, we'll often use the term 'static routes'. Static routes refer to a fixed collection schedule, for example, containers that are collected every second Tuesday.

In contrast, you'll also see the term 'dynamic routes'. Dynamic routes refer to containers that are collected based on WasteHero's prediction algorithm, which can be fuelled by weight and/or sensor data. Dynamic routes are named as such due to their changing nature. They don't follow a fixed schedule, the collection days and times will change depending on the prediction algorithm.

You can create as many pickup settings as are necessary for your project. Let's find out how!

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make pickup settings for. Click Operation Management then Pickup Settings.

Click + Create

Here you can add all the preferences for your pickup settings. For guidance on each field, refer to the table below.

LabelDescription
Project*Select the project from the dropdown that you would like to create the pickup settings within.
Name*Here you can name your pickup setting. Give it a meaningful name, e.g. Tuesday odd weeks.
First collection*Select the date that the containers will be collected for the first time using the WasteHero Platform. It's important this is correct so that the Platform can generate correct routes for your drivers.
Collections per week*Here you can choose between 1-7, which tells the platform how many times per week the container must be collected.
Weeks between collections*Here you decide how many weeks must elapse between container collections. If the static route is once per week, select one. If the static route is every 2 weeks, select 2.
Monday - Friday checkboxes*Check off the days that containers should be collected. Enter a start and end time (collection window) that the containers should be collected within.


Click Save. Congratulations! You've now created your first pickup setting.


Bulk Imports

In this section, we'll outline how you bulk import containers to the platform, as well as how to bulk import historical container weight data to the platform. Let's get started!


Import Containers

The bulk importing of containers allows you to add multiple containers to the system at one time. This is a very handy feature when you have hundreds if not thousands of containers you want to quickly import to the system.

Before you can import containers, you need to have container types and waste fractions configured in your asset management settings, and pickup settings configured in your operation management settings.

The basic idea of importing containers is to create an excel spreadsheet with system-generated IDs in place of your container types, waste fractions and pickup settings. You should also have the full street address, container name/number, and any desired description ready to go for the import.

Let's take a look at how to import containers:

Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Import Containers.

Click + Import Containers

This will bring up a modal explaining how to set up an excel spreadsheet for the import.

Step 1. Download 'The Import Example File'.

Download 'The Import Example File'. This provides an example of what a completed example file should look like. Delete the example data, leaving the column titles. You can choose to add another column with the label description, which is an optional field.

This will now be used to set up your spreadsheet for import.

Step 2. Download 'The Import Type Ids File'.

Download 'The Import Type Ids File'. Each container type, waste fraction and pickup setting you have already created in your project settings will have a respective ID. You will use these IDs in place of the names of the different container types, waste fractions and pickup settings in your import.

You can see the example below includes:

2 container types (Frontloader 770L and Surface Bin 240L)

2 waste fractions (Paper and Plastic)

2 pickup settings (Once per week and Every 14 days)

Each of these types has its respective ID.

The ID for the Frontloader 770L container type in this example is:

Q29udGFpbmVyVHlwZVR5cGU6NDA1Mg==




Step 3. Add Your Data and Transfer the Import Type IDs

In the example spreadsheet that will now be used as the base for your import, add in your container information in line with the following column titles as shown below.

Create a new line for each individual container.

Available Columns

container_id


This ID describes what container id the container should be created with. Required when creating, required when updating. This should reflect whatever mix of words and numbers you use to refer to your container.

container_type_id


This ID describes what container type the container should be created with. Required when creating, optional when updating. This should reflect the system-generated Container Type ID given in the Import Type IDs file.

waste_fraction_id


This ID describes what waste fraction the container should be created with. Required when creating, optional when updating. This should reflect the system-generated Waste Fraction ID given in the Import Type IDs file.

location_name


You can choose to use 'location_name' which should be the address with country (eg. Europaplads 16, 8000 Aarhus, Denmark), or you can choose to use the columns 'location_latitude' and 'location_longitude' (or 'location_latitude_longitude' with comma separation). Required when creating, optional when updating.

pickup_setting_id


This id describes what pickup setting the container should be created with. Optional when creating, optional when updating. This should reflect the system-generated Pickup Setting ID given in the Import Type IDs file.

description


Use this field to add a description to a container. Optional when creating, optional when updating.


Be sure to switch out the names of the container types, waste fractions, and pickup settings with the Import Type IDs.

For a small number of containers you can copy and paste the ID values, but if you have a large number of containers to import, consider using the VLOOKUP function in Excel to save on manual work!

You should now have an excel spreadsheet ready for import. It should resemble the below example:



Step 4. Save your File for Import

You must save your spreadsheet as a .csv file in utf-8 format.

Step 5. Upload the File to the Platform

Return to the Import Containers section on the platform (Go to Settings in the main menu, and press Projects. Click Edit next to the project you want to make settings for. Click Asset Management then Import Containers.)

Select the relevant project.

Add the delimiter depending on which operating system you're using. For Windows OS, use a comma. For Mac OS, use a semicolon.

Windows OS Default DelimiterMAC OS Default Delimiter
,;


Click or drag your .csv file to upload your list of containers.

Here you can edit the settings for the import and whether you want to allow the creation of new containers, allow the update of existing containers and allow the update of container locations. For your first bulk import, you can keep all the boxes checked and don't need to make any changes.

Going forward, if you conduct another bulk import that includes existing container IDs, it's important that you check over these settings to avoid accidentally overriding existing data.



Click Submit to import your list of containers.

Refresh the page and you will see the status of your upload. If successful, the status will show as Completed.



If there has been an error in your bulk import, the status will show as Error. From here you can click Show to find further information on the error.



Step 6. View Your New Containers!

In the main menu, go to Asset Management then Containers.

You can now view your containers in the table view and map view. To view or edit an individual container, click the 3 small grey dots on the right side, then click Edit.




Import Containers Weight

Coming soon!
Was this article helpful?
Cancel
Thank you!