SDK Địa điểm dành cho việc sử dụng và thanh toán trên iOS

Lỗi: kGMSPlacesRateLimitExceeded

SDK Địa điểm dành cho iOS sử dụng mô hình định giá trả tiền theo mức dùng. Các yêu cầu của SDK Địa điểm dành cho iOS đối với API Địa điểm được tính phí theo SKU. Ngoài Điều khoản sử dụng chung của Google, còn có các giới hạn sử dụng dành riêng cho SDK Địa điểm dành cho iOS. 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 thanh toán cho SDK Địa điểm dành cho iOS

SDK Địa điểm dành cho iOS (Mới) và SDK Địa điểm dành cho iOS sử dụng mô hình định giá trả phí theo mức sử dụng. API và SDK của Nền tảng Google Maps được tính phí theo SKU. Việc sử dụng được theo dõi cho từng SKU và bất kỳ API hoặc SDK nào cũng có thể có nhiều SKU SKU sản phẩm. Chi phí được tính bằng công thức sau:
Mức sử dụng SKU × Giá mỗi lượt sử dụng

Sử dụng Định giá và Công cụ tính mức sử dụng để ước tính chi phí sử dụng cho mỗi API hoặc SDK. Để đủ điều kiện Các SKU của Nền tảng Google Maps, tín dụng Google Maps Platform trị giá 200 USD mỗi tháng cho từng tài khoản thanh toán. Khoản tín dụng này được cấp tự động được áp dụng cho các SKU đủ điều kiện.

Định giá SDK Địa điểm dành cho iOS (Mới)

Giới thiệu về mặt nạ trường

Sử dụng mặt nạ trường (còn được 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ẽ đượ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 bạn chọn các trường trong cả phần (Cơ bản) SKU và SKU (Nâng cao), bạn sẽ được tính phí dựa trên SKU (Nâng cao).

Sử dụng mặt nạ trường là một phương pháp thiết kế hiệu quả để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và thanh toán không cần thiết các khoản phí.

Giới thiệu về phiên Tự động hoàn thành (Mới)

Phiên Tự động hoàn thành (Mới) bao gồm một hoặc nhiều yêu cầu Tự động hoàn thành (Mới) và một yêu cầu Yêu cầu Chi tiết địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ. Mã thông báo phiên tương tự được chuyển đến yêu cầu Tự động hoàn thành (Mới) và đến yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ tiếp theo.

Một phiên bắt đầu bằng yêu cầu Tự động hoàn thành đầu tiên (Mới). Sau đó, yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ sẽ được thực hiện khi người dùng đã chọn một trong các đề xuất Tự động hoàn thành (Mới). Nếu một phiên hoạt động bị huỷ, nghĩa là không có yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc Yêu cầu xác thực địa chỉ được thực hiện, các yêu cầu Tự động hoàn thành (Mới) sẽ bị tính phí như thể không có mã thông báo phiên đã được cung cấp.

Sau khi người dùng đã chọn một địa điểm (nghĩa là yêu cầu Chi tiết địa điểm (Mới) hoặc Xác thực địa chỉ chưa thực hiện yêu cầu nào), thì 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.

Mã thông báo phiên chỉ có hiệu lực trong một phiên và bạn không thể dùng mã này cho nhiều phiên phiên hoạt động. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được coi là không hợp lệ và 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.

SKU: Yêu cầu tự động hoàn thành

SKU Yêu cầu tự động hoàn thành sẽ bị tính phí cho mỗi yêu cầu gửi đến API Tự động hoàn thành (Mới) không bao gồm mã thông báo phiên.

Phí cũng sẽ được tính nếu bạn sử dụng mã thông báo phiên và:

  • Chấm dứt các phiên bằng một yêu cầu duy nhất đối với Chi tiết địa điểm (Mới) yêu cầu bất kỳ trường nào được xác định bởi SKU: Chi tiết địa điểm (Chỉ vị trí).
    • Tối đa 12 yêu cầu Tự động hoàn thành (Mới) sẽ được lập hoá đơn bằng SKU: Yêu cầu tự động hoàn thành.
    • Mỗi yêu cầu Tự động hoàn thành (Mới) tiếp theo sẽ được lập hoá đơn bằng SKU: Tự động hoàn thành việc sử dụng phiên.
  • Bỏ qua hoặc kết thúc phiên bằng cách gọi đến SKU: Thông tin chi tiết về địa điểm (chỉ mã nhận dạng). Sau đó, tất cả yêu cầu Tự động hoàn thành (Mới) sẽ được lập hoá đơn bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,00283 USD cho mỗi
(2,83 USD cho 1.000
)		 0,00227 USD mỗi
(2,27 USD mỗi 1000)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tự động hoàn thành sử dụng phiên

SKU Sử dụng phiên tự động hoàn thành được tính phí cho mỗi yêu cầu gửi đến API Tự động hoàn thành (Mới) bao gồm mã thông báo phiên.

SKU này sẽ được tính phí trong các trường hợp sau:

  • Phiên tự động hoàn thành bị chấm dứt bằng lệnh gọi đến SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí):

    • Tối đa 12 yêu cầu Tự động hoàn thành (Mới) sẽ được lập hoá đơn bằng SKU: Yêu cầu tự động hoàn thành.
    • Mỗi yêu cầu Tự động hoàn thành (Mới) tiếp theo sẽ được tính phí bằng cách sử dụng SKU: Mức sử dụng phiên Tự động hoàn thành.

  • Phiên tự động hoàn thành đã kết thúc bằng lệnh gọi đến SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên).

    Lệnh gọi Thông tin chi tiết về địa điểm yêu cầu bất kỳ trường nào trong SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên) được thanh toán ở SKU: Thông tin chi tiết về địa điểm (Ưu tiên).

  • Phiên tự động hoàn thành đã kết thúc bằng lệnh gọi tới SKU: Xác thực địa chỉ Nên dùng.

