Stay organized with collectionsSave and categorize content based on your preferences.
This sample demonstrates how to use the Places service'sgetDetails()method to retrieve Place Details for a particular place, and add a marker to the
map which displays the details when clicked.
// This example requires the Places library. Include the libraries=places// parameter when you first load the API. For example:// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places">functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{center:{lat:-33.866,lng:151.196},zoom:15,});constrequest={placeId:"ChIJN1t_tDeuEmsRUsoyG83frY4",fields:["name","formatted_address","place_id","geometry"],};constinfowindow=newgoogle.maps.InfoWindow();constservice=newgoogle.maps.places.PlacesService(map);service.getDetails(request,(place,status)=>{if(status===google.maps.places.PlacesServiceStatus.OK&&place&&place.geometry&&place.geometry.location){constmarker=newgoogle.maps.Marker({map,position:place.geometry.location,});google.maps.event.addListener(marker,"click",()=>{constcontent=document.createElement("div");constnameElement=document.createElement("h2");nameElement.textContent=place.name!;content.appendChild(nameElement);constplaceIdElement=document.createElement("p");placeIdElement.textContent=place.place_id!;content.appendChild(placeIdElement);constplaceAddressElement=document.createElement("p");placeAddressElement.textContent=place.formatted_address!;content.appendChild(placeAddressElement);infowindow.setContent(content);infowindow.open(map,marker);});}});}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
// This example requires the Places library. Include the libraries=places// parameter when you first load the API. For example:// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places">functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{center:{lat:-33.866,lng:151.196},zoom:15,});constrequest={placeId:"ChIJN1t_tDeuEmsRUsoyG83frY4",fields:["name","formatted_address","place_id","geometry"],};constinfowindow=newgoogle.maps.InfoWindow();constservice=newgoogle.maps.places.PlacesService(map);service.getDetails(request,(place,status)=>{if(status===google.maps.places.PlacesServiceStatus.OK&&place&&place.geometry&&place.geometry.location){constmarker=newgoogle.maps.Marker({map,position:place.geometry.location,});google.maps.event.addListener(marker,"click",()=>{constcontent=document.createElement("div");constnameElement=document.createElement("h2");nameElement.textContent=place.name;content.appendChild(nameElement);constplaceIdElement=document.createElement("p");placeIdElement.textContent=place.place_id;content.appendChild(placeIdElement);constplaceAddressElement=document.createElement("p");placeAddressElement.textContent=place.formatted_address;content.appendChild(placeAddressElement);infowindow.setContent(content);infowindow.open(map,marker);});}});}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;}
<html>
<head>
<title>Place Details</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<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&libraries=places&v=weekly"
defer
></script>
</body>
</html>
Git and Node.js are required to run this sample locally. Follow theseinstructionsto 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-09-04 UTC."],[[["\u003cp\u003eThis sample demonstrates retrieving Place Details using the Places service's \u003ccode\u003egetDetails()\u003c/code\u003e method and displaying them in a marker's info window.\u003c/p\u003e\n"],["\u003cp\u003eThe sample utilizes the Google Maps JavaScript API and the Places library to fetch place information like name, address, and place ID.\u003c/p\u003e\n"],["\u003cp\u003eUsers can interact with the map by clicking on the marker, triggering the display of the retrieved place details in an info window.\u003c/p\u003e\n"],["\u003cp\u003eSample code is provided in both JavaScript and TypeScript, along with HTML and CSS for basic styling and map setup.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can clone and run the sample locally or try it on JSFiddle and Google Cloud Shell.\u003c/p\u003e\n"]]],[],null,["This sample demonstrates how to use the Places service's\n[`getDetails()`](/maps/documentation/javascript/places#place_details_requests)\nmethod to retrieve Place Details for a particular place, and add a marker to the\nmap which displays the details when clicked.\n\nRead the [documentation](/maps/documentation/javascript/places#place_details). \n\nTypeScript \n\n```typescript\n// This example requires the Places library. Include the libraries=places\n// parameter when you first load the API. For example:\n// \u003cscript src=\"https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places\"\u003e\n\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n center: { lat: -33.866, lng: 151.196 },\n zoom: 15,\n }\n );\n\n const request = {\n placeId: \"ChIJN1t_tDeuEmsRUsoyG83frY4\",\n fields: [\"name\", \"formatted_address\", \"place_id\", \"geometry\"],\n };\n\n const infowindow = new google.maps.InfoWindow();\n const service = new google.maps.places.PlacesService(map);\n\n service.getDetails(request, (place, status) =\u003e {\n if (\n status === google.maps.places.PlacesServiceStatus.OK &&\n place &&\n place.geometry &&\n place.geometry.location\n ) {\n const marker = new google.maps.Marker({\n map,\n position: place.geometry.location,\n });\n\n google.maps.event.addListener(marker, \"click\", () =\u003e {\n const content = document.createElement(\"div\");\n\n const nameElement = document.createElement(\"h2\");\n\n nameElement.textContent = place.name!;\n content.appendChild(nameElement);\n\n const placeIdElement = document.createElement(\"p\");\n\n placeIdElement.textContent = place.place_id!;\n content.appendChild(placeIdElement);\n\n const placeAddressElement = document.createElement(\"p\");\n\n placeAddressElement.textContent = place.formatted_address!;\n content.appendChild(placeAddressElement);\n\n infowindow.setContent(content);\n infowindow.open(map, marker);\n });\n }\n });\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/place-details/index.ts#L8-L71\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\n// This example requires the Places library. Include the libraries=places\n// parameter when you first load the API. For example:\n// \u003cscript src=\"https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places\"\u003e\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n center: { lat: -33.866, lng: 151.196 },\n zoom: 15,\n });\n const request = {\n placeId: \"ChIJN1t_tDeuEmsRUsoyG83frY4\",\n fields: [\"name\", \"formatted_address\", \"place_id\", \"geometry\"],\n };\n const infowindow = new google.maps.InfoWindow();\n const service = new google.maps.places.PlacesService(map);\n\n service.getDetails(request, (place, status) =\u003e {\n if (\n status === google.maps.places.PlacesServiceStatus.OK &&\n place &&\n place.geometry &&\n place.geometry.location\n ) {\n const marker = new google.maps.Marker({\n map,\n position: place.geometry.location,\n });\n\n google.maps.event.addListener(marker, \"click\", () =\u003e {\n const content = document.createElement(\"div\");\n const nameElement = document.createElement(\"h2\");\n\n nameElement.textContent = place.name;\n content.appendChild(nameElement);\n\n const placeIdElement = document.createElement(\"p\");\n\n placeIdElement.textContent = place.place_id;\n content.appendChild(placeIdElement);\n\n const placeAddressElement = document.createElement(\"p\");\n\n placeAddressElement.textContent = place.formatted_address;\n content.appendChild(placeAddressElement);\n infowindow.setContent(content);\n infowindow.open(map, marker);\n });\n }\n });\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/place-details/docs/index.js#L7-L57\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}\nhttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/place-details/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003ePlace Details\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=\"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&libraries=places&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/place-details/docs/index.html#L8-L30\n```\n\nTry Sample \n[JSFiddle.net](https://jsfiddle.net/gh/get/library/pure/googlemaps/js-samples/tree/master/dist/samples/place-details/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-place-details&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-place-details 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"]]
