Having a reference to a Place in Visibility Hub can help you to work with and manage Places.
Context
Whenever you send new transports to Visibility Hub by the means you have chosen (which is usually an interface from your inhouse system), you have two options to define the locations of the transport stops:
Include the address data (street, house nr, city etc.) so that Visibility Hub can geocode the location (or alternatively provide geocoordinates directly).
Use an existing Place and it's location by directly referring to it.
The details of point 2 are described below.
How to
When creating a Place in Visibility Hub, you can set a reference ID by using the field "Set a reference ID" as shown in the screenshot below:
Note: Setting a reference ID is optional, and if you don't want to create one yourself, Visibility Hub will automatically assign one after you have created the Place. You can always change the reference ID later in case you see need.
Impact
When you refer to an existing Place using the field place_reference_id
(from the interface that you're using, see below) during the transport creation, Visibility Hub will directly use the address data, name and geofence definitions that were set up for the Place instead of geocoding the address and applying the system's geofencing logic.
Supported Interfaces
The following APIs support using the place_reference_id
: