Mức sử dụng và thanh toán API địa điểm

API Địa điểm sử dụng mô hình định giá trả tiền theo mức dùng. Yêu cầu API Địa điểm tạo lệnh gọi đến bất kỳ SKU nào. Cùng với Điều khoản sử dụng chung của Google, các hạn mức sử dụng dành riêng cho API Địa điểm. Quản lý chi phí và mức sử dụng bằng các công cụ có trong Google Cloud Console.

API Địa điểm được lập hóa đơn như thế nào

API Địa điểm sử dụng mô hình định 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.

Giá cho API Địa điểm

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.

Đối với dịch vụ web, các lệnh gọi API Địa điểm này hỗ trợ việc chỉ định các trường dữ liệu cần trả về:

Đối với dịch vụ web, các API địa điểm này sẽ gọi KHÔNG hỗ trợ chỉ định các trường được trả về. Các lệnh gọi này luôn trả về tất cả dữ liệu Địa điểm, tính thêm 3 SKU Dữ liệu địa điểm ngoài khoản phí cho mỗi yêu cầu API:


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 hoặc vicinity

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 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, price_level, rating, review, 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: Tự động hoàn thành truy vấn – Mỗi yêu cầu

SKU Tự động hoàn thành truy vấn – Mỗi yêu cầu được tính phí cho từng yêu cầu nhằm:

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

Hệ thống không hỗ trợ đặt giá theo phiên Tự động hoàn thành bằng tính năng Tự động hoàn thành truy vấn. Các lệnh gọi Chi tiết địa điểm tiếp theo sẽ bị tính phí dựa trên mức giá Thông tin chi tiết về địa điểm thông thường.


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: Chi tiết địa điểm – Làm mới mã nhận dạng

Sử dụng yêu cầu Thông tin chi tiết về địa điểm để làm mới mã địa điểm cũ. Các loại yêu cầu này được cung cấp miễn phí.

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 VND 0 VND 0 VND

Ví dụ:

Thực hiện yêu cầu Thông tin chi tiết về địa điểm, chỉ định trường mã địa điểm: getPlaceDetails(fields: place_id). 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):

  • Thông tin chi tiết về địa điểm – Làm mới giấy tờ tùy thân (tính phí 0 USD)

SKU: Tìm địa điểm

Dịch vụ Tìm địa điểm được tính phí đối với yêu cầu Tìm địa điểm.

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,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

Các yêu cầu Tìm địa điểm cũng tạo ra 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 yêu cầu. Giống như yêu cầu Thông tin chi tiết về địa điểm, bạn có thể sử dụng thông số trường trong yêu cầu Tìm địa điểm để chỉ hiển thị phản hồi cho những trường được chỉ định. Bạn sẽ bị tính phí cho yêu cầu Tìm địa điểm cũng như dữ liệu được yêu cầu. Theo mặc định, nếu bạn yêu cầu các trường NO, thì chỉ có mã địa điểm được trả về, vì vậy không phát sinh thêm phí dữ liệu.

