API Địa điểm sử dụng mô hình định giá trả tiền theo mức dùng. Các yêu cầu API Địa điểm tạo ra lệnh gọi đến nhiều 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 API Địa điểm. Quản lý chi phí và sử dụng của bạn bằng các công cụ có trong Google Cloud Console.
Cách API Địa điểm được lập hoá đơn
API Địa điểm sử dụng mô hình định giá trả tiền theo mức dùng. API và API Nền tảng Google Maps do SKU thanh toán. Hoạt động sử dụng được theo dõi cho từng SKU và mọi API hoặc SDK có thể có nhiều SKU sản phẩm. Chi phí được tính bằng
Sử dụng Trình tính toán giá và sử dụng để ướ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, khoản tín dụng Google Maps Platform trị giá 200 USD mỗi tháng sẽ được áp dụng cho mỗi tài khoản thanh toán. Tín dụng này tự động áp dụng1 cho các SKU đủ điều kiện.
Đặt 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 điền (để truy xuất đề xuất về một địa điểm khi 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 hoạt động tương tự được chuyển cho yêu cầu Tự động hoàn thành và yêu cầu Chi tiết địa điểm tiếp theo. Một phiên bắt đầu với yêu cầu Tự động điền đầu tiên (thường xảy ra khi người dùng bắt đầu nhập). Lệnh gọi Chi tiết đị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 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 hoạt động mới bằng cách sử dụng mã thông báo phiên mới.
Có thể tạo các 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 bằng API Địa điểm hoặc Dịch vụ Tự động điền địa điểm trong API JavaScript của Maps. 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 thay đổi mã hiện có).
- Tiện ích Tự động điền của API Maps JavaScript. Thanh toán dựa trên phiên đượ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 tốt cho một phiên người dùng và không nên sử dụng cho nhiều phiên người dùng. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được 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.
Yêu cầu Tự động hoàn thành và Yêu cầu chi tiết địa điểm bằng cách sử dụng các phiên được lập hóa đơ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 khí quyển.Một hoặc nhiều SKU dữ liệu được kích hoạt cho:
- Android: mỗi yêu cầu gửi đến
fetchPlace()
hoặcfindCurrentPlace()
- iOS: mỗi lệnh gọi đến
fetchPlaceFromPlaceID:
hoặcfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Dịch vụ web: mỗi yêu cầu Địa điểm tùy thuộc vào các trường được chỉ định trong yêu cầu
SKU dữ liệu luôn tính phí ngoài SKU cơ sở cho yêu cầu kích hoạt những SKU này. 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ẽ bị tính phí trong 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 gọi 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, ngoài ra còn tính phí 3 SKU dữ liệu Địa điểm vào chi 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ể chỉ cung cấp phản hồi cho những trường đã 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 bất kỳ trường nào sau đâ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
,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
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
Chi phí yêu cầu địa điểm + 0,00 USD |
Chi phí yêu cầu địa điểm + 0,00 USD |
Chi phí 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ỉ giới hạn phản hồi cho các trường đó. Các trường trong danh mục Contact (Liên hệ) sẽ bị 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.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
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
Chi phí yêu cầu địa điểm + 0,003 USD mỗi chi phí (+ 3,00 USD mỗi 1000) |
Chi phí yêu cầu địa điểm + 0,0024 USD cho mỗi địa điểm (+ 2,40 USD cho 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 yêu cầu Tìm địa điểm, bạn có thể chỉ giới hạn phản hồi cho những trường được chỉ định. Các trường trong danh mục Khí quyển sẽ tính thêm phí. SKU Khí dữ liệu được kích hoạt khi có yêu cầu về bất kỳ trường nào sau đây:
- 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
.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
Chi phí yêu cầu địa điểm + 0,005 USD cho mỗi yêu cầu (+ 5 USD cho mỗi 1000) |
Chi phí yêu cầu địa điểm + 0,004 USD mỗi chi phí (+ 4 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 – Theo yêu cầu
SKU Tự động hoàn thành – Mỗi yêu cầu sẽ được tính phí cho mọi lệnh gọi hoặ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 điền địa điểm của API JavaScript của Maps
- Dịch vụ web: Dịch vụ tự động điền đị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 sử dụng lại mã thông báo phiên) cũng bị tính phí cho Tự động điền – theo SKU yêu cầu.
Các yêu cầu Tự động điền từ Tiện ích Tự động điền địa điểm trong API JavaScript của Maps có thể được tính phí cho Tự động điền – Theo SKU yêu cầu trong trường hợp 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ệ. Đ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 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 dự đoán tự động hoàn thành.
TẦM KHỐI LƯỢNG HÀNG THÁNG (Giá cho 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 không có thông tin chi tiết về địa điểm – Mỗi phiên hoạt động sẽ bị tính phí cho một phiên Tự động hoàn thành không bao gồm yêu cầu Chi tiết địa điểm (trong vòng vài phút đầu phiên).
TẦM KHỐI LƯỢNG HÀNG THÁNG (Giá cho mỗi PHIÊN BẢN) |
||
---|---|---|
0,017 USD mỗi (17,00 USD mỗi 1000) |
0,0136 USD mỗi (13,60 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 hai lệnh gọi trong một phiên:
Android
- Tìm kiếm tự động hoàn thành() (.setQuery(”par”), .setSessionToken(XYZ))
- Tìm kiếm tự động hoàn thành() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findTự Dự đoán(từTruy vấn: "par" ...
- placesClient?.findTự Dự đoán(từTruy vấn: "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 (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á bắt đầu từ 0,017 USD 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
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ẽ bị 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: lệnh gọi đến
fetchPlaceFromPlaceID:
- Dịch vụ web: yêu cầu Chi tiết đị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 Thông tin chi tiết về địa điểm tiếp theo sẽ bị tính phí dựa trên mức giá chi tiết của Đị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 Khí quyển) – tùy 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 Chi tiết địa điểm, tất cả cá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ỉ chỉ định trường place_id
) trong phiên tự động hoàn tất được lập hóa đơn dưới dạng SKU: Tự động hoàn thành mà không có Chi tiết địa điểm – Mỗi phiên.
TẦM KHỐI LƯỢNG HÀNG THÁNG (Giá cho mỗi PHIÊN BẢN) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
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
- Tìm kiếm tự động hoàn thành() (.setQuery(”par”), .setSessionToken(XYZ))
- Tìm kiếm tự động hoàn thành() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (với
FetchPlaceRequest
bao gồm ID địa điểm và trường ADDRESS)
iOS
- placesClient?.findTự Dự đoán(từTruy vấn: "par" ...
- placesClient?.findTự Dự đoán(từTruy vấn: "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, fields:formatted_address)
Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):
- Tự động hoàn tất (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên (thanh toán là 0 USD)
- Chi tiết địa điểm (giá khởi điểm 0,017 USD mỗi phiên)
- Dữ liệu cơ bản (tính bằng 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 – Mỗi yêu cầu bị tính phí cho mỗi yêu cầu:
- JavaScript:
Dịch vụ tự động điền đị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 được tạo làm loại người dùng). - Dịch vụ web: Dịch vụ Tự động hoàn thành truy vấn API địa điểm
TẦM KHỐI LƯỢNG HÀNG THÁNG (Giá cho 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 |
Giá theo phiên Tự động hoàn thành không được hỗ trợ khi sử dụng Tự động hoàn thành truy vấn. Các cuộc gọi Thông tin chi tiết về địa điểm tiếp theo sẽ bị 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: Chi tiết địa điểm
Cuộc gọi Chi tiết địa điểm được tính phí như sau:
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,017 USD mỗi (17,00 USD mỗi 1000) |
0,0136 USD mỗi (13,60 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 tạo từ những API này:
- Android: SDK Địa điểm dành cho Android
(
fetchPlace()
) - iOS: SDK Địa điểm cho iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
Dịch vụ chi tiết địa điểm của API JavaScript của Maps (
getDetails
) - JavaScript:
Tiện ích tự động điền địa điểm của API Maps JavaScript (
getPlace
) - JavaScript
getPlaces()
- Dịch vụ web: Dịch vụ chi tiết về địa điểm của API Địa điểm
Với API và dịch vụ web, 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.
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 SKU dữ liệu (Cơ bản, 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 hoặc yêu cầu. Nếu các trường KHÔNG được chỉ định trong lệnh gọi hoặc yêu cầu Chi tiết địa điểm, 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 Chi tiết đị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 web hoặc dịch vụ: đưa ra yêu cầu Thông tin chi tiết về đị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 0,017 USD mỗi phiên)
- Dữ liệu cơ bản (tính bằng 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 trườngPHONE_NUMBER
- 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 số điện thoại:
getPlaceDetails(fields: formatted_phone_number)
- Chi tiết địa điểm (giá khởi điểm 0,017 USD mỗi phiên)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD 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ụ: đư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 trường nào):
getPlaceDetails()
.
- Chi tiết địa điểm (giá khởi điểm 0,017 USD mỗi phiên)
- Dữ liệu cơ bản (tính bằng USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD mỗi yêu cầu)
- Dữ liệu về khí quyển (giá bắt đầu từ 0,005 USD mỗi 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 Thông tin chi tiết về địa điểm để làm mới mã địa điểm cũ. Các loại yêu cầu này được cung cấp miễn phí.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
Ví dụ:
Thực hiện yêu cầu Thông tin chi tiết về địa điểm, chỉ xác định trường mã địa điểm:
getPlaceDetails(fields: place_id)
.
Trên hóa đơn, bạn sẽ thấy SKU này (khi
xem hóa đơn theo SKU):
- Chi tiết địa điểm – Làm mới ID (thanh toán là 0,00 USD)
SKU: Tìm địa điểm
Tính năng Tìm địa điểm được tính cho yêu cầu Tìm địa điểm.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,017 USD mỗi (17,00 USD mỗi 1000) |
0,0136 USD mỗi (13,60 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 (Cơ bản, 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. Giống như yêu cầu Thông tin chi tiết về địa điểm, bạn có thể sử dụng tham số trường trong yêu cầu Tìm địa điểm để giới hạn phản hồi chỉ đối với những trường được chỉ định. Bạn sẽ phải trả phí 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 KHÔNG được yêu cầu thì chỉ mã địa điểm được trả về, vì vậy sẽ không phát sinh thêm phí dữ liệu.
Ví dụ
- Bạn tạo yêu cầu Tìm địa điểm và chỉ định trường địa chỉ:
FindPlace(fields: formatted_address)
. Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):- Tìm địa điểm (giá bắt đầu từ 0,017 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (tính bằng 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 (khi xem hóa đơn theo SKU):- Tìm địa điểm (giá bắt đầu từ 0,017 USD mỗi cuộc gọi)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD mỗi 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ả ba bộ chứa loại dữ liệu:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Trên hóa đơn, bạn sẽ thấy các SKU này (khi xem hóa đơn theo SKU):- Tìm địa điểm (giá bắt đầu từ 0,017 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (tính bằng USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD mỗi yêu cầu)
- Dữ liệu về khí quyển (giá bắt đầu từ 0,005 USD mỗi yêu cầu)
SKU: Find Place – chỉ ID
Hệ thống sẽ tính 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ì chỉ có mã địa điểm được trả về.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,00 USD | 0,00 USD | 0,00 USD |
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 (khi
xem hóa đơn theo SKU):
- Tìm địa điểm – chỉ có ID (nhận được hóa đơn 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 đối với
dịch vụ Tìm kiếm lân cận của API JavaScript trên Maps
(nearbySearch()
) hoặc đối với
dịch vụ Tìm kiếm lân cận API Địa điểm
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,032 USD mỗi (32,00 USD mỗi 1000) |
0,0256 USD mỗi (25,60 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ợ việc chỉ định trường nào được trả về. Yêu cầu Tìm kiếm lân cận trả về tập hợ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 mức phí 0, 032 USD cho mỗi yêu cầu, cũng như tất cả SKU loại dữ liệu (Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu khí quyển).
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 (khi
xem hóa đơn theo SKU):
- Địa điểm - Tìm kiếm lân cận (giá khởi điểm 0,032 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (tính bằng USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD mỗi yêu cầu)
- Dữ liệu về khí quyển (giá bắt đầu từ 0,005 USD mỗi 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 văn bản được tính phí cho các yêu cầu đối với
dịch vụ Tìm kiếm văn bản trên địa điểm bằng API JavaScript của Maps
(textSearch()
) hoặc đối với
dịch vụ Tìm kiếm văn bản của API Địa điểm.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,032 USD mỗi (32,00 USD mỗi 1000) |
0,0256 USD mỗi (25,60 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ề danh sách địa điểm, nhưng không hỗ trợ chỉ định trường nào được trả về. Yêu cầu Tìm kiếm văn bản trả về tập hợp con các trường dữ liệu được hỗ trợ. Bạn phải trả phí 0, 032 USD cho mỗi yêu cầu Tìm kiếm văn bản, 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 khí quyển).
Đị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 JavaScript cho Maps: 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
kết quả (biểu tượng: ghim), 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 (khi
xem hóa đơn theo SKU):
- Địa điểm - Tìm kiếm bằng văn bản (giá bắt đầu từ 0,032 USD mỗi cuộc gọi)
- Dữ liệu cơ bản (tính bằng USD)
- Dữ liệu liên hệ (giá khởi điểm 0,003 USD mỗi yêu cầu)
- Dữ liệu về khí quyển (giá bắt đầu từ 0,005 USD mỗi yêu cầu)
SKU: Hình ảnh địa điểm
SKU Địa điểm chụp ảnh bị tính phí cho:
- Android: cuộc gọi tới
fetchPhoto()
- iOS: cuộc gọi tới
loadPlacePhoto:
- JavaScript: tới Thư viện địa điểm, dịch vụ Địa điểm ảnh của API 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 gửi đến dịch vụ Photos Place của Photos
Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl()
không gây ra tình trạng thanh toán cho đến khi URL thực sự được dùng để lấy dữ liệu pixel.
RANGE VOLUME HÀNG THÁNG (Giá mỗi GỌI) |
||
---|---|---|
0,007 USD mỗi (7,00 USD mỗi 1000) |
0,0056 USD mỗi (5,60 USD mỗi 1000) |
Liên hệ với bộ phận bán hàng để biết giá theo số lượng |
Giới hạn 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 giới hạn sử dụng sau đây vẫn được áp dụng khi sử dụng API Địa điểm:
- Giới hạn tốc độ là 6.000 QPM (yêu cầu mỗi phút). 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ả các ứng dụng sử dụng thông tin đăng nhập của cùng một dự án.
Hạn chế Đ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ế 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 của bạn
Để quản lý chi phí sử dụng API địa điểm hoặc đáp ứng nhu cầu về lưu lượng truy cập sản phẩm, 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. 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 trên Google Maps Platform.
- Nhấp vào menu thả xuống API và chọn API địa điểm.
- Để xem các hạn mức, hãy di chuyển xuống thẻ Yêu cầu.
Bảng liệt kê tên và 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 định mức, hãy nhập hạn mức có thể lập hoá đơn hằng ngày mà bạn muốn (tối đa hạn mức là Google nếu có) và chọn Lưu.
Nếu mức sử dụng API đạ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 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 Google Cloud Platform trước khi tạo một tài khoản thanh toán Google Maps Platform để nhận được tín dụng Maps Platform. ↩