Để biết thêm thông tin, hãy xem Tự động hoàn thành (Mới) và định giá cho phiên hoạt động.

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
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ỉ dành cho 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 Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName! GMSPlacePropertyPhotos

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
0 USD cho mỗi
(0 USD cho 1.000
)		 0 USD cho mỗi
(0 USD cho 1.000
)		 0 USD cho mỗi
(0 USD cho 1.000
)

SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí)

Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyFormattedAddress! GMSPlacePropertyCoordinate, GMSPlacePropertyPlusCode! GMSPlacePropertyTypes, GMSPlacePropertyViewport

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,005 USD mỗi
(5 USD mỗi 1000)		 0,004 USD mỗi
(4 USD mỗi 1000)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Thông tin chi tiết về địa điểm (Cơ bản)

Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyBusinessStatus, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyWheelchairAccessibleEntrance

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
0,0170 USD cho mỗi
(17,00 USD cho 1.000
)		 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 Thông tin chi tiết về địa điểm (Mới), bạn có thể giới hạn chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours! GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel! GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,020 USD mỗi
(20 USD mỗi 1000)		 0,016 USD cho mỗi
(16 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Thông tin chi tiết về địa điểm (Ưu tiên)

Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Thông tin chi tiết về địa điểm (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã chỉ định. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
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)

Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm lân cận (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus! GMSPlacePropertyCoordinate, GMSPlacePropertyFormattedAddress! GMSPlacePropertyName, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyPhotos, GMSPlacePropertyPlaceID, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
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)

Bằng cách sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm lân cận (Mới), bạn có thể chỉ giới hạn phản hồi ở những trường đã chỉ định. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours! GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel! GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,035 USD cho mỗi
(35 USD cho 1.000
)		 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) của mình, bạn có thể hạn chế chỉ phản hồi cho các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
0,040 USD cho mỗi
(40,00 USD cho 1.000
)		 0,032 USD cho mỗi
(32 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tìm kiếm bằng văn bản (chỉ mã nhận dạng)

Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể hạn chế chỉ phản hồi cho các trường được chỉ định. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0 USD cho mỗi
(0 USD cho 1.000
)		 0 USD cho mỗi
(0 USD cho 1.000
)		 0 USD mỗi
(0 USD mỗi 1000)

SKU: Tìm kiếm văn bản (Cơ bản)

Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể hạn chế chỉ phản hồi cho các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus! GMSPlacePropertyFormattedAddress, GMSPlacePropertyIconBackgroundColor! GMSPlacePropertyIconImageURL, GMSPlacePropertyCoordinate, GMSPlacePropertyPhotos, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,032 USD mỗi
(32 USD mỗi 1000)		 0,0256 USD cho mỗi
(25,6 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tìm kiếm văn bản (Nâng cao)

Khi sử dụng mặt nạ trường hoặc danh sách trường trong yêu cầu Tìm kiếm văn bản (Mới), bạn có thể hạn chế chỉ phản hồi cho các trường được chỉ định. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours! GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel! GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,035 USD cho mỗi
(35 USD cho 1.000
)		 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 bằng 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 đó. Chiến dịch này SKU được kích hoạt khi bạn chỉ yêu cầu các trường sau:

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
0,040 USD cho mỗi
(40,00 USD cho 1.000
)		 0,032 USD cho mỗi
(32 USD cho 1.000
)		 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–100.000 100.001–500.000 Hơn 500.000
0,007 USD cho mỗi
(7 USD cho 1.000
)		 0,0056 USD mỗi
(5,6 USD mỗi 1000)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Mức giá của SDK Địa điểm dành cho iOS

Giới thiệu về phiên Tự động hoàn thành

Phiên Tự động hoàn thành bao gồm một số yêu cầu Tự động hoàn thành (để truy xuất các đề xuất trên đặt khi người dùng nhập) và tối đa một yêu cầu Chi tiết địa điểm (để truy xuất thông tin chi tiết về địa điểm do người dùng chọn). Mã thông báo phiên đó 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 hoạt động bắt đầu bằng yêu cầu Tự động hoàn thành đầu tiên (tức là 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, không có cuộc gọi nào về Thông tin chi tiết về địa điểm được thực hiện.

Sau khi người dùng đã chọn một địa điểm (tức là một cuộc gọi Chi tiết địa điểm được thực hiện), bạn phải bắt đầu một cuộc gọi mới bằng cách sử dụng mã thông báo phiên mới.

Phiên tự động hoàn thành có thể được tạo qua các API sau:

Mã thông báo phiên chỉ dùng được cho một phiên người dùng và không được dùng cho nhiều 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à 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 phiên sẽ được tính phí theo các SKU khác nhau.

Giới thiệu về SKU dữ liệu về địa điểm

Ba SKU Dữ liệu địa điểm là: Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu môi trường xung quanh.

Một hoặc nhiều SKU Dữ liệu được kích hoạt cho:

  • Android: từng yêu cầu đến fetchPlace() hoặc findCurrentPlace()
  • iOS: mỗi lệnh gọi đến fetchPlaceFromPlaceID: hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Dịch vụ web: mỗi yêu cầu Places tuỳ thuộc vào các trường được chỉ định trong yêu cầu

Các SKU dữ liệu luôn được tính phí ngoài SKU cơ sở cho việc kích hoạt yêu cầu chúng. Ví dụ: yêu cầu Chi tiết địa điểm bao gồm các trường Dữ liệu cơ bản sẽ được tính phí theo SKU dữ liệu cơ bản và SKU Thông tin chi tiết về địa điểm.

SKU: Dữ liệu cơ bản

Bằng cách sử dụng tham số trường trong yêu cầu Thông tin chi tiết về địa điểm hoặc Tìm địa điểm, bạn có thể giới hạn phản hồi chỉ ở những trường được chỉ định đó. Các trường trong danh mục Cơ bản được tính trong chi phí cơ bản của yêu cầu về Địa điểm và không tính thêm phí. SKU Dữ liệu cơ bản được kích hoạt khi có yêu cầu về bất kỳ trường nào sau đây:

  • Android: Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT hoặc Place.Field.UTC_OFFSET.
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes hoặc GMSPlaceFieldViewport
  • 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ặc wheelchair_accessible_entrance
PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
Chi phí yêu cầu về địa điểm
+ 0,00 USD		 Chi phí yêu cầu liên quan đến địa điểm
+ 00000.00 VND		 Chi phí yêu cầu về địa điểm
+ 0,00 USD

SKU: Dữ liệu liên hệ

Dùng tham số trường trong phần Thông tin chi tiết về địa điểm hoặc yêu cầu Tìm địa điểm cho các dịch vụ web, hoặc một mảng Place.Field cho Android hoặc iOS, bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. Các trường trong danh mục Người liên hệ sẽ tính thêm phí. SKU Dữ liệu liên hệ đã được kích hoạt khi có bất kỳ trường nào trong số này được yêu cầu:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS hoặc Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber hoặc GMSPlaceFieldWebsite
  • Dịch vụ web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours hoặc website
DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
Phí yêu cầu về địa điểm
+ 0,003 USD/yêu cầu
(+ 3 USD/1.000 yêu cầu)		 Chi phí yêu cầu về địa điểm
+ 0,0024 USD/yêu cầu
(+ 2,40 USD/1.000 yêu cầu)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Dữ liệu về bầu không khí

Bằng cách sử dụng thông số trường trong yêu cầu Chi tiết địa điểm hoặc Tìm địa điểm, bạn có thể giới hạn phản hồi chỉ ở các trường được chỉ định. Các trường trong Khí quyển thì sẽ bị tính thêm phí. SKU Dữ liệu khí quyển đượ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ặc Place.Field.USER_RATING_COUNT
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch hoặc GMSPlaceFieldServesVegetarianFood.
  • 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ặc user_ratings_total.
PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
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 sẽ bị 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:

Các lệnh gọi được thực hiện từ một phiên Tự động hoàn thành không hợp lệ (ví dụ: một phiên sử dụng lại mã thông báo phiên) cũng sẽ bị tính phí SKU Tự động hoàn thành – Theo yêu cầu.

Tự động hoàn thành các yêu cầu từ API JavaScript của Maps Tiện ích Tự động hoàn thành địa điểm có thể bị tính phí cho một tính năng Tự động hoàn thành – Theo SKU yêu cầu trong trường hợp có cuộc gọi được thực hiện từ một phiên Tự động hoàn thành không hợp lệ. Điều này có thể xảy ra khi người dùng đang nhập nhiều địa chỉ khác nhau hoặc sao chép/dán nhiều địa chỉ vào tiện ích và không phải lúc nào cũng chọn một cụm từ gợi ý tự động hoàn thành.

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi YÊU CẦU)
0 – 100.000 100.001–500.000 Hơn 500.000
0,00283 USD cho mỗi
(2,83 USD cho 1.000
)		 0,00227 USD mỗi
(2,27 USD mỗi 1000)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Mỗi phiên

SKU Tự động hoàn thành không có Thông tin chi tiết về địa điểm – Mỗi phiên được tính phí cho một Phiên tự động hoàn thành mà không bao gồm yêu cầu Chi tiết địa điểm (trong vòng vài phút kể từ khi bắt đầu phiên hoạt động).

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi PHỤ KIỆN)
0–100.000 100.001–500.000 Hơn 500.000
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

iOS

Dịch vụ web

Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hoá đơn theo SKU):

  • Tự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Theo phiên (giá bắt đầu từ 0,017 USD/phiên)

