Security notice: We have become aware of a security issue that may be affecting websites using specific third-party libraries (including polyfill.io). This issue can sometimes redirect visitors away from the intended website without website owner knowledge or permission. Many of our JavaScript samples previously included a polyfill.io script declaration. We have removed this from our samples. If you have used our JavaScript samples that contain this declaration, we recommend removing the declaration.

Announcement: New basemap styling is coming soon to Google Maps Platform. This update to map styling includes a new default color palette, modernized pins, and improvements to map experiences and usability. All map styles will be automatically updated in March 2025. For more information on availability and how to opt in earlier, see New map style for Google Maps Platform.

3D models

Image of windmills in 3D map

You can use the Photorealistic 3D Maps in Maps JavaScript API to render GLTF 3D models directly into 3D maps. These realistic 3D objects can represent buildings, landmarks, or other custom objects, and can enhance both the visual appeal and functionality of your maps.

The models should support the core properties of the glTF PBR. No extensions or extension properties are supported.

Add a model to a map

To add a model to a map, use the gmp-model-3d element, as shown below. Models are clamped to the ground by default when omitting the altitude-mode attribute.

<gmp-model-3d position="lat,lng,altitude" altitude-mode="string" orientation="heading,tilt,roll" scale="x,y,z|number" src="string"></gmp-model-3d>

Next steps

Learn how to add your own 3D models to maps in the 3D models sample.