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

Showing Pixel and Tile Coordinates

This example creates a map that displays a window with the latitude, longitude, and world, pixel, and tile coordinates for Chicago, IL. It also shows how these values change as the zoom level is adjusted.

Read the documentation.

TypeScript

function initMap(): void {
  const chicago = new google.maps.LatLng(41.85, -87.65);

  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      center: chicago,
      zoom: 3,
    }
  );

  const coordInfoWindow = new google.maps.InfoWindow();
  coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom()));
  coordInfoWindow.setPosition(chicago);
  coordInfoWindow.open(map);

  map.addListener("zoom_changed", () => {
    coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom()));
    coordInfoWindow.open(map);
  });
}

const TILE_SIZE = 256;

function createInfoWindowContent(latLng: google.maps.LatLng, zoom: number) {
  const scale = 1 << zoom;

  const worldCoordinate = project(latLng);

  const pixelCoordinate = new google.maps.Point(
    Math.floor(worldCoordinate.x * scale),
    Math.floor(worldCoordinate.y * scale)
  );

  const tileCoordinate = new google.maps.Point(
    Math.floor((worldCoordinate.x * scale) / TILE_SIZE),
    Math.floor((worldCoordinate.y * scale) / TILE_SIZE)
  );

  return [
    "Chicago, IL",
    "LatLng: " + latLng,
    "Zoom level: " + zoom,
    "World Coordinate: " + worldCoordinate,
    "Pixel Coordinate: " + pixelCoordinate,
    "Tile Coordinate: " + tileCoordinate,
  ].join("<br>");
}

// The mapping between latitude, longitude and pixels is defined by the web
// mercator projection.
function project(latLng: google.maps.LatLng) {
  let siny = Math.sin((latLng.lat() * Math.PI) / 180);

  // Truncating to 0.9999 effectively limits latitude to 89.189. This is
  // about a third of a tile past the edge of the world tile.
  siny = Math.min(Math.max(siny, -0.9999), 0.9999);

  return new google.maps.Point(
    TILE_SIZE * (0.5 + latLng.lng() / 360),
    TILE_SIZE * (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI))
  );
}

JavaScript

function initMap() {
  const chicago = new google.maps.LatLng(41.85, -87.65);
  const map = new google.maps.Map(document.getElementById("map"), {
    center: chicago,
    zoom: 3,
  });
  const coordInfoWindow = new google.maps.InfoWindow();
  coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom()));
  coordInfoWindow.setPosition(chicago);
  coordInfoWindow.open(map);
  map.addListener("zoom_changed", () => {
    coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom()));
    coordInfoWindow.open(map);
  });
}
const TILE_SIZE = 256;

function createInfoWindowContent(latLng, zoom) {
  const scale = 1 << zoom;
  const worldCoordinate = project(latLng);
  const pixelCoordinate = new google.maps.Point(
    Math.floor(worldCoordinate.x * scale),
    Math.floor(worldCoordinate.y * scale)
  );
  const tileCoordinate = new google.maps.Point(
    Math.floor((worldCoordinate.x * scale) / TILE_SIZE),
    Math.floor((worldCoordinate.y * scale) / TILE_SIZE)
  );
  return [
    "Chicago, IL",
    "LatLng: " + latLng,
    "Zoom level: " + zoom,
    "World Coordinate: " + worldCoordinate,
    "Pixel Coordinate: " + pixelCoordinate,
    "Tile Coordinate: " + tileCoordinate,
  ].join("<br>");
}

// The mapping between latitude, longitude and pixels is defined by the web
// mercator projection.
function project(latLng) {
  let siny = Math.sin((latLng.lat() * Math.PI) / 180);
  // Truncating to 0.9999 effectively limits latitude to 89.189. This is
  // about a third of a tile past the edge of the world tile.
  siny = Math.min(Math.max(siny, -0.9999), 0.9999);
  return new google.maps.Point(
    TILE_SIZE * (0.5 + latLng.lng() / 360),
    TILE_SIZE * (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI))
  );
}

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;
}

HTML

<!DOCTYPE html>
<html>
  <head>
    <title>Showing Pixel and Tile Coordinates</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="map"></div>
  </body>
</html>

All

