SDK Địa điểm dành cho việc sử dụng và thanh toán Android

Lỗi: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

SDK Địa điểm dành cho Android sử dụng mô hình định giá trả tiền theo mức dùng. SDK của Địa điểm dành cho Android yêu cầu SDK Địa điểm dành cho Android được lập hoá đơn bởi SKU. Cùng với Điều khoản sử dụng chung của Google, có các giới hạn sử dụng dành riêng cho SDK Địa điểm dành cho Android. Quản lý chi phí và mức sử dụng bằng các công cụ có trong Google Cloud Console.

Cách tính phí SDK Địa điểm dành cho Android

SDK Địa điểm dành cho Android sử dụng mô hình đặt giá trả tiền theo mức dùng. Các API và SDK của Nền tảng Google Maps sẽ do SKU tính phí. Mức sử dụng được theo dõi cho từng SKU và mọi API hoặc SDK có thể có nhiều SKU sản phẩm. Chi phí được tính theo

Mức sử dụng SKU × Giá mỗi lần sử dụng

Hãy dùng Công cụ tính giá và mức sử dụng để ước tính chi phí sử dụng cho mỗi API hoặc SDK. Đối với các SKU Google Maps Platform đủ điều kiện, khoản tín dụng Nền tảng Google Maps là 200 đô la Mỹ mỗi tháng cho mỗi tài khoản thanh toán. Khoản tín dụng này được tự động áp dụng1 cho các SKU đủ điều kiện.

Định giá cho SDK địa điểm dành cho Android

Giới thiệu về phiên Tự động hoàn thành

Phiên tự động hoàn thành bao gồm một số yêu cầu Tự động hoàn thành (để truy xuất các đề xuất về một địa điểm làm loại người dùng) và nhiều nhất là một yêu cầu Thông tin chi tiết về địa điểm (để truy xuất thông tin chi tiết về địa điểm mà người dùng chọn). Cùng một mã thông báo được chuyển đến yêu cầu Tự động hoàn thành và yêu cầu Thông tin chi tiết về địa điểm. Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành đầu tiên (thường xảy ra khi người dùng bắt đầu nhập). Lệnh gọi Thông tin chi tiết về địa điểm được thực hiện khi người dùng đã chọn một trong các đề xuất Tự động hoàn thành. Nếu người dùng không chọn đề xuất, thì sẽ không có lệnh gọi Thông tin chi tiết về địa điểm.

Sau khi người dùng đã chọn một địa điểm (tức là lệnh gọi Thông tin chi tiết về địa điểm), bạn phải bắt đầu một phiên mới bằng cách sử dụng mã thông báo phiên mới.

Phiên tự động hoàn thành có thể được tạo từ các API sau:

Mã thông báo phiên rất hữu ích cho một phiên người dùng và không nên dùng cho nhiều phiên người dùng. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên hoạt động sẽ được coi là không hợp lệ và các yêu cầu sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp.

Các yêu cầu Tự động hoàn thành và yêu cầu Thông tin chi tiết về địa điểm bằng cách sử dụng các phiên được lập hóa đơn trên các SKU khác nhau.

Giới thiệu về SKU dữ liệu địa điểm

Một hoặc nhiều SKU dữ liệu được kích hoạt cho:

  • Android: mỗi yêu cầu gửi đến fetchPlace() hoặc findCurrentPlace()
  • iOS: mỗi cuộc gọi đến fetchPlaceFromPlaceID: hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Dịch vụ web: từng yêu cầu Địa điểm tùy thuộc vào các trường được chỉ định trong yêu cầu

Yêu cầu dữ liệu tạo ra một khoản phí ngoài chi phí cho yêu cầu Địa điểm. Các khoản phí dữ liệu luôn đi đôi với các yêu cầu về Địa điểm.


SKU: Dữ liệu cơ bản

Khi sử dụng tham số trường trong thông tin chi tiết về Địa điểm hoặc yêu cầu Tìm địa điểm, bạn có thể chỉ cung cấp thông tin phản hồi cho những trường được chỉ định. Các trường trong danh mục Cơ bản được đưa vào chi phí cơ sở của yêu cầu Địa điểm và không dẫn đến thêm bất kỳ khoản phí nào. SKU Dữ liệu cơ bản được kích hoạt khi bất kỳ trường nào trong số này được yêu cầu:

Android

address_component, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color,name, permanently_closed ,photo, type, url, utc_offset hoặc vicinity

iOS

GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes hoặc GMSPlaceFieldViewport

Dịch vụ web

address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity hoặc wheelchair_accessible_entrance

