DistanceMatrixTool 1.0.0

Distance Matrix Package

Package description

Given a list of origins and destinations, the DistanceMatrix package provides the time taken to travel by car from each origin to each destination.

Use

Steps to use

• Create a list of origins defined by the Location class
• Create a list of destinations defined by the Location class
• A Location object is constructed using a latitude as a first parameter and a longitude as a second parameter
• Both Location constructor parameters are supplied using decimal degees notation
• Invoke the DistanceMatrixCreator static class method GenerateDistanceMatrix to return a DistanceMatrix
• The GenerateDistanceMatrix method takes three parameters
  • List of origins
  • List of destinations
  • Google Maps API key
• The returned distance matrix contains the time taken to travel by car from each origin to each destination as demonstrated below:

  +------------+------------+------------+------------+
  |            |      D     |     E      |      F     |
  +------------+------------+------------+------------+
  |     A      |    A - D   |   A - E    |    A - F   |
  +------------+------------+------------+------------+
  |     B      |    B - D   |   B - E    |    B - F   |
  +------------+------------+------------+------------+
  |     C      |    C - D   |   C - E    |    C - F   |
  +------------+------------+------------+------------+
  

• The data in the matrix can be consumed row wise by using the distanceMatrix[originIndex]. This returns the time taken to travel from the origin to each destination.
• The data in the matrix can be consumed cell wise by using distanceMatrix[originIndex][destinationIndex]. This returns the time taken to travel from a given origin to a given destination.

Assumptions

The distance matrix package relies on the Google Maps API without any additional parameters. It is therefore subject to the same assumptions as the parameterless API, namely:

• The time duration is based on travelling by car
• The time duration assumes no traffic
• If a provided location is off a road, the location will be attached onto the nearest road

Example use

        List<Location> origins = new List<Location>() {
            new Location(37.73475, -122.47523),
            new Location(38.11751, -121.53500),
            new Location(38.58993, -121.73333),
        };
        List<Location> destinations = new List<Location>() {
            new Location(37.67184, -122.43652),
            new Location(38.45499, -120.88909),
            new Location(38.66347, -121.85902),
        };
        var distanceMatrix = DistanceMatrixCreator.GenerateDistanceMatrix(origins, destinations, "GOOGLE_MAPS_API_KEY");
        var Origin1ToAllDestinations = distanceMatrix[0];
        var Origin2ToAllDestinations = distanceMatrix[1];
        var Origin3ToAllDestinations = distanceMatrix[2];
        var Origin2ToDestination2 = distanceMatrix[1][1];

Package dependencies

• Microsoft.AspNet.WebApi.Client