SKU: Tự động hoàn thành (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên

Tính năng Tự động hoàn thành (đi kèm với Thông tin chi tiết về địa điểm) – Mỗi phiên SKU được tính phí cho một phiên Tự động hoàn thành bao gồm bất kỳ điều kiện nào trong số:

  • Android: lệnh gọi đến fetchPlace()
  • iOS: lệnh 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 thông tin chi tiết về địa điểm tiếp theo sẽ được tính phí theo thông thường Giá Thông tin về địa điểm.

Yêu cầu Thông tin chi tiết về địa điểm sẽ tạo các SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Bầu không khí) – tuỳ thuộc vào các trường được chỉ định trong yêu cầu.

Nếu bạn không chỉ định các trường trong yêu cầu Thông tin chi tiết về địa điểm, thì tất cả SKU dữ liệu sẽ được kích hoạt (Cơ bản, Thông tin liên hệ và Không gian).

Yêu cầu làm mới mã thông tin chi tiết về địa điểm (yêu cầu chỉ chỉ định trường place_id) trong phiên tự động hoàn thành sẽ được lập hoá đơn dưới dạng SKU: Tự động hoàn thành không có Thông tin chi tiết về địa điểm – Mỗi phiên.

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi PHỤ KIỆN)
0–100.000 100.001–500.000 Hơn 500.000
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

