Documentation

Directions Field

Last modified: December 5, 2025

Introduction

The Directions Field in Formidable Forms Geolocation calculates routes, distances, traffic-aware travel times, and step-by-step instructions between two or more locations. It supports the Google Maps Routes API for precise driving calculations and can display results on a connected Map Field or inside a Directions Panel Field. This field is ideal for delivery workflows, travel planning, cost estimations, logistics routing, and other location-based applications.

Learn more about the routing features powering this field in the Google Maps Routes API documentation.

Note: This documentation covers the geolocation options added by the Formidable Geolocation plugin. All standard Formidable Forms field settings (labels, conditional logic, visibility controls, etc.) can also be configured as usual.

Configuring the Formidable Forms Directions Field

The following sections outline the configuration settings available for the Directions Field.

Formidable Forms Map Field
Address Field settings in Formidable Geolocation.

1. Travel Calculation Method

Select how the distance and travel time should be calculated.

Travel Calculation Method

Choose the routing engine:

  • Google Routes API: Provides precise routing, traffic-aware durations, waypoints, restrictions, and turn-by-turn guidance (Default).
  • Straight-Line (Haversine): Calculates the linear distance between two points without roads or traffic considerations.


2. Trigger Method

Control how directions are generated either automatically or via a button.

How Should Directions Be Triggered?

Select the trigger behavior:

  • Manually (Using a Button): The user must click a button to calculate routes.
  • Automatically: Directions update instantly when a geolocation field changes.

Get Directions Button Text

Customize the label displayed on the button that triggers route calculation (Default: Get directions).

Clear Directions Button Text

Customize the label for the button that clears displayed routes (Default: Clear directions).


3. Directions Source & Destination

Assign the Geocoder Fields used to define the origin, destination, and optional waypoints.

Origin Field (Geocoder)

Select the Geocoder Field that provides the starting point for the route.

Destination Field (Geocoder)

Select the Geocoder Field that represents the destination.

Waypoint Fields (Optional)

Select one or more Geocoder Fields to serve as intermediate stops. Waypoints are optional and can be reordered by the user depending on your form setup.


4. Travel Preferences

Customize routing behavior, units, and travel mode.

Measurement System

Choose how distances should appear:

  • Imperial (Miles): Uses miles and feet (Default).
  • Metric (Kilometers): Uses kilometers and meters.

Travel Mode

Select the preferred travel method:

  • Driving (Default)
  • Walking
  • Bicycling
  • Transit

Travel Mode Field

Select a Dropdown or Radio field that allows users to choose DRIVING, WALKING, BICYCLING, or TRANSIT dynamically.

Routing Preference

Choose how the Google Routes API selects the path:

  • Traffic Unaware (Shortest Distance) (Default)
  • Traffic Aware (Fastest Route)
  • Traffic Aware Optimal

Avoid Ferries

Enable to avoid ferry routes.

Avoid Highways

Enable to avoid highway travel.

Avoid Tolls

Enable to avoid toll roads.


5. Travel Date & Time Settings

Configure date/time-aware routing using the Google Routes API.

Travel Time Mode

Select when the estimated route should be calculated:

  • Leave Now (Default)
  • Leave At
  • Arrive By

Travel Time Mode Field

Select a frontend field that allows the user to choose Leave Now / Leave At / Arrive By.

Default Travel Date

Set a default date used when Leave At or Arrive By is selected.

Travel Date Field

Select the frontend date field that users will interact with.

Default Travel Time

Set a default time used when Leave At or Arrive By is selected.

Travel Time Field

Select the frontend time field used for selecting the departure or arrival time.


6. Display Options

Choose where and how the directions and route should appear.

Map Field for Displaying Route

Select the Map Field where the route polyline will be rendered.

Polyline Appearance

Customize the route line styling using JSON-compatible syntax such as color, opacity, and stroke weight (Example: strokeColor:'#0088FF',strokeWeight:6,strokeOpacity:0.6).

Directions Panel Output

Select the Directions Panel Field where detailed turn-by-turn instructions will appear.


How to Use the Formidable Geolocation Directions Field

Follow these steps to set up the Directions Field:

  1. Add the Directions Field: Insert it via the Formidable Forms builder.
  2. Configure all routing, travel, and display options: Use the settings described above.
  3. Link Geocoder Fields: Assign origin, destination, and optional waypoint fields.
  4. Connect a Map Field and/or Directions Panel Field: Enables visual results.
  5. Test your form: Verify routing behavior across devices and browsers.
menu-circle