Guide Purpose:

• This guide IS designed to:
  • Shows how to pull and event association
  • Explain how Residential association works
• This guide IS NOT designed to:
  • Show how Commercial association works.

How to View an Event Association Through Collection API

1. Click on Collections
2. Search or Select the Tenant/Division
3. Insert Roue name or ID
   1. If none of the information above is not available, use other filters highlighted in orange
4. Click on the route
   

How to Open an Associated Event

1. Select the desired Status from the dropdown list
2. Input the Stop ID if known
3. Input the Stop Name if provided
4. Select the event
5. Click Open Event
   

How to View Commercial Association Event

Following the last step on the prior page, we can open an event and view association details of the event.

1. This section as highlighted in the BLUE box provides significant information about association of the details provided by our customer and how we associate them to the event we captured. Explained below are crucial information about how association is done
   1. Event ID: This is the identification number of the event that was created
   2. Stop ID: This is the Stop identification number that is used to identify a service that was done
   3. Name: This shows the end users/customer’s name
   4. Status: This shows the status of the service done. Below is the list of status of services done
      1. Completed: This means the system was able to match a service event GPS Lat/Lon with GPS point from the customer records within a schedule
      2. Extra Stop Completed: This means the system was able to match a service event GPS Lat/Lon with a GPS point from the customer records within the radius which the service was performed. The matched event is not part of the schedule
      3. Unknown Stop: this means the GPS location of the service completed could not be matched with any address within the customers records provided by the tenant
      4. Blocked: This means there was an obstruction, and the service could not be completed
   5. Route ID: This is the identification number attached to the route
   6. Stop Address: This shows the address attached to the Stop name
      
2. This section shows the longitude and latitude of the event that was captured as highlighted in the GREEN box
3. Click on the Map to generate a map view of the event association
4. Click on the enlarge icon to expand the map view
   

Commercial Association Explained

Commercial association focuses on matching events with customer records for our commercial line of business. Based on the vehicle types used for commercial purposes such as FEL and REL, the way association is done differs from that of residential. Commercial association does not consider parcel but the radius within the event has occurred. Within that radius, we look at what customer records provided by the tenants are available

 For commercial association, we consider several scenarios to determine association.

Scenario 1

This is when a schedule is provided, and we can match the customer record (Yellow Diamond) to the event.

Scenario 2

This is when we have multiple customer records within the 25m radius. To better associate the event to the right customer record, we will consider the material type. Material type is the type of material the vehicle is set to pick up such as Material Solid waste (MSW), Recycle waste, Organic waste and so on. Material type is assigned to each schedule/route provided by the tenant. So, looking at which customer record within the radius matches the material type the vehicle is set to pick up determines which customer record we match with.

Scenario 3

This is when scenario 1 and 2 fails, we go with the closest customer record to the event within the radius.

Below is an explanation of event association Icons

1. Orange Circle: This circle is the 25 meters radius we use to match an event to customer records
2. Yellow Diamond: This indicates customer records we have within the mapped region of the event
3. Green Trash Can: This indicates the physical location of the service event performed by the selected event we pulled from the route
   
4. Orange Line:  This indicates the direction in which the vehicle is moving
5. Blue Line: This is a GPS breadcrumb trail of the vehicle before an event