Places API Usage and Billing

Pay-As-You-Go Pricing

The Places API uses a pay-as-you-go pricing model.

How usage and billing work under the pay-as-you-go model

  • The Google Maps Platform APIs are billed by SKU.
  • Usage is tracked for each Product SKU, and an API may have more than one Product SKU.
  • Cost is calculated by: SKU Usage x Price per each use.
  • For each billing account, for qualifying Google Maps Platform SKUs, a $200 USD Google Maps Platform credit is available each month, and automatically applied to the qualifying SKUs.

See guide to understanding billing for more information.

Pricing for the Places API

Under the pay-as-you-go pricing model, requests for the Places API are billed by SKU.

About Autocomplete sessions

An Autocomplete session includes some Autocomplete requests (to retrieve suggestions on a place as the user types), and at most one Places Details request (to retrieve details about the place selected by the user). The same session token is passed to the Autocomplete and the subsequent Place Detail request. A session starts with the first Autocomplete request (which typically happens when the user starts typing). A Places Details call is made when the user has selected one of the Autocomplete suggestions. If a user does not select a suggestion, no Places Details call is made.

After a user has selected a place (a Places Details call is made), you must start a new session using a new session token.

Autocomplete sessions can be generated from the following APIs:

A session token is good for one user session and should not be used for more than one user session. If you reuse a session token, the session is considered invalid and the requests are charged as if no session token was provided.

The Autocomplete requests and the Places Details requests using sessions are billed on different SKUs.

About Places Data SKUs

One or more Data SKUs are triggered for each Places request, depending on the fields that are specified in the request.

The following Places APIs calls support specifying the data fields in the request. Data requests generate a charge in addition to the cost of the Places request. Data charges are always in tandem with the Places requests.

The following Places APIs calls support specifying the data fields to return:

The following Places APIs calls DO NOT support specifying the returned fields. These calls always return all the Places data, charging the three Places Data SKUs in addition to the charge for each API request:

SKU: Basic Data

Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Basic category are included in the base cost of the Places request and do not result in any additional charge. The Basic Data SKU is triggered when any of these fields are requested: address_component, adr_address, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity.

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
Places request cost
+ 0.00 USD		 Places request cost
+ 0.00 USD		 Places request cost
+ 0.00 USD

SKU: Contact Data

Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Contact category result in an additional charge. The Contact Data SKU is triggered when any of these fields are requested: formatted_phone_number, international_phone_number, opening_hours, website.

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
Places request cost
+ 0.003 USD per each
(+ 3.00 USD per 1000)		 Places request cost
+ 0.0024 USD per each
(+ 2.40 USD per 1000)		 Contact Sales for volume pricing

SKU: Atmosphere Data

Using the fields parameter in your Place Details or Find Place request, you can limit the response to only those fields specified. Fields in the Atmosphere category result in an additional charge. The Atmosphere Data SKU is triggered when any of these fields are requested: price_level, rating, review, user_ratings_total.

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
Places request cost
+ 0.005 USD per each
(+ 5.00 USD per 1000)		 Places request cost
+ 0.004 USD per each
(+ 4.00 USD per 1000)		 Contact Sales for volume pricing

SKU: Autocomplete – Per Character

An Autocomplete – Per Character SKU is charged for requests to the Places API Place Autocomplete service, or the Maps JavaScript API’s Places Autocomplete service, that do not include a session token. Calls made from an invalid Autocomplete session (for example, a session that reuses a session token) are also charged an Autocomplete – Per Character SKU.

MONTHLY VOLUME RANGE
(Price per REQUEST)
0–100,000 100,001–500,000 500,000+
0.00283 USD per each
(2.83 USD per 1000)		 0.00227 USD per each
(2.27 USD per 1000)		 Contact Sales for volume pricing

SKU: Autocomplete without Places Details – Per Session

An Autocomplete without Places Details – Per Session SKU is charged for an Autocomplete session that does not include a Places Details request (within a few minutes of the beginning of the session).

MONTHLY VOLUME RANGE
(Price per SESSION)
0–100,000 100,001–500,000 500,000+
0.017 USD per each
(17.00 USD per 1000)		 0.0136 USD per each
(13.60 USD per 1000)		 Contact Sales for volume pricing

Example

If your application issues the following two calls in a single session:

On your bill, you will see the following SKU listed (when viewing your bill by SKU):

  • Autocomplete without Places Details – Per Session (price starting at 0.017 USD per session)

SKU: Autocomplete (included with Places Details) – Per Session

