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 và SDK của Nền tảng Google Maps 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 sản phẩm. Chi phí được tính bằng công thức sau:
Hãy 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 Google Maps Platform trị giá 200 USD mỗi tháng. Khoản tín dụng này sẽ tự động áp dụng cho các SKU đủ điều kiện.
Giá cho Places API (Mới)
Giới thiệu về mặt nạ trường
Đối với Chi tiết đị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), bạn sẽ bị 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à 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à một 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ỉ. Mã thông báo phiên tương tự sẽ đượ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 đầu tiên (Mới). Sau đó, 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 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, tức là không có yêu cầu Chi tiết đị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ẽ được 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 (nghĩa là thực hiện yêu cầu Chi tiết đị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 có hiệu lực cho một phiên và không thể 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ẽ bị 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 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í 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 tới Chi tiết địa điểm (Mới) yêu cầu bất kỳ trường nào do SKU: Chi tiết địa điểm (Chỉ vị trí) xác định.
- 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 cách sử dụ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 tính phí bằng cách sử dụng SKU: Tự động hoàn thành phiên sử dụng.
- Bỏ qua hoặc kết thúc phiên bằng cách gọi đến SKU: Place Details (Chỉ 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 tính phí thông qua 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 mỗi (2,83 USD mỗi 1000) |
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 sẽ được tính phí cho mỗi yêu cầu tới 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ị kết thúc bằng lệnh gọi tớ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 cách sử dụ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 tính phí bằng cách sử dụng SKU: Tự động hoàn thành phiên sử dụng.
Phiên tự động hoàn thành đã kết thúc bằng một 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) sẽ được lập hoá đơn theo 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 đến SKU: Ưu tiên xác thực địa chỉ.
Để biết thêm thông tin, hãy xem phần Tự động hoàn thành (Mới) và đặt giá cho phiên.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0 USD mỗi (0 USD mỗi 1000) |
0 USD mỗi (0 USD mỗi 1000) |
0 USD mỗi (0 USD mỗi 1000) |
SKU: Thông tin chi tiết về địa điểm (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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở những 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:
attributions
,
id
,
name
*,
photos
* Trường name
chứa địa điểm tên tài nguyên
ở dạng: places/PLACE_ID
. Hãy sử dụng displayName
để truy cập vào tên dạng văn bản của địa điểm.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0 USD mỗi (0 USD mỗi 1000) |
0 USD mỗi (0 USD mỗi 1000) |
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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở những 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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ ở những 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ằng một 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), thì lệnh gọi sẽ được tính phí theo 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: Tự động hoàn thành cách sử dụng phiên.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌ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)
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ỉ ở những 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ằng một 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), thì lệnh gọi sẽ được tính phí theo 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: Tự động hoàn thành cách sử dụng phiên.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,020 USD mỗi (20 USD mỗi 1000) |
0,016 USD mỗi (16 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 (Ư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ỉ ở những 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
,
reviews
,
restroom
,
reviews
,
{//},
reviews
,
{//},
reviews
,
{//},
reviews
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
restroom
,
reviews
,
{//},
reviews
,
{/},
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Nếu phiên Tự động hoàn thành bị chấm dứt bằng một 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), thì lệnh gọi sẽ được tính phí theo 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: Tự động hoàn thành cách sử dụng phiên.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,025 USD mỗi (25 USD mỗi 1000) |
0,020 USD mỗi (20 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 (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ỉ ở những 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.businessStatus
,
places.businessStatus
và places.displayName
places.formattedAddress
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name
places.name
*places.photos
places.plusCode
places.primaryType
places.primaryTypeDisplayName
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
Hãy sử dụng places.displayName
để truy cập vào tên dạng văn bản của địa điểm.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,032 USD mỗi (32 USD mỗi 1000) |
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)
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ỉ ở những 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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌ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 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ỉ ở những 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.restroom
,
places.reviews
,
{//},
places.reviews
,
{//},
places.reviews
,
{//},
places.reviews
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.restroom
,
places.reviews
,
{//},
places.reviews
,
{/},
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,040 USD mỗi (40 USD mỗi 1000) |
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ể giới hạn phản hồi chỉ ở những 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 địa điểm tên tài nguyên
ở dạng: places/PLACE_ID
. Hãy sử dụng places.displayName
để truy cập vào tên dạng văn bản của địa điểm.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0 USD mỗi (0 USD mỗi 1000) |
0 USD mỗi (0 USD mỗi 1000) |
0 USD mỗi (0 USD mỗi 1000) |
SKU: Tìm kiếm 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ỉ ở những 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.viewport
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,032 USD mỗi (32 USD mỗi 1000) |
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 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ỉ ở những 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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌ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ể giới hạn phản hồi chỉ ở những 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.restroom
,
places.reviews
,
{//},
places.reviews
,
{//},
places.reviews
,
{//},
places.reviews
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.restroom
,
places.reviews
,
{//},
places.reviews
,
{/},
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,040 USD mỗi (40 USD mỗi 1000) |
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
SKU Ảnh địa điểm được tính phí cho mỗi yêu cầu gửi tới API.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,007 USD mỗi (7 USD mỗi 1000) |
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 |
Đị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 vị trí dưới dạng 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 đó cũng được chuyển đến 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 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ì 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à lệnh gọi Thông tin chi tiết về địa điểm đượ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.
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 của 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ế ứng dụng để cung cấp mã thông báo phiên (có thể bạn sẽ 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 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 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 đó sẽ bị 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 thông qua các phiên hoạt động 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 của địa điểm là: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu khí quyển.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ở đối với yêu cầu kích hoạt các SKU đó. Ví dụ: yêu cầu Thông tin chi tiết về địa điểm bao gồm cả 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 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 phí cho 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 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 chỉ phản hồi ở những trường được chỉ định. Các trường thuộc danh mục Cơ bản được đưa vào chi phí cơ bản của yêu cầu Địa điểm và không làm phát sinh thêm phí. SKU Dữ liệu cơ bản được kích hoạt khi có 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_OFFSET
hoặcPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
hoặ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ệ
Khi dùng tham số trường trong yêu cầu Chi tiết địa điểm hoặc 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ỉ ở những trường được chỉ định. Các trường trong danh mục Thông tin liên hệ 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 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_HOURS
hoặcPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
hoặcGMSPlaceFieldWebsite
-
Dịch vụ web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
hoặcwebsite
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,003 USD mỗi đơn hàng (+ 3,00 USD mỗi 1.000) |
Chi phí yêu cầu tại địa điểm + 0,0024 USD mỗi đơn vị quảng cáo (+ 2,4 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: 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ể giới hạn chỉ phản hồi ở những trường được chỉ định. Các trường trong danh mục Khí quyển sẽ bị tính thêm phí. SKU Dữ liệu khí quyển được kích hoạt khi có 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.TAKEOUT
, hoặcPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
hoặcGMSPlaceFieldServesVegetarianFood
. - JavaScript: Xem Trường (Chi tiết về địa điểm)
- Dịch vụ web:
curbside_pickup
,delivery
,dine_in
,editorial_summary
,price_level
,rating
,reservable
,reviews
,serves_beer
,serves_breakfast
,serves_brunch
,serves_dinner
,serves_lunch
,serves_vegetarian_food
,serves_wine
,takeout
hoặ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 yêu cầu được tính phí cho bất kỳ lệnh gọi hoặc yêu cầu nào sau đây 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ừ 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 bị tính phí theo SKU của tính năng Tự động hoàn thành – Theo mỗi yêu cầu.
Các yêu cầu Tự động hoàn thành từ Tiện ích tự động hoàn thành của API Maps JavaScript có thể bị tính phí bằng tính năng Tự động hoàn thành – Theo SKU yêu cầu trong trường hợp 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 cũng chọn cụm từ gợi ý của tính năng tự động hoàn thành.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG (Giá mỗi YÊU CẦU) |
||
---|---|---|
0,00283 USD mỗi (2,83 USD mỗi 1000) |
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 mà không có thông tin chi tiết về địa điểm – mỗi phiên sẽ được tính phí cho một 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 đầu phiên).
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 dự đoán(fromQuery: "par" ...
- placesClient?.findTự động tự động dự đoán(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)
- Đặt yêu cầu tự động hoàn thành (input=”paris”, session_token: XYZ)
Trên hoá đơn, bạn sẽ thấy SKU này (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 – Mỗi phiên (giá 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
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 sẽ được tính phí cho một Phiên tự động hoàn thành bao gồm bất kỳ yếu tố nào sau đây:
- Android: 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
Bạn không phải trả phí cho yêu cầu tự động hoàn thành, và cuộc gọi tiếp theo qua Thông tin chi tiết về địa điểm sẽ được tính phí dựa trên mức giá 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 các SKU dữ liệu (Cơ bản, Thông tin liên hệ và/hoặc Khí quyển) – 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 (các 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 LƯU LƯỢNG 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 đư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
FetchPlaceRequest
bao gồm ID địa điểm và trường ADDRESS)
iOS
- placesClient?.findTự động dự đoán(fromQuery: "par" ...
- placesClient?.findTự động tự động dự đoán(fromQuery: "paris" ...
- fetchPlaceFromPlaceID: (bao gồm ID địa điểm và trường
GMSPlaceFieldFormattedAddress
)
Dịch vụ web
- Yêu cầu tự động hoàn thành theo đị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 sau đâ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)
- 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)
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 để:
- 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 (Các yêu cầu Tự động hoàn thành truy vấn được tạo dưới dạng kiểu 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 LƯU LƯỢNG HẰNG THÁNG (Giá mỗi YÊU CẦU) |
||
---|---|---|
0,00283 USD mỗi (2,83 USD mỗi 1000) |
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 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 Thông tin chi tiết về địa điểm sẽ được 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: Thông tin chi tiết về địa điểm
Các cuộc gọi 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,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 |
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ụ Chi tiết đị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ả về địa điểm (biểu tượng: ghim), *không* phải truy vấn (biểu tượng: phóng to), như minh họa ở đây: - Dịch vụ web: Dịch vụ Chi tiết địa điểm bằng API Địa điểm
Với API web và dịch vụ, SKU Chi tiết đị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 (Basic, Contact (Thông tin liên hệ) và/hoặc Environment), tuỳ thuộc vào các trường được chỉ định trong lệnh gọi hoặc yêu cầu. Nếu bạn chỉ định trường NO trong lệnh gọi hoặc yêu cầu Thông tin chi tiết về địa điểm, thì NO SKU dữ liệu sẽ được kích hoạt và bạn sẽ bị tính phí cho cuộc 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: đưa ra yêu cầu Chi tiết địa điểm và chỉ chỉ định trường địa chỉ:
getPlaceDetails(fields: formatted_address)
- 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)
- 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 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 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 rồi chỉ định tất cả các trường - Dịch vụ hoặc API web: đưa ra yêu cầu 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à loại yêu cầu 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ông khí (giá khởi điểm 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 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 Thông tin chi tiết về địa điểm chỉ định chỉ định trường mã đị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 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 |
Yêu cầu Tìm địa điểm cũng tạo ra SKU dữ liệu (Basic, Liên hệ và/hoặc Không khí được chỉ định trong các trường Giống như các yêu cầu 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ỉ ở 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 trường NO được yêu cầu, thì chỉ có mã địa điểm được trả về, 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ỉ xác định trường địa chỉ:
FindPlace(fields: formatted_address)
. Trên hoá đơn, bạn sẽ thấy các SKU sau đây được liệt kê (khi xem hoá đơn của bạ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 những SKU sau đây được liệt kê (khi xem hoá đơn của bạn theo SKU):- Tìm địa điểm (giá khởi điểm từ 0,017 USD/cuộc gọi)
- Dữ liệu liên hệ (giá khởi điểm 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 trong cả 3 nhóm loại dữ liệu:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Trên hoá đơn, bạn sẽ thấy các SKU sau đây được liệt kê (khi xem hoá đơn của bạ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
Tìm địa điểm – Chỉ mã nhận dạng được tính phí 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ì 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 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 (khi xem hoá đơn theo SKU):
- Tìm địa điểm – Chỉ mã (thanh toán 0 đô la Mỹ)
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 đến
dịch vụ Tìm kiếm lân cận của API Maps JavaScript (nearbySearch()
) hoặc
dịch vụ Tìm kiếm lân cận bằng 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 mỗi (32 USD mỗi 1000) |
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 |
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 trả về một tập hợp con gồm các trường dữ liệu được hỗ trợ. Bạn sẽ phải trả phí cho yêu cầu Tìm kiếm lân cận với giá khởi điểm là 0,032 USD mỗi SKU và 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).
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 sau đâ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 (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: Địa điểm – Tìm kiếm văn bản
Hệ thống sẽ tính phí Địa điểm – Tìm kiếm văn bản cho những yêu cầu được gửi đến
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 bằng 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 mỗi (32 USD mỗi 1000) |
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 |
Yêu cầu Tìm kiếm văn bản trả về một danh sách đị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ẽ phải trả phí cho yêu cầu Tìm kiếm văn bản với giá khởi điểm là 0,032 USD cho mỗi yêu cầu và 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ằng
tiện ích Hộp tìm kiếm địa điểm của Maps JavaScript API: phương thức getPlaces()
sau khi người dùng chọn truy vấn địa điểm (biểu tượng: phóng to), 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 sau đây được liệt kê (khi xem hoá đơn theo SKU):
- Địa điểm – Tìm kiếm văn bản (giá khởi điểm từ 0,032 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: Ảnh địa điểm
SKU Ảnh địa điểm được tính phí đối với:
- Android: cuộc gọi đến
fetchPhoto()
- iOS: cuộc gọi đến
loadPlacePhoto:
- JavaScript: sang Thư viện địa điểm, dịch vụ Place Photos của API Maps JavaScript 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 dịch vụ Ảnh về địa điểm bằng API Địa điểm
Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl()
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,007 USD mỗi (7 USD mỗi 1000) |
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 |
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 các giới hạn sử dụng sau đây vẫn được áp dụng:
Places API (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 của mỗi dự án. Tức là mỗi phương thức API sẽ có một hạn mức riêng.
Places API: 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.
Giới hạn trong Điều khoản sử dụng
Để biết thông tin về điều khoản sử dụng, hãy xem các chính sách dành cho API Địa điểm và mục Giới hạn 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 chính thức, 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 sẽ đượ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 rồi chọn API Địa điểm.
- Để xem hạn mức, hãy di chuyển xuống thẻ Yêu cầu.
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 hạn mức đó.
Trong hộp thoại hiện ra, trong trường Giới hạn hạn mức, hãy nhập hạn mức hằng ngày có thể thanh toán mà bạn ưu tiên (tối đa là hạn mức do Google chỉ định, nếu có) rồi chọn Lưu.
Nếu mức sử dụng API của bạn đạt đến hạn mức có thể thanh toán vào một ngày nhất định, 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 đó.