iOS

Dịch vụ web

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ính năng tự động hoàn thành (bao gồm cả Thông tin chi tiết về địa điểm) – Theo phiên (được tính phí 0 USD)
  • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
  • Dữ liệu cơ bản (phí 0 VND)

SKU: Thông tin chi tiết về địa điểm

Các lệnh gọi Place Details sẽ được tính phí như sau:

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
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 Thông tin chi tiết về địa điểm được tạo từ các API sau:

Với API web và các dịch vụ, SKU Thông tin chi tiết về địa điểm sẽ bị tính phí cho dù bạn có cung cấp mã thông báo phiên hay không.

Cuộc gọi hoặc yêu cầu Thông tin chi tiết về địa điểm cũng tạo ra các SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Bầu không khí), tuỳ thuộc vào trên các trường được chỉ định trong lệnh gọi hoặc yêu cầu. Nếu trường NO được chỉ định trong cuộc gọi hoặc yêu cầu Chi tiết địa điểm, TẤT CẢ SKU dữ liệu được kích hoạt và bạn sẽ bị tính phí cho cuộc gọi hoặc yêu cầu Chi tiết về địa điểm cộng với chi phí của tất cả dữ liệu.

Ví dụ

  1. 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ặc fetchPlaceFromPlaceID: trên iOS và chỉ định trường ADDRESS
    • 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)
    Trên hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
    • Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
  2. 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ặc fetchPlaceFromPlaceID: trên iOS và chỉ định trường PHONE_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)
    Trên hoá đơn, bạn sẽ thấy các SKU sau đây (khi xem hoá đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu 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)
  3. 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ặc fetchPlaceFromPlaceID: trên iOS và chỉ định tất cả các trường
    • API hoặc dịch vụ web: đưa ra yêu cầu Chi tiết địa điểm và chỉ định tất cả các trường (loại yêu cầu là mặc định nếu bạn không chỉ định bất kỳ trường nào): getPlaceDetails().
    Trên hoá đơn, bạn sẽ thấy các SKU sau đây (khi xem hoá đơn theo SKU):
    • Thông tin chi tiết về địa điểm (giá bắt đầu từ 0,017 USD/phiên)
    • Dữ liệu cơ bản (phí 0 VND)
    • Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
    • Dữ liệu về bầu khí quyển (giá bắt đầu từ 0,005 USD cho mỗi yêu cầu)

