It's the 15th anniversary of Google Maps Platform - Check out the latest news and announcements

Geocoding Component Restrictions

This example creates a request to the geocoding service that restricts the results to a particular postal area within Sydney, Australia.

Read the documentation.

JavaScript

function initMap() {
  var geocoder = new google.maps.Geocoder();
  var map = new google.maps.Map(document.getElementById("map"), {
    zoom: 8,
    center: { lat: -33.865, lng: 151.209 }
  });

  document.getElementById("submit").addEventListener("click", function() {
    geocodeAddress(geocoder, map);
  });
}

function geocodeAddress(geocoder, map) {
  geocoder.geocode(
    {
      componentRestrictions: {
        country: "AU",
        postalCode: "2000"
      }
    },
    function(results, status) {
      if (status === "OK") {
        map.setCenter(results[0].geometry.location);
        new google.maps.Marker({
          map: map,
          position: results[0].geometry.location
        });
      } else {
        window.alert(
          "Geocode was not successful for the following reason: " + status
        );
      }
    }
  );
}

CSS

/* Always set the map height explicitly to define the size of the div
       * element that contains the map. */
#map {
  height: 100%;
}

/* Optional: Makes the sample page fill the window. */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}

#floating-panel {
  position: absolute;
  top: 10px;
  left: 25%;
  z-index: 5;
  background-color: #fff;
  padding: 5px;
  border: 1px solid #999;
  text-align: center;
  font-family: "Roboto", "sans-serif";
  line-height: 30px;
  padding-left: 10px;
}

HTML

<!DOCTYPE html>
<html>
  <head>
    <title>Geocoding Component Restriction</title>
    <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script>
    <script
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=&v=weekly"
      defer
    ></script>
    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script src="./app.js"></script>
  </head>
  <body>
    <div id="floating-panel">
      <pre>componentRestrictions: {country: "AU", postalCode: "2000"}</pre>
      <button id="submit">Geocode</button>
    </div>
    <div id="map"></div>
  </body>
</html>

All

<!DOCTYPE html>
<html>
  <head>
    <title>Geocoding Component Restriction</title>
    <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script>
    <script
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=&v=weekly"
      defer
    ></script>
    <style type="text/css">
      /* Always set the map height explicitly to define the size of the div
       * element that contains the map. */
      #map {
        height: 100%;
      }

      /* Optional: Makes the sample page fill the window. */
      html,
      body {
        height: 100%;
        margin: 0;
        padding: 0;
      }

      #floating-panel {
        position: absolute;
        top: 10px;
        left: 25%;
        z-index: 5;
        background-color: #fff;
        padding: 5px;
        border: 1px solid #999;
        text-align: center;
        font-family: "Roboto", "sans-serif";
        line-height: 30px;
        padding-left: 10px;
      }
    </style>
    <script>
      (function(exports) {
        "use strict";

        function initMap() {
          var geocoder = new google.maps.Geocoder();
          var map = new google.maps.Map(document.getElementById("map"), {
            zoom: 8,
            center: {
              lat: -33.865,
              lng: 151.209
            }
          });
          document
            .getElementById("submit")
            .addEventListener("click", function() {
              geocodeAddress(geocoder, map);
            });
        }

        function geocodeAddress(geocoder, map) {
          geocoder.geocode(
            {
              componentRestrictions: {
                country: "AU",
                postalCode: "2000"
              }
            },
            function(results, status) {
              if (status === "OK") {
                map.setCenter(results[0].geometry.location);
                new google.maps.Marker({
                  map: map,
                  position: results[0].geometry.location
                });
              } else {
                window.alert(
                  "Geocode was not successful for the following reason: " +
                    status
                );
              }
            }
          );
        }

        exports.geocodeAddress = geocodeAddress;
        exports.initMap = initMap;
      })((this.window = this.window || {}));
    </script>
  </head>
  <body>
    <div id="floating-panel">
      <pre>componentRestrictions: {country: "AU", postalCode: "2000"}</pre>
      <button id="submit">Geocode</button>
    </div>
    <div id="map"></div>
  </body>
</html>
(function(exports) { "use strict"; function initMap() { var geocoder = new google.maps.Geocoder(); var map = new google.maps.Map(document.getElementById("map"), { zoom: 8, center: { lat: -33.865, lng: 151.209 } }); document.getElementById("submit").addEventListener("click", function() { geocodeAddress(geocoder, map); }); } function geocodeAddress(geocoder, map) { geocoder.geocode( { componentRestrictions: { country: "AU", postalCode: "2000" } }, function(results, status) { if (status === "OK") { map.setCenter(results[0].geometry.location); new google.maps.Marker({ map: map, position: results[0].geometry.location }); } else { window.alert( "Geocode was not successful for the following reason: " + status ); } } ); } exports.geocodeAddress = geocodeAddress; exports.initMap = initMap; })((this.window = this.window || {}));
/* Always set the map height explicitly to define the size of the div * element that contains the map. */ #map { height: 100%; } /* Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } #floating-panel { position: absolute; top: 10px; left: 25%; z-index: 5; background-color: #fff; padding: 5px; border: 1px solid #999; text-align: center; font-family: "Roboto", "sans-serif"; line-height: 30px; padding-left: 10px; }
<!DOCTYPE html> <html> <head> <title>Geocoding Component Restriction</title> <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script> <script src="https://maps.googleapis.com/maps/api/js?key=&callback=initMap&libraries=&v=weekly" defer ></script> <!-- jsFiddle will insert css and js --> </head> <body> <div id="floating-panel"> <pre>componentRestrictions: {country: "AU", postalCode: "2000"}</pre> <button id="submit">Geocode</button> </div> <div id="map"></div> </body> </html>