Product Updates

We’ve made updates to a number of our APIs. Learn more below.

Maps

There are no product changes for Maps. Please see API-specific billing changes.

Routes

There are no product changes for Routes. Please see API-specific billing changes.

Places

Places Details requests can be constrained to specific fields

Places Details requests have been updated to return only the fields that you specify. Previously, Places Details requests returned all of the available data associated with the specified place. With this change, the response is limited to only those fields specified using the fields parameter. The fields correspond to Places Details results, and are divided into three billing categories: Basic, Contact, and Atmosphere. The cost for each request varies depending on which fields are selected; however, if no fields are specified, all available data for the specified place will be returned, and you will be billed the maximum amount.

All Places Details requests will be billed at the base rate.

The Basic category does not result in any additional charge and includes the following fields:

address_component, adr_address, alt_id, formatted_address, geometry, icon, id, name, permanently_closed, photo, place_id, plus_code, scope, type, url, utc_offset, vicinity

The Contact category results in an additional charge and includes the following fields:

formatted_phone_number, international_phone_number, opening_hours, website

The Atmosphere category results in an additional charge and includes the following fields:

price_level, rating, review

Note: Attributions (html_attributions) are always returned with every call, regardless of whether it has been requested.

What you can do:

Evaluate your apps to see which Places Details data you're currently using
Update your code to add the fields parameter
Log in to the Google Cloud Platform Console to understand your current Places API usage (for help with the Console, please visit the Google Account Help Center)

Examples

You can use the fields parameter to specify the fields to return for a Places Details request, as shown in the following examples (the name, rating, and formatted_phone_number fields are specified):

Web Service

https://maps.googleapis.com/maps/api/place/details/json?placeid={PLACE_ID}&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY

JavaScript

const placeId = 'not_actually_a_place_id';
const request = {
  placeId: placeId,
  fields: ['name', 'rating', 'formatted_phone_number']
};
const service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback);

Web Services

A new Find Place service has been introduced for web services, which takes a text input or phone number, and returns a place. The text input can be any kind of Places data, for example, a name, address, or phone number. You must use the fields parameter with Find Place to receive the fields you need. Fields from the Basic, Contact, or Atmosphere categories are billed the same way as a Places Details request. If no fields are specified, the PlaceId for the place found will be returned, and you will not be billed.

What you can do:

Consider migrating your existing Place Search requests to use Find Place.

JavaScript

Two new Find Place APIs have been introduced for JavaScript. The Find Place From Query service takes a text query and returns a Place. The query can be any kind of Places data, for example a name or address. The Find Place From Phone Number service takes a phone number as input and returns a Place. You must use the fields parameter with both Find Place APIs to receive the fields you need. Fields from the Basic, Contact, or Atmosphere categories are billed the same way as a Places Details request. The fields parameter is required, if no fields are specified, the request will result in an error.

What you can do

Consider migrating your existing Text Search requests to use Find Place instead.

Examples

The following examples show a Places API Web Service Find Place request for “Museum of Contemporary Art Australia”, including the photos, formatted_address, name, rating, opening_hours, and geometry fields.

Web service

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

JavaScript

var map;
var service;
var infowindow;

function initMap() {
  var circularquay = new google.maps.LatLng(-33.8617374,151.2021291);

  map = new google.maps.Map(document.getElementById('map'), {
    center: circularquay,
    zoom: 15
  });

  var request = {
    query: 'Museum of Contemporary Art Australia',
    fields: ["photos", "formatted_address", "name", "rating", "opening_hours", "geometry"],
  };

  service = new google.maps.places.PlacesService(map);
  service.findPlaceFromQuery(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      var place = results[i];
      createMarker(results[i]);
    }
  }
}

Mobile SDKs for Places

Google is currently preparing new versions of the Places SDK for Android, and the Places SDK for iOS. The following section describes the changes and explains how they will affect you.

A new Places SDK for Android will be made available as a standalone library, and will no longer be available through Google Play services; This version will not be backward-compatible with the current SDK
A new Places SDK for iOS will be made available

It's worth noting that several Places SDK features will be updated to reflect overall Places API changes, affecting both mobile platforms:

Places Details (Android, iOS) request will have a new fields parameter.
Autocomplete billing will be session-based.

In the coming months we will share more details including a timeline and appropriate lead time to migrate to the new SDK versions. These new versions will replace the current SDK versions. The current SDKs will be deprecated and will follow appropriate deprecation timelines.

Maps Elevation API

With the launch of Google Maps Platform, new customers will need to contact Support for access to the Maps Elevation API. Keyless users who are currently using this API, please make sure you sign up for a Google Cloud account and enable the Maps Elevation API as soon as possible.

Quota

New Query per Second (QPS) limits and usage caps

