Sử dụng và thanh toán API Địa điểm

Places API (Mới) và Places API sử dụng mô hình tính phí trả theo mức sử dụng. Yêu cầu API Địa điểm (Mới) và API Địa điểm tạo lệnh gọi đến bất kỳ SKU nào trong số nhiều SKU. Ngoài Điều khoản sử dụng chung của Google, còn 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ó trong Google Cloud Console.

Cách tính phí API Địa điểm

Places API (Mới) và Places API sử dụng mô hình định giá theo mức dùng. API và SDK của Nền tảng Google Maps được tính phí theo SKU. Mức sử dụng được theo dõi cho từng SKU và mọi API hoặc SDK đều có thể có nhiều SKU sản phẩm. Chi phí được tính theo công thức:

Số lần sử dụng SKU × Giá mỗi lần sử dụng

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

Mức giá của Places API (Mới)

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

Đối với thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng văn bản (Mới), hãy sử dụng tiêu đề FieldMask trong các yêu cầu API để chỉ định danh sách các trường cần trả về trong phản hồi. Sau đó, bạn sẽ được tính phí theo SKU cao nhất áp dụng cho yêu cầu của mình. Điều đó có nghĩa là nếu bạn 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 tính năng che 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à các khoản phí thanh toán không cần thiết.

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

Một phiên Tự động hoàn thành (Mới) bao gồm một hoặc nhiều yêu cầu Tự động hoàn thành (Mới) và một yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc yêu cầu Xác thực địa chỉ. Mã thông báo phiên tương tự đượ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 (Mới) đầu tiên. 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 bị bỏ dở, tức 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ỉ nào được thực hiện, thì 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 nào đượ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 yêu cầu Xác thực địa chỉ được thực hiện), bạn phải bắt đầu một phiên mới bằng mã thông báo phiên mới.

Mã thông báo phiên chỉ có giá trị trong một phiên và không thể sử dụng cho nhiều phiên. Nếu bạn sử dụng lại mã thông báo phiên, thì phiên đó sẽ được coi là không hợp lệ và các yêu cầu sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp.

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

SKU Yêu cầu tự động hoàn thành sẽ 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.

Bạn cũng sẽ bị tính phí nếu sử dụng mã thông báo phiên và:

  • Kết thúc phiên bằng một yêu cầu duy nhất đến Thông tin chi tiết về địa điểm (Mới) yêu cầu bất kỳ trường nào do SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí) xác định.
    • Mỗi yêu cầu Tự động hoàn thành (Mới), tối đa 12 yêu cầu, sẽ được tính phí bằng 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.
  • Huỷ phiên 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ả các yêu cầu Tự động hoàn thành (Mới) sẽ được tính phí bằng SKU: Yêu cầu tự động hoàn thành.
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,00283 USD cho mỗi
(2,83 USD cho 1.000
)		 0,00227 USD cho mỗi
(2,27 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

SKU: Mức sử dụng phiên tự động hoàn thành

SKU Số lượt sử dụng phiên tính năng Tự động hoàn thành sẽ được tính phí cho mỗi yêu cầu gửi đến API Tự động hoàn thành (Mới) có chứa mã thông báo phiên.

SKU này sẽ bị 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í):

    • Mỗi yêu cầu Tự động hoàn thành (Mới), tối đa 12 yêu cầu, sẽ được tính phí bằng 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 từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên) sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm (Ưu tiên).

  • Phiên tự động hoàn thành đã kết thúc bằng lệnh gọi đến SKU: Address Validation (Xác minh địa chỉ) Preferred (Ưu tiên).

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

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,00 USD cho mỗi
(0,00 USD cho 1.000
)		 0,00 USD cho mỗi
(0,00 USD cho 1.000
)		 0,00 USD cho mỗi
(0,00 USD cho 1.000
)

SKU: Thông tin chi tiết về địa điểm (chỉ dành cho mã nhận dạng)

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:

Dịch vụ web: attributions, id, name*, photos

