EBS: Travel Connectors - Expected Location Calculation Behavior and Configuration Options

Topic:

Expected location calculation behavior and configuration options when using travel connectors such as AMEX, ISOS, Anvil, et al. with Everbridge Suite.

Description:

Itineraries may contain multiple locations. When using a travel connector, upon ingestion, the traveler expected location is updated. This Knowledge Base Article explains how those locations are calculated based on how each option (event) is configured.

NOTE: h = hour/hours

Expected Locations:

Expected locations created from travel itineraries are set by default to start 24h before the traveler departs from a specific location and expire 24h after the traveler reaches a specific location.

For instance, if a traveler is leaving their home to take a flight, they will be considered at the airport 24h before the scheduled departure time for the flight. In the same way, a traveler reaching a destination will be considered at that location for 24h after the expected arrival date and time.

  • For flight and train segments, two expected locations are created. (See the special case for Transit under Expected Location Calculation for Transit below.)
  • For a car segment, two expected locations are created.
  • For a hotel segment, a single expected location is created.

The default times are configurable under Settings > Map > Location Data Sources > Defaults.

User-added image

The below table describes each event available, its default value, the configuration options for that event, and recommended (best practice) values for each event.

Event Default Value Configuration options (can be enabled individually) Recommended Best Practice
Hotel Check-In
Note: One hotel segment has one expected location
The original hotel check-in time Point in time: The time configured as the check-in time. The time-zone is the hotel's local time zone
OR
Length of time prior to check-in
4PM
Hotel Check-Out
Note: One hotel segment has one expected location
The original hotel check-out time Point in time: The time configured as the check-out time. The time-zone is the hotel's local time zone
OR
Length of time prior to check-out
10AM
Flight Departure 24h prior to departure 1h to 12h (by hour increment) prior to departure 3h
Flight Arrival 24h after arrival 1h to 12h (by hour increment) after arrival 2h
Train Departure 24h prior to departure 1h to 12h (by hour increment) prior to departure 1h
Train Arrival 24h after arrival 1h to 12h (by hour increment) after arrival 1h
Max Flight/Train Connection Time 4h 1h to 12h (by hour increment) 4h
Car Rental Pick Up 24h before pickup 1h to 12h (by hour increment) before pickup 1h
Car Rental Return 24h after return 1h to 12h (by hour increment) after return 1h
Other 24h 1h to 12h (by hour increment)  

Changes will apply to all newly created or updated itineraries for the entire organization. (Expected locations for existing itineraries will not be re-calculated.)

Maintain Contact at Their Expected Location

Because of the expected location range, by default for a multi-segment itinerary, it is possible that an expected location may start some time after the expiration of the previous one. When that occurs,the traveler has no expected locations for the time period between when the last expected location expires and the new expected location starts and cannot be alerted if a risk event occurs.

In this case, you can configure the system to keep the traveler in its expected location until the start of the next one by turning on the toggle Maintain traveler at their expected location under Settings > Map > Location Data Sources > Defaults.
 

User-added image

Enabling that specific toggle, will allow filling the gap between the expiration of an expected location and the start of the next expected location.

Example 1: Day trip from Boston to Chicago

User-added image

Example 2: Overnight trip from Boston to Chicago

User-added image

NOTE: This option does not work if expected locations are in different itineraries. All expected locations must be in the same itinerary.

Expected Location Calculation for Transit

By default, for Air and Train segments, an expected location is created for each side of the segment (arrival and departure), however a single expected location will be created in the case of transit.

Transit occurs when the traveler arrives and departs from the same airport/train station within (by default) 4h. The max transit time is also configurable and can be extended/reduced from 1h to 12h.

In the case of transit, the expected location range will ALWAYS take the earliest to the latest of the dates/times (calculated or actual arrival/departure). If the default configuration is used, the calculated expected location range for transit will be:

  • Start: 24h before the departure date/time of the 2nd segment.
  • End: 24h after the arrival date/time of the 1rst segment.

Example: Trip from BOS to LAX with three hour layover at ORD. Depart BOS at 9AM, Arrive ORD at 11AM, Depart ORD at 2PM Arrive LAX at 7PM

User-added image
 

If the configuration was changed with X being the time PRIOR to departure and Y the time AFTER arrival, the expected location range for transit will be:

  • Start: Xh before the departure date/time of the 2nd segment.
  • End: Yh after the arrival date/time of the 1rst segment.
User-added image

EXCEPT in the following conditions:

If X + Y is less than the actual transit time, then in this case the calculation takes the actual arrival and departure times.

User-added image

If Y < Transit time AND X > Transit Time, then in this case the range will be

  • Start: Xh before the departure date/time of the 2nd segment.
  • End: Actual departure time of the 2nd segment.
User-added image

If X < Transit Time AND Y > Transit time, then in this case the range will be

  • Start: Actual Arrival time of the 1rst segment.
  • End: Yh after the arrival date/time of the first segment.
User-added image
Was this article helpful?
0 out of 0 found this helpful

Article Feedback


While we can’t respond to you directly, we’d love to know how we can improve the article.

Please sign in to leave a comment.