Places SDK for Android Usage and Billing

Before you begin

To use the Places SDK for Android, you must include an API key with all API requests, and you must enable billing on each of your projects.

Pay-As-You-Go pricing

The Places SDK for Android uses a pay-as-you-go pricing model.

How usage and billing works 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 SDK for Android

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

About Places Data SKUs

One or more Data SKUs are triggered for each request to fetchPlace(), or findCurrentPlace(), in addition to the cost of the Places request. Data charges are always in tandem with method requests.

SKU: Basic Data

Using an array of Place.Fields, 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, BUSINESS_STATUS, ID, LAT_LNG, NAME, PHOTO_METADATAS, PLUS_CODE, TYPES, UTC_OFFSET, VIEWPORT.

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 an array of Place.Fields, 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: OPENING_HOURS, PHONE_NUMBER, WEBSITE_URI.

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 an array of Place.Fields, 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, 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 Request

An Autocomplete – Per Request SKU is charged for requests to the findAutocompletePredictions(), 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 Request 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 requests 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 to fetchPlace(). The autocomplete request is free, and the subsequent Places Details request gets charged based on regular Places Details pricing (described below).

A Places Details request to fetchPlace() generates Data SKUs (Basic, Contact, and/or Atmosphere) – depending on the fields that are specified in the FetchPlaceRequest.

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 requests 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: Places Details

Places Details requests 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 whenever you call fetchPlace().

A fetchPlace() request also generates Data SKUs (Basic, Contact, and/or Atmosphere), depending on the fields that are specified in the call.

Examples

1. You call fetchPlace() and specify just the ADDRESS field. 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 request)
  • Basic Data (billed at 0.00 USD)

2. You call fetchPlace() and specify the PHONE_NUMBER field. 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 request)
  • Contact Data (price starting at 0.003 USD per request)

3. You call fetchPlace() and specify all the fields. 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 request)
  • 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 Current Place

A Find Current Place SKU is charged for calls to findCurrentPlace().

MONTHLY VOLUME RANGE
(Price per CALL)
0–100,000 100,001–500,000 500,000+
0.030 USD per each
(30.00 USD per 1000)		 0.024 USD per each
(24.00 USD per 1000)		 Contact Sales for volume pricing

Calls to findCurrentPlace() also generate Data SKUs (Basic, Contact, and/or Atmosphere), depending on the fields that are specified in the call. You can specify data fields in your FindCurrentPlaceRequest, to limit the response to only those fields specified. You are billed for the Find Current Place call as well as the data requested.

Examples

1. You call findCurrentPlace() and specify just the ADDRESS field. On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Find Current Place (price starting at 0.030 USD per request)
  • Basic Data (billed at 0.00 USD)

2. You call findCurrentPlace() and specify fields from the Basic and Atmosphere buckets. On your bill, you will see the following SKUs listed (when viewing your bill by SKU):

  • Find Current Place (price starting at 0.030 USD per request)
  • Basic Data (billed at 0.00 USD)
  • Atmosphere Data (price starting at 0.005 USD per request)

SKU: Places Photo

A Places Photo SKU is charged for calls to fetchPhoto().

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

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 SDK for Android:

  • 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 SDK for Android, 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 quota limits on all requests to any billable API.

To view or change quota limits for the Places SDK for Android:

  1. Go to the Google Cloud Platform Console.
  2. Click the project drop-down and select a project.
  3. Open the Quotas page.
  4. Click the APIs drop-down and select the Places SDK for Android.
  5. To view the quota limits, scroll down to the Requests card.
    A table lists the quota names and limits.
  6. To change a quota limit, click the Edit icon for that limit.
    In the dialog that appears, in the Quota Limit field, enter the preferred billable daily quota limit (up to the quota limit, if any, specified by Google) and click Save.

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