1. https://appdevelopermagazine.com/programming
  2. https://appdevelopermagazine.com/google-maps-api-updates-include-styling-boundaries/
7/1/2022 8:48:02 AM
Google Maps API updates include styling boundaries
App Developer Magazine
Google Maps API updates include styling boundaries


Google Maps API updates include styling boundaries

Friday, July 1, 2022

Richard Harris Richard Harris

Google has announced the release of the Google Maps JavaScript API that is data-driven and enables developers to style boundaries. The styling has many use cases including helping users more easily visualize the area, supporting interactive user experiences, creating choropleth maps, and a lot more.

Displaying data through maps enables you to communicate key information to your users in a more visually engaging and intuitive way. One way to do this is by utilizing polygons to highlight regions and data. Many of you have told us that purchasing, updating, and maintaining your own boundary data to style polygons and create choropleth maps is expensive and takes a lot of development time and resources. One of the most commonly requested features you have asked for is access to the same boundaries and polygons used in Google Maps to build informative and engaging maps for your customers. They have announced the preview release of Data-driven styling for the Maps JavaScript API, which enables you to display and style Google boundaries.

What is Data-driven styling?

Data-driven styling is a new capability that enables you to style your maps to visually convey key information to your users, using your proprietary data (e.g. store inventory) or publicly available data (e.g. election results).

The first capability we are enabling with Data-driven styling is the ability for you to easily display Google’s polygons for administrative boundaries, or enhance your own tabular business data with Google’s administrative boundaries to style polygons or create rich, customized choropleth maps. This opens up possibilities for new visually engaging user experiences and provides additional context to users on areas they care about, helping them make more informed decisions and save time.

Google Maps JavaScript API preview release

Data-driven styling provides the same polygons for boundaries you see on Google Maps. Access country boundaries around the world, and for select countries we provide access to additional administrative boundary types such as localities, postal codes, and more. And Google manages the administrative boundary data for you, removing the need for you to purchase, update, and maintain boundary data yourself.

"The ability to highlight geographical boundaries on a map was a long-awaited feature from our customers. It enables many new use cases where you previously had to worry about challenging technical aspects and costly data acquisition. Google Maps Platform is a source that provides high-quality polygons", said Martin Kleppe, Co-founder of Ubilabs.

Key use cases

Key use cases

Data-driven styling enables a wide range of use cases that utilize boundary data across various industries, including real estate, travel, media, government, education, and many more. You can define the style and display the polygon for a specific administrative boundary that you choose.

To help a user easily visualize if a listing is in the desired area, you can provide context for a home, hotel, or store search by displaying the polygon for the locality or postal code that they searched.

It also enables you to create a choropleth map for an administrative boundary type, using Google’s boundary data and your own or sourced tabular business data. For example, style multiple country, administrative area level 1, locality, or postal code boundaries by Covid-19 cases, home prices, or election results.

Data-driven styling also provides support for interactive user experiences. Clicking a polygon on your map returns metadata to your apps, including Place ID, feature type, and display name of the clicked polygon. These events are useful for experiences where you wish to restyle the map based on user interactions.

Using data driven styling

Using Data-driven styling

To enable Data-driven styling, select the feature layers you want to enable for a new or existing Map Style in the Google Cloud Console, and associate that style with a Map ID that has the vector map for JavaScript enabled. Please note that Data-driven styling is not supported for Static Maps or the raster tile map in JavaScript.

You’ll find the feature layers dropdown in the settings for your Map Styles over the coming days.

Then apply a FeatureStyleOptions object or FeatureStyleFunction to a feature layer in your code. You can customize fill and stroke color, fill and stroke opacity, and stroke weight for each feature layer.

"At AppGeo, we have been building applications on Google Maps Platform for many years and the Data-driven styling feature is just another example of how Google continues to make it easier for mapping novices and experts alike to bring their spatial insights to light. Data-driven styling provides much easier access to the most commonly desired geographies for aggregating and visualizing data. We can now bring client data to life faster with less supporting data infrastructure and would be happy to help anyone interested in learning how to leverage these new assets," said David Breeding, Principal/Director of Analytics, AppGeo.


For the preview release, Data-driven styling provides access to feature types for administrative areas including countries, localities, postal codes, and much more.

Visit our coverage table in the documentation to view supported countries and available feature types. We will continue to roll out additional coverage throughout the preview phase. If there are specific countries and feature types you’d like added, please provide your feedback through our Issue Tracker.

Styling polygons using the Place ID

Styling polygons using the Place ID

A common use case for Data-driven styling is to style individual polygons or a subset of polygons within a feature type, such as a limited set of countries or localities. The best way to do this is by referencing those boundaries using their Place IDs, which we allow you to cache indefinitely.

To make prefetching of Place IDs for individual regions easier, we are providing a region lookup utility that gives you the option to provide geographic coordinates, address, place name, ISO Code, or FIPS code and returns the Place ID of the region available at that location. This utility is an open-source library for JavaScript available on our Google Maps repository on GitHub. Alternatively, you can use Geocoding, Place Search, or Autocomplete to retrieve Place IDs for regions.

How to get started

Data-driven styling is included with Dynamic Maps for Maps Javascript API. Developers can use Data-driven styling and other Cloud-based map styling features for Dynamic Maps by creating a Javascript Vector Map configured MapID in Google Cloud Console. In the future, we plan to introduce additional capabilities that will extend Data-driven styling to help you build more customized visualization and interactive experiences for your users and to leverage your unique data.

Data-driven styling will be available in Preview over the next week for the Maps JavaScript API, visit our documentation to give it a try and let us know what you think. Also, check out our new Dynamic Maps webpage to learn more, try the demo, and learn about other Cloud-based maps styling use cases and capabilities. Our team is eager to see what new possibilities these features open up for styling your maps.

Subscribe to App Developer Magazine

Become a subscriber of App Developer Magazine for just $5.99 a month and take advantage of all these perks.


  • - Exclusive content from leaders in the industry
  • - Q&A articles from industry leaders
  • - Tips and tricks from the most successful developers weekly
  • - Monthly issues, including all 90+ back-issues since 2012
  • - Event discounts and early-bird signups
  • - Gain insight from top achievers in the app store
  • - Learn what tools to use, what SDK's to use, and more

    Subscribe here