API địa điểm sử dụng mô hình thanh toán theo mức chi tiêu. Yêu cầu API địa điểm tạo lệnh gọi đến bất kỳ SKU nào. Cùng với Điều khoản sử dụng tổng thể của Google, có giới hạn sử dụng dành riêng cho API địa điểm. Quản lý chi phí và mức sử dụng bằng các công cụ có sẵn trong Google Cloud Console.
Cách tính phí API Địa điểm
API Địa điểm sử dụng mô hình thanh toán theo mức chi tiêu. Các API và SDK của Nền tảng Google Maps được tính phí theo SKU. Hoạt động sử dụng được theo dõi đối với 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
Sử dụng Công cụ tính giá và 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 Google Maps Platform đủ điều kiện, bạn sẽ nhận được khoản tín dụng 200 đô la Mỹ trên 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 sẽ tự động được áp dụng1 cho các SKU đủ điều kiện.
Định giá cho API địa điểm
Giới thiệu về Phiên tự động hoàn thành
Phiên Tự động hoàn thành bao gồm một số yêu cầu Tự động hoàn thành (để truy xuất đề xuất về một địa điểm khi người dùng nhập loại) và nhiều nhất là một yêu cầu Thông tin chi tiết về địa điểm (để truy xuất thông tin chi tiết về địa điểm do người dùng chọn). Hệ thống sẽ chuyển mã thông báo của phiên hoạt động đó sang yêu cầu Tự động hoàn thành và yêu cầu Chi tiết địa điểm sau đó. Một phiên bắt đầu với yêu cầu Tự động hoàn thành đầu tiên (thường xảy ra khi người dùng bắt đầu nhập). Lệnh gọi Thông tin chi tiết về địa điểm được thực hiện khi người dùng đã chọn một trong các đề xuất Tự động hoàn thành. Nếu người dùng không chọn đề xuất, sẽ không có lệnh gọi Chi tiết địa điểm.
Sau khi người dùng đã chọn một địa điểm (tức là lệnh gọi Thông tin chi tiết về địa điểm được thực hiện), bạn phải bắt đầu một phiên mới bằng cách sử dụng mã thông báo phiên mới.
Phiên tự động hoàn thành có thể được tạo từ các API sau:
- 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 JavaScript 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 cần phải thay đổi mã hiện có).
- Tiện ích Tự động hoàn thành của API Maps JavaScript. Hệ thống sẽ tự động bật tính năng thanh toán dựa trên phiên hoạt động trên những tiện ích đó mà bạn không cần phải thay đổi mã.
Mã thông báo phiên hoạt động tốt cho một phiên hoạt động của người dùng và không được dùng cho nhiều phiên hoạt động của người dùng. Nếu bạn sử dụng lại một mã thông báo phiên, phiên đó sẽ bị coi là không hợp lệ và các yêu cầu sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp.
Các yêu cầu Tự động hoàn thành và yêu cầu Thông tin chi tiết về địa điểm sử dụng các phiên được thanh toán trên các SKU khác nhau.
Giới thiệu về SKU Dữ liệu địa điểm
Ba SKU dữ liệu địa điểm là: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu bầu không khí.Một hoặc nhiều SKU dữ liệu được kích hoạt cho:
- Android: từng yêu cầu đến
fetchPlace()
hoặcfindCurrentPlace()
- iOS: mỗi cuộc gọi đến
fetchPlaceFromPlaceID:
hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Dịch vụ web: mỗi 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 bị tính phí ngoài SKU cơ sở cho yêu cầu kích hoạt chúng. 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ẽ bị 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 API Địa điểm này sẽ hỗ trợ KHÔNG 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 trên Địa điểm, ngoài ra còn tính phí 3 SKU dữ liệu địa điểm vào lần tính 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 yêu cầu Tìm địa điểm, bạn có thể giới hạn phản hồi chỉ cho những trường được chỉ định. Các trường trong danh mục Cơ bản được đưa vào chi phí cơ bản của yêu cầu Địa điểm và không dẫn đến bất kỳ khoản phí bổ sung nào. SKU Dữ liệu cơ bản được kích hoạt khi có yêu cầu về bất kỳ trường nào trong số các trường này:
-
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
hoặcPlace.Field.UTC_OFFSET
-
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 TẬP TRƯỞNG THÁNG (Giá mỗi cuộc gọi) |
||
---|---|---|
Chi phí khi yêu cầu địa điểm + 0,00 USD |
Chi phí khi yêu cầu địa điểm + 0,00 USD |
Chi phí khi yêu cầu địa điểm + 0,00 USD |
SKU: Dữ liệu liên hệ
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 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ể chỉ cho phép phản hồi các trường đó. Các trường trong danh mục Liên hệ
có tính thêm phí. SKU Dữ liệu liên hệ được kích hoạt khi có yêu cầu bất kỳ trường nào sau đây:
-
Android:
Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
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 TẬP TRƯỞNG THÁNG (Giá mỗi cuộc gọi) |
||
---|---|---|
Chi phí khi yêu cầu địa điểm + 0,003 USD cho mỗi lần (+ 3,00 USD cho mỗi 1000) |
Chi phí cho yêu cầu địa điểm + 0,0024 USD cho mỗi yêu cầu (+ 2,40 USD cho mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Dữ liệu 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 yêu cầu Tìm địa điểm, bạn có thể chỉ giới hạn nội dung phản hồi cho những trường được chỉ định đó. Các trường trong danh mục Bầu không khí có tính thêm phí. SKU Data Data được kích hoạt khi có yêu cầu bất kỳ trường nào sau đây:
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,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 (Chi tiết đị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 TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
Chi phí cho yêu cầu địa điểm + 0,005 USD cho mỗi địa điểm (+ 5 USD cho mỗi 1000) |
Chi phí cho yêu cầu địa điểm + 0,004 USD cho mỗi địa điểm (+ 4,00 USD cho mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tự động hoàn thành – Mỗi yêu cầu
SKU Tự động hoàn thành – Mỗi yêu cầu là tính phí cho bất kỳ lệnh gọi hay yêu cầu nào trong số này mà không chứa 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
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ụ: phiên hoạt động sử dụng lại mã thông báo phiên) cũng bị tính phí theo SKU tự động hoàn thành – Theo 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 JavaScript có thể được tính phí SKU tự động hoàn thành – 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 đang 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 một cụm từ gợi ý tự động hoàn thành.
PHẠM VI TUỔI HÀNG THÁNG (Giá cho mỗi YÊU CẦU) |
||
---|---|---|
0,00283 USD cho mỗi (2,83 USD cho mỗi 1000) |
0,00227 USD cho mỗi (2,27 USD cho mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU: Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Mỗi phiên
SKU Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Mỗi phiên được tính phí cho một Phiên tự động hoàn thành không bao gồm yêu cầu Thông tin chi tiết về địa điểm (trong vòng vài phút đầu phiên).
PHẠM VI TỐI ĐA THÁNG (Giá tính theo SESSION) |
||
---|---|---|
0,017 USD/mỗi (17,00 USD/1000) |
0,0136 USD/mỗi (13,60 USD/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 đưa ra hai lệnh gọi này trong một phiên:
Android
- find Cụm Dự đoán() (.setQuery(”par”), .setSessionToken(XYZ))
- findTự dự đoán() (.setQuery(”Paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findTự động dự đoán(fromQuery: "par" ...
- placesClient?.findTự dự đoán(fromQuery: "Paris" ...
Dịch vụ web
- Yêu cầu tự động hoàn thành địa điểm (input=”par”, session_token: XYZ)
- Yêu cầu tự động hoàn thành địa điểm (input=”Paris”, session_token: XYZ)
Trên hóa đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hóa đơ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 từ 0,017 USD/phiên)
SKU: Tự động hoàn thành (bao gồm 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:
- Android: cuộc gọi đến
fetchPlace()
- iOS: cuộc gọi đến
fetchPlaceFromPlaceID:
- Dịch vụ web: yêu cầu Thông tin chi tiết về địa điểm
Yêu cầu tự động hoàn thành được cung cấp miễn phí và cuộc gọi về Thông tin chi tiết về địa điểm tiếp theo sẽ được tính phí dựa trên mức giá của thông tin chi tiết về địa điểm thông thường.
Yêu cầu Thông tin chi tiết về địa điểm sẽ tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Bối cảnh) – 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à Khí quyển).
Yêu cầu làm mới ID chi tiết địa điểm (yêu cầu chỉ xác định trường place_id
) trong phiên tự động hoàn thành được lập hóa đơ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 TỐI ĐA THÁNG (Giá tính theo SESSION) |
||
---|---|---|
0 VND | 0 VND | 0 VND |
Ví dụ:
Nếu ứng dụng của bạn thực hiện ba lệnh gọi sau trong một phiên:
Android
- find Cụm Dự đoán() (.setQuery(”par”), .setSessionToken(XYZ))
- findTự dự đoán() (.setQuery(”Paris”), .setSessionToken(XYZ))
- fetchPlace() (với
FetchPlaceRequest
bao gồm Mã địa điểm và trường ADDRESS)
iOS
- placesClient?.findTự động dự đoán(fromQuery: "par" ...
- placesClient?.findTự dự đoán(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 đị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, field:formatted_address)
Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):
- Tự động hoàn thành (bao gồm Thông tin chi tiết về địa điểm) – Mỗi phiên (được tính phí 0 USD)
- Thông tin chi tiết về địa điểm (giá khởi điểm từ 0,017 USD/phiên)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
SKU: Tự động hoàn thành truy vấn – Mỗi yêu cầu
SKU Tự động hoàn thành truy vấn – Mỗi yêu cầu là tính phí cho mỗi yêu cầu để:
- JavaScript: Dịch vụ tự động hoàn thành 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 dưới dạng người dùng). - Dịch vụ web: Dịch vụ tự động hoàn thành truy vấn API địa điểm
PHẠM VI TUỔI HÀNG THÁNG (Giá cho mỗi YÊU CẦU) |
||
---|---|---|
0,00283 USD cho mỗi (2,83 USD cho mỗi 1000) |
0,00227 USD cho mỗi (2,27 USD cho mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Tính năng Tự động hoàn thành truy vấn không hỗ trợ tính năng đặt giá theo phiên Tự động hoàn thành. Các lệnh gọi Chi tiết địa điểm tiếp theo sẽ bị tính phí dựa trên mức giá của 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
Cuộc gọi về thông tin chi tiết về địa điểm được tính phí như sau:
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,017 USD/mỗi (17,00 USD/1000) |
0,0136 USD/mỗi (13,60 USD/1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
SKU Thông tin chi tiết về địa điểm được tạo từ các API sau:
- Android: Địa điểm SDK cho Android
(
fetchPlace()
) - iOS: Địa điểm SDK cho iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
Dịch vụ Chi tiết về địa điểm của API JavaScript JavaScript (
getDetails
) - JavaScript:
Tiện ích Tự động hoàn thành của API Maps JavaScript (
getPlace
) - .
- Dịch vụ web: Dịch vụ Chi tiết về Địa điểm API Địa điểm
Với API web và dịch vụ, SKU chi tiết địa điểm được tính phí cho dù mã thông báo phiên có được cung cấp 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 SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Môi trường), 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 các 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 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 chỉ trườngADDRESS
- API web hoặc dịch vụ: đưa ra yêu cầu Thông tin chi tiết về địa điểm và chỉ định trường địa chỉ:
getPlaceDetails(fields: formatted_address)
- Thông tin chi tiết về địa điểm (giá khởi điểm từ 0,017 USD/phiên)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
- 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ỉ định chỉ trườngPHONE_NUMBER
- Dịch vụ hoặc API web: thực hiện yêu cầu Thông tin chi tiết về địa điểm và chỉ định trường số điện thoại:
getPlaceDetails(fields: formatted_phone_number)
- Thông tin chi tiết về đị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 0,003 USD cho mỗi yêu cầu)
- 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ỉ định tất cả các trường - API Web hoặc dịch vụ: tạo 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á khởi điểm từ 0,017 USD/phiên)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD cho mỗi yêu cầu)
- Dữ liệu về bầu không khí (giá từ 0,005 USD/yêu cầu)
- Thiết bị di động: gọi
SKU: Chi tiết địa điểm – Làm mới ID
Sử dụng yêu cầu Chi tiết địa điểm để làm mới mã địa điểm cũ. Các loại yêu cầu này là miễn phí.
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0 VND | 0 VND | 0 VND |
Ví dụ:
Tạo một yêu cầu Thông tin chi tiết về địa điểm để chỉ định riêng trường mã địa điểm:
getPlaceDetails(fields: place_id)
.
Trên hóa đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hóa đơn 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
Dịch vụ Tìm địa điểm được tính phí cho yêu cầu Tìm địa điểm.
PHẠM VI TẬP TRƯỞNG THÁNG (Giá mỗi cuộc gọi) |
||
---|---|---|
0,017 USD/mỗi (17,00 USD/1000) |
0,0136 USD/mỗi (13,60 USD/1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Yêu cầu Tìm địa điểm cũng tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Bối cảnh), tuỳ thuộc vào các trường được chỉ định trong yêu cầu. Giống như yêu cầu Thông tin chi tiết về địa điểm, bạn có thể sử dụng tham số trường trong yêu cầu Tìm địa điểm để chỉ giới hạn phản hồi cho các trường đó. Bạn sẽ bị tính phí cho yêu cầu Tìm địa điểm và dữ liệu đã yêu cầu. Theo mặc định, nếu yêu cầu KHÔNG có trường, thì hệ thống sẽ chỉ trả về mã địa điểm, do đó, 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ỉ định trường địa chỉ:
FindPlace(fields: formatted_address)
. Trên hoá đơn, bạn sẽ thấy các SKU sau (khi xem hoá đơn theo SKU):- Tìm địa điểm (giá khởi điểm 0,017 USD cho mỗi cuộc gọi)
- Dữ liệu cơ bản (bị tính phí 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 hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):- Tìm địa điểm (giá khởi điểm 0,017 USD cho mỗi cuộc gọi)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD cho mỗi yêu cầu)
- Bạn đưa ra một yêu cầu Tìm địa điểm và chỉ định các trường trong cả 3 nhóm loại dữ liệu:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Trên 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 0,017 USD cho mỗi cuộc gọi)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD cho mỗi yêu cầu)
- Dữ liệu về bầu không khí (giá 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ả lại. 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ỉ mã địa điểm được trả về.
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi 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 hóa đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hóa đơn theo SKU):
- Tìm địa điểm – chỉ có mã nhận dạng (bị tính phí 0,00 USD)
SKU: Địa điểm – Tìm kiếm lân cận
Địa điểm – Tìm kiếm lân cận bị tính phí cho các yêu cầu đối với
dịch vụ Tìm kiếm lân cận của API JavaScript cho Maps (nearbySearch()
) hoặc
Dịch vụ tìm kiếm lân cận API Địa điểm
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,032 USD/mỗi (32,00 USD/1000) |
0,0256 USD/mỗi (25,60 USD/1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Các yêu cầu Tìm kiếm lân cận trả về danh sách các địa điểm, nhưng không hỗ trợ 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 của 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 yêu cầu, cũng như tất cả các SKU thuộc 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 hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):
- Địa điểm – Tìm kiếm lân cận (giá khởi điểm từ 0,032 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD cho mỗi yêu cầu)
- Dữ liệu về bầu không khí (giá từ 0,005 USD/yêu cầu)
SKU: Địa điểm – Tìm kiếm bằng văn bản
Place – Tìm kiếm văn bản được tính phí cho các yêu cầu đến dịch vụ Tìm kiếm văn bản trong địa điểm của API JavaScript (textSearch()
) hoặc đến dịch vụ Tìm kiếm văn bản API địa điểm.
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,032 USD/mỗi (32,00 USD/1000) |
0,0256 USD/mỗi (25,60 USD/1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Yêu cầu Tìm kiếm văn bản trả về danh sách các địa điểm nhưng không hỗ trợ chỉ định trường nào được trả về. Yêu cầu Tìm kiếm văn bản trả về một tập hợp con của các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho yêu cầu Tìm kiếm văn bản bắt đầu từ 0, 032 USD cho mỗi yêu cầu, cũng như tất cả các SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu bầu không khí).
Địa điểm – SKU tìm kiếm văn bản cũng được tạo bằng tiện ích Place SearchBox của API Maps JavaScript: phương thức getPlaces()
sau khi người dùng chọn truy vấn địa điểm (biểu tượng: kính lúp), không phải kết quả (biểu tượng: pin), như được minh họa ở đây:

