Skip to main content
All CollectionsFAQ
Working with Places references
Working with Places references
Florian Ransmayr avatar
Written by Florian Ransmayr
Updated over 4 months ago

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:

  1. Include the address data (street, house nr, city etc.) so that Visibility Hub can geocode the location (or alternatively provide geocoordinates directly).

  2. 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:

  • Transporeon API for Shippers and Partners, see here.

  • Transporeon Shipment Create API, see here.

Did this answer your question?