Cách tính phí API Địa điểm
Places API (Mới) và Places API sử dụng mô hình định giá trả tiền theo mức dùng. API của Nền tảng Google Maps và SDK do SKU tính phí. Việc 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 SKU sản phẩm. Chi phí được tính theo công thức:
Hãy sử dụng Công cụ tính mức 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ều kiện Các SKU của Nền tảng Google Maps, tín dụng Google Maps Platform trị giá 200 USD mỗi tháng cho từng tài khoản thanh toán. Khoản tín dụng này sẽ tự động được áp dụng cho các SKU đủ điều kiện.
Mức giá của Places API (Mới)
Giới thiệu về mặt nạ trường
Để biết 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), sử dụng tiêu đề FieldMask trong
Các yêu cầu API chỉ định danh sách trường cần trả về trong phản hồi. Bạn
sau đó 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 bạn 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).
Sử dụng tính năng che giấu trường là một phương pháp thiết kế hiệu quả để đả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à thanh toán không cần thiết các khoản phí.
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à một yêu cầu 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ự được chuyển đến yêu cầu Tự động hoàn thành (Mới) và đế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ỉ 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 đó, 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ỉ sẽ đượ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 (Mới). Nếu một phiên hoạt động bị huỷ, 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ỉ được thực hiện, 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 đã được cung cấp.
Sau khi người dùng chọn một địa điểm (nghĩa là yêu cầu Chi tiết địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ được thực hiện), 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 chỉ có giá trị trong 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, thì phiên đó sẽ được coi là không hợp lệ và các yêu cầu sẽ được 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 đượ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í cũng sẽ được tính nếu bạn sử dụng mã thông báo phiên và:
- Chấm dứt các phiên bằng một yêu cầu duy nhất đối với Chi tiết địa điểm (Mới)
yêu cầu bất kỳ trường nào được xác định bởi SKU: Chi tiết địa điểm (Chỉ vị trí).
- Mỗi yêu cầu Tự động hoàn thành (Mới), tối đa 12 yêu cầu, sẽ được tính phí 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: Tự động hoàn thành việc sử dụng phiên.
- Huỷ phiên hoặc kết thúc phiên bằng cách gọi đến SKU: Thông tin chi tiết về địa điểm (Chỉ mã nhận dạng). Sau đó, tất cả yêu cầu Tự động hoàn thành (Mới) sẽ được lập hoá đơn bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành.
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,00283 USD cho mỗi (2,83 USD cho 1.000 ) |
0,00227 USD mỗi (2,27 USD 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 sử dụng phiên
SKU Sử dụng phiên tự động hoàn thành được tính phí cho mỗi yêu cầu gửi đến API Tự động hoàn thành (Mới) bao gồm mã thông báo phiên.
SKU này sẽ được tính phí trong các trường hợp sau:
Phiên tự động hoàn thành bị chấm dứt bằng lệnh gọi đến SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí):
- Tối đa 12 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.
- 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: Tự động hoàn thành việc sử dụng phiên.
Phiên tự động hoàn thành đã kết thúc bằng lệnh gọi đến SKU: Chi tiết địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên).
Lệnh gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào trong SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên) được thanh toán ở SKU: Thông tin chi tiết về địa điểm (Ưu tiên).
Phiên tự động hoàn thành đã kết thúc bằng lệnh gọi tới SKU: Xác thực địa chỉ Nên dùng.
Để biết thêm thông tin, hãy xem bài viết Tính năng tự động hoàn thành (Mới) và giá phiên.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,00 USD cho mỗi (0,00 USD cho 1.000 ) |
0,00 USD cho mỗi (0,00 USD cho 1.000 ) |
0,00 USD cho mỗi (0,00 USD cho 1.000 ) |
SKU: Thông tin chi tiết về địa điểm (Chỉ mã nhận dạng)
Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã 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:
attributions,
id!
name*,
photos
* Trường name chứa tên tài nguyên địa điểm
trong biểu mẫu: places/PLACE_ID. Sử dụng displayName để truy cập tên văn bản của địa điểm.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0 USD cho mỗi (0 USD cho 1.000 ) |
0 USD cho mỗi (0 USD cho 1.000 ) |
0 USD mỗi (0 USD mỗi 1000) |
SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho 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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,005 USD mỗi (5 USD mỗi 1000) |
0,004 USD mỗi (4 USD mỗi 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ơ bản)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU đượ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ị kết thúc bởi lệnh gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào trong SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), sau đó tính phí cho cuộc gọ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 bài viết SKU: Mức sử dụng phiên tự động hoàn thành.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,0170 USD mỗi (17 USD mỗi 1000) |
0,0136 USD mỗi (13,6 USD mỗi 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)
Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã 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ị kết thúc bởi lệnh gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào trong SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), sau đó tính phí cho cuộc gọ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 bài viết SKU: Mức sử dụng phiên tự động hoàn thành.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,020 USD cho mỗi (20,00 USD cho 1.000 ) |
0,016 USD cho mỗi (16 USD cho 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 (Ưu tiên)
Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU đượ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,
reviews,
routingSummaries,*
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine,
takeout
* Chỉ Tìm kiếm văn bản và Tìm kiếm lân cận
Nếu phiên Tự động hoàn thành bị kết thúc bởi lệnh gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào trong SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), sau đó tính phí cho cuộc gọ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 SKU: Tự động hoàn thành việc sử dụng phiên.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,025 USD cho mỗi (25 USD cho 1.000 ) |
0,020 USD cho mỗi (20,00 USD cho 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 (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) của mình, bạn có thể hạn chế chỉ phản hồi cho 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.attributions!
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.shortFormattedAddress,
places.subDestinations,
places.types,
places.utcOffsetMinutes,
places.viewport
* Trường places.name chứa địa điểm tên tài nguyên
trong biểu mẫu: places/PLACE_ID. Sử dụng places.displayName để truy cập tên văn bản của địa điểm.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,032 USD cho mỗi (32 USD cho 1.000 ) |
0,0256 USD mỗi (25,6 USD mỗi 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)
Bằng cách 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ể chỉ giới hạn phản hồi ở những trường đã 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
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,035 USD mỗi (35 USD mỗi 1000) |
0,028 USD cho mỗi (28 USD cho 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) của mình, bạn có thể hạn chế chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU đượ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.reviews,
places.routingSummaries,*
places.servesBeer,
places.servesBreakfast,
places.servesBrunch,
places.servesCocktails,
places.servesCoffee,
places.servesDessert,
places.servesDinner,
places.servesLunch,
places.servesVegetarianFood,
places.servesWine,
places.takeout
* Chỉ Tìm kiếm văn bản và Tìm kiếm lân cận
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,040 USD cho mỗi (40,00 USD cho 1.000 ) |
0,032 USD mỗi (32 USD mỗi 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 (Chỉ 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 Tìm kiếm văn bản (Mới), bạn có thể hạn chế chỉ phản hồi cho 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.attributions,
places.id!
places.name*,
nextPageToken
* Trường places.name chứa tên tài nguyên địa điểm
trong biểu mẫu: places/PLACE_ID. Sử dụng places.displayName
để truy cập vào tên dạng văn bản của địa điểm.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0 USD cho mỗi (0 USD cho 1.000 ) |
0 USD cho mỗi (0 USD cho 1.000 ) |
0 USD mỗi (0 USD mỗi 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ể hạn chế chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU đượ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.viewport
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,032 USD cho mỗi (32 USD cho 1.000 ) |
0,0256 USD cho mỗi (25,6 USD cho 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 (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ể hạn chế chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU đượ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
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,035 USD mỗi (35 USD mỗi 1000) |
0,028 USD mỗi (28 USD mỗi 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 (Ư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ể hạn chế chỉ phản hồi cho 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.reviews,
places.routingSummaries,*
places.servesBeer,
places.servesBreakfast,
places.servesBrunch,
places.servesCocktails,
places.servesCoffee,
places.servesDessert,
places.servesDinner,
places.servesLunch,
places.servesVegetarianFood,
places.servesWine,
places.takeout
* Chỉ Tìm kiếm văn bản và Tìm kiếm lân cận
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,040 USD cho mỗi (40,00 USD cho 1.000 ) |
0,032 USD mỗi (32 USD mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Ảnh địa điểm
Bạn sẽ phải trả phí cho mỗi yêu cầu gửi đến API đối với SKU Ảnh địa điểm.
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,007 USD cho mỗi (7 USD cho 1.000 ) |
0,0056 USD cho mỗi (5,60 USD cho 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 trên đặt khi người dùng nhập) và tối đa một yêu cầu Chi tiết địa điểm (để truy xuất thông tin chi tiết về địa điểm do người dùng chọn). Mã thông báo phiên tương tự được truyền đến tính năng Tự động hoàn thành và yêu cầu Thông tin chi tiết về địa điểm tiếp theo. Một phiên hoạt động 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 một đề xuất, thì hệ thống sẽ không thực hiện lệnh gọi Chi tiết về địa điểm.
Sau khi người dùng đã chọn một địa điểm (tức là một cuộc gọi Chi tiết địa điểm được thực hiện), bạn phải bắt đầu một cuộc gọi 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 qua các API sau:
- Dịch vụ Tự động hoàn thành địa điểm bằng API Địa điểm hoặc Dịch vụ Tự động hoàn thành địa điểm của API Maps JavaScript. Bạn cần thiết kế để cung cấp mã thông báo phiên (bạn có thể cần phải thay đổi mã hiện tại của mình).
- Tiện ích Tự động hoàn thành của API Maps JavaScript. Thanh toán dựa trên phiên là tự động được bật trên các tiện ích đó mà không cần phải thay đổi mã.
Mã thông báo phiên chỉ dùng được cho một phiên người dùng và không được dùng cho nhiều người dùng phiên hoạt động. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được coi là không hợp lệ và các yêu cầu sẽ được 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 sử dụng phiên sẽ được tính phí theo 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 môi trường xung quanh.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: từng lệnh gọi đến
fetchPlaceFromPlaceID:hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - Dịch vụ web:từng yêu cầu Địa điểm tuỳ thuộc vào các trường được chỉ định trong yêu cầu
Các SKU dữ liệu luôn được tính phí ngoài SKU cơ sở cho việc kích hoạt yêu cầu chúng. Ví dụ: yêu cầu Chi tiết địa điểm bao gồm các trường Dữ liệu cơ bản sẽ được tính phí theo 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ợ việc 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 ĐƯỢC hỗ trợ chỉ định hàm được trả về mới. Các lệnh gọi này luôn trả về tất cả dữ liệu Địa điểm, tính phí cho 3 SKU Dữ liệu địa điểm trong ngoài khoản phí cho mỗi yêu cầu API:
SKU: Dữ liệu cơ bả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ỉ ở những trường được chỉ định đó. Các trường trong danh mục Cơ bản được tính trong chi phí cơ bản của yêu cầu về Địa điểm và không tính thêm phí. SKU Dữ liệu cơ bản được kích hoạt khi bất kỳ trường nào sau đây được yêu cầu:
-
Android:
Place.Field.ACCESSIBILITY_OPTIONS,Place.Field.ADDRESS_COMPONENTS!Place.Field.BUSINESS_STATUS,Place.Field.DISPLAY_NAME!Place.Field.FORMATTED_ADDRESS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_MASK_URL,Place.Field.ID,Place.Field.LOCATION,Place.Field.PHOTO_METADATAS,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORThoặcPlace.Field.UTC_OFFSET. -
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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| Chi phí yêu cầu liên quan đến địa điểm + 00000.00 VND |
Chi phí yêu cầu liên quan đến địa điểm + 00000.00 VND |
Chi phí yêu cầu liên quan đến địa điểm + 00000.00 VND |
SKU: Dữ liệu liên hệ
Dùng tham số trường trong phần 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 chỉ ở các trường được chỉ định. Các trường trong phần Người liên hệ
thì sẽ bị tính thêm phí. SKU Dữ liệu liên hệ đã được kích hoạt
khi có bất kỳ trường nào trong số này được yêu cầu:
-
Android:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.INTERNATIONAL_PHONE_NUMBER,Place.Field.OPENING_HOURS,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
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| Chi phí yêu cầu tại địa điểm + 0,003 USD mỗi đơn hàng (+ 3,00 USD mỗi 1.000) |
Chi phí yêu cầu về địa điểm + 0,0024 USD/yêu cầu (+ 2,40 USD/1.000 yêu cầu) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Dữ liệu về bầu không khí
Khi 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ể chỉ giới hạn phản hồi ở những trường được chỉ định đó. Các trường trong Khí quyển thì sẽ bị tính thêm phí. SKU Dữ liệu khí quyển là được kích hoạt khi có bất kỳ trường nào trong số các trường sau đượ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_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel,GMSPlaceFieldRatingGMSPlaceFieldUserRatingsTotal,GMSPlaceFieldTakeout,GMSPlaceFieldDelivery,GMSPlaceFieldDineIn,GMSPlaceFieldCurbsidePickup,GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast,GMSPlaceFieldServesLunch,GMSPlaceFieldServesDinner,GMSPlaceFieldServesBeer,GMSPlaceFieldServesWine,GMSPlaceFieldServesBrunchhoặcGMSPlaceFieldServesVegetarianFood. - JavaScript: Xem phần 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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| Chi phí yêu cầu tại địa điểm + 0,005 USD mỗi đơn vị (+ 5 USD mỗi 1.000) |
Chi phí yêu cầu tại địa điểm + 0,004 USD mỗi đơn vị quảng cáo (+ 4,00 USD mỗi 1.000) |
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 mỗi yêu cầu được tính phí cho bất kỳ cuộc gọi nào trong số các cuộc gọi này hoặc các yêu cầu không bao gồm mã thông báo phiên:
- Android:
findAutocompletePredictions() - iOS:
findAutocompletePredictionsFromQuery: - JavaScript: Dịch vụ Tự động hoàn thành địa điểm của API Maps JavaScript
- Dịch vụ web: Dịch vụ tự động hoàn thành địa điểm bằng 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ã thông báo phiên) cũng sẽ bị tính phí SKU Tự động hoàn thành – Theo yêu cầu.
Tự động hoàn thành các yêu cầu từ API JavaScript của Maps Tiện ích Tự động hoàn thành địa điểm có thể bị tính phí cho một tính năng Tự động hoàn thành – Theo SKU yêu cầu trong trường hợp có cuộc 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 nhiều địa chỉ vào tiện ích và không phải lúc nào cũng chọn một cụm từ gợi ý tự động hoàn thành.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi YÊU CẦU) |
||
|---|---|---|
| 0,00283 USD cho mỗi (2,83 USD cho 1.000 ) |
0,00227 USD mỗi (2,27 USD 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ó 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 được tính phí cho một Phiên tự động hoàn thành mà không bao gồm yêu cầu Chi tiết đị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,017 USD mỗi (17 USD mỗi 1000) |
0,0136 USD mỗi (13,6 USD 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 đưa ra 2 lệnh gọi này trong một phiên duy nhất:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findTự động tự động dự đoán(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Dịch vụ web
- Địa điểm cho yêu cầu tự động hoàn thành (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ó Thông tin chi tiết về địa điểm – Theo phiên (giá bắt đầu từ 0,017 USD/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
Tính năng 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 được tính phí cho một phiên Tự động hoàn thành bao gồm bất kỳ điều kiện nào trong số:
- Android: lệnh gọi đến
fetchPlace() - iOS: gọi đến
fetchPlaceFromPlaceID: - Dịch vụ web:yêu cầu về Thông tin chi tiết về địa điểm
Yêu cầu tự động hoàn thành không tính phí và lệnh 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á 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, 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 đều được kích hoạt (Cơ bản, Tiếp xúc và Bầu không khí).
Yêu cầu làm mới mã thông tin chi tiết về địa điểm (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
không có Thông tin chi tiết về địa điểm – Mỗi phiên.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi PHỤ KIỆN) |
||
|---|---|---|
| 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:
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
- placesClient?.findTự động tự động dự đoán(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(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 thông tin về địa điểm (input=”par”, session_token: XYZ)
- Yêu cầu tự động hoàn thành theo địa điểm (input=”paris”, session_token: XYZ)
- Thông tin chi tiết về địa điểm (place_id, session_token: XYZ, fields:formatted_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 (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên (thanh toán 0 VND)
- 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 (lập hóa đơn 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 cụm từ tìm kiếm – Mỗi yêu cầu sẽ bị tính phí cho mỗi yêu cầu để:
- JavaScript: Dịch vụ tự động hoàn thành địa điểm của API Maps JavaScript (
getQueryPredictions()) và việc sử dụng tiện ích SearchBox của API Maps JavaScript (yêu cầu Tự động hoàn thành truy vấn được tạo khi người dùng nhập). - Dịch vụ web: Dịch vụ tự động hoàn thành truy vấn API Địa điểm
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi YÊU CẦU) |
||
|---|---|---|
| 0,00283 USD cho mỗi (2,83 USD cho 1.000 ) |
0,00227 USD mỗi (2,27 USD mỗi 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ự động hoàn thành cụm từ tìm kiếm không hỗ trợ tính năng định giá theo phiên Tự động hoàn thành. Các lệnh 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á thông thường của Thông tin chi tiết về địa điểm.
SKU: Thông tin chi tiết về địa điểm
Các lệnh gọi Place Details sẽ được tính phí như sau:
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,017 USD mỗi (17 USD mỗi 1000) |
0,0136 USD cho mỗi (13,6 USD cho 1.000 ) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU Chi tiết địa điểm được tạo từ 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ụ Thông tin chi tiết về địa điểm của API Maps JavaScript (
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:
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ư được minh hoạ ở đây:
Trong kết quả của tiện ích hộp tìm kiếm, sau khi nhập "pizza" trong phần tìm kiếm hãy lưu ý rằng Pizza Autico có biểu tượng ghim ở bên cạnh, cho biết rằng là kết quả về địa điểm (chứ không phải truy vấn). - Dịch vụ web: Dịch vụ Chi tiết địa điểm bằng 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ẽ bị tính phí cho dù bạn có cung cấp mã thông báo phiên hay không.
Cuộc 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, Liên hệ và/hoặc Bầu không khí), tuỳ thuộc vào trên các trường được chỉ định trong lệnh gọi hoặc yêu cầu. Nếu bạn không chỉ định trường KHÔNG 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Ả 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 các 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 trườngADDRESS - API hoặc dịch vụ web: tạo 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)
- 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 (phí 0 VND)
- Thiết bị di động: gọi
- Thực hiện một trong các 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ỉ xác định trườngPHONE_NUMBER - API hoặc dịch vụ web: tạo yêu cầu Chi tiết địa điểm và chỉ định trường số điện thoại:
getPlaceDetails(fields: formatted_phone_number)
- Chi tiết địa điểm (giá khởi điểm từ 0,017 USD/phiên)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Thiết bị di động: gọi
- Thực hiện một trong các lệnh 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 rồi chỉ định tất cả các trường - API hoặc dịch vụ web: đưa ra yêu cầu Chi tiết địa điểm và chỉ định tất cả các trường (loại
yêu cầu là mặc định nếu bạn không chỉ định bất kỳ trường nào):
getPlaceDetails().
- Chi tiết địa điểm (giá khởi điểm từ 0,017 USD/phiên)
- Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Dữ liệu về bầu khí quyển (giá bắt đầu từ 0,005 USD cho mỗi 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 Chi tiết địa điểm để làm mới mã địa điểm cũ. Chúng tôi cung cấp miễn phí các loại yêu cầu này.
| PHẠM VI LƯU 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 Chi tiết địa điểm chỉ xác định trường id địa điểm:
getPlaceDetails(fields: place_id).
Trên hoá đơn, bạn sẽ thấy SKU này (khi
xem hoá đơn theo SKU):
- Chi tiết địa điểm – Làm mới ID (thanh toán 0,00 USD)
SKU: Tìm địa điểm
Tính phí Tìm địa điểm cho một yêu cầu Tìm địa điểm.
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,017 USD mỗi (17 USD mỗi 1000) |
0,0136 USD cho mỗi (13,6 USD cho 1.000 ) |
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, Liên hệ và/hoặc Không gian), tuỳ thuộc vào các trường được chỉ định trong yêu cầu. Thích thông tin chi tiết về địa điểm các yêu cầu, 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 thành chỉ những trường được chỉ định. Bạn sẽ thanh toán cho yêu cầu Tìm địa điểm cũng như dữ liệu đã yêu cầu. Theo mặc định, nếu trường KHÔNG được yêu cầu thì chỉ có mã địa điểm được trả về, để bạn không phải trả thêm phí dữ liệu.
Ví dụ
- Bạn thực hiện yêu cầu Tìm địa điểm và chỉ xác định trường địa chỉ:
FindPlace(fields: formatted_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ìm địa điểm (giá khởi điểm từ 0,017 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn 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 được liệt kê này (khi xem hoá đơn theo SKU):- Tìm địa điểm (giá bắt đầu từ 0,017 USD cho mỗi lệnh gọi)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Bạn tạo một 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 bạ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á khởi điểm từ 0,017 USD/cuộc gọi)
- Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Dữ liệu về bầu không khí (giá khởi điểm từ 0,005 USD/yêu cầu)
SKU: Tìm địa điểm – Chỉ mã nhận dạng
Bạn sẽ phải trả phí Tìm địa điểm – chỉ mã cho 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ì hệ thống sẽ chỉ trả về mã địa điểm.
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 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 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ỉ mã (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í cho các yêu cầu vào
Dịch vụ Tìm kiếm địa điểm lân cận của API Maps JavaScript
(nearbySearch()) hoặc vào
Dịch vụ Tìm kiếm lân cận bằng API Địa điểm
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,032 USD cho mỗi (32 USD cho 1.000 ) |
0,0256 USD mỗi (25,6 USD 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 đị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 lân cận trả về một tậ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 với giá từ 0,032 USD cho mỗi SKU, 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 về bầu không khí).
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á khởi điểm từ 0,032 USD/cuộc gọi)
- Dữ liệu cơ bản (được tính phí 0 USD)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Dữ liệu về bầu không khí (giá khởi điểm từ 0,005 USD/yêu cầu)
SKU: Địa điểm – Tìm kiếm bằng văn bản
Địa điểm – Tìm kiếm bằng văn bản sẽ tính phí cho các yêu cầu gửi đến dịch vụ Tìm kiếm bằng văn bản của địa điểm trong API Maps JavaScript (textSearch()) hoặc đến dịch vụ Tìm kiếm bằng văn bản của API Địa điểm.
| PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
|---|---|---|
| 0,032 USD cho mỗi (32 USD cho 1.000 ) |
0,0256 USD cho mỗi (25,6 USD cho 1.000 ) |
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 bằng văn bản trả về danh sách địa điểm, nhưng không hỗ trợ việc chỉ định trường nào được trả về. Yêu cầu Tìm kiếm văn bản trả về a tập hợp con các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho mỗi yêu cầu Tìm kiếm bằng văn bản, bắt đầu từ 0,032 USD, 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 về bầu khí quyển).
Địa điểm – SKU của 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: getPlaces()
sau khi người dùng chọn một truy vấn địa điểm (biểu tượng: trình phóng to), không phải
kết quả (biểu tượng: ghim), như minh hoạ ở đây:
Ví dụ:
Bạn tạo 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 của bạ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 bằng văn bản (giá bắt đầu từ 0,032 USD cho mỗi lệnh gọi)
- Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
- Dữ liệu về bầu khí quyển (giá bắt đầu từ 0,005 USD cho mỗi yêu cầu)
SKU: Ảnh địa điểm
SKU Ảnh địa điểm được tính phí đối với:
- Android: cuộc gọi đến
fetchPhoto() - iOS: lệnh gọi đến
loadPlacePhoto: - JavaScript: đến Thư viện địa điểm, dịch vụ Ảnh địa điểm của Maps JavaScript API 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:yêu cầu gửi đến Địa điểm API Địa điểm Dịch vụ Photos
Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl() sẽ không
cho đến khi URL được sử dụng để lấy dữ liệu pixel.
| DUNG LƯỢNG HÀNG THÁNG (Giá mỗi LƯU LẠI) |
||
|---|---|---|
| 0,007 USD cho mỗi (7 USD cho 1.000 ) |
0,0056 USD mỗi (5,6 USD 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ó quy định về số lượng yêu cầu tối đa mỗi ngày, nhưng những hạn mức sử dụng vẫn áp dụng:
Places API (Mới): Giới hạn số lượng yêu cầu là 600 QPM (yêu cầu mỗi phút) theo phương thức API cho mỗi dự án. Tức là mỗi phương thức API có hạn mức riêng.
Places API: Giới hạn tốc độ là 6.000 QPM (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 bằng thông tin xác thực của cùng một dự án.
Quy định hạn chế trong Đ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 đối với API Địa điểm và mục Hạn chế về 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
Để quản lý chi phí sử dụng Places API hoặc đáp ứng nhu cầu sản xuất của bạn lưu lượng truy cập, đặt giới hạn hạn mức hằng ngày cho tất cả yêu cầu đối với bất kỳ API nào. Hạn mức hằng ngày được đặt lại 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 rồi chọn Places API.
- Để xem hạn mức, hãy di chuyển xuống phần Yêu cầu
.
Một bảng liệt kê tên và hạn mức 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 hạn mức đó.
Trong hộp thoại xuất hiện, trong trường Giới hạn hạn mức, hãy nhập hạn mức hằng ngày ưu tiên có thể thanh toán (tối đa 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 của bạn đạt đến giới hạn hạn mức có thể thanh toán vào một ngày cụ thể bất kỳ, ứng dụng của bạn sẽ không có thể truy cập API trong thời gian còn lại trong ngày.