An Autocomplete (included with Places Details) – Per Session SKU is charged for an Autocomplete session that includes a Places Details request. The autocomplete request is free, and the subsequent Places Details call gets charged based on regular Places Details pricing (described below).

A Places Details request generates Data SKUs (Basic, Contact, and/or Atmosphere) – depending on the fields that are specified in the request. If you do not specify fields in the Place Details request, all Data SKUs are triggered (Basic, Contact, and Atmosphere). To avoid paying for data that you don't need, call Autocomplete.setFields() to specify only the place data that you will use.

MONTHLY VOLUME RANGE
(Price per SESSION)
0–100,000 100,001–500,000 500,000+
0.00 USD (Free) 0.00 USD (Free) 0.00 USD (Free)

Example

If your application issues the following three calls in a single session:

On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Autocomplete (included with Places Details) – Per Session (billed at 0.00 USD)
  • Places Details (price starting at 0.017 USD per session)
  • Basic Data (billed at 0.00 USD)

SKU: Query Autocomplete – Per Character

A Query Autocomplete – Per Character SKU is charged for each request to the Places API Query Autocomplete service, or the Maps JavaScript API’s Places Autocomplete Service (getQueryPredictions()), and the use of the Maps JavaScript API’s SearchBox widget (Query Autocomplete requests are generated as the user types).

MONTHLY VOLUME RANGE
(Price per REQUEST)
0–100,000 100,001–500,000 500,000+
0.00283 USD per each
(2.83 USD per 1000)		 0.00227 USD per each
(2.27 USD per 1000)		 Contact Sales for volume pricing

Pricing by Autocomplete session is not supported using Query Autocomplete. Subsequent Places Details calls get charged based on regular Places Details pricing (described below).

SKU: Places Details

Places Details calls are charged as follows:

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.017 USD per each
(17.00 USD per 1000)		 0.0136 USD per each
(13.60 USD per 1000)		 Contact Sales for volume pricing

The Places Details SKU is generated from the following APIs:

The Places Details SKU is charged whether a session token is provided or not.

A Places Details request also generates Data SKUs (Basic, Contact, and/or Atmosphere), depending on the fields that are specified in the request. If you DO NOT specify fields in the Place Details request, ALL Data SKUs are triggered (Basic, Contact, and Atmosphere), and you are charged for the Places Details request plus the cost of all the data.

Examples

1. You make a Place Details request and specify just the address field: getPlaceDetails(fields: formatted_address). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places Details (price starting at 0.017 USD per session)
  • Basic Data (billed at 0.00 USD)

2. You make a Place Details request and specify the phone number field: getPlaceDetails(fields: formatted_phone_number). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places Details (price starting at 0.017 USD per session)
  • Contact Data (price starting at 0.003 USD per request)

3. You make a Place Details request and specify all the fields (this type of request is the default if you do not specify any fields): getPlaceDetails(). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places Details (price starting at 0.017 USD per session)
  • Basic Data (billed at 0.00 USD)
  • Contact Data (price starting at 0.003 USD per request)
  • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Places Details – ID Refresh

You can use the Places Details request to refresh stale place IDs. These types of requests are free.

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.00 USD (Free) 0.00 USD (Free) 0.00 USD (Free)

Example

You make a Place Details request specifying just the place id field: getPlaceDetails(fields: place_id).

On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places Details – ID Refresh (billed at 0.00 USD)

SKU: Find Place

Find Place is charged for a Find Place request (new feature, available in beta on June 11, 2018).

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.017 USD per each
(17.00 USD per 1000)		 0.0136 USD per each
(13.60 USD per 1000)		 Contact Sales for volume pricing

Find Place requests also generate Data SKUs (Basic, Contact, and/or Atmosphere), depending on the fields that are specified in the request. Like Place Details requests, you can use the fields parameter in your Find Place request to limit the response to only those fields specified. You are billed for the Find Place request as well as the data requested. By default, if NO fields are requested, only the place id is returned, so no additional data charges are incurred.

Examples

1. You make a Find Place request and specify just the address field: FindPlace(fields: formatted_address). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Find Place (price starting at 0.017 USD per call)
  • Basic Data (billed at 0.00 USD)

2. You make a Find Place request and specify the phone number field: FindPlace(fields: formatted_phone_number). On your bill, you will see following SKUs listed (when viewing your bill by SKU):

  • Find Place (price starting at 0.017 USD per call)
  • Contact Data (price starting at 0.003 USD per request)

3. You make a Find Place request and specify fields from all three data-type buckets: FindPlace(fields: formatted_address, opening_hours, price_level). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Find Place (price starting at 0.017 USD per call)
  • Basic Data (billed at 0.00 USD)
  • Contact Data (price starting at 0.003 USD per request)
  • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Find Place – ID only

