Introducing Places UI Kit :A ready-to-use, low-cost component library that lets you bring the familiar Google Maps UI for Places to any map of your choice. Try it out, and share your input to help shape the future of GMP!

Place Autocomplete Element

This example adds an Autocomplete widget to a web page, and displays the results for each selected place.

Read the documentation .

TypeScript

 async 
  
 function 
  
 initMap 
 () 
 : 
  
 Promise<void> 
  
 { 
  
 // Request needed libraries. 
  
 await 
  
 google 
 . 
 maps 
 . 
 importLibrary 
 ( 
 "places" 
 ) 
  
 as 
  
 google 
 . 
 maps 
 . 
 PlacesLibrary 
 ; 
  
 // Create the input HTML element, and append it. 
  
 //@ts-ignore 
  
 const 
  
 placeAutocomplete 
  
 = 
  
 new 
  
 google 
 . 
 maps 
 . 
 places 
 . 
 PlaceAutocompleteElement 
 (); 
  
 //@ts-ignore 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 placeAutocomplete 
 ); 
  
 // Inject HTML UI. 
  
 const 
  
 selectedPlaceTitle 
  
 = 
  
 document 
 . 
 createElement 
 ( 
 'p' 
 ); 
  
 selectedPlaceTitle 
 . 
 textContent 
  
 = 
  
 '' 
 ; 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 selectedPlaceTitle 
 ); 
  
 const 
  
 selectedPlaceInfo 
  
 = 
  
 document 
 . 
 createElement 
 ( 
 'pre' 
 ); 
  
 selectedPlaceInfo 
 . 
 textContent 
  
 = 
  
 '' 
 ; 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 selectedPlaceInfo 
 ); 
  
 // Add the gmp-placeselect listener, and display the results. 
  
 //@ts-ignore 
  
 placeAutocomplete 
 . 
 addEventListener 
 ( 
 'gmp-select' 
 , 
  
 async 
  
 ({ 
  
 placePrediction 
  
 }) 
  
 = 
>  
 { 
  
 const 
  
 place 
  
 = 
  
 placePrediction 
 . 
 toPlace 
 (); 
  
 await 
  
 place 
 . 
 fetchFields 
 ({ 
  
 fields 
 : 
  
 [ 
 'displayName' 
 , 
  
 'formattedAddress' 
 , 
  
 'location' 
 ] 
  
 }); 
  
 selectedPlaceTitle 
 . 
 textContent 
  
 = 
  
 'Selected Place:' 
 ; 
  
 selectedPlaceInfo 
 . 
 textContent 
  
 = 
  
 JSON 
 . 
 stringify 
 ( 
  
 place 
 . 
 toJSON 
 (), 
  
 /* replacer */ 
  
 null 
 , 
  
 /* space */ 
  
 2 
 ); 
  
 }); 
 } 
 initMap 
 (); 
   index 
 . 
 ts

JavaScript

 async 
  
 function 
  
 initMap 
 () 
  
 { 
  
 // Request needed libraries. 
  
 await 
  
 google 
 . 
 maps 
 . 
 importLibrary 
 ( 
 "places" 
 ); 
  
 // Create the input HTML element, and append it. 
  
 //@ts-ignore 
  
 const 
  
 placeAutocomplete 
  
 = 
  
 new 
  
 google 
 . 
 maps 
 . 
 places 
 . 
 PlaceAutocompleteElement 
 (); 
  
 //@ts-ignore 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 placeAutocomplete 
 ); 
  
 // Inject HTML UI. 
  
 const 
  
 selectedPlaceTitle 
  
 = 
  
 document 
 . 
 createElement 
 ( 
 'p' 
 ); 
  
 selectedPlaceTitle 
 . 
 textContent 
  
 = 
  
 '' 
 ; 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 selectedPlaceTitle 
 ); 
  
 const 
  
 selectedPlaceInfo 
  
 = 
  
 document 
 . 
 createElement 
 ( 
 'pre' 
 ); 
  
 selectedPlaceInfo 
 . 
 textContent 
  
 = 
  
 '' 
 ; 
  
 document 
 . 
 body 
 . 
 appendChild 
 ( 
 selectedPlaceInfo 
 ); 
  
 // Add the gmp-placeselect listener, and display the results. 
  
 //@ts-ignore 
  
 placeAutocomplete 
 . 
 addEventListener 
 ( 
 'gmp-select' 
 , 
  
 async 
  
 ({ 
  
 placePrediction 
  
 }) 
  
 = 
>  
 { 
  
 const 
  
 place 
  
 = 
  
 placePrediction 
 . 
 toPlace 
 (); 
  
 await 
  
 place 
 . 
 fetchFields 
 ({ 
  
 fields 
 : 
  
 [ 
 'displayName' 
 , 
  
 'formattedAddress' 
 , 
  
 'location' 
 ] 
  
 }); 
  
 selectedPlaceTitle 
 . 
 textContent 
  
 = 
  
 'Selected Place:' 
 ; 
  
 selectedPlaceInfo 
 . 
 textContent 
  
 = 
  
 JSON 
 . 
 stringify 
 ( 
 place 
 . 
 toJSON 
 (), 
  
 /* replacer */ 
  
 null 
 , 
  
 /* space */ 
  
 2 
 ); 
  
 }); 
 } 
 initMap 
 (); 
   index 
 . 
 js

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 
 ; 
 } 
 p 
  
 { 
  
 font-family 
 : 
  
 Roboto 
 , 
  
 sans-serif 
 ; 
  
 font-weight 
 : 
  
 bold 
 ; 
 } 
   style 
 . 
 css

HTML

<html>
  <head>
    <title>Place Autocomplete element</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <p style="font-family: roboto, sans-serif">Search for a place here:</p>

    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "weekly"});</script>
  </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 
 / 
 place 
 - 
 autocomplete 
 - 
 element 
 
  
  npm 
  
 i 
 
  
  npm 
  
 start