Skip to main content
All CollectionsFAQ
Stop visit detection & geofencing in Visibility Hub
Stop visit detection & geofencing in Visibility Hub

This article explains how Visibility Hub defines geofences to detect stop visits and how users can adjust these geofences

Florian Ransmayr avatar
Written by Florian Ransmayr
Updated over 2 months ago

In Visibility Hub, it's all about detecting stop visits using state of the art technologies and involving different stakeholder on the supply chain. We want to give you some insights into the methodology and explain what it takes to accurately track transports.

What are geofences

One common definition is:

"A geofence is a virtual boundary defined around a real-world geographic area. This boundary can be dynamically generated, as in a radius around a point location, or a predefined set of boundaries. When a device that is equipped with GPS, RFID, Wi-Fi, or cellular data enters or exits this boundary, it triggers an event."

How are geofences used in Visibility Hub

Such a triggered event tells Visibility Hub that the vehicle is now near a stop location, which is primarily used for:


Stop visit detection: A vehicle takes a break inside a geofence which is used to detect a stop arrival as well as a vehicle leaving the geofence, which is used to detect stop departures. A break is defined as "the vehicle spends some time in the geofence without movement". Have a look here to learn more about this topic.

A vehicle break inside the stop's geofence is used to trigger the arrival and departure

Limited vs. standard visibility sharing: In order to know when Visibility can share it's standard visibility (which in short means the track on the map as well as the ETA for the next stop) across the involved stakeholders, first and last stop visits of a given transports are important. Have a look here to learn more about the differentiation of limited vs. standard visibility.

Stop visits are detected when the vehicle breaks inside a geofence.
Standard visibility is shown between first and last stop visit.

Geofence sizing based on address data quality

When Visibility Hub receives stop addresses within a transport, these addresses need to be converted first into geocoordinates (latitude and longitude). During this process, the address data quality is evaluated, which results in different geofence sizes: The better the address quality, the smaller the geofence. And vice versa: If the address quality is bad, the geofence size will be bigger.

The reason for this behavior is: If the location couldn't be exactly determined based on the input stop address data provided by the customer, we try to still catch the stop visit, even though the location might not be 100% correct.

Example for good address quality:

Heidenheimer Str. 55/1, 89075 Ulm, Germany
E.Leclerc CHAPONNAY, 85 Av. de Chaponnay, 69970 Chaponnay, France
Universal Studios Singapore, 8 Sentosa Gateway, Singapore 098269

--> All address components are provided, the order is maintained, no typos or abbreviations.

Example for bad address quality:

Straße, 62000, Ort1, DE
12-331, PL
Transporeon London, London

--> Address components missing, order is mixed up, street is abbreviated, not useable numbers.

The tradeoff to make is: Creating a smaller geofence in order to have more accurate arrival/departure times based on stop visit detection but potentially missing a stop visit vs. having bigger geofences in order to at least capture the visit but having less accurate arrival/departure times.

Different geofence sizes are used to capture as many stop visits as possible.

Note: All geofences that are created based on input address data are circular geofences. Polygonal geofences can be created by the user, have a look below how to get there!

Geofence customization

Customers, who provide the transport data to Visibility Hub, can use their own geofence definitions to configure shapes and sizes.

Note that you need an admin user role in Visibility Hub to be able to customize locations.

Customization options

You can customize your locations in various ways:

  • Geofence size: Smaller size for more accurate arrival/departure times. Bigger size to capture more stop visits in case of e.g. sparse GPS data.

  • Geofence shape: While circular geofences are the most common ones, you can define your exact own custom area which should be used for stop visit detection. Have a look here to learn more about that.

  • Linked addresses: All addresses received as part of your transport stops that are enclosed by the geofence you have defined are called "linked addresses". Those can be manually added as well, using the Visibility Hub Places Management API as described below. Have a look here to learn more about that.

  • Reference id: You can set your own reference id for the Place, so that you can refer to it during transport creation. Have a look here to learn more about that.

The Visibility Hub Places feature can be used to customize the location of a transport stop

Data input

You can customize locations in two ways:

  1. Visibility Hub application: Managing Places directly from the Visibility Hub user interface. Have a look at this article to learn more.

    The list and map view of the Visibility Hub Places feature

  2. Visibility Hub Places Management API: An interface, set up between your inhouse system and Visibility Hub to manage Places. This is especially useful if you already manage locations in your inhouse system and want to make them available for Visibility HUb to improve the tracking experience.
    Have a look at our API documentation, where you'll find a user guide as well as the specifications.

Various interface options allow you to automate visibility workflows

Additional tracking features

Not everything goes right all the time when it comes to transport tracking:

Stop addresses might not be correctly defined, the execution stop order is different compared to what is defined in the transport plan, GPS data is received too late or not accurate enough to mention a few common ones.

The Visibility Hub internal tracking engine offers features to track as many transports as possible, even though the input data might not be as accurate as expected:

  • Missed arrival/departure: When a certain transport stop visit is confirmed by an event or by a vehicle break in the geofence, but the departure couldn't be confirmed, Visibility Hub will skip the departure for this stop and will continue tracking and providing ETA information towards the next in-line stop. This can happen if the GPS data is interrupted or a stop arrival was confirmed by an event and GPS data is only received later. Same goes for arrival: If only the departure is detected, the arrival will be skipped.

  • Close by breaks: When a vehicle is near a certain stop geofence, but no break has been recorded inside the geofence itself, Visibility Hub still acknowledges the stop visit some time later when it's very likely that the vehicle will not enter the stop geofence (for example when it's already heading to the next stop) directly. For customer defined geofences (= Visibility Hub Places), this is not used, as we trust that customers know the exact location of a geofence anyway.

  • Overlapping transport stops: When we have multiple transports from the same customer with similar stops that overlap time wise (by stop timeslots) and/or location wise (ie. the geofences overlap) and are executed by the same vehicle, we will only acknowledge the arrival to the stop that has earlier timeslots. This scenario usually appears for short, inner city transports and is known as "Tour Association". Have a look here to learn more.

  • Stop order auto updates: When Visibility Hub receives a transport, the transport creator defines a so called "stop order", which tells Visibility Hub which stop the vehicle is heading to next. This is important to know for the ETA calculation: If we don't know the next in-line stop, we don't know to which location we should calculate the ETA to. Sometimes, the transport creator doesn't know the exact plan how the carrier will visit the stops, so the actual stop order might be different from the planned stop order. If Visibility Hub detects a stop visit that is not in-line with the initial order, the order will be updated accordingly and the ETA is calculated to the next in-line stop automatically.

  • Overlapping geofences: When there are nearby locations where the geofences overlap to some extent, Visibility Hub is still able to know which stop visit to detect: The nearest geofence center is chosen based on the closest vehicle break. This is calculated in real time when the vehicle takes such a break in the overlapping geofences.

... and many more!

If you notice a behavior that you can't explain yourself, reach out to our support, they will be happy to assist you.

Did this answer your question?