Find Place – ID only is charged for Find Place requests (new feature, available in beta on June 11, 2018) that only specify the Place ID to be returned. By default, if no fields are specified in the Find Place request, only the place id is returned.

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.00 USD (Free) 0.00 USD (Free) 0.00 USD (Free)

Example

You make a Find Place request and do not specify any fields: FindPlace(). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Find Place – ID only (billed at 0.00 USD)

Places – Nearby Search is charged for requests to the Places API Nearby Search service, and to the Maps JavaScript API’s Places Nearby Search service (nearbySearch()).

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.032 USD per each
(32.00 USD per 1000)		 0.0256 USD per each
(25.60 USD per 1000)		 Contact Sales for volume pricing

Nearby Search requests return a list of places, but do not support specifying which fields are returned. Nearby Search requests return a subset of the supported data fields. You are charged for the Nearby Search request starting at 0.032 USD per each, as well as all of the data-type SKUs (Basic Data, Contact Data, and Atmosphere Data).

Example

You make a Nearby Search request, for example: NearbySearch(San Francisco, 100 meters). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places - Nearby Search (price starting at 0.032 USD per call)
  • Basic Data (billed at 0.00 USD)
  • Contact Data (price starting at 0.003 USD per request)
  • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Places – Text Search

Places – Text Search is charged for requests to the Places API Text Search service, and to the Maps JavaScript API’s Places Text Search service (textSearch()).

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.032 USD per each
(32.00 USD per 1000)		 0.0256 USD per each
(25.60 USD per 1000)		 Contact Sales for volume pricing

Text Search requests return a list of places, but do not support specifying which fields are returned. Text Search requests return a subset of the supported data fields. You are charged for the Text Search request starting at 0.032 USD per each, as well as all of the data-type SKUs (Basic Data, Contact Data, and Atmosphere Data).

The Places – Text Search SKU is also generated by the Maps JavaScript API’s Places SearchBox widget: getPlaces() method after the user selects a place query (icon: magnifier), not a result (icon: pin), as illustrated here:

Places Details Search Box Widget Query Selection
In the results of the search box widget, after typing "pizza" in the search box, notice that pizza delivery has a magnifier icon next to it, indicating that it is a place query (and not a result).

Example

You make a Text Search request, for example: TextSearch(123 Main Street). On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Places - Text Search (price starting at 0.032 USD per call)
  • Basic Data (billed at 0.00 USD)
  • Contact Data (price starting at 0.003 USD per request)
  • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Places Photo

A Places Photo SKU is charged for requests to the Places API Place Photos service, and to the Places Library, Maps JavaScript API’s Place Photos service (using photos.getURL() to fetch and load Photo URLs).

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.007 USD per each
(7.00 USD per 1000)		 0.0056 USD per each
(5.60 USD per 1000)		 Contact Sales for volume pricing

Other Usage Limits

While you are no longer limited to a maximum number of requests per day (QPD), the following usage limits still apply when using the Places API:

  • Rate limit is 100 requests per second (QPS). It is calculated as the sum of client-side and server-side requests for all applications using the credentials of the same project.

Terms of Use Restrictions

For information on terms of use, see policies for the Places API, and the License Restrictions section of the Google Maps Platform Terms of Service.

Manage Your Cost of Use

To manage your cost of use of the Google Maps Platform APIs, you can set daily limits to all requests to any billable API.

To view or change daily billable limits for the Places API, do the following:

  1. Go to the Places API Quotas page in the Google Cloud Platform Console.
  2. From the projects list, select a project.
  3. In the Requests section, on the Requests per day line, click the edit icon, then enter the preferred total billable daily quota, up to the limit (if any) specified by Google.

If your API usage reaches your billable limit on any given day, your application will not be able to access the API for the remainder of that day.

Related resources

Premium Plan Customers

Starting November 1, 2018, Premium Plan customers will be able to migrate to the new Google Maps Platform pay-as- you-go pricing plan once their current Premium Plan contract expires. Only contracts whose end date is November 1, 2018, or later, are eligible to be migrated to Google Maps Platform. Contracts expiring prior to that date must be renewed on Premium Plan. For more information, see the Maps Platform Migration Guide.

Premium Plan Usage Limits

Google Maps APIs Premium Plan customers:

  • Requests applied against the annual purchase of Maps APIs Credits.
  • Rate limit applied per user session, regardless of how many users share the same project.

See Premium Plan Usage Rates and Limits for more information.

发送以下问题的反馈：

此网页
文档反馈
Places API
产品反馈