Lỗi: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
SDK Địa điểm dành cho Android sử dụng mô hình định giá trả tiền theo mức dùng. Các yêu cầu SDK Địa điểm dành cho Android đối với SDK Địa điểm dành cho Android được tính phí theo SKU. Cùng với Điều khoản sử dụng chung của Google, có giới hạn sử dụng dành riêng cho SDK Địa điểm dành cho Android. Quản lý chi phí và mức sử dụng bằng các công cụ có trong Google Cloud Console.
Cách tính phí sử dụng SDK Địa điểm dành cho Android
SDK Địa điểm dành cho Android (Mới) và SDK Địa điểm dành cho Android sử dụng mô hình định giá trả theo mức dùng. API và SDK của Nền tảng Google Maps do SKU tính phí. Hệ thống theo dõi mức sử dụng 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 sau:
Hãy 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, bạn sẽ nhận được 200 USD tín dụng của Nền tảng Google Maps mỗi tháng cho mỗi tài khoản thanh toán. Khoản tín dụng này tự động áp dụng1 cho các SKU đủ điều kiện.
Giá cho SDK Địa điểm dành cho Android (Mới)
Giới thiệu về mặt nạ cho hiện trường
Sử dụng mặt nạ cho trường (field mask) (còn gọi là danh sách trường) trong yêu cầu để chỉ định danh sách trường cần trả về trong phản hồi. Sau đó, bạn sẽ thanh toán theo SKU cao nhất áp dụng cho yêu cầu của mình. Đ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 mặt nạ 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à phí thanh toán không cần thiết.
SKU: Chi tiết đị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ỉ với 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:
Android:
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.PHOTO_METADATAS
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0 USD trên mỗi (0,00 USD mỗi 1000) |
0 USD trên mỗi (0,00 USD mỗi 1000) |
0 USD trên mỗi (0,00 USD mỗi 1000) |
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ỉ với 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:
Android:
Place.Field.ADDRESS
,
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,0170 USD trên mỗi (17 USD trên 1.000) |
0,0136 USD mỗi (13,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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ỉ với 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:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,020 USD mỗi (20 USD mỗi 1.000) |
0,016 USD mỗi (16 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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ỉ với 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:
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,025 USD mỗi (25 USD mỗi 1.000) |
0,020 USD mỗi (20 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ với 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:
Android:
Place.Field.ID
,
Place.Field.NAME
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0 USD trên mỗi (0,00 USD mỗi 1000) |
0 USD trên mỗi (0,00 USD mỗi 1000) |
0 USD trên mỗi (0,00 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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ với 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:
Android:
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
,
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,032 USD mỗi (32 USD mỗi 1.000) |
0,0256 USD mỗi (25,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ với 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:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,035 USD mỗi (35 USD mỗi 1.000) |
0,028 USD mỗi (28,00 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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 Chi tiết địa điểm (Mới), bạn có thể giới hạn phản hồi chỉ với 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:
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,040 USD mỗi (40 USD mỗi 1.000) |
0,032 USD mỗi (32 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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 KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,007 USD mỗi (7,00 USD mỗi 1.000) |
0,0056 USD mỗi (5,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức giá theo số lượng |
Giá của SDK Địa điểm dành cho Android
Giới thiệu về phiên Tự động hoàn thành
Phiên Tự động hoàn thành bao gồm một số yêu cầu Tự động hoàn thành (để truy xuất các đề xuất về một địa điểm 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 đế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à 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 hoạt động mới bằng mã 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 đị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ẽ cần thay đổi mã hiện tại).
- 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 được 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ẽ được tính phí như khi 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 các phiên được tính phí 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: 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 được tính phí bổ sung cho SKU cơ sở đối với yêu cầu kích hoạt SKU dữ liệu. Ví dụ: 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.
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 nội dung phản hồi chỉ ở 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ơ bản 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_OFFSET
hoặcPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinesssStatus
,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 KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
Phí yêu cầu của địa điểm + 0,00 USD |
Phí yêu cầu của địa điểm + 0,00 USD |
Phí yêu cầu của địa điểm + 0,00 USD |
SKU: Dữ liệu 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 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. Bạn sẽ phải trả thêm phí đối với các trường trong danh mục Contact (Liên hệ). 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_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 KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
Phí yêu cầu của địa điểm + 0,003 USD cho mỗi yêu cầu (+ 3 USD/1.000) |
Phí yêu cầu của địa điểm + 0,0024 USD/mỗi yêu cầu (+ 2,40 USD/1.000) |
Liên hệ với bộ phận bán hàng để biết mức giá theo số lượng |
SKU: Dữ liệu về khí quyể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 nội dung phản hồi ở các trường đã chỉ định. Bạn sẽ phải trả thêm phí khi sử dụng các trường trong danh mục Khí quyển. 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.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 Các trường (Thông tin chi tiết về địa điểm)
- Dịch vụ web:
curbside_pickup
,delivery
,dine_in
,editorial_summary
,price_level
,rating
,reservable
,reviews
,serves_beer
,serves_breakfast
,serves_brunch
,serves_dinner
,serves_lunch
,serves_vegetarian_food
,serves_wine
,takeout
hoặcuser_ratings_total
.
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
Phí yêu cầu của địa điểm + 0,005 USD cho mỗi yêu cầu (+ 5 USD/1.000) |
Phí yêu cầu của địa điểm + 0,004 đô la Mỹ cho mỗi yêu cầu (+ 4 USD/1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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í đối với mọi lệnh gọi hoặc yêu cầu trong số nà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 API địa điểm
Các lệnh gọi 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 của phiên hoạt động) cũng sẽ bị tính phí cho tính năng Tự động hoàn thành – theo SKU 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 địa điểm của API Maps JavaScript có thể được tính phí 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ỉ khác nhau hoặc sao chép/dán nhiều địa chỉ vào tiện ích mà 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 KHỐI LƯỢNG HÀNG THÁNG (Giá theo YÊU CẦU) |
||
---|---|---|
0,00283 USD mỗi (2,83 USD mỗi 1.000) |
0,00227 USD trên mỗi (2,27 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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 hoạt động được tính phí cho phiên Tự động hoàn thành không bao gồm yêu cầu Thông tin chi tiết về địa điểm (trong vòng vài phút đầu phiên).
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi PHIÊN HOẠT ĐỘNG) |
||
---|---|---|
0,017 USD trên mỗi (17 USD mỗi 1.000) |
0,0136 USD mỗi (13,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức 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
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ó thông tin chi tiết về địa điểm – Mỗi phiên (giá khởi điểm là 0,017 USD/phiên)
SKU: Tự động hoàn thành (kèm theo 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 hoạt động sẽ được tính phí cho một phiên Tự động hoàn thành bao gồm bất kỳ thông tin nào sau đây:
- Android: một lệnh gọi đến
fetchPlace()
- iOS: một lệnh 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 miễn phí yêu cầu tự động hoàn thành và cuộc gọi đến Thông tin chi tiết về địa điểm tiếp theo sẽ được tính phí theo 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 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 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, 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 một 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 KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi PHIÊN HOẠT ĐỘNG) |
||
---|---|---|
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
FetchPlaceRequest
bao gồm mã địa điểm và trường ADDRESS)
iOS
- placeClient?.findAutofillPredictions(fromQuery: "par" ...
- những nơi ?
- 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 đị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)
- Thông tin chi tiết về địa điểm (place_id, session_token: XYZ, trường:formatted_address)
Trên hoá đơn, bạn sẽ thấy các SKU sau (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 (thanh toán 0 VND)
- Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD mỗi phiên)
- Dữ liệu cơ bản (thanh toán với giá 0 USD)
SKU: Chi tiết địa điểm
Cuộc gọi Thông tin chi tiết về địa điểm được tính phí như sau:
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,017 USD trên mỗi (17 USD mỗi 1.000) |
0,0136 USD mỗi (13,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức giá theo số lượng |
SKU Thông tin chi tiết về đị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 Địa điểm 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ạ ở đây: - Dịch vụ web: Dịch vụ Thông tin chi tiết về địa điểm API Địa điểm
Với API web và 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 NO được chỉ định trong cuộc 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 phải trả 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 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 và chỉ chỉ định trườngADDRESS
- Web API hoặc dịch vụ: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ xác đị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 mỗi phiên)
- Dữ liệu cơ bản (thanh toán với giá 0 USD)
- Thiết bị di động: gọi
- Thực hiện một trong những 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 và chỉ chỉ định trườngPHONE_NUMBER
- Web API hoặc dịch vụ: đưa ra yêu cầu Chi tiết về địa điểm và chỉ định trường số điện thoại:
getPlaceDetails(fields: formatted_phone_number)
- Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD mỗi phiên)
- Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD mỗi yêu cầu)
- Thiết bị di động: gọi
- Thực hiện một trong những 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 và chỉ định tất cả các trường - Web API hoặc dịch vụ: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ định tất cả các trường (loại yêu cầu này là mặc định nếu bạn không chỉ định bất kỳ trường nào):
getPlaceDetails()
.
- Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD mỗi phiên)
- Dữ liệu cơ bản (thanh toán với giá 0 USD)
- Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD mỗi yêu cầu)
- Dữ liệu về Khí quyển (giá từ 0.005 USD cho mỗi yêu cầu)
- Thiết bị di động: gọi
SKU: Tìm địa điểm hiện tại
Tính năng Tìm địa điểm hiện tại tính phí cho các cuộc gọi đến findCurrentPlace()
(Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,030 USD mỗi (30 USD mỗi 1.000) |
0,024 USD mỗi (24,00 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức giá theo số lượng |
Các lệnh gọi đến findCurrentPlace()
(Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) cũng tạo ra 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 lệnh gọi.
Chỉ định các trường dữ liệu để giới hạn nội dung phản hồi chỉ ở những trường đó. Bạn sẽ bị tính phí cho cuộc gọi Tìm địa điểm hiện tại
cũng như dữ liệu được yêu cầu.
Ví dụ
- Bạn gọi
findCurrentPlace()
(Android) hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) và chỉ chỉ định trườngADDRESS
. Trên hoá đơn, bạn sẽ thấy các SKU sau (khi xem hoá đơn theo SKU):- Tìm Địa điểm hiện tại (giá khởi điểm là 0.030 USD mỗi yêu cầu)
- Dữ liệu cơ bản (thanh toán với giá 0 USD)
- Bạn gọi
findCurrentPlace()
(Android) hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) và chỉ định trườngPHONE_NUMBER
. Trên hoá đơn, bạn sẽ thấy các SKU sau (khi xem hoá đơn theo SKU):- Tìm Địa điểm hiện tại (giá khởi điểm là 0.030 USD mỗi yêu cầu)
- Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD mỗi yêu cầu)
- Bạn gọi
findCurrentPlace()
(Android) hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) và chỉ định các trường từ cả ba nhóm loại dữ liệu. Trên hoá đơn, bạn sẽ thấy các SKU sau (khi xem hoá đơn theo SKU):- Tìm Địa điểm hiện tại (giá khởi điểm là 0.030 USD mỗi yêu cầu)
- Dữ liệu cơ bản (thanh toán với giá 0 USD)
- Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD mỗi yêu cầu)
- Dữ liệu về Khí quyển (giá 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í 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ụ Ả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 đối với dịch 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()
không dẫn đến việc tính phí cho đến khi URL thực sự được sử dụng để lấy dữ liệu pixel.
PHẠM VI KHỐI LƯỢNG HÀNG THÁNG (Giá mỗi CUỘC GỌI) |
||
---|---|---|
0,007 USD mỗi (7,00 USD mỗi 1.000) |
0,0056 USD mỗi (5,6 USD mỗi 1.000) |
Liên hệ với bộ phận bán hàng để biết mức giá theo số lượng |
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 phần 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 SDK Địa điểm dành cho Android hoặc để đáp ứng nhu cầu của lưu lượng truy cập thực tế, hãy đặt giới hạn hạn mức hằng ngày đối với tất cả các yêu cầu đối với API bất kỳ. Hạn mức hằng ngày sẽ được đặt lại vào lúc nửa đêm Thái Bình Dương.
Để xem hoặc thay đổi giới hạn hạn mức cho SDK Địa điểm dành cho Android:
- 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 SDK Địa điểm dành cho Android.
- Để xem hạn mức, hãy cuộ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 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 Hạn mức hạn mức, hãy nhập hạn mức có thể thanh toán hằng ngày ưu tiên (tối đa giới hạn 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 hạn mức có thể thanh toán vào một ngày cụ thể bất kỳ, 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 Nền tảng Google Maps để nhận được tín dụng Maps Platform. ↩