PHẠM VI LƯU LƯỢNG THÁNG
(Giá mỗi cuộc gọi)
0 – 100.000 100.001 – 500.000 hơn 500.000
Chi phí cho yêu cầu địa điểm
+ 0 USD
Chi phí cho yêu cầu địa điểm
+ 0 USD
Chi phí cho yêu cầu địa điểm
+ 0 USD

SKU: Dữ liệu liên hệ

Khi sử dụng tham số trường trong thông tin chi tiết về Địa điểm hoặc yêu cầu Tìm địa điểm cho các dịch vụ web, hoặc một mảng Place.Field cho Android hoặc iOS, bạn có thể giới hạn phản hồi ở các trường chỉ định đó. Các trường trong danh mục Liên hệ sẽ tính thêm phí. SKU Liên hệ với dữ liệu được kích hoạt khi có bất kỳ trường nào sau đây được yêu cầu:

Android

OPENING_HOURS, PHONE_NUMBER hoặc WEBSITE_URI

iOS

GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber hoặc GMSPlaceFieldWebsite

Dịch vụ web

formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours, hoặc website

PHẠM VI LƯU LƯỢNG THÁNG
(Giá mỗi cuộc gọi)
0 – 100.000 100.001 – 500.000 hơn 500.000
Chi phí yêu cầu tại địa điểm
+ 0,003 USD cho mỗi địa điểm
(+ 3,00 USD cho mỗi 1000)
Chi phí yêu cầu tại địa điểm
+ 0,0024 USD cho mỗi địa điểm
(+ 2,40 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Dữ liệu bầu không khí

Khi sử dụng tham số trường trong thông tin chi tiết về Địa điểm hoặc yêu cầu Tìm địa điểm, bạn có thể chỉ hiển thị phản hồi cho những trường được chỉ định. Các trường trong danh mục Môi trường sẽ dẫn đến việc tính thêm phí. SKU Dữ liệu không khí được kích hoạt khi có bất kỳ trường nào sau đây được yêu cầu:

  • Android: PRICE_LEVEL, RATING hoặc USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating hoặc GMSPlaceFieldUserRatingsTotal
  • JavaScript: Xem Các trường (Thông tin chi tiết về địa điểm)
  • Dịch vụ web: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout hoặc user_ratings_total.
PHẠM VI LƯU LƯỢNG Hằng tháng
(Giá mỗi CUỘC GỌI)
0 – 100.000 100.001 – 500.000 hơn 500.000
Chi phí yêu cầu tại địa điểm
+ 0,005 USD cho mỗi địa điểm
(+ 5 USD cho mỗi 1000)
Chi phí yêu cầu tại địa điểm
+ 0,004 USD cho mỗi địa điểm
(+ 4 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tự động hoàn thành – Mỗi yêu cầu

SKU Tự động hoàn thành – Mỗi yêu cầu được tính phí cho mọi lệnh gọi hoặc yêu cầu không chứa mã phiên:

Các cuộc gọi được thực hiện từ phiên Tự động hoàn thành không hợp lệ (ví dụ: phiên sử dụng lại mã thông báo phiên) cũng bị tính phí tự động hoàn thành – Theo yêu cầu SKU.

Các yêu cầu tự động hoàn thành từ Tiện ích tự động hoàn thành địa điểm của API JavaScript có thể bị tính phí là Tự động hoàn thành – Một SKU theo yêu cầu trong trường hợp lệnh gọi được thực hiện từ một phiên Tự động hoàn thành không hợp lệ. Điều này có thể xảy ra khi người dùng đang nhập nhiều địa chỉ khác nhau hoặc sao chép/dán các địa chỉ khác nhau vào tiện ích và không phải lúc nào cũng chọn cụm từ gợi ý tự động hoàn thành.

PHẠM VI SỐ LƯỢNG HÀNG THÁNG
(Giá mỗi YÊU CẦU)
0 – 100.000 100.001 – 500.000 hơn 500.000
0,00283 USD cho mỗi
(2,83 USD cho mỗi 1000)
0,00227 USD cho mỗi
(2,27 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tự động hoàn thành mà không cần Thông tin chi tiết về địa điểm – Mỗi phiên

SKU Tự động hoàn thành không có Thông tin chi tiết về địa điểm – Mỗi phiên sẽ bị tính phí cho phiên Tự động hoàn thành không bao gồm yêu cầu Thông tin chi tiết về địa điểm (trong vòng vài phút kể từ khi bắt đầu phiên hoạt động).

PHẠM VI LƯU LƯỢNG Hằng tháng
(Giá mỗi PHIÊN)
0 – 100.000 100.001 – 500.000 hơn 500.000
0,017 USD cho mỗi
(17,00 USD cho mỗi 1000)
0,0136 USD cho mỗi
(13,60 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Ví dụ:

Nếu ứng dụng của bạn thực hiện hai lệnh gọi này trong một phiên:

Android

iOS

Dịch vụ web

Trên hóa đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hóa đơn của bạn theo SKU):

  • Tự động hoàn thành mà không cần Thông tin chi tiết về địa điểm – Mỗi phiên (giá bắt đầu từ 0,017 USD mỗi phiên)

SKU: Tự động hoàn thành (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên

SKU Tự động hoàn thành (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên được tính phí cho một phiên Tự động hoàn thành bao gồm bất kỳ:

  • Android: cuộc gọi tới fetchPlace()
  • iOS: cuộc gọi tới fetchPlaceFromPlaceID:
  • Dịch vụ web: yêu cầu Thông tin chi tiết về địa điểm

Yêu cầu tự động hoàn thành được cung cấp miễn phí và cuộc gọi Thông tin chi tiết về địa điểm tiếp theo sẽ được tính phí dựa trên mức giá của thông tin chi tiết về địa điểm thông thường.

Yêu cầu Thông tin chi tiết về địa điểm sẽ tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Không gian) – tùy thuộc vào các trường được chỉ định trong yêu cầu.

Nếu bạn không chỉ định các trường trong yêu cầu Thông tin chi tiết về địa điểm, tất cả SKU dữ liệu sẽ được kích hoạt (Cơ bản, Liên hệ và Bầu không khí).

Yêu cầu làm mới mã chi tiết địa điểm (các yêu cầu chỉ định trường place_id) trong phiên tự động hoàn thành sẽ được lập hóa đơn dưới dạng SKU: Tự động hoàn thành mà không cung cấp thông tin chi tiết về địa điểm – Mỗi phiên.

PHẠM VI LƯU LƯỢNG Hằng tháng
(Giá mỗi PHIÊN)
0 – 100.000 100.001 – 500.000 hơn 500.000
0 VND 0 VND 0 VND

Ví dụ:

Nếu ứng dụng của bạn đưa ra 3 lệnh gọi sau đây trong một phiên hoạt động:

Android

iOS

Dịch vụ web

Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn của bạn theo SKU):

  • Tự động hoàn thành (có kèm theo thông tin chi tiết về địa điểm) – Mỗi phiên (tính phí 0 USD)
  • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
  • Dữ liệu cơ bản (tính phí 0 USD)

SKU: Chi tiết địa điểm

Các cuộc gọi về Thông tin chi tiết về địa điểm được tính phí như sau:

PHẠM VI LƯU LƯỢNG Hằng tháng
(Giá mỗi CUỘC GỌI)
0 – 100.000 100.001 – 500.000 hơn 500.000
0,017 USD cho mỗi
(17,00 USD cho mỗi 1000)
0,0136 USD cho mỗi
(13,60 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU Place Details (Thông tin chi tiết về địa điểm) được tạo từ các API sau:

Với API web và dịch vụ, SKU chi tiết địa điểm sẽ bị tính phí cho dù mã thông báo phiên có được cung cấp hay không.

Lệnh gọi Chi tiết địa điểm hoặc yêu cầu cũng tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Không khí), tùy thuộc vào các trường được chỉ định trong lệnh gọi hoặc yêu cầu. Nếu các trường KHÔNG được chỉ định trong lệnh gọi hoặc yêu cầu Thông tin chi tiết về địa điểm, thì TẤT CẢ các SKU dữ liệu sẽ được kích hoạt và bạn sẽ bị tính phí cho lệnh gọi hoặc yêu cầu Thông tin chi tiết về địa điểm cùng với chi phí của tất cả dữ liệu.

Ví dụ

  1. Thực hiện một trong những cuộc gọi hoặc yêu cầu sau:
    • Thiết bị di động: gọi fetchPlace() trên Android hoặc fetchPlaceFromPlaceID: trên iOS và chỉ định trường ADDRESS
    • API hoặc dịch vụ web: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ định trường địa chỉ: getPlaceDetails(fields: formatted_address)
    Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
    • Dữ liệu cơ bản (tính phí 0 USD)
  2. Thực hiện một trong những cuộc gọi hoặc yêu cầu sau:
    • Thiết bị di động: gọi fetchPlace() trên Android hoặc fetchPlaceFromPlaceID: trên iOS và chỉ định trường PHONE_NUMBER
    • API hoặc dịch vụ web: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ định trường số điện thoại: getPlaceDetails(fields: formatted_phone_number)
    Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
  3. Thực hiện một trong những cuộc gọi hoặc yêu cầu sau:
    • Thiết bị di động: gọi fetchPlace() trên Android hoặc fetchPlaceFromPlaceID: trên iOS và chỉ định tất cả các trường
    • API Web hoặc dịch vụ: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ định tất cả các trường (loại yêu cầu này là mặc định nếu bạn không chỉ định trường nào): getPlaceDetails().
    Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
    • Dữ liệu cơ bản (tính phí 0 USD)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
    • Dữ liệu về không khí (giá từ 0,005 USD cho mỗi yêu cầu)

SKU: Tìm địa điểm hiện tại

Tính năng Tìm địa điểm hiện tại bị tính phí cho các cuộc gọi đến findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

PHẠM VI LƯU LƯỢNG THÁNG
(Giá mỗi cuộc gọi)
0 – 100.000 100.001 – 500.000 hơn 500.000
0,030 USD cho mỗi
(30,00 USD cho mỗi 1000)
0,024 USD cho mỗi
(24,00 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Các lệnh gọi đến findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) cũng tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Bầu không khí), tuỳ thuộc vào các trường được chỉ định trong lệnh gọi. Chỉ định các trường dữ liệu để chỉ trả lời những trường đó. Bạn sẽ phải thanh toán cho lệnh gọi Tìm địa điểm hiện tại cũng như dữ liệu đã yêu cầu.

Ví dụ

  1. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) và chỉ định trường ADDRESS. Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):
    • Tìm địa điểm hiện tại (giá bắt đầu từ 0,030 đô la Mỹ/yêu cầu)
    • Dữ liệu cơ bản (tính phí 0 USD)
  2. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) và chỉ định trường PHONE_NUMBER. Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn của bạn theo SKU):
    • Tìm địa điểm hiện tại (giá bắt đầu từ 0,030 đô la Mỹ/yêu cầu)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
  3. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) và chỉ định các trường từ cả ba nhóm loại dữ liệu. Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):
    • Tìm địa điểm hiện tại (giá bắt đầu từ 0,030 đô la Mỹ/yêu cầu)
    • Dữ liệu cơ bản (tính phí 0 USD)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
    • Dữ liệu về không khí (giá từ 0,005 USD cho mỗi yêu cầu)

