The Places fields
scope are deprecated as of
September 3, 2019, and will be turned off on
June 3, 2020. We strongly recommend replacing ALL Place
references retrieved prior to September 14, 2018 with new Place ID values. This
guide shows you how to update these values, and provides further details about
these Places fields.
reference fields are replaced by the
place_id field. Please
update your apps to use the
place_id field as soon as possible. If you are
still using stored values from the
reference fields prior to
September 14, 2018, replace them with
Place Details currently supports two different ways to request details for a
Place: by providing either Place IDs (
place_id) or references (
the request parameters. Place IDs, which are used by all Google Maps Platform
APIs, are the preferred method; Place references are deprecated, and will be
turned off on June 3, 2020.
Since September 12, 2018, Place references are no longer returned in Places API
responses. Instead, the
reference field in all Places API responses contains
a Place ID. Place Details requests also accept Place IDs in the
request parameter. Thanks to this transparent change, applications that request
Place Details by references received from Places API responses are effectively
using Place IDs without changes.
Retrieve a Place ID using the
To replace ALL stored values that were received in the
fields in Places API responses, follow these steps:
- Make a Place Details request
referencefield. Note that there is no way to retrieve places by their
- Store the resulting
place_idparameter for all Places API Place Details requests. Note that this will result in
INVALID_REQUESTerrors if the content of the
place_idparameter is a Place reference instead of a Place ID value.
The following example shows a Place Details request using the
parameter to pass a Place reference:
When a Place ID value is available, always use the
place_id parameter, as shown in this example:
scope fields have no equivalent, as these fields were only
used for the Place Add service which was turned off in July 2018. Please
ensure that your Place Details requests do not specify this field.
If you are using any of the Client Libraries for Google Maps Web Services, please update to the latest version as soon as possible.