Set the Geosearch rules for a Fergus booking form
Geosearch offers a time only when a visit you already have is near the customer's address. The rules are on the form's Geosearch page, under Bookings setup, headed "Geosearch for Fergus Bookings". Geosearch has to be enabled on the account first, on the Geosearch page.
Before you start
- Without a subscription the page says "Subscription required". If the account switch is off it says "Geosearch not turned on" with a Turn on Geosearch link.
- Turn on Geosearch needs the Geosearch plan. Without it the switch is off and reads "Geosearch functions available with the Geosearch plan".
- Allow dynamic travel times? needs the Georoute plan. Without it the switch is off and reads "Dynamic travel times available with the Georoute plan". Dynamic travel times only work on a form that has Geosearch on.
- Distance units is set on Form Properties, as Kilometres or Miles. The distances on this page follow it.
Step by step
- Switch on Turn on Geosearch. The page notes that usage charges apply.
- Choose a Home location with the address box. Use Clear to remove it.
- Enter the Maximum allowable searchable distance radius (50 to start with) and the Maximum allowable searchable time in minutes (120 to start with). The time must be a multiple of the form's time block and rounds up to one when you leave the box.
- Choose how Empty visit days are handled.
- Click Save. The page says "Geosearch settings updated." and the form is published.
When both distance and time are set, a green box spells out the rule: "Booking times are available when there is an existing visit within 50km away and either within 2 hours before an existing visit or within 2 hours after an existing visit."
Distances are as the crow flies, so allow extra for the route. Fergus visits that sit on a job count as places to measure from, using the job's site address. A visit with no job, such as lunch, has no site and cannot count. A visit whose site cannot be placed is ignored.
Empty visit days
When a customer looks at a day with no visits, choose one:
- Allow customers to book any time when there is an empty day.
- Block out all available times that are not near the home location. Only the first and last times of the day are offered, and only when the home location is near enough. The page says visits will be manually created in Fergus to create availability.
An address that was let in because it is near a region is never offered an empty day. Set nearby distances on the form's Regions page.
Tick Treat free stretches like empty days to apply the same rule to a time with no visit within the searchable time either side. A gap of exactly the searchable time counts as enough.
Non-work events
Under Non-work events, add the title of each Fergus calendar event to ignore when deciding whether a day is empty, such as "Lunch" or "Toolbox meeting". Type the title and click Add title, or press Enter. Titles are not case sensitive, up to 60 characters each, and you can add 30. With none the page says "No titles added. Every calendar event counts as work."
Dynamic travel times
With Allow dynamic travel times? on, the form counts the real drive between visits. Route requests are made for every visit the form checks, whether or not the customer books, so the page warns that charges rise.
- Add travel at both ends of a booking counts the drive after the visit as well as the drive before it. A time is only offered when both drives fit inside the staff member's hours. It needs a Home location.
- Regions appears when the form searches by region. Tick regions to calculate travel times only for addresses in them. Leave all unticked to calculate for every address.
- Maximum allowable travel time in minutes (60 to start with) is required. Times needing a longer drive are not offered.
- Minimum travel time allowance in minutes is the least the form allows for any drive. With 15 set, a one minute drive is held as 15.
With dynamic travel times on, each staff member's first booking of the day includes the drive from the Home location, and cannot start until their start time plus that drive. Without them the Home location does not apply to time groups.
Georoute rules appear only with the Georoute plan. Without it the page reads "Please turn on dynamic travel times to setup travel time rules."
Travel blocks on the calendar
Tick Book the drives in the Fergus calendar to put each drive on the Fergus calendar as an event of its own when a booking is made. They are titled "Travel to ..." and "Travel from ...", have no job, and keep the time free for the same staff member and team as the visit. The page says no extra route usage is charged, because the drives are the routes already used to offer the time. If an auth link moves the visit, its drives are taken off the calendar. Dynamic travel times must be on.
When it goes wrong
Save is greyed out
The message beside it starts "Save is off:". The reasons are: the form is archived, no search distance, no searchable time, no maximum travel time with dynamic travel times on, or a minimum travel time above the maximum. The home location rule reads "choose a home location, which empty days and travel times are measured from. Or let customers book on days with no visits, and turn dynamic travel times off." A home location is needed when empty days are blocked, or when dynamic travel times or both ends are on.
Turning off dynamic travel times cleared other boxes
Both ends and travel blocks belong to dynamic travel times, so they are saved off with it.
A customer sees no times
Either no visit is near enough, or the drive does not fit. Run the address through Search Diagnostics. Its notes name each visit and say how far away it is. A time is also dropped when a drive cannot be worked out.
The customer is asked for their address again
A Geosearch form needs an address with a point on the map. A customer who types one without choosing a suggestion has no point to measure from, and the form answers "Enter your address."
Auth links ignore these rules
A booking from an auth link fixes the service and the job, so the form does not ask for an address or apply regions or Geosearch.