Product Updates
We’ve made updates to a number of our APIs. Learn more below.
Maps | Routes | Places | Quota | Brand and product name changes
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
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
, formatted_address
, geometry
, icon
, name
, permanently_closed
, photo
, place_id
, plus_code
, 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);
Find Place
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.
To enable APIs or set up billing, we'll guide you through a few tasks:
- Pick product(s) below
- Select a project
- Set up your billing