There will be no more daily quota caps (QPD), and there will be new higher Query Per Second (QPS) limits for most of our services. All current self-serve customers will be automatically transitioned to the new QPS limits and caps.

API	Current default usage caps	New default usage caps
Directions	100k QPD, 50 QPS	50 QPS
Distance Matrix	100k EPD, 100 EPS	1000 EPS
Elevation	100k QPD, 50 QPS	100 QPS
Geocoding	100k QPD, 50 QPS	50 QPS
Geolocation	100k QPD, 50 QPS	100 QPS
Dynamic Maps	100k QPD	500 QPS
Static Maps	100k QPD	500 QPS
Street View Image API	100k QPD	500 QPS
Time Zone	100k QPD, 50 QPS	500 QPS
Places (JavaScript and web)	150k QPD	50 QPS
Roads	100k QPD	500 QPS

*EPS = Element Per Second, EPD = Element Per Day, QPS = Query Per Second, QPD = Query Per Day

If you're limiting your requests using the previous default API daily quota limits, you can keep the same behavior by adding a daily quota limit for your project, in the Google Cloud Platform Console. Learn more.

Brand and product name changes

How are the brand and product names changing?

First, we have changed our brand name to Google Maps Platform, which includes the same APIs you know and love, with simplified billing and an easier path to scale as you grow. In addition, we now offer comprehensive industry solutions for the gaming, ridesharing, and asset tracking industries. We will continue to provide you access to the extensive global coverage of Google Maps infrastructure, serving more than one billion users in over 200 countries and territories.

Second, with Google Maps Platform, our APIs have been simplified into three core products: Maps, Routes, and Places. Each core product includes several features and are powered by different APIs. To view features and APIs by product, visit our documentation page.

Third, we've simplified the names of our APIs and billing SKUs to make them easier to find and use. Below is a list of the new names. For details on how the new SKUs are triggered, see the guide to understanding billing.

API name changes

Old name	New names
Google Maps Android API	Maps SDK for Android
Google Maps Directions API	Directions API
Google Maps Distance Matrix API	Distance Matrix API
Google Maps Geocoding API	Geocoding API
Google Maps Geolocation API	Geolocation API
Google Maps JavaScript API	Maps JavaScript API
Google Maps Roads API	Roads API
Google Maps SDK for iOS	Maps SDK for iOS
Google Maps Time Zone API	Time Zone API
Google Places API for Android	Places SDK for Android
Google Places API for iOS	Places SDK for iOS
Google Places API Web Service	Places API
Google Static Maps API	Maps Static API
Google Street View Image API	Street View API
Places Library in the Maps JavaScript API	Places Library, Maps JavaScript API

Billing SKU name changes

Product	Billing SKU: New name	Description
Maps
	Static Maps	Display static maps. Style them with custom markers, lines, colors, polygons, and images.
	Dynamic Maps	Display interactive maps. Zoom, pinch, rotate, and tilt maps to explore in more detail, and style.
	Static Street View	Display a static Street View, 360-degree panoramic, or thumbnail image.
	Dynamic Street View	Display an interactive Street View, 360-degree panoramic, or thumbnail image.
Routes
	Directions	Get directions for driving, walking, biking, and transit, and create routes with up to 10 waypoints.
	Directions Advanced	Get multi-modal directions, create routes with up to 25 waypoints, and access real-time traffic.
	Distance Matrix	Deliver travel times and distances for one or more locations.
	Distance Matrix Advanced	Deliver travel times and distances for one or more locations, using real-time traffic.
	Roads - Route Traveled	Create itineraries by determining the route traveled, collecting up to 100 GPS points along a route.
	Roads - Nearest Road	Determine the nearest roads using up to 100 independent coordinates.
Places
	Basic Data	Provide names and addresses for over 100 million places and points of interest.
	Contact Data	Provide names, addresses, and contact info for over 100 million places and points of interest.
	Atmosphere Data	Provide names, addresses, contact info, and rich details like ratings and atmosphere for over 100 million places and points of interest.
	Places Photo	Add a high-quality photo to places and points of interest with access to millions of photos.
	Places - Text Search	Return a list of nearby places based on a search string (like 'sushi restaurant.')
	Places - Nearby Search	Return a list of nearby places based on a user's location.
	Find Place	Turn a phone number, address, or name into a place, and provide its name and address.
	Autocomplete with Details	Autocomplete place suggestions with Places Details.
	Autocomplete - Per Request	Autocomplete place suggestions when the user enters an address or a place name. Billed by characters typed.
	Autocomplete - Per Session	Autocomplete place suggestions when the user enters an address or a place name. Billed by session.
	Geolocation	Return the location and accuracy radius of a device based on Wi-Fi or cell towers.
	Geocoding	Convert addresses to geographic coordinates, or geographic coordinates to addresses.
	Time Zone	Return a time zone for any location, based on geographic coordinates and date.