The Vector Map is the same map your users are familiar with using on maps.google.com, and offers a number of advantages over the default raster tile map, the two most noticeable being the sharpness of vector-based images, and the addition of 3D buildings at close zoom levels.
To use the Vector Map, do the following:
- Create a Vector-Map-enabled Map ID.
- Update your bootstrap request.
- Load a static map for fast rendering (optional).
Create a Vector-Map-enabled Map ID
To create a Map ID that uses the Vector Map, follow the steps in Using Cloud-based Map Styling - Get a Map ID to create a new Map ID, set the Map type to JS and select Vector.
Update your bootstrap request
v=beta parameter to the
<script src="https://maps.googleapis.com/maps/api/js?key=KEY&v=beta&callback=yourInitMapMethod"> </script>
Load a static map for fast rendering
A common strategy for improving map loading performance is to load a static map, which will be displayed while the dynamic map renders. For more information, see Vector Static Map.
Browser and device support
Browser and device support matches that for Google Maps.
You can find more information about browser blacklists for vector maps here. Map IDs associated with vector maps will revert to raster maps on these browsers.
Developers can check if a browser on a particular device supports vector maps here.
If you encounter rendering errors, use
and a screenshot with bug reports, if possible.
Mobile web support
Mobile web support for vector maps is still experimental. If you want to use a raster map instead of a vector map, use client APIs to detect mobile web browsers and use a Map ID associated with the raster map.
As with other vector map renderers, slower rendering performance is expected for some mobile devices. If you choose to use vector maps on a mobile web platform, we welcome your performance statistics and feedback. If vector maps support is not available, a vector Map Id will fallback to using a raster map automatically.