* Trường name chứa tên tài nguyên ở dạng: places/PLACE_ID. Sử dụng displayName để truy cập tên văn bản của địa điểm.

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ỉ có 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:

Dịch vụ web: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

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,005 USD cho mỗi
(5 USD cho 1.000
)		 0,004 USD cho mỗi
(4 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 (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 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:

Dịch vụ web: accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

* Trường googleMapsLinks đang ở giai đoạn Bản dùng thử trước khi phát hành công khai và không tính phí, tức là khoản thanh toán là 0 USD đối với việc sử dụng trong Bản dùng thử.

Nếu một phiên Tự động hoàn thành bị chấm dứt bằng 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 từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì lệnh gọi đó sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem bài viết SKU: Mức sử dụng phiên tự động hoàn thành.

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 cho mỗi
(13,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: Thông tin chi tiết về địa điểm (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 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:

Dịch vụ web: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

Nếu một phiên Tự động hoàn thành bị chấm dứt bằng 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 từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì lệnh gọi đó sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem bài viết SKU: Mức sử dụng phiên tự động hoàn thành.

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,020 USD cho mỗi
(20,00 USD cho 1.000
)		 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. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, routingSummaries,* servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

* Chỉ tìm kiếm bằng văn bản và tìm kiếm lân cận

Nếu một phiên Tự động hoàn thành bị chấm dứt bằng 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 từ SKU: Thông tin chi tiết về địa điểm (Cơ bản, Nâng cao hoặc Ưu tiên), thì lệnh gọi đó sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm (Ưu tiên). Để biết thêm thông tin, hãy xem bài viết SKU: Mức sử dụng phiên tự động hoàn thành.

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 cho mỗi
(25 USD cho 1.000
)		 0,020 USD cho mỗi
(20,00 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 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:

Dịch vụ web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.attributions, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Trường places.googleMapsLinks đang ở giai đoạn Bản dùng thử trước khi phát hành công khai và không tính phí, tức là khoản thanh toán là 0 USD đối với việc sử dụng trong Bản dùng thử.

** Trường places.name chứa tên tài nguyên ở dạng: places/PLACE_ID. Sử dụng places.displayName để truy cập tên văn bản của địa điểm.

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 cho mỗi
(32 USD cho 1.000
)		 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 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. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

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,035 USD/
(35 USD/1.000
)		 0,028 USD cho mỗi
(28 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 lân cận (Ư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 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:

Dịch vụ web: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* Chỉ tìm kiếm bằng văn bản và tìm kiếm lân cận

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 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 đó. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: places.attributions, places.id, places.name*, nextPageToken

* Trường places.name chứa tên tài nguyên ở dạng: places/PLACE_ID. Sử dụng places.displayName để truy cập tên văn bản của địa điểm.

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: Tìm kiếm bằng 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 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 đó. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Trường places.googleMapsLinks đang ở giai đoạn Xem trước trước khi phát hành công khai và không tính phí, tức là khoản thanh toán là 0 USD đối với việc sử dụng trong giai đoạn Xem trước.

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 cho mỗi
(32 USD cho 1.000
)		 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 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 đó. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

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,035 USD/
(35 USD/1.000
)		 0,028 USD cho mỗi
(28 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 (Ư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 đó. SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Dịch vụ web: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* Chỉ tìm kiếm bằng văn bản và tìm kiếm lân cận

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

Bạn sẽ phải trả phí cho mỗi yêu cầu gửi đến API đối với SKU Ảnh địa điểm.

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 cho mỗi
(5,60 USD cho 1.000
)		 Liên hệ với bộ phận bán hàng để biết giá theo số lượng

Mức giá của API Địa điểm

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

Một 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 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 tương tự được truyền đến tính năng Tự động hoàn thành và yêu cầu Thông tin chi tiết về đị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 (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ì hệ thống sẽ không thực hiện lệnh gọi Chi tiết về địa điểm.

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 mới bằng mã thông báo phiên mới.

Bạn có thể tạo phiên tự động hoàn thành từ 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à các yêu cầu sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp.

Các yêu cầu Tự động hoàn thành và yêu cầu Thông tin chi tiết về địa điểm 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 đị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: mỗi 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

SKU dữ liệu luôn được tính phí ngoài SKU cơ sở cho yêu cầu kích hoạt các SKU đó. Ví dụ: yêu cầu Thông tin chi tiết về địa điểm bao gồm các trường Dữ liệu cơ bản sẽ được tính phí cả 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 lệnh gọi API Địa điểm này KHÔNG hỗ trợ việc 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 của Places, tính phí 3 SKU Dữ liệu của Places ngoài phí cho mỗi yêu cầu API:

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
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
Chi phí yêu cầu về địa điểm
+ 0,00 USD		 Chi phí yêu cầu về địa điểm
+ 0,00 USD		 Chi phí yêu cầu về đị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 yêu cầu Thông tin chi tiết về địa điểm hoặc Tìm địa điểm cho dịch vụ web, hoặc một mảng Place.Field cho Android hoặc iOS, bạn có thể giới hạn phản hồi chỉ ở những trường được chỉ định đó. Các trường trong danh mục 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ó yêu cầu về bất kỳ trường nào sau đây:

  • 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í 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ể chỉ giới hạn phản hồi ở những trường được chỉ định đó. Các trường trong danh mục Atmosphere (Không khí) sẽ 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 phần 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ặc user_ratings_total.
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,005 USD/yêu cầu
(+ 5 USD/1.000 yêu cầu)		 Chi phí yêu cầu về địa điểm
+ 0,004 USD/yêu cầu
(+ 4,00 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: Tự động hoàn thành – Theo mỗi yêu cầu

SKU Tự động hoàn thành – Theo yêu cầu sẽ bị tính phí cho mọi lệnh gọi hoặc yêu cầu không chứa mã thông báo phiên sau đây:

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.

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ủa Maps có thể bị tính phí SKU Tự động hoàn thành – Mỗi 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 đ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.

DUNG 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 cho mỗi
(2,27 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ự động hoàn thành mà không có Thông tin chi tiết về địa điểm – Trên mỗi phiên

SKU Tự động hoàn thành không có Thông tin chi tiết về địa điểm – Theo 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 kể từ khi bắt đầu phiên).

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi PHẦN MỀM)
0–100.000 100.001–500.000 Hơn 500.000
0,017 USD cho mỗi
(17 USD cho 1.000
)		 0,0136 USD cho mỗi
(13,6 USD cho 1.000
)		 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 này trong một phiên:

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 (bao gồm Thông tin chi tiết về địa điểm) – Mỗi phiên

SKU Tự động điền (bao gồm Thông tin chi tiết về địa điểm) – Theo phiên sẽ được tính phí cho một phiên Tự động điền bao gồm bất kỳ nội dung nào sau đây:

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

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ông gian) – 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).

Các yêu cầu làm mới mã nhận dạng Thông tin chi tiết về địa điểm (yêu cầu chỉ chỉ định trường place_id) trong một phiên tự động hoàn thành sẽ được tính phí là 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.

DUNG LƯỢNG HÀNG THÁNG
(Giá mỗi PHẦN MỀM)
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 thực hiện 3 lệnh gọi sau trong một phiên:

Android

iOS

Dịch vụ web

Trên hoá đơn, bạn sẽ thấy các SKU sau đây (khi xem hoá đơn theo SKU):

  • Tự động hoàn thành (bao gồm 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: Tự động hoàn thành truy vấn – Mỗi yêu cầu

SKU Tự động hoàn thành cụm từ tìm kiếm – Mỗi yêu cầu sẽ bị tính phí cho mỗi yêu cầu để:

DUNG 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 cho mỗi
(2,27 USD cho 1.000
)		 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 cụm từ tìm kiếm không hỗ trợ tính năng định giá theo phiên Tự động hoàn thành. Các lệnh gọi 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á thông thường của Thông tin chi tiết về địa điểm.

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

Các lệnh gọi đến API Chi tiết địa điểm sẽ được tính phí như sau:

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,017 USD cho mỗi
(17 USD cho 1.000
)		 0,0136 USD cho mỗi
(13,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 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.

Lệnh 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 Không gian), 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 không chỉ định 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 sẽ 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ụ

  1. Thực hiện một trong các lệnh 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: tạo 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)
    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 (phí 0 VND)
  2. Thực hiện một trong các lệnh 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: tạo 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 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 liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
  3. Thực hiện một trong các lệnh 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: 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 trường nào): getPlaceDetails().
    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 (phí 0 VND)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi 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: Thông tin chi tiết về địa điểm – Làm mới mã nhận dạng

Sử dụng yêu cầu Chi tiết địa điểm để làm mới mã địa điểm cũ. Những loại yêu cầu này được cung cấp mà không tính phí.

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 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ỉ chỉ định trường mã địa điểm: getPlaceDetails(fields: place_id). Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hoá đơn theo SKU):

  • Thông tin chi tiết về địa điểm – Làm mới giấy tờ tuỳ thân (phí 0 USD)

SKU: Tìm địa điểm

Tìm địa điểm sẽ tính phí cho một yêu cầu Tìm địa điểm.

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,017 USD cho mỗi
(17 USD cho 1.000
)		 0,0136 USD cho mỗi
(13,6 USD cho 1.000
)		 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 Không gian), tuỳ thuộc vào các trường được chỉ định trong yêu cầu. Giống như các 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 ở những trường được chỉ định. Bạn sẽ bị tính phí cho yêu cầu Tìm địa điểm cũng như dữ liệu được yêu cầu. Theo mặc định, nếu bạn yêu cầu các trường KHÔNG, thì hệ thống sẽ chỉ trả về mã địa điểm, vì vậy, bạn sẽ không phải trả thêm phí dữ liệu.

Ví dụ

  1. Bạn tạo một 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 này được liệt kê (khi xem hoá đơn theo SKU):
    • Tìm địa điểm (giá bắt đầu từ 0,017 USD cho mỗi lệnh gọi)
    • Dữ liệu cơ bản (phí 0 VND)
  2. Bạn tạo một yêu cầu Tìm địa điểm và chỉ định trường số điện thoại: FindPlace(fields: formatted_phone_number). Trên hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):
    • Tìm địa điểm (giá bắt đầu từ 0,017 USD cho mỗi lệnh gọi)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi yêu cầu)
  3. Bạn tạo một yêu cầu Tìm địa điểm và chỉ định các trường từ cả ba 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á bắt đầu từ 0,017 USD cho mỗi lệnh gọi)
    • Dữ liệu cơ bản (phí 0 VND)
    • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi 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 – chỉ mã nhận dạng

Bạn sẽ phải trả 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ì hệ thống sẽ chỉ trả về mã địa điểm.

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 VND 0 VND 0 VND

Ví dụ:

Bạn tạo một yêu cầu Tìm địa điểm và chỉ chỉ định trường place_id: FindPlace(fields: place_id). Trên hoá đơn, bạn sẽ thấy SKU này được liệt kê (khi xem hoá đơn theo SKU):

  • Tìm địa điểm – chỉ mã (phí 0 USD)

Địa điểm – Tìm kiếm lân cận sẽ tính phí cho các yêu cầu đến dịch vụ Tìm kiếm địa điểm lân cận của API Maps JavaScript (nearbySearch()) hoặc đến dịch vụ Tìm kiếm lân cận của API Địa điểm

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 cho mỗi
(32 USD cho 1.000
)		 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

Yêu cầu Tìm kiếm lân cận trả về danh sách địa điểm, nhưng không hỗ trợ chỉ định trường nào được trả về. Yêu cầu Tìm kiếm lân cận trả về một nhóm nhỏ 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 địa điểm lân cận, bắt đầu từ 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 về môi trường xung quanh).

Ví dụ:

Bạn tạo một yêu cầu Tìm kiếm lân cận, chẳng hạn như NearbySearch (San Francisco, 100 meters). Trên hoá đơn, bạn sẽ thấy các SKU sau đây (khi xem hoá đơn theo SKU):

  • Địa điểm – Tìm kiếm lân cận (giá bắt đầu từ 0,032 USD/lượt gọi)
  • Dữ liệu cơ bản (phí 0 VND)
  • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi 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: Địa điểm – Tìm kiếm bằng văn bản

Địa điểm – Tìm kiếm bằng văn bản sẽ tính phí cho các yêu cầu đến dịch vụ Tìm kiếm bằng văn bản của địa điểm trong API Maps JavaScript (textSearch()) hoặc đến dịch vụ Tìm kiếm bằng văn bản của API Địa điểm.

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 cho mỗi
(32 USD cho 1.000
)		 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

Yêu cầu Tìm kiếm bằng văn bả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 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 mỗi yêu cầu Tìm kiếm bằng văn bản, bắt đầu từ 0,032 USD, 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 về bầu khí quyển).

