The RouteMatrix
class replaces the Distance Matrix Service, Maps JavaScript API (Legacy)
.
This page explains the differences between the legacy Distance Matrix service and the new
JavaScript library, and provides some code for comparison.
Distance Matrix API (Legacy) versus Route Matrix class (Beta)
The following table compares the request parameters for the legacy Distance Matrix API
and
the RouteMatrix
class.
Required Parameters
Optional Parameters
Code comparison
This section compares two similar pieces of code to illustrate the differences between the
legacy Distance Matrix API and the new RouteMatrix
class. The code snippets show
the code required on each respective API to make a directions request, and view the results.
Directions API (Legacy)
The following code makes a distance matrix request using the legacy Distance Matrix API.
// Define the request. const request = { origins : [{ lat : 55.93 , lng : - 3.118 }, 'Greenwich, England' ], destinations : [ 'Stockholm, Sweden' , { lat : 50.087 , lng : 14.421 }], travelMode : 'DRIVING' , drivingOptions : { departureTime : new Date ( Date . now ()), trafficModel : 'optimistic' } }; // Make the request. service . getDistanceMatrix ( request ). then (( response ) => { // Display the response. document . getElementById ( "response" ). textContent = JSON . stringify ( response , null , 2 , ); });
Route Matrix class (Beta)
The following code makes a distance matrix request using the new Route Matrix class:
// Define the request. const request = { origins : [{ lat : 55.93 , lng : - 3.118 }, 'Greenwich, England' ], destinations : [ 'Stockholm, Sweden' , { lat : 50.087 , lng : 14.421 }], travelMode : 'DRIVING' , departureTime : new Date (), trafficModel : 'optimistic' }; // Make the request. const response = await RouteMatrix . computeRouteMatrix ( request ); // Display the response. document . getElementById ( "response" ). setValue ( JSON . stringify ( response , null , 2 ,));