SKU: Tìm địa điểm hiện tại

Dịch vụ Tìm địa điểm hiện tại được tính phí cho các cuộc gọi đến findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

PHẠM VI LƯU LƯỢNG HẰNG THÁNG
(Giá mỗi CUỘC GỌI)
0–100.000 100.001–500.000 Hơn 500.000
0,030 USD mỗi
(30 USD mỗi 1000)		 0,024 USD cho mỗi
(24 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Các lệnh gọi đến findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) cũng tạo SKU dữ liệu (Cơ bản, Liên hệ và/hoặc Atmosphere), 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 để chỉ giới hạn phản hồi ở các trường đó. Bạn sẽ bị tính phí cho lệnh gọi Tìm vị trí hiện tại cũng như dữ liệu được yêu cầu.

Ví dụ

  1. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) và chỉ xác định trường ADDRESS. Trên hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):
    • Tìm địa điểm hiện tại (giá bắt đầu từ 0,030 USD/yêu cầu)
    • Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
  2. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) và chỉ định trường PHONE_NUMBER. 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 hiện tại (giá bắt đầu từ 0,030 USD/yêu cầu)
    • Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
  3. Bạn gọi findCurrentPlace() (Android) hoặc findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (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 này được liệt kê (khi xem hoá đơn theo SKU):
    • Tìm địa điểm hiện tại (giá khởi điểm từ 0,030 VND/yêu cầu)
    • Dữ liệu cơ bản (lập hóa đơn 0,00 USD)
    • Dữ liệu liên hệ (giá khởi điểm từ 0,003 USD/yêu cầu)
    • Dữ liệu về bầu khí quyển (giá bắt đầu từ 0,005 USD cho mỗi yêu cầu)

SKU: Ảnh địa điểm

SKU Ảnh địa điểm được tính phí đối với:

Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl() sẽ không cho đến khi URL được sử dụng để lấy dữ liệu pixel.

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi LƯU LẠI)
0–100.000 100.001–500.000 Hơn 500.000
0,007 USD cho mỗi
(7 USD cho 1.000
)		 0,0056 USD mỗi
(5,6 USD mỗi 1000)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Các hạn mức sử dụng khác

Mặc dù không có 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 áp dụng khi bạn sử dụng SDK Địa điểm cho iOS:

  • Giới hạn tốc độ là 6.000 yêu cầu mỗi phút (QPM). Giá trị này được tính là tổng của các 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.

Quy định hạn chế trong Điều khoản sử dụng

Để biết thông tin về điều khoản sử dụng, hãy xem Mục Quy định hạn chế về giấy phép về Đ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 iOS hoặc để đáp ứng nhu cầu sản xuất của bạn lưu lượng truy cập, đặt giới hạn hạn mức hằng ngày cho tất cả yêu cầu đối với bất kỳ API nào. Hạn mức hằng ngày được đặt lại lúc nửa đêm theo giờ Thái Bình Dương.

Cách xem hoặc thay đổi hạn mức cho SDK Địa điểm dành cho iOS:

  1. Trong Cloud Console, hãy mở trang Hạn mức của Nền tảng Google Maps.
  2. Nhấp vào trình đơn thả xuống API rồi chọn SDK Địa điểm dành cho iOS.
  3. Để xem các giới hạn về 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.
  4. Để thay đổi một hạn mức, hãy nhấp vào biểu tượng Chỉnh sửa cho hạn mức đó.
    Trong hộp thoại xuất hiện, trong trường Quota Limit (Giới hạn hạn mức), hãy nhập giới hạn hạn mức hằng ngày có thể tính phí mà bạn muốn (tối đa là giới hạn hạn mức do Google chỉ định, nếu có) rồi chọn Save (Lưu).

Nếu mức sử dụng API của bạn đạt đến hạn mức có thể tính phí vào một ngày 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 đó.