Cách tính phí Places API
Places API (Mới) và Places API sử dụng mô hình định giá trả tiền theo mức dùng. API và SDK trên Nền tảng Google Maps sẽ do SKU tính phí. Hoạt động sử dụng được theo dõi cho từng SKU, và bất kỳ API hoặc SDK nào cũng có thể có nhiều SKU sản phẩm. Chi phí được tính theo công thức:
Sử dụng Công cụ tính giá và mức sử dụng của chúng tôi để ước tính chi phí sử dụng cho mỗi API hoặc SDK. Đối với các SKU đủ điều kiện của Nền tảng Google Maps, mỗi tài khoản thanh toán sẽ nhận được khoản tín dụng trị giá 200 USD của Nền tảng Google Maps. 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 Places API (Mới)
Giới thiệu về mặt nạ cho trường (field mask)
Đối với Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới), hãy sử dụng tiêu đề FieldMask trong các yêu cầu API để chỉ định danh sách các trường cần trả về trong phản hồi. Sau đó, bạn sẽ được tính phí theo SKU cao nhất áp dụng cho yêu cầu của bạn. Điều đó có nghĩa là nếu chọn các trường trong cả SKU (Cơ bản) và SKU (Nâng cao), thì bạn sẽ được tính phí dựa trên SKU (Nâng cao).
Việc sử dụng tính năng che giấu trường là một phương pháp thiết kế hay để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và các khoản phí thanh toán không cần thiết.
Giới thiệu về phiên Tự động hoàn thành (Mới)
Phiên Tự động hoàn thành (Mới) bao gồm một hoặc nhiều yêu cầu Tự động hoàn thành (Mới) và tối đa một yêu cầu Chi tiết địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ. Mã thông báo phiên tương tự sẽ được chuyển tới yêu cầu Tự động hoàn thành (Mới) và tới yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ tiếp theo.
Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành (Mới) đầu tiên. Sau đó, một yêu cầu Chi tiết địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ sẽ được đưa ra khi người dùng chọn một trong các đề xuất Tự động hoàn thành (Mới). Nếu một phiên bị bỏ qua, nghĩa là không có yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ nào được thực hiện, thì các yêu cầu Tự động hoàn thành (Mới) sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp.
Sau khi người dùng đã chọn một địa điểm (có nghĩa là đã thực hiện yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ), bạn phải bắt đầu một phiên mới bằng mã thông báo phiên mới.
Mã thông báo phiên phù hợp cho một phiên và không thể sử dụng cho nhiều phiên. Nếu bạn sử dụng lại mã thông báo phiên, phiên đó sẽ bị 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.
SKU: Yêu cầu tự động hoàn thành
SKU Yêu cầu tự động hoàn thành sẽ được tính phí cho mỗi yêu cầu đến API Tự động hoàn thành (Mới) không bao gồm mã thông báo phiên.
Phí này cũng sẽ bị tính phí nếu bạn sử dụng mã phiên và:
- Chấm dứt các phiên truy cập bằng một yêu cầu duy nhất đối với Thông tin chi tiết về địa điểm (Mới) trong đó yêu cầu bất kỳ trường nào do SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí) xác định.
- Mỗi yêu cầu Tự động hoàn thành (Mới), có tối đa 12 yêu cầu, được lập hoá đơn bằng SKU: Yêu cầu tự động hoàn thành.
- Mỗi yêu cầu Tự động hoàn thành (Mới) tiếp theo sẽ được lập hoá đơn bằng SKU: Mức sử dụng phiên tự động hoàn thành.
- Bỏ qua phiên hoặc kết thúc phiên bằng cách gọi điện đến SKU: Thông tin chi tiết về địa điểm (chỉ dành cho mã nhận dạng). Sau đó, tất cả các yêu cầu Tự động hoàn thành (Mới) sẽ được lập hoá đơn bằng SKU: Yêu cầu tự động hoàn thành.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,00283 USD mỗi (2,83 USD trên 1.000) |
0,00227 USD trên mỗi (2,27 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Mức sử dụng phiên tự động hoàn thành
SKU Mức sử dụng phiên tự động hoàn thành được tính phí cho mỗi yêu cầu đối với API Tự động hoàn thành (Mới) có chứa mã thông báo phiên.
SKU này được tính phí trong hai trường hợp:
Phiên Tự động hoàn thành bị chấm dứt bằng một lệnh gọi tới SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí):
- Mỗi yêu cầu Tự động hoàn thành (Mới), có tối đa 12 yêu cầu, được lập hoá đơn bằng SKU: Yêu cầu tự động hoàn thành.
- Mỗi yêu cầu Tự động hoàn thành (Mới) tiếp theo sẽ được lập hoá đơn bằng SKU: Mức sử dụng phiên tự động hoàn thành.
Phiên Tự động hoàn thành bị chấm dứt bằng một lệnh gọi tới SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên) hoặc một cuộc gọi tới SKU: Ưu tiên xác thực địa chỉ.
Cuộc gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên) sẽ được lập hoá đơn tại SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem phần Tự động hoàn thành (Mới) và định giá theo phiên.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0.00 USD trên mỗi (0.00 USD trên 1000) |
0.00 USD trên mỗi (0.00 USD trên 1000) |
0.00 USD trên mỗi (0.00 USD trên 1000) |
SKU: Thông tin chi tiết về địa điểm (Chỉ áp dụng cho mã nhận dạng)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
id,
name*,
photos
* Trường name chứa địa điểm tên tài nguyên
ở dạng: places/PLACE_ID. Sử dụng displayName để truy cập vào tên văn bản của địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0.0 USD trên mỗi (0.00 USD trên 1000) |
0.0 USD trên mỗi (0.00 USD trên 1000) |
0.0 USD trên mỗi (0.00 USD trên 1000) |
SKU: Thông tin chi tiết về địa điểm (Chỉ áp dụng vị trí)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
addressComponents,
adrFormatAddress,
formattedAddress,
location,
plusCode,
shortFormattedAddress,
types,
viewport
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,005 USD trên mỗi (5 USD trên 1000) |
0,004 USD trên mỗi (4 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Thông tin chi tiết về địa điểm (Cơ bản)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
accessibilityOptions,
businessStatus,
displayName,
googleMapsUri,
iconBackgroundColor,
iconMaskBaseUri,
primaryType,
primaryTypeDisplayName,
subDestinations,
utcOffsetMinutes
Nếu phiên Tự động hoàn thành bị chấm dứt bởi một lệnh gọi Chi tiết địa điểm yêu cầu bất kỳ trường nào từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì cuộc gọi sẽ được tính phí tại SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem phần SKU: Tự động hoàn thành phiên sử dụng.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,0170 USD trên mỗi (170000 VND trên 1000) |
0,0136 USD mỗi (13,60 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Thông tin chi tiết về địa điểm (Nâng cao)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
currentOpeningHours,
currentSecondaryOpeningHours,
internationalPhoneNumber,
nationalPhoneNumber,
priceLevel,
rating,
regularOpeningHours,
regularSecondaryOpeningHours,
userRatingCount,
websiteUri
Nếu phiên Tự động hoàn thành bị chấm dứt bởi một lệnh gọi Chi tiết địa điểm yêu cầu bất kỳ trường nào từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì cuộc gọi sẽ được tính phí tại SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem phần SKU: Tự động hoàn thành phiên sử dụng.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,020 USD trên mỗi (20 USD trên 1000) |
0,016 USD trên mỗi (16 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Thông tin chi tiết về địa điểm (Ưu tiên)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
allowsDogs,
curbsidePickup,
delivery,
dineIn,
editorialSummary,
evChargeOptions,
fuelOptions,
goodForChildren,
goodForGroups,
goodForWatchingSports,
liveMusic,
menuForChildren,
parkingOptions,
paymentOptions,
outdoorSeating,
reservable,
restroom,
restroom,
allowsDogs,
restroom,
allowsDogs,
allowsDogs,
allowsDogs,
restroom,
allowsDogs,
allowsDogs,
allowsDogs,
restroom,
restroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout
Nếu phiên Tự động hoàn thành bị chấm dứt bởi một lệnh gọi Chi tiết địa điểm yêu cầu bất kỳ trường nào từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì cuộc gọi sẽ được tính phí tại SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem phần SKU: Tự động hoàn thành phiên sử dụng.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,025 USD trên mỗi (25 USD trên 1000) |
0,020 USD trên mỗi (20 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm lân cận (Cơ bản)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm lân cận (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.accessibilityOptions,
places.addressComponents,
places.adrFormatAddress,
places.businessStatus,
places.displayName,
places.formattedAddress,
places.googleMapsUri,
places.iconBackgroundColor,
places.iconMaskBaseUri,
places.id,
places.location,
places.name*,
places.photos,
places.plusCode,
places.primaryType,
places.primaryTypeDisplayName,
places.primaryTypeDisplayName,
places.businessStatus, places.accessibilityOptions, {2/3},places.nameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewportplaces/PLACE_ID Sử dụng places.displayName để truy cập vào tên văn bản của địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,032 USD trên mỗi (32 USD trên 1.000) |
0,0256 USD mỗi (25,60 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm lân cận (Nâng cao)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm lân cận (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.currentOpeningHours,
places.currentSecondaryOpeningHours,
places.internationalPhoneNumber,
places.nationalPhoneNumber,
places.priceLevel,
places.rating,
places.regularOpeningHours,
places.regularSecondaryOpeningHours,
places.userRatingCount,
places.websiteUri
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,035 USD trên mỗi (35 USD trên 1.000) |
0,028 USD trên mỗi (28 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm lân cận (Ưu tiên)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm lân cận (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.allowsDogs,
places.curbsidePickup,
places.delivery,
places.dineIn,
places.editorialSummary,
places.evChargeOptions,
places.fuelOptions,
places.goodForChildren,
places.goodForGroups,
places.goodForWatchingSports,
places.liveMusic,
places.menuForChildren,
places.parkingOptions,
places.paymentOptions,
places.outdoorSeating,
places.reservable,
places.restroom,
places.restroom,
places.allowsDogs,
places.restroom,
places.allowsDogs,
places.allowsDogs,
places.allowsDogs,
places.restroom,
places.allowsDogs,
places.allowsDogs,
places.allowsDogs,
places.restroom,
places.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,040 USD trên mỗi (40 USD trên 1.000) |
0,032 USD trên mỗi (32 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm Văn bản (Chỉ ID)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.id,
places.name*
* Trường places.name chứa địa điểm tên tài nguyên
ở dạng: places/PLACE_ID.
Sử dụng places.displayName để truy cập vào tên văn bản của địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0.0 USD trên mỗi (0.00 USD trên 1000) |
0.0 USD trên mỗi (0.00 USD trên 1000) |
0.0 USD trên mỗi (0.00 USD trên 1000) |
SKU: Tìm kiếm bằng văn bản (Cơ bản)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.accessibilityOptions,
places.addressComponents,
places.adrFormatAddress,
places.businessStatus,
places.displayName,
places.formattedAddress,
places.googleMapsUri,
places.iconBackgroundColor,
places.iconMaskBaseUri,
places.location,
places.photos,
places.plusCode,
places.primaryType,
places.primaryTypeDisplayName,
places.shortFormattedAddress,
places.subDestinations,
places.types,
places.utcOffsetMinutes,
places.utcOffsetMinutes,
places.utcOffsetMinutesplaces.viewport
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,032 USD trên mỗi (32 USD trên 1.000) |
0,0256 USD mỗi (25,60 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm văn bản (Nâng cao)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.currentOpeningHours,
places.currentSecondaryOpeningHours,
places.internationalPhoneNumber,
places.nationalPhoneNumber,
places.priceLevel,
places.rating,
places.regularOpeningHours,
places.regularSecondaryOpeningHours,
places.userRatingCount,
places.websiteUri
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,035 USD trên mỗi (35 USD trên 1.000) |
0,028 USD trên mỗi (28 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tìm kiếm văn bản (Ưu tiên)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:
Dịch vụ web:
places.allowsDogs,
places.curbsidePickup,
places.delivery,
places.dineIn,
places.editorialSummary,
places.evChargeOptions,
places.fuelOptions,
places.goodForChildren,
places.goodForGroups,
places.goodForWatchingSports,
places.liveMusic,
places.menuForChildren,
places.parkingOptions,
places.paymentOptions,
places.outdoorSeating,
places.reservable,
places.restroom,
places.restroom,
places.allowsDogs,
places.restroom,
places.allowsDogs,
places.allowsDogs,
places.allowsDogs,
places.restroom,
places.allowsDogs,
places.allowsDogs,
places.allowsDogs,
places.restroom,
places.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,040 USD trên mỗi (40 USD trên 1.000) |
0,032 USD trên mỗi (32 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Ảnh địa điểm
SKU Ảnh địa điểm được tính phí cho mỗi yêu cầu gửi tới API.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,007 USD trên mỗi (7 USD trên 1.000) |
0,0056 USD trên mỗi (5,60 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Định giá cho Places API
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 mà người dùng nhập) và tối đa 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). Mã thông báo phiên tương tự sẽ được chuyển tới tính năng Tự động hoàn thành và yêu cầu Chi tiết địa điểm tiếp theo. Một phiên bắt đầu với 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 một đề xuất, thì sẽ không có lệnh gọi Thông tin chi tiết về địa điểm nào được thực hiện.
Sau khi người dùng đã chọn một địa điểm (tức là thực hiện 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 mã thông báo phiên mới.
Bạn có thể tạo phiên tự động hoàn thành qua các API sau:
- Dịch vụ Tự động hoàn thành theo địa điểm của API Địa điểm hoặc Dịch vụ Tự động hoàn thành theo địa điểm của API Maps JavaScript. Bạn cần thiết kế ứng dụng để cung cấp mã phiên (có thể bạn phải thay đổi mã hiện có).
- Tiện ích Tự động hoàn thành của API Maps JavaScript. Tính năng thanh toán dựa trên phiên hoạt động được tự động bật trên các tiện ích đó mà không cần thay đổi mã.
Mã thông báo phiên phù hợp cho một phiên người dùng và không nên sử 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, phiên đó sẽ bị 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 thông qua các phiên sẽ được tính phí dựa trên các SKU khác nhau.
Giới thiệu về SKU dữ liệu địa điểm
Ba SKU dữ liệu địa điểm là: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu về bầu không khí.Một hoặc nhiều SKU dữ liệu được kích hoạt cho:
- Android: từng yêu cầu đến
fetchPlace()hoặcfindCurrentPlace() - iOS: mỗi lệnh gọi đến
fetchPlaceFromPlaceID:hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - Dịch vụ web: mỗi yêu cầu của Địa điểm tuỳ thuộc vào các trường được chỉ định trong yêu cầu
SKU dữ liệu luôn bị tính phí bên cạnh SKU cơ sở đối với yêu cầu kích hoạt các SKU đó. Ví dụ: một yêu cầu Thông tin chi tiết về địa điểm bao gồm các trường Dữ liệu cơ bản sẽ được tính phí theo cả SKU dữ liệu cơ bản và SKU Thông tin chi tiết 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ợ chỉ định các trường dữ liệu cần trả về:
Đối với dịch vụ web, các lệnh gọi API Địa điểm này KHÔNG hỗ trợ chỉ định các trường được trả về. Ngoài việc tính phí cho từng yêu cầu API, các lệnh gọi này luôn trả về tất cả dữ liệu Địa điểm, đồng thời tính phí 3 SKU Dữ liệu đị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ể giới hạn phản hồi chỉ trong các 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 về Địa điểm và không làm phát sinh 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ố sau được yêu cầu:
-
Android:
Place.Field.ADDRESS,Place.Field.ADDRESS_COMPONENTS,Place.Field.BUSINESS_STATUS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_URL,Place.Field.ID,Place.Field.LAT_LNG,Place.Field.NAME,Place.Field.PHOTO_METADATAS,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORT,Place.Field.UTC_OFFSEThoặcPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE -
iOS:
GMSPlaceFieldFormattedAddress,GMSPlaceFieldBusinessStatus,GMSPlaceFieldID,GMSPlaceFieldCoordinate,GMSPlaceFieldName,GMSPlaceFieldPhotos,GMSPlaceFieldPlusCode,GMSPlaceFieldTypeshoặcGMSPlaceFieldViewport -
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ặcwheelchair_accessible_entrance
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| Chi phí yêu cầu đối với địa điểm + 0,00 USD |
Chi phí yêu cầu đối với địa điểm + 0,00 USD |
Chi phí yêu cầu đối với địa điểm + 0,00 USD |
SKU: Dữ liệu người liên hệ
Bằng cách 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 đối với các dịch vụ web hoặc một mảng Place.Field dành cho Android hoặc iOS, bạn có thể giới hạn phản hồi chỉ trong các trường được chỉ định. Các trường trong danh mục Contact (Liên hệ) sẽ trả thêm phí. SKU Dữ liệu liên hệ được kích hoạt khi bất kỳ trường nào sau đây được yêu cầu:
-
Android:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.OPENING_HOURS,Place.Field.PHONE_NUMBER,Place.Field.SECONDARY_OPENING_HOURShoặcPlace.Field.WEBSITE_URI -
iOS:
GMSPlaceFieldOpeningHours,GMSPlaceFieldPhoneNumberhoặcGMSPlaceFieldWebsite -
Dịch vụ web:
formatted_phone_number,international_phone_number,opening_hours,current_opening_hours,secondary_opening_hourshoặcwebsite
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| Chi phí cho yêu cầu về địa điểm + 0,003 USD/mỗi 1.000 USD (+ 3 USD/1.000 USD) |
Chi phí cho yêu cầu đối với địa điểm + 0,0024 USD/mỗi (+ 2,4 USD/1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Dữ liệu về khí quyển
Bằng cách sử dụng tham số trường trong yêu cầu Thông tin chi tiết về địa điểm hoặc Tìm địa điểm, bạn có thể giới hạn phản hồi chỉ trong các trường được chỉ định. Các trường trong danh mục Baseline sẽ tính thêm phí. SKU Dữ liệu khí quyển được kích hoạt khi bất kỳ trường nào sau đây được yêu cầu:
- Android:
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.EDITORIAL_SUMMARY,Place.Field.DINE_IN,Place.Field.PRICE_LEVEL,Place.Field.RATING,Place.Field.RESERVABLE,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST,Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER,Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD,Place.Field.SERVES_WINE,Place.Field.TAKEOUThoặcPlace.Field.USER_RATINGS_TOTAL - iOS:
GMSPlaceFieldPriceLevel,GMSPlaceFieldRating,GMSPlaceFieldUserRatingsTotal,GMSPlaceFieldTakeout,GMSPlaceFieldDelivery,GMSPlaceFieldDineIn,GMSPlaceFieldCurbsidePickup,GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast,GMSPlaceFieldServesLunch,GMSPlaceFieldServesDinner,GMSPlaceFieldServesBeer,GMSPlaceFieldServesWine,GMSPlaceFieldServesBrunchhoặcGMSPlaceFieldServesVegetarianFood. - 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,takeouthoặcuser_ratings_total.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| Chi phí cho yêu cầu về địa điểm + 0,005 USD/mỗi 1.000 USD (+ 5 USD/1.000) |
Chi phí cho yêu cầu về địa điểm + 0,004 USD/mỗi 1.004 USD (+ 4 USD/1.000 USD) |
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 – Theo yêu cầu
SKU Tự động hoàn thành – Theo yêu cầu được tính phí cho mọi lệnh gọi hoặc yêu cầu sau đây không bao gồm mã thông báo phiên:
- Android:
findAutocompletePredictions() - iOS:
findAutocompletePredictionsFromQuery: - JavaScript: dịch vụ Địa điểm tự động hoàn thành của API Maps JavaScript
- Dịch vụ web: dịch vụ Tự động hoàn thành địa điểm API Địa điểm
Các 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ệ (ví dụ: một phiên sử dụng lại mã của phiên) cũng sẽ bị tính phí một SKU Tự động hoàn thành – Mỗi yêu cầu.
Các yêu cầu Tự động hoàn thành qua Tiện ích Tự động hoàn thành địa điểm của API Maps JavaScript có thể được tính phí một SKU Tự động hoàn thành – Mỗi yêu cầu trong trường hợp có các 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 nhập nhiều địa chỉ 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 người dùng cũng chọn một cụm từ gợi ý tự động hoàn thành.
| PHẠM VI HẠN CHẾ HÀNG THÁNG (Giá mỗi YÊU CẦU) |
||
|---|---|---|
| 0,00283 USD mỗi (2,83 USD trên 1.000) |
0,00227 USD trên mỗi (2,27 USD trên 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 mà không có 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 không bao gồm yêu cầu Chi tiết địa điểm (trong vòng vài phút trước khi bắt đầu phiên).
| PHẠM VI PHẠM VI HẰNG THÁNG (Giá mỗi PHIÊN) |
||
|---|---|---|
| 0,017 USD trên mỗi (170000 VND trên 1.000) |
0,0136 USD mỗi (13,60 USD trên 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
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placeClient?.findAutofillPredictions(fromQuery: "par" ...
- placeClient?.findAutofillPredictions(fromQuery: "paris" ...
Dịch vụ web
- Yêu cầu tự động hoàn thành địa điểm (input=”par”, session_token: XYZ)
- Yêu cầu tự động hoàn thành địa điểm (input=”paris”, session_token: XYZ)
Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hoá đơn theo SKU):
- Tự động hoàn thành mà không cần chi tiết đị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 (được bao gồm với Thông tin chi tiết về địa điểm) – Mỗi phiên
SKU Tự động hoàn thành (kèm theo Thông tin chi tiết về địa điểm) – Theo 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ỳ giá trị nào sau đây:
- Android: cuộc gọi đến
fetchPlace() - iOS: cuộc gọi đến
fetchPlaceFromPlaceID: - Dịch vụ web:yêu cầu Thông tin chi tiết về địa điểm
Bạn có thể sử dụng yêu cầu tự động hoàn thành mà không mất phí và cuộc gọi tiếp theo có tên Chi tiết địa điểm sẽ được tính phí dựa trên giá thông thường của Thông tin chi tiết về địa điểm.
Yêu cầu Thông tin chi tiết về địa điểm sẽ tạo các SKU dữ liệu (Cơ bản, Thông tin 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.
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, thì tất cả SKU dữ liệu sẽ được kích hoạt (Cơ bản, Thông tin liên hệ và Bầu không khí).
Các yêu cầu làm mới Mã thông tin chi tiết về địa điểm (những yêu cầu chỉ chỉ định trường place_id) trong phiên tự động hoàn thành sẽ được lập hoá đơn dưới dạng SKU: Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Mỗi phiên.
| PHẠM VI PHẠM VI HẰNG THÁNG (Giá mỗi PHIÊN) |
||
|---|---|---|
| 0 VND | 0 VND | 0 VND |
Ví dụ:
Nếu ứng dụng của bạn thực hiện 3 lệnh gọi sau đây trong một phiên:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (với
FetchPlaceRequestbao gồm Mã địa điểm và trường ADDRESS)
iOS
- placeClient?.findAutofillPredictions(fromQuery: "par" ...
- placeClient?.findAutofillPredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(bao gồm mã địa điểm và trường
GMSPlaceFieldFormattedAddress)
Dịch vụ web
- Yêu cầu tự động hoàn thành của địa điểm (input=”par”, session_token: XYZ)
- Yêu cầu tự động hoàn thành của địa điểm (input=”paris”, session_token: XYZ)
- Thông tin chi tiết về địa điểm (place_id, session_token: XYZ, trường:format_address)
Trên hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):
- Tự động hoàn thành (kèm theo Thông tin chi tiết về địa điểm) – Mỗi phiên (được tính phí 0,00 USD)
- Thông tin về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
SKU: Tự động hoàn thành truy vấn – Theo yêu cầu
SKU Tự động hoàn thành truy vấn – Theo mỗi yêu cầu được tính phí cho mỗi yêu cầu nhằm:
- JavaScript:
Dịch vụ Tự động hoàn thành địa điểm của API Maps JavaScript (
getQueryPredictions()) và sử dụng tiện ích SearchBox của API Maps JavaScript (các yêu cầu Tự động hoàn thành truy vấn được tạo dưới dạng người dùng). - Dịch vụ web: dịch vụ Tự động hoàn thành truy vấn API Địa điểm
| PHẠM VI HẠN CHẾ HÀNG THÁNG (Giá mỗi YÊU CẦU) |
||
|---|---|---|
| 0,00283 USD mỗi (2,83 USD trên 1.000) |
0,00227 USD trên mỗi (2,27 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Tính năng đặt giá theo phiên Tự động hoàn thành không được hỗ trợ bằng tính năng Tự động hoàn thành truy vấn. Các cuộc gọi tiếp theo có tên Thông tin chi tiết về địa điểm sẽ được tính phí dựa trên giá thông thường của Thông tin về địa điểm.
SKU: Thông tin về địa điểm
Các cuộc gọi có thông tin chi tiết về địa điểm được tính phí như sau:
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,017 USD trên mỗi (170000 VND trên 1.000) |
0,0136 USD mỗi (13,60 USD trên 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU Thông tin chi tiết về địa điểm được tạo qua các API sau:
- Android: SDK Địa điểm dành cho Android
(
fetchPlace()) - iOS: SDK Địa điểm dành cho iOS
(
fetchPlaceFromPlaceID:) - JavaScript:
Dịch vụ Chi tiết địa điểm của API JavaScript Maps (
getDetails) - JavaScript:
Tiện ích Tự động hoàn thành địa điểm của API Maps JavaScript (
getPlace) - JavaScript:
Tiện ích Place SearchBox của API Maps JavaScript: phương thức
getPlaces()sau khi người dùng chọn kết quả địa điểm (biểu tượng: ghim), *không phải* truy vấn (biểu tượng: kính lúp), như minh hoạ trong phần kết quả này:
- Dịch vụ web: Dịch vụ Thông tin địa điểm về API Địa điểm
Với API web và các dịch vụ, SKU Thông tin chi tiết về địa điểm sẽ được tính phí cho dù mã thông báo phiên có được cung cấp hay không.
Lệnh gọi hoặc yêu cầu Thông tin chi tiết về địa điểm cũng tạo ra các SKU dữ liệu (Cơ bản, Thông tin liên hệ và/hoặc Bầu không khí), tuỳ thuộc vào các trường được chỉ định trong cuộc gọi hoặc yêu cầu. Nếu trường KHÔNG được chỉ định trong yêu cầu hoặc lệnh gọi Thông tin chi tiết về địa điểm, thì TẤT 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ụ
- 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ặcfetchPlaceFromPlaceID:trên iOS và chỉ chỉ định trườngADDRESS - API hoặc dịch vụ web: gửi yêu cầu Thông tin chi tiết về địa điểm và chỉ nêu rõ trường địa chỉ:
getPlaceDetails(fields: formatted_address)
- Thông tin về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Thiết bị di động: gọi
- 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ặcfetchPlaceFromPlaceID:trên iOS và chỉ chỉ định trườngPHONE_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à nêu rõ trường số điện thoại:
getPlaceDetails(fields: formatted_phone_number)
- Thông tin về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Thiết bị di động: gọi
- 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ặcfetchPlaceFromPlaceID:trên iOS và chỉ định tất cả các trường - 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 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 bất kỳ trường nào):
getPlaceDetails().
- Thông tin về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Dữ liệu về Khí quyển (giá từ 0.005 USD/yêu cầu)
- Thiết bị di động: gọi
SKU: Thông tin chi tiết về đị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ũ. Bạn có thể sử dụng các loại yêu cầu này mà không tốn phí.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0 VND | 0 VND | 0 VND |
Ví dụ:
Tạo yêu cầu Thông tin chi tiết về địa điểm, chỉ xác định trường mã địa điểm: getPlaceDetails(fields: place_id).
Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi
xem hoá đơn theo SKU):
- Thông tin chi tiết về địa điểm – Làm mới mã nhận dạng (tính phí với giá 00000.00 VND)
SKU: Tìm địa điểm
Tính phí Tìm địa điểm cho yêu cầu Tìm địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,017 USD trên mỗi (170000 VND trên 1.000) |
0,0136 USD mỗi (13,60 USD trên 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 địa điểm cũng tạo SKU dữ liệu (Cơ bản, Thông tin 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 tham số trường trong yêu cầu Tìm địa điểm để giới hạn phản hồi chỉ với các 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 trường KHÔNG được yêu cầu, thì hệ thống sẽ chỉ trả về mã địa điểm, do đó, sẽ không phát sinh thêm phí dữ liệu.
Ví dụ
- Bạn đưa ra yêu cầu Tìm địa điểm và chỉ chỉ định trường địa chỉ:
FindPlace(fields: formatted_address). Trên hoá đơn, bạn sẽ thấy các SKU sau (khi xem hoá đơn theo SKU):- Tìm địa điểm (giá từ 0,017 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Bạn đưa ra 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 hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):- Tìm địa điểm (giá từ 0,017 USD/cuộc gọi)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Bạn đưa ra yêu cầu Tìm địa điểm và chỉ định các trường từ cả ba nhóm loại dữ liệu:
FindPlace(fields: formatted_address, opening_hours, price_level). Trên hoá đơn của mình, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):- Tìm địa điểm (giá từ 0,017 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Dữ liệu về Khí quyển (giá từ 0.005 USD/yêu cầu)
SKU: Tìm địa điểm – Chỉ có mã nhận dạng
Tìm địa điểm – chỉ có mã nhận dạng sẽ bị tính phí đối với những yêu cầu Tìm địa điểm chỉ chỉ định Mã địa điểm cần được 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ì hệ thống chỉ trả về mã địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0 VND | 0 VND | 0 VND |
Ví dụ:
Bạn đưa ra yêu cầu Tìm địa điểm và chỉ chỉ định trường place_id: FindPlace(fields: place_id).
Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi
xem hoá đơn theo SKU):
- Tìm địa điểm – Chỉ có giấy tờ tuỳ thân (tính phí 0.00 USD)
SKU: Địa điểm – Tìm kiếm lân cận
Địa điểm – Tìm kiếm lân cận được tính phí đối với các yêu cầu đối với
dịch vụ Tìm kiếm địa điểm lân cận của API Maps JavaScript (nearbySearch()) hoặc
dịch vụ Tìm kiếm lân cận của API Địa điểm
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,032 USD trên mỗi (32 USD trên 1.000) |
0,0256 USD mỗi (25,60 USD trên 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 địa điểm, nhưng không hỗ trợ chỉ định trường nào được trả về. Các yêu cầu Tìm kiếm lân cận sẽ trả về một tập con của các trường dữ liệu được hỗ trợ. Bạn phải trả phí cho yêu cầu Tìm kiếm lân cận với giá từ 0, 032 USD cho mỗi yêu cầu, cũng như mọi SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệ và 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 hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):
- Địa điểm – Tìm kiếm lân cận (giá từ 0,032 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Dữ liệu về Khí quyển (giá từ 0.005 USD/yêu cầu)
SKU: Địa điểm – Tìm kiếm văn bản
Địa điểm – Tìm kiếm văn bản được tính phí đối với các yêu cầu tới
dịch vụ Tìm kiếm văn bản địa điểm của API Maps JavaScript (textSearch()) hoặc
dịch vụ Tìm kiếm văn bản của API Địa điểm.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,032 USD trên mỗi (32 USD trên 1.000) |
0,0256 USD mỗi (25,60 USD trên 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 địa điểm, nhưng không hỗ trợ chỉ định trường nào được trả về. 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ẽ được tính phí cho yêu cầu Tìm kiếm văn bản với giá từ 0, 032 USD cho mỗi yêu cầu, cũng như tất cả SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu khí quyển).
SKU Địa điểm – Tìm kiếm văn bản cũng được tạo bởi
tiện ích Place SearchBox của API Maps JavaScript: phương thức getPlaces() sau khi người dùng chọn truy vấn địa điểm (biểu tượng: kính lúp), không phải kết quả (biểu tượng: ghim), như minh hoạ dưới đây:
Ví dụ:
Bạn đưa ra một yêu cầu Tìm kiếm văn bản, chẳng hạn như TextSearch(123 Main Street). Trên hoá đơn,
bạn sẽ thấy các SKU này được liệt kê (khi
xem hoá đơn theo SKU):
- Địa điểm – Tìm kiếm văn bản (giá từ 0,032 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn với giá 0,00 USD)
- Dữ liệu liên hệ (giá từ 0,003 USD/yêu cầu)
- Dữ liệu về Khí quyển (giá từ 0.005 USD/yêu cầu)
SKU: Ảnh địa điểm
SKU Ảnh địa điểm sẽ được tính phí cho:
- Android: cuộc gọi đến
fetchPhoto() - iOS: cuộc gọi đến
loadPlacePhoto: - JavaScript: đối với Thư viện địa điểm, dịch vụ Địa điểm của API JavaScript Maps khi yêu cầu dữ liệu từ các URL do
PlacePhoto.getUrl()trả về để tải dữ liệu pixel hình ảnh - Dịch vụ web: các yêu cầu đến dịch vụ Ảnh về địa điểm API Địa điểm
Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl() sẽ không gây ra vấn đề thanh toán cho đến khi URL thực sự được dùng để lấy dữ liệu pixel.
| PHẠM VI SỐ LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,007 USD trên mỗi (7 USD trên 1.000) |
0,0056 USD trên mỗi (5,60 USD trên 1.000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Hạn mức sử dụng khác
Mặc dù không có giới hạn tối đa về số lượng yêu cầu mỗi ngày, nhưng các giới hạn sử dụng sau đây vẫn áp dụng:
API Địa điểm (Mới): Giới hạn số lượng yêu cầu là 600 QPM (số yêu cầu mỗi phút) cho mỗi phương thức API cho mỗi dự án. Có nghĩa là mỗi phương thức API có một hạn mức riêng.
API Địa điểm: Giới hạn số lượng yêu cầu là 6.000 QPM (số yêu cầu mỗi phút). Số liệu 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 xác thực của cùng một dự án.
Các hạn chế của Điều khoản sử dụng
Để biết thông tin về điều khoản sử dụng, hãy xem chính sách dành cho Places API và mục Hạn chế cấp 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
Để quản lý chi phí sử dụng Places API hoặc đáp ứng nhu cầu về lưu lượng truy cập vào kênh phát hành công khai, hãy đặt hạn mức hằng ngày cho tất cả yêu cầu gửi đến API bất kỳ. 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 hạn mức cho Places API:
- Trong Cloud Console, hãy mở trang Hạn mức của Nền tảng Google Maps.
- Nhấp vào trình đơn thả xuống API và chọn API Địa điểm.
- Để xem hạn mức, hãy di chuyển xuống thẻ Yêu cầu.
Có một bảng liệt kê tên và giới hạn của hạn mức. - Để thay đổi một hạn mức, hãy nhấp vào biểu tượng Chỉnh sửa cho giới hạn đó.
Trong hộp thoại xuất hiện sau đó, trong trường Hạn mức, hãy nhập hạn mức có thể thanh toán hằng ngày mong muốn (lên đến hạn mức do Google chỉ định, nếu có) rồi chọn Lưu.
Nếu việc sử dụng API của bạn đạt đến hạn mức có thể lập hoá đơn vào một ngày cụ thể nào đó, thì ứng dụng của bạn sẽ không thể truy cập vào API trong thời gian còn lại của ngày đó.
Tài nguyên quản lý chi phí có liên quan
-
Người dùng ở Ấn Độ phải tạo tài khoản thanh toá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 tín dụng Maps Platform. ↩