<!DOCTYPE html>
<html>
  <head>
    <title>Showing Pixel and Tile Coordinates</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;
      }
    </style>
    <script>
      "use strict";

      function initMap() {
        const chicago = new google.maps.LatLng(41.85, -87.65);
        const map = new google.maps.Map(document.getElementById("map"), {
          center: chicago,
          zoom: 3,
        });
        const coordInfoWindow = new google.maps.InfoWindow();
        coordInfoWindow.setContent(
          createInfoWindowContent(chicago, map.getZoom())
        );
        coordInfoWindow.setPosition(chicago);
        coordInfoWindow.open(map);
        map.addListener("zoom_changed", () => {
          coordInfoWindow.setContent(
            createInfoWindowContent(chicago, map.getZoom())
          );
          coordInfoWindow.open(map);
        });
      }

      const TILE_SIZE = 256;

      function createInfoWindowContent(latLng, zoom) {
        const scale = 1 << zoom;
        const worldCoordinate = project(latLng);
        const pixelCoordinate = new google.maps.Point(
          Math.floor(worldCoordinate.x * scale),
          Math.floor(worldCoordinate.y * scale)
        );
        const tileCoordinate = new google.maps.Point(
          Math.floor((worldCoordinate.x * scale) / TILE_SIZE),
          Math.floor((worldCoordinate.y * scale) / TILE_SIZE)
        );
        return [
          "Chicago, IL",
          "LatLng: " + latLng,
          "Zoom level: " + zoom,
          "World Coordinate: " + worldCoordinate,
          "Pixel Coordinate: " + pixelCoordinate,
          "Tile Coordinate: " + tileCoordinate,
        ].join("<br>");
      } // The mapping between latitude, longitude and pixels is defined by the web
      // mercator projection.

      function project(latLng) {
        let siny = Math.sin((latLng.lat() * Math.PI) / 180); // Truncating to 0.9999 effectively limits latitude to 89.189. This is
        // about a third of a tile past the edge of the world tile.

        siny = Math.min(Math.max(siny, -0.9999), 0.9999);
        return new google.maps.Point(
          TILE_SIZE * (0.5 + latLng.lng() / 360),
          TILE_SIZE * (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI))
        );
      }
    </script>
  </head>
  <body>
    <div id="map"></div>
  </body>
</html>
"use strict"; function initMap() { const chicago = new google.maps.LatLng(41.85, -87.65); const map = new google.maps.Map(document.getElementById("map"), { center: chicago, zoom: 3, }); const coordInfoWindow = new google.maps.InfoWindow(); coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom())); coordInfoWindow.setPosition(chicago); coordInfoWindow.open(map); map.addListener("zoom_changed", () => { coordInfoWindow.setContent(createInfoWindowContent(chicago, map.getZoom())); coordInfoWindow.open(map); }); } const TILE_SIZE = 256; function createInfoWindowContent(latLng, zoom) { const scale = 1 << zoom; const worldCoordinate = project(latLng); const pixelCoordinate = new google.maps.Point( Math.floor(worldCoordinate.x * scale), Math.floor(worldCoordinate.y * scale) ); const tileCoordinate = new google.maps.Point( Math.floor((worldCoordinate.x * scale) / TILE_SIZE), Math.floor((worldCoordinate.y * scale) / TILE_SIZE) ); return [ "Chicago, IL", "LatLng: " + latLng, "Zoom level: " + zoom, "World Coordinate: " + worldCoordinate, "Pixel Coordinate: " + pixelCoordinate, "Tile Coordinate: " + tileCoordinate, ].join("<br>"); } // The mapping between latitude, longitude and pixels is defined by the web // mercator projection. function project(latLng) { let siny = Math.sin((latLng.lat() * Math.PI) / 180); // Truncating to 0.9999 effectively limits latitude to 89.189. This is // about a third of a tile past the edge of the world tile. siny = Math.min(Math.max(siny, -0.9999), 0.9999); return new google.maps.Point( TILE_SIZE * (0.5 + latLng.lng() / 360), TILE_SIZE * (0.5 - Math.log((1 + siny) / (1 - siny)) / (4 * Math.PI)) ); }
/* 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; }
<!DOCTYPE html> <html> <head> <title>Showing Pixel and Tile Coordinates</title> <script src="https://polyfill.io/v3/polyfill.min.js?features=default"></script> <script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyBIwzALxUPNbatRBj3Xi1Uhp0fFzwWNBkE&callback=initMap&libraries=&v=weekly" defer ></script> <!-- jsFiddle will insert css and js --> </head> <body> <div id="map"></div> </body> </html>

Create a starter application from sample

A skeleton starter application using TypeScript, Webpack, and Babel can be generated from this sample using one of the methods below.

Run Locally

Node.js is required to run this sample locally. Follow these instructions to install Node.js and NPM.

npm i -g '@googlemaps/js-samples'
googlemaps-js-samples init map-coordinates DESTINATION_FOLDER

Run in Google Cloud Shell

Google Cloud Shell is an interactive shell environment for Google Cloud Platform that makes it easy for you to learn and experiment with GCP and manage your projects and resources from your web browser.

Run in Cloud Shell