Menu

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

100 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.

Enable Google Maps Platform

To enable APIs or set up billing, we'll guide you through a few tasks:

  1. Pick product(s) below
  2. Select a project
  3. Set up your billing

Build customized map experiences that bring the real world to your users.

Give your users the best way to get from A to Z.

Help users discover the world with rich details.

You are now signed in.
Click "Continue" to select a project.
Continue Continue Continue Continue Continue Continue Continue