Ví dụ:
Bạn đưa ra yêu cầu Tìm kiếm văn bản, chẳng hạn như TextSearch(123 Main Street)
. Trên hóa đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hóa đơn theo SKU):
- Địa điểm – Tìm kiếm bằng văn bản (giá khởi điểm từ 0,032 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (bị tính phí 0,00 USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD cho mỗi yêu cầu)
- Dữ liệu về bầu không khí (giá từ 0,005 USD/yêu cầu)
SKU: Ảnh địa điểm
SKU Place Photo được tính phí cho:
- Android: gọi đến
fetchPhoto()
- iOS: lệnh gọi đến
loadPlacePhoto:
- JavaScript: đến Thư viện địa điểm, dịch vụ Photos Place API của API Maps khi yêu cầu dữ liệu từ các URL do
PlacePhoto.getUrl()
trả về để tải dữ liệu pixel hình ảnh - Dịch vụ web: các yêu cầu đến dịch vụ Photos Place API (API Địa điểm)
Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl()
sẽ không gây ra thanh toán cho đến khi URL thực sự được dùng để lấy dữ liệu pixel.
PHẠM VI TẬP TRƯNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,007 USD/mỗi (7,00 USD/1000) |
0,0056 USD/mỗi (5,60 USD/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 hạn mức sử dụng sau đây vẫn áp dụng khi sử dụng API địa điểm:
- Giới hạn tốc độ là 100 yêu cầu mỗi giây. Nó được tính bằng tổng số yêu cầu phía máy khách và phía máy chủ cho tất cả ứng dụng sử dụng thông tin đăng nhập của cùng một dự án.
Hạn chế về Đ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 về API Địa điểm và mục Hạn chế cấp phép trong Điều khoản dịch vụ của Nền tảng Google Maps.
Quản lý chi phí sử dụng
Để quản lý chi phí sử dụng API Nền tảng Google Maps, hãy đặt hạn mức hằng ngày cho tất cả các yêu cầu đối với mọi API có thể lập hoá đơn. Hạn mức hằng ngày được đặt lại vào lúc nửa đêm theo giờ Thái Bình Dương.
Để xem hoặc thay đổi giới hạn hạn ngạch cho API địa điểm:
- Trong Cloud Console, hãy mở trang Hạn mức của Nền tảng Google Maps.
- Nhấp vào trình đơn thả xuống API và chọn API địa điểm.
- Để xem các hạn mức về hạn mức, hãy di chuyển xuống thẻ Requests (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 Giới hạn hạn mức, hãy nhập hạn mức thanh toán hằng ngày có thể lập hóa đơn ưu tiê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 hạn mức có thể thanh toán vào một ngày bất kỳ, thì ứng dụng 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 một tài khoản thanh toán trên Google Cloud Platform trước khi tạo tài khoản thanh toán trên Google Maps Platform để nhận được tín dụng Maps Platform. ↩