SKU: Ảnh địa điểm

SKU Hình ảnh địa điểm bị tính phí đối với:

Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl() sẽ không gây ra việc thanh toán cho đến khi URL thực sự được dùng để lấy dữ liệu pixel.

PHẠM VI LƯU LƯỢNG Hằng tháng
(Giá mỗi CUỘC GỌI)
0 – 100.000 100.001 – 500.000 hơn 500.000
0,007 USD cho mỗi
(7,00 USD cho mỗi 1000)
0,0056 USD cho mỗi
(5,60 USD cho mỗi 1000)
Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Giới hạn Điều khoản sử dụng

Để biết thông tin về các điều khoản sử dụng, hãy xem mục Hạn chế giấy phép trong Điều khoản dịch vụ của Nền tảng Google Maps.

Quản lý chi phí sử dụng của bạn

Để quản lý chi phí sử dụng API Nền tảng Google Maps, hãy đặt giới hạn hằng ngày cho tất cả yêu cầu đối với mọi API có thể lập hoá đơn. Hạn mức hằng ngày được đặt lại vào lúc nửa đêm theo giờ Thái Bình Dương.

Để xem hoặc thay đổi giới hạn định mức cho SDK địa điểm dành cho Android:

  1. Trong Cloud Console, hãy mở trang Hạn mức nền tảng Google Maps.
  2. Nhấp vào trình đơn thả xuống API và chọn SDK địa điểm cho Android.
  3. Để xem các giới hạn của hạn mức, hãy di chuyển xuống thẻ Yêu cầu.
    Bảng có liệt kê tên hạn mức và hạn mức.
  4. Để thay đổi hạn mức, hãy nhấp vào biểu tượng Chỉnh sửa cho hạn mức đó.
    Trong hộp thoại xuất hiện, trong trường Giới hạn định mức, hãy nhập hạn mức hằng ngày có thể lập hoá đơn ưu tiên (tối đa là hạn mức, nếu có, do Google chỉ định) rồi chọn Lưu.

Nếu mức sử dụng API đạt đến hạn mức có thể thanh toán vào một ngày cụ thể, thì ứng dụng sẽ không thể truy cập API trong thời gian còn lại của ngày đó.


  1. Người dùng ở Ấn Độ phải tạo tài khoản thanh toán trên Google Cloud Platform trước khi tạo tài khoản thanh toán trên Nền tảng Google Maps để nhận được khoản tín dụng trên Nền tảng Maps.