SKU Địa điểm – Tìm kiếm bằng văn bản cũng được tạo bằng tiện ích Place SearchBox của API JavaScript của Maps: phương thức getPlaces() sau khi người dùng chọn một cụm từ tìm kiếm địa điểm (biểu tượng: kính lúp), không phải một kết quả (biểu tượng: ghim), như minh hoạ ở đây:

Lựa chọn truy vấn tiện ích Hộp tìm kiếm thông tin chi tiết về địa điểm
Trong kết quả của tiện ích hộp tìm kiếm, sau khi nhập "pizza" vào hộp tìm kiếm, hãy lưu ý rằng pizza delivery có biểu tượng kính lúp bên cạnh, cho biết đó là cụm từ tìm kiếm địa điểm (chứ không phải kết quả).

Ví dụ:

Bạn tạo một yêu cầu Tìm kiếm bằng văn bản, chẳng hạn như TextSearch(123 Main Street). Trên hoá đơn, bạn sẽ thấy các SKU này được liệt kê (khi xem hoá đơn theo SKU):

  • Địa điểm – Tìm kiếm bằng văn bản (giá bắt đầu từ 0,032 USD cho mỗi lệnh gọi)
  • Dữ liệu cơ bản (phí 0 VND)
  • Dữ liệu liên hệ (giá bắt đầu từ 0,003 USD cho mỗi 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 sẽ bị tính phí cho:

Đối với dịch vụ JavaScript, việc gọi phương thức PlacePhoto.getUrl() sẽ không gây ra việc tính phí cho đến khi URL thực sự được 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 cho mỗi
(5,60 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 hạn mức sử dụng khác

Mặc dù không có số lượng yêu cầu tối đa mỗi ngày, nhưng các hạn mức sử dụng sau đây vẫn áp dụng:

  • API Địa điểm (Mới): Giới hạn tốc độ là 600 yêu cầu mỗi phút (yêu cầu mỗi phút) cho mỗi phương thức API trên mỗi dự án. Tức là mỗi phương thức API có một hạn mức riêng.

  • Places API: Giới hạn tốc độ là 6.000 QPM (yêu cầu mỗi phút). Giá trị này được tính bằng tổng số yêu cầu phía máy khách và phía máy chủ cho tất cả ứng dụng sử dụng thông tin xác thực của cùng một dự án.

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 chính sách đối với API Địa điểm và mục 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 API Địa điểm hoặc để đáp ứng nhu cầu về lưu lượng truy cập thực tế, hãy đặt hạn mức hằng ngày cho tất cả yêu cầu gửi đến bất kỳ API nào. 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.

Cách xem hoặc thay đổi hạn mức hạn mức cho API Địa điểm:

  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 Places API.
  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 hạn mức.
  4. Để thay đổi hạn mức 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 đó.