Directions API Examples
Basic Directions Fast Request
To create a simple Directions Fast request we will provide an `origin` from where a trip starts and a `destination` where it ends. We also set `mode=car’ to get a legal route which a car can take.
Basic Directions Fast - POST Request
Let’s see how to build a POST method request for Direction Fast API for the same scenario from the curbside example.
Basic Directions Flexible - POST Request
Let’s see how to build a POST method request for Directions Flexible API for the same scenario from the trips in future example
Routes with multiple stops
In this example, we will configure a request with multiple waypoints or stops that need to be made before the final destination. We will add 3 location coordinates which should be visited before the route ends at the destination location.
Approach destinations on curbside
In this example, we will make a Directions Flexible request to get a route where all stops are to be approached from the driving side only. We use the `approaches` parameter to configure the approach direction for each stop on the route.
Avoid Tolls & Highways
To get a route between two points which does not go through a toll road or a highway we can make use of the avoid parameter of the Directions API. The avoid parameter can take multiple values in input and then suggests the best feasible route while avoiding the specified objects/roads
Directions for custom truck sizes
Routing requirements for a truck with custom dimensions can be tricky as not all roads are suitable for all types of trucks. Taking wrong and inappropriate routes can result in operational and regulatory setbacks for a business.
Get Shortest Route
When the business requirements are such that a shortest route between 2 places is most desirable, users can make use of the `route_type` parameter of Directions Flexible API to generate a route with least traveling distance.
Plan a future trip
To plan a trip in the future we configure the `departure_time` parameter of the Directions Flexible API along with other constraints. Providing a `departure_time` allows the service to consider the general traffic conditions at the given time and provide the best route and ETAs accordingly.
Legal routes for a given truck weight
Directions Flexible API allows configuring the truck weight when making a request so that the routes returned are safe and legal for the given route to travel on. `truck_wight` parameter is used to eliminate routes which pass through roads with an allowed weight threshold lower than the given weight.
Avoid sharp turns for a truck
It gets complicated and risky for large trucks to maneuver around sharp turns. With Directions Flexible API users can specify the custom turn angles which are safe for their trucks to take. In order to use the `turn_angle_range` parameter, users also need to set the `avoid` property to “sharp_turn”.
Get routes for hazmat load
To get routes for safely transporting hazardous material, use the `hazmat_type` parameter of the Directions Flexible API to avoid unsafe routes for your truck. Users need to provide the type of material that is being carried by the truck to get the legal routes as per the contents of the truck load.