Get a Maps Demo Key :Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Add a Map using HTML

Page Summary

This example showcases creating a basic Google Map using HTML and the gmp-map web component.
The map is initialized using JavaScript (or TypeScript) with an initMap function.
Sample code provides implementation in both JavaScript and TypeScript, along with the corresponding HTML and CSS.
Users can experiment with the example via provided links to JSFiddle and Google Cloud Shell or clone the repository for local execution.

This example demonstrates creating a map using HTML, with the gmp-map element.

Read the documentation .

TypeScript

 // This example adds a map using web components.  index.ts

JavaScript

 // This example adds a map using web components.  index.js

CSS

   style 
 . 
 css

HTML

<html>
    <head>
        <title>Add a Map using HTML</title>

        <link rel="stylesheet" type="text/css" href="./style.css" />
        <script type="module" src="./index.js"></script>
        <script
            async
            src="https://maps.googleapis.com/maps/api/js?loading=async&key=AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8&libraries=maps,marker"></script>
    </head>
    <body>
        <gmp-map
            center="37.4220656,-122.0840897"
            zoom="10"
            map-id="DEMO_MAP_ID"
            style="height: 500px"></gmp-map>
    </body>
</html>  index.html

Try Sample

JSFiddle.net

Clone Sample

Git and Node.js are required to run this sample locally. Follow these instructions to install Node.js and NPM. The following commands clone, install dependencies and start the sample application.

  
  git 
  
 clone 
  
 https 
 : 
 //github.com/googlemaps-samples/js-api-samples.git 
 
  
  cd 
  
 samples 
 / 
 web 
 - 
 components 
 - 
 map 
 
  
  npm 
  
 i 
 
  
  npm 
  
 start

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-06-09 UTC.