Ví dụ

  1. Bạn tạo một yêu cầu Tìm địa điểm và chỉ định trường địa chỉ: FindPlace(fields: formatted_address). Trên hóa đơn, bạn sẽ thấy các SKU này (sau khi xem hóa đơn của bạn theo SKU):
    • Tìm Địa điểm (giá bắt đầu từ 0,017 USD cho mỗi cuộc gọi)
    • Dữ liệu cơ bản (tính phí 0 USD)
  2. Bạn tạo một yêu cầu Tìm địa điểm và chỉ định trường số điện thoại: FindPlace(fields: formatted_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 (giá bắt đầu từ 0,017 USD cho mỗi cuộc gọi)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
  3. Bạn tạo một yêu cầu Tìm địa điểm và chỉ định các trường trong cả 3 nhóm loại dữ liệu: FindPlace(fields: formatted_address, opening_hours, price_level). 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 (giá bắt đầu từ 0,017 USD cho mỗi cuộc gọi)
    • 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 – Chỉ có mã nhận dạng

Tìm địa điểm – Chỉ ID bị tính phí đối với các yêu cầu Tìm địa điểm chỉ chỉ định Mã địa điểm cần trả về. Theo mặc định, nếu không có trường nào được chỉ định trong yêu cầu Tìm địa điểm, thì chỉ có mã địa điểm được trả về.

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 VND 0 VND 0 VND

Ví dụ:

Bạn tạo một yêu cầu Tìm địa điểm và chỉ chỉ định trường place_id: FindPlace(fields: place_id). 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ìm địa điểm – chỉ dành cho giấy tờ tùy thân (tính phí 0 VND)

Địa điểm – Tìm kiếm lân cận bị tính phí cho các yêu cầu đến dịch vụ Tìm kiếm địa điểm lân cận của API JavaScript (nearbySearch()) hoặc Dịch vụ tìm kiếm lân cận API địa điểm

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,032 USD cho mỗi
(32,00 USD cho mỗi 1000)
0,0256 USD cho mỗi
(25,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

Các yêu cầu Tìm kiếm lân cận trả về danh sách các địa điểm, nhưng không hỗ trợ việc chỉ định trường nào sẽ được trả về. Các yêu cầu Tìm kiếm lân cận trả về một tập hợp con các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho yêu cầu Tìm kiếm lân cận bắt đầu từ 0, 032 USD cho mỗi yêu cầu, cũng như tất cả các SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệDữ liệu khí quyển).

Ví dụ:

Bạn đưa ra yêu cầu Tìm kiếm lân cận, chẳng hạn như NearbySearch (San Francisco, 100 meters). 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):

  • Địa điểm – Tìm kiếm lân cận (giá khởi điểm từ 0,032 USD mỗi cuộc gọi)
  • 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)

Địa điểm – Tìm kiếm văn bản được tính phí cho các yêu cầu đến dịch vụ Tìm kiếm văn bản địa điểm của API JavaScript (textSearch()) hoặc đến dịch vụ Tìm kiếm văn bản API địa điểm.

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,032 USD cho mỗi
(32,00 USD cho mỗi 1000)
0,0256 USD cho mỗi
(25,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

Yêu cầu Tìm kiếm văn bản trả về danh sách các địa điểm, nhưng không hỗ trợ việc chỉ định trường nào được trả về. Các yêu cầu Tìm kiếm văn bản trả về một tập hợp con các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho yêu cầu Tìm kiếm văn bản bắt đầu từ 0,032 USD cho mỗi yêu cầu, cũng như tất cả các SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệ, và Dữ liệu không khí).

Lựa chọn truy vấn tiện ích hộp tìm kiếm thông tin chi tiết về địa điểm
Trong kết quả của tiện ích hộp tìm kiếm, sau khi nhập "pizza" trong hộp tìm kiếm, hãy lưu ý rằng giao pizza có biểu tượng kính lúp bên cạnh, cho biết rằng đó là truy vấn địa điểm (và không phải là kết quả).

Ví dụ:

Bạn đưa ra yêu cầu Tìm kiếm văn bản, chẳng hạn như TextSearch(123 Main Street). 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 chỗ - Tìm kiếm văn bản (giá bắt đầu từ 0,032 USD cho mỗi cuộc gọi)
  • 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 dẫn đến 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

Các hạn mức sử dụng khác

Mặc dù không có số lượng yêu cầu tối đa mỗi ngày, nhưng hạn mức sử dụng sau đây vẫn được áp dụng khi bạn sử dụng API Địa điểm:

  • Giới hạn tốc độ là 100 yêu cầu mỗi giây. Giá trị này được tính bằng tổng số yêu cầu phía máy khách và phía máy chủ cho tất cả ứng dụng sử dụng thông tin đăng nhập của cùng một dự án.

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 chính sách đối với API Địa điểmphần 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 API Địa điểm:

  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 API địa điểm.
  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.