/gmaps-bigdistancematrix

Javascript object for fill Google Maps Distance Matrix for 25+ locations.

Primary LanguageJavaScriptMIT LicenseMIT

Big Distance Matrix for Google Maps

Javascript object for fill Google Maps Distance Matrix for 25+ locations.

It can call the Google Maps v3 API to get the distance matrix for many locations that may go over the 25 locations limit by splitting it in smaller blocks.

The object can display the distance matrix on a HTML table or export it as a string in JSON format.

Links

Find optimal routes with the retrieved data on:

Route Optimizer for Big Distance Matrix for Google Maps: https://github.com/davcs86/gmaps-bigrouteoptimizer

Requirements:

  1. jQuery 1.8+ http://jquery.com/
  2. JSON3 http://bestiejs.github.io/json3/

Instructions:

  1. Define an object with the GPS latitude and longitude of the route points in an Object. From example.js

    // Places in NY.
var Route_Points = {
	"Times Square": [40.758673, -73.985281],
	"St Patrick's Cathedral": [40.758196, -73.975347],
	"Grand Central Terminal": [40.752105, -73.977686],
	//...
	"Bronx Zoo": [40.848611, -73.882631],
	"New York Botanical Garden": [40.861748, -73.880145],
	"Washington Square Park": [40.731371, -73.996997]
};

  2. Initialize the object.

    Route_DistanceMatrix.init(routePoints, consoleDivId, itemsPerReq, gTravelMode, gUnitSystem, gAvoidHighways, gAvoidTolls);

//from example.js	
Route_DistanceMatrix.init(Route_Points,"console_route_matrix", 10);
    Parameter Description
    routePoints Object with the GPS latitude and longitude of the places.
    Mandatory.
    consoleDivId DOM id of the container where the log information will be written.
    Optional. Default value: false.
    itemsPerReq Number of items to include per request to Google.
    Optional. Default value: 5, Max Value 25.
    gTravelMode Google's parameter, view Google Maps Reference.
    Optional. Default value: google.maps.TravelMode.DRIVING.
    gUnitSystem Google's parameter, view Google Maps Reference.
    Optional. Default value: false.
    gAvoidTolls Google's parameter, view Google Maps Reference.
    Optional. Default value: false.

    Google Maps v3 API Reference: https://developers.google.com/maps/documentation/javascript/distancematrix#distance_matrix_requests

  3. Set the table where the data will be displayed.

    Route_DistanceMatrix.displayTable(tableDomvId);

//from example.js	
Route_DistanceMatrix.displayTable("table_route_matrix");
    Parameter Description
    tableDomvId DOM id of the table where the data will be displayed.
    Mandatory.

    NOTE: This function is OPTIONAL, you can populate the distance matrix without display any data. See function Route_DistanceMatrix.exportResults().

  4. Start the matrix population.

    Route_DistanceMatrix.startRouting(delayRequest);

//from example.js
Route_DistanceMatrix.startRouting(5000);
    Parameter Description
    delayRequest Miliseconds between requests.
    Optional. Default value: 1500 ms.

  5. Export the distance matrix as a JSON object.

    var jsonObjResults = Route_DistanceMatrix.exportResults(asString);

//from example.js
var distanceMatrix = Route_DistanceMatrix.exportResults(true);
    Parameter Description
    asString If it's true, returns the string representation of the JSON Object.
    Optional. Default value: false.

  6. Use the data as you prefer. Check out an interesting application for this data on my another project https://github.com/davcs86/gmaps-bigrouteoptimizer where you can find an optimal route of these points using any of three variables: Time, Distance and Speed.

Support

Drop me line on: http://d-castillo.info/contactme/ or to: davcs86@gmail.com

Donations

Did this project help you to save (or earn) some money?
Please, support to the author by making a small donation.

Buy Me A Coffee :) @ PayPal