// Initialize the map.functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{zoom:8,center:{lat:40.72,lng:-73.96},});constgeocoder=newgoogle.maps.Geocoder();constinfowindow=newgoogle.maps.InfoWindow();(document.getElementById("submit")asHTMLElement).addEventListener("click",()=>{geocodePlaceId(geocoder,map,infowindow);});}// This function is called when the user clicks the UI button requesting// a geocode of a place ID.functiongeocodePlaceId(geocoder:google.maps.Geocoder,map:google.maps.Map,infowindow:google.maps.InfoWindow){constplaceId=(document.getElementById("place-id")asHTMLInputElement).value;geocoder.geocode({placeId:placeId}).then(({results})=>{if(results[0]){map.setZoom(11);map.setCenter(results[0].geometry.location);constmarker=newgoogle.maps.Marker({map,position:results[0].geometry.location,});infowindow.setContent(results[0].formatted_address);infowindow.open(map,marker);}else{window.alert("No results found");}}).catch((e)=>window.alert("Geocoder failed due to: "+e));}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
// Initialize the map.functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{zoom:8,center:{lat:40.72,lng:-73.96},});constgeocoder=newgoogle.maps.Geocoder();constinfowindow=newgoogle.maps.InfoWindow();document.getElementById("submit").addEventListener("click",()=>{geocodePlaceId(geocoder,map,infowindow);});}// This function is called when the user clicks the UI button requesting// a geocode of a place ID.functiongeocodePlaceId(geocoder,map,infowindow){constplaceId=document.getElementById("place-id").value;geocoder.geocode({placeId:placeId}).then(({results})=>{if(results[0]){map.setZoom(11);map.setCenter(results[0].geometry.location);constmarker=newgoogle.maps.Marker({map,position:results[0].geometry.location,});infowindow.setContent(results[0].formatted_address);infowindow.open(map,marker);}else{window.alert("No results found");}}).catch((e)=>window.alert("Geocoder failed due to: "+e));}window.initMap=initMap;
/* * 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:1pxsolid#999;text-align:center;font-family:"Roboto","sans-serif";line-height:30px;padding-left:10px;}#floating-panel{width:440px;}#place-id{width:250px;}
<html> <head> <title>Retrieving an Address for a Place ID</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="floating-panel"> <!-- Supply a default place ID for a place in Brooklyn, New York. --> <input id="place-id" type="text" value="ChIJd8BlQ2BZwokRAFUEcm_qrcA" /> <input id="submit" type="button" value="Get Address for Place ID" /> </div> <div id="map"></div> <!-- The `defer` attribute causes the script to execute after the full HTML document has been parsed. For non-blocking uses, avoiding race conditions, and consistent behavior across browsers, consider loading using Promises. See https://developers.google.com/maps/documentation/javascript/load-maps-js-api for more information. --> <script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly" defer ></script> </body> </html>
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis example demonstrates how to use the Google Maps JavaScript API's geocoding service to retrieve an address for a given Place ID.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes the \u003ccode\u003eGeocoder\u003c/code\u003e object to perform the geocoding request, providing the Place ID as input.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful geocoding, the example updates the map's center and zoom level, adds a marker at the retrieved location, and displays the formatted address in an info window.\u003c/p\u003e\n"],["\u003cp\u003eThe example is provided in both TypeScript and JavaScript, showcasing how to implement the functionality in either language.\u003c/p\u003e\n"],["\u003cp\u003eUsers can try the sample using JSFiddle or Google Cloud Shell, and can also clone and run it locally with Git and Node.js.\u003c/p\u003e\n"]]],[],null,["This example uses geocoding to retrieve an address for a given place ID.\n\nRead the [documentation](/maps/documentation/javascript/geocoding#place-id). \n\nTypeScript \n\n```typescript\n// Initialize the map.\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n zoom: 8,\n center: { lat: 40.72, lng: -73.96 },\n }\n );\n const geocoder = new google.maps.Geocoder();\n const infowindow = new google.maps.InfoWindow();\n\n (document.getElementById(\"submit\") as HTMLElement).addEventListener(\n \"click\",\n () =\u003e {\n geocodePlaceId(geocoder, map, infowindow);\n }\n );\n}\n\n// This function is called when the user clicks the UI button requesting\n// a geocode of a place ID.\nfunction geocodePlaceId(\n geocoder: google.maps.Geocoder,\n map: google.maps.Map,\n infowindow: google.maps.InfoWindow\n) {\n const placeId = (document.getElementById(\"place-id\") as HTMLInputElement)\n .value;\n\n geocoder\n .geocode({ placeId: placeId })\n .then(({ results }) =\u003e {\n if (results[0]) {\n map.setZoom(11);\n map.setCenter(results[0].geometry.location);\n\n const marker = new google.maps.Marker({\n map,\n position: results[0].geometry.location,\n });\n\n infowindow.setContent(results[0].formatted_address);\n infowindow.open(map, marker);\n } else {\n window.alert(\"No results found\");\n }\n })\n .catch((e) =\u003e window.alert(\"Geocoder failed due to: \" + e));\n}\n\ndeclare global {\n interface Window {\n initMap: () =\u003e void;\n }\n}\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/samples/geocoding-place-id/index.ts#L10-L66\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\n// Initialize the map.\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 8,\n center: { lat: 40.72, lng: -73.96 },\n });\n const geocoder = new google.maps.Geocoder();\n const infowindow = new google.maps.InfoWindow();\n\n document.getElementById(\"submit\").addEventListener(\"click\", () =\u003e {\n geocodePlaceId(geocoder, map, infowindow);\n });\n}\n\n// This function is called when the user clicks the UI button requesting\n// a geocode of a place ID.\nfunction geocodePlaceId(geocoder, map, infowindow) {\n const placeId = document.getElementById(\"place-id\").value;\n\n geocoder\n .geocode({ placeId: placeId })\n .then(({ results }) =\u003e {\n if (results[0]) {\n map.setZoom(11);\n map.setCenter(results[0].geometry.location);\n\n const marker = new google.maps.Marker({\n map,\n position: results[0].geometry.location,\n });\n\n infowindow.setContent(results[0].formatted_address);\n infowindow.open(map, marker);\n } else {\n window.alert(\"No results found\");\n }\n })\n .catch((e) =\u003e window.alert(\"Geocoder failed due to: \" + e));\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/geocoding-place-id/docs/index.js#L8-L48\n```\n| **Note:** The JavaScript is compiled from the TypeScript snippet.\n\nCSS \n\n```css\n/* \n * Always set the map height explicitly to define the size of the div element\n * that contains the map. \n */\n#map {\n height: 100%;\n}\n\n/* \n * Optional: Makes the sample page fill the window. \n */\nhtml,\nbody {\n height: 100%;\n margin: 0;\n padding: 0;\n}\n\n#floating-panel {\n position: absolute;\n top: 10px;\n left: 25%;\n z-index: 5;\n background-color: #fff;\n padding: 5px;\n border: 1px solid #999;\n text-align: center;\n font-family: \"Roboto\", \"sans-serif\";\n line-height: 30px;\n padding-left: 10px;\n}\n\n#floating-panel {\n width: 440px;\n}\n\n#place-id {\n width: 250px;\n}\nhttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/geocoding-place-id/docs/style.css#L7-L46\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eRetrieving an Address for a Place ID\u003c/title\u003e\n\n \u003clink rel=\"stylesheet\" type=\"text/css\" href=\"./style.css\" /\u003e\n \u003cscript type=\"module\" src=\"./index.js\"\u003e\u003c/script\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003cdiv id=\"floating-panel\"\u003e\n \u003c!-- Supply a default place ID for a place in Brooklyn, New York. --\u003e\n \u003cinput id=\"place-id\" type=\"text\" value=\"ChIJd8BlQ2BZwokRAFUEcm_qrcA\" /\u003e\n \u003cinput id=\"submit\" type=\"button\" value=\"Get Address for Place ID\" /\u003e\n \u003c/div\u003e\n \u003cdiv id=\"map\"\u003e\u003c/div\u003e\n\n \u003c!-- \n The `defer` attribute causes the script to execute after the full HTML\n document has been parsed. For non-blocking uses, avoiding race conditions,\n and consistent behavior across browsers, consider loading using Promises. See\n https://developers.google.com/maps/documentation/javascript/load-maps-js-api\n for more information.\n --\u003e\n \u003cscript\n src=\"https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly\"\n defer\n \u003e\u003c/script\u003e\n \u003c/body\u003e\n\u003c/html\u003ehttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/geocoding-place-id/docs/index.html#L8-L35\n```\n\nTry Sample \n[JSFiddle.net](https://jsfiddle.net/gh/get/library/pure/googlemaps/js-samples/tree/master/dist/samples/geocoding-place-id/jsfiddle) [Google Cloud Shell](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fgooglemaps%2Fjs-samples&cloudshell_git_branch=sample-geocoding-place-id&cloudshell_tutorial=cloud_shell_instructions.md&cloudshell_workspace=.)\n\nClone Sample\n\n\nGit and Node.js are required to run this sample locally. Follow these [instructions](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to install Node.js and NPM. The following commands clone, install dependencies and start the sample application. \n\n git clone -b sample-geocoding-place-id https://github.com/googlemaps/js-samples.git\n cd js-samples\n npm i\n npm start\n\n\nOther samples can be tried by switching to any branch beginning with `sample-`\u003cvar translate=\"no\"\u003eSAMPLE_NAME\u003c/var\u003e. \n\n git checkout sample-\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nx\"\u003eSAMPLE_NAME\u003c/span\u003e\u003c/var\u003e\n npm i\n npm start"]]