Tutorials

JavaScript Google Maps Distance Matrix API Example to Find Distance & Time Between Two Addresses

In this tutorial, I will give you the complete JavaScript source code of the Google Maps Distance Matrix API example. You will learn how Google Maps Distance Matrix API measures the distance and calculates the journey duration between multiple locations (origins and destinations).

First of all, create a new HTML5 file on your computer and copy/paste the below source code into it.

JavaScript Google Maps Distance Matrix API Example

index.html

Important Note: On line # 6, replace ###YOUR_API_KEY### text with your actual Google Maps API key. Otherwise, this code will not work.

<html>
  <head>
    <title>JavaScript Google Maps Distance Matrix API Example</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
    <script defer src="https://maps.googleapis.com/maps/api/js?libraries=places&language=en&key=###YOUR_API_KEY###" type="text/javascript"></script>
    <link href="https://netdna.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css" id="bootstrap-css" rel="stylesheet"/>
  </head>
  <body>
    <div class="container">
      <div class="row">
        <div class="jumbotron">
          <h1>JavaScript Google Maps Distance Matrix API Example</h1>
        </div>

        <div class="col-md-6">
          <form id="distance_form">
            <div class="form-group">
              <label>Origin: </label>
              <input
                class="form-control"
                id="from_places"
                placeholder="Enter a location"
              />
              <input id="origin" name="origin" required="" type="hidden" />
            </div>

            <div class="form-group">
              <label>Destination: </label>
              <input
                class="form-control"
                id="to_places"
                placeholder="Enter a location"
              />
              <input
                id="destination"
                name="destination"
                required=""
                type="hidden"
              />
            </div>
            <input class="btn btn-primary" type="submit" value="Calculate" />
          </form>

          <div id="result">
            <ul class="list-group">
              <li
                id="mile"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                Distance In Mile :
              </li>
              <li
                id="kilo"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                Distance is Kilo:
              </li>
              <li
                id="text"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                IN TEXT:
              </li>
              <li
                id="minute"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                IN MINUTES:
              </li>
              <li
                id="from"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                FROM:
              </li>
              <li
                id="to"
                class="
                  list-group-item
                  d-flex
                  justify-content-between
                  align-items-center
                "
              >
                TO:
              </li>
            </ul>
          </div>
        </div>
      </div>
    </div>
    <script>
      $(function () {
        // add input listeners
        google.maps.event.addDomListener(window, "load", function () {
          var from_places = new google.maps.places.Autocomplete(
            document.getElementById("from_places")
          );
          var to_places = new google.maps.places.Autocomplete(
            document.getElementById("to_places")
          );

          google.maps.event.addListener(
            from_places,
            "place_changed",
            function () {
              var from_place = from_places.getPlace();
              var from_address = from_place.formatted_address;
              $("#origin").val(from_address);
            }
          );

          google.maps.event.addListener(
            to_places,
            "place_changed",
            function () {
              var to_place = to_places.getPlace();
              var to_address = to_place.formatted_address;
              $("#destination").val(to_address);
            }
          );
        });
        // calculate distance
        function calculateDistance() {
          var origin = $("#origin").val();
          var destination = $("#destination").val();
          var service = new google.maps.DistanceMatrixService();
          service.getDistanceMatrix(
            {
              origins: [origin],
              destinations: [destination],
              travelMode: google.maps.TravelMode.DRIVING,
              unitSystem: google.maps.UnitSystem.IMPERIAL, // miles and feet.
              // unitSystem: google.maps.UnitSystem.metric, // kilometers and meters.
              avoidHighways: false,
              avoidTolls: false,
            },
            callback
          );
        }
        // get distance results
        function callback(response, status) {
          if (status != google.maps.DistanceMatrixStatus.OK) {
            $("#result").html(err);
          } else {
            var origin = response.originAddresses[0];
            console.log(origin);
            var destination = response.destinationAddresses[0];
            console.log(destination);
            if (response.rows[0].elements[0].status === "ZERO_RESULTS") {
              $("#result").html(
                "Better get on a plane. There are no roads between " +
                  origin +
                  " and " +
                  destination
              );
            } else {
              var distance = response.rows[0].elements[0].distance;
              console.log(distance);
              var duration = response.rows[0].elements[0].duration;
              console.log(duration);
              console.log(response.rows[0].elements[0].distance);
              var distance_in_kilo = distance.value / 1000; // the kilom
              var distance_in_mile = distance.value / 1609.34; // the mile
              console.log(distance_in_kilo);
              console.log(distance_in_mile);
              var duration_text = duration.text;
              var duration_value = duration.value;
              $("#mile").html(
                `Distance in Miles: ${distance_in_mile.toFixed(2)}`
              );
              $("#kilo").html(
                `Distance in Kilometre: ${distance_in_kilo.toFixed(2)}`
              );
              $("#text").html(`Distance in Text: ${duration_text}`);
              $("#minute").html(`Distance in Minutes: ${duration_value}`);
              $("#from").html(`Distance From: ${origin}`);
              $("#to").text(`Distance to: ${destination}`);
            }
          }
        }
        // print results on submit the form
        $("#distance_form").submit(function (e) {
          e.preventDefault();
          calculateDistance();
        });
      });
    </script>
  </body>
</html>

Project Screenshot

JavaScript Google Maps Distance Matrix API Example
Furqan

Well. I've been working for the past three years as a web designer and developer. I have successfully created websites for small to medium sized companies as part of my freelance career. During that time I've also completed my bachelor's in Information Technology.

Recent Posts

Obsidian vs Notion (2026): I tested both for 6 months

If you have been searching for the right note-taking or knowledge management app, you have…

May 31, 2026

AnyType Alternatives: 10 Best Tools for Knowledge Management in 2026

Looking for AnyType alternatives? You're not alone. AnyType has gained popularity as a privacy-focused, local-first…

May 31, 2026

Notion Alternatives – Best Note-taking & Wiki Tools

Notion is a popular all-in-one workspace, but many users seek alternatives for different needs (free…

May 31, 2026

Best Logseq Alternatives in 2026: Find Your Perfect Knowledge Management Tool

Logseq is a beloved tool in the personal knowledge management (PKM) community. It's free, open-source,…

May 30, 2026

Webshare Alternatives: 8 Best Proxy Providers to Use in 2026

Looking for a Webshare alternative? You're not alone. Webshare is a popular proxy service with…

May 30, 2026

Docker Alternatives in 2026: The Complete Guide to Container Tools

Docker changed software development forever. It made containers accessible, gave developers a simple workflow, and…

May 30, 2026