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

Thông tin thanh toán và giá của API Địa điểm

Để biết thông tin về cách Google tính phí và giá, hãy xem danh sách giá của Google Maps Platform hoặc danh sách giá của Google Maps Platform – Ấn Độ.

SKU sản phẩm trên Địa điểm (Mới)

Nhấp vào biểu tượng thông tin info để xem mục lục của trang này. Các phần sau đây trình bày thông tin chi tiết về từng SKU:

Danh mục Liệu SKU có thuộc danh mục SKU Essentials, Pro hay Enterprise hay không.
Sự kiện có thể lập hoá đơn Sự kiện nào được tính phí cho SKU.
Điều kiện kích hoạt Những phần tử mã kích hoạt sự kiện có thể lập hoá đơn.
Định giá Đường liên kết đến bảng giá cho nhóm SKU đó.

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 Essentials và SKU Pro, thì bạn sẽ được tính phí dựa trên SKU Pro.

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ỏ ngang, 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ẽ 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 này tính phí cho các yêu cầu đến Autocomplete API không sử dụng phiên. Để biết thông tin về cách sử dụng phiên để giới hạn số lượng yêu cầu được tính phí trong một phiên Tự động điền, hãy xem Mã thông báo phiên hoặc SKU: Mức sử dụng phiên Tự động điền.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt

SKU này được kích hoạt trong các điều kiện sau:

  • Yêu cầu của bạn không có mã thông báo phiên.
  • Yêu cầu của bạn có mã thông báo phiên, nhưng bạn đã bỏ phiên.
  • Yêu cầu của bạn bao gồm mã thông báo phiên, nhưng bạn chấm dứt phiên theo một số điều kiện nhất định. Để biết thông tin về Mức sử dụng phiên tự động hoàn thành, hãy xem phần Mã thông báo phiên hoặc Mức sử dụng phiên tự động hoàn thành.
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

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

SKU này 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.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn gửi một yêu cầu đến API Tự động hoàn thành (Mới) có chứa mã thông báo phiên.

SKU này đóng vai trò là trình bao bọc cho SKU yêu cầu Tự động hoàn thành (Mới). SKU này giúp bạn giới hạn số lượng yêu cầu được tính phí trong một phiên Tự động hoàn thành. Để biết thông tin về Mức sử dụng phiên Tự động hoàn thành, hãy xem phần Mã thông báo phiê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.

  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

SKU: Thông tin cơ bản về chi tiết địa điểm của API Địa điểm (chỉ có mã nhận dạng)

SKU này tính phí cho các yêu cầu về Thông tin chi tiết về địa điểm chỉ trả về Mã địa điểm.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn yêu cầu các trường sau:

Các trường cho 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.
  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Kiến thức cơ bản về thông tin chi tiết về địa điểm trong API Địa điểm

SKU này tính phí cho các yêu cầu đến API Thông tin chi tiết về địa điểm để truy xuất các trường trong SKU này.
  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn yêu cầu các trường vị trí sau:

Các trường cho dịch vụ web

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

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

SKU này tính phí cho các trường mà bạn chỉ định trong yêu cầu Thông tin chi tiết về địa điểm Pro.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau hoặc các trường có mức giá thấp hơn:

Các trường cho dịch vụ web

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* Trường 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 đô la khi sử dụng trong giai đoạn Xem trước.

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Địa điểm – Thông tin chi tiết về địa điểm dành cho doanh nghiệp

SKU này tính phí cho một yêu cầu về Địa điểm có chứa các trường dành cho Doanh nghiệp.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn yêu cầu các trường sau:

Các trường cho dịch vụ web

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

Nếu bạn chấm dứt một phiên Tự động hoàn thành 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 Essentials, Pro, Enterprise hoặc Enterprise + Atmosphere, thì lệnh gọi đó sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm Enterprise + Atmosphere. Để biết thêm thông tin, hãy xem phần SKU: Mức sử dụng phiên tự động hoàn thành.
  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Chi tiết địa điểm API Địa điểm Enterprise + Atmosphere

SKU này tính phí cho các lệnh gọi đến API Thông tin chi tiết về địa điểm yêu cầu các trường bầu không khí được chỉ định.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn 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 một 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 Essentials, Pro, Enterprise hoặc Enterprise + Atmosphere, thì lệnh gọi đó sẽ được tính phí theo SKU: Thông tin chi tiết về địa điểm Enterprise + Atmosphere. Để 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.
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Địa điểm Tìm kiếm lân cận Pro

SKU này tính phí cho các trường mà bạn chỉ định trong yêu cầu Tìm kiếm địa điểm lân cận nâng cao.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau hoặc các trường có mức giá thấp hơn:

Các trường cho 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.postalAddress
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 đô la, đối với việc sử dụng trong giai đoạn Xem trước.

** 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.

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Tìm kiếm lân cận của Places API dành cho doanh nghiệp

SKU này tính phí cho các yêu cầu Tìm kiếm lân cận có chứa bất kỳ trường nào của Enterprise.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn yêu cầu các trường sau:

Các trường cho 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

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Tìm kiếm lân cận của API Địa điểm dành cho doanh nghiệp + Atmosphere

SKU này tính phí cho các yêu cầu tìm kiếm địa điểm lân cận có chứa các trường môi trường đã chỉ định.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn 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
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Kiến thức cơ bản về tính năng Tìm kiếm bằng văn bản của API Địa điểm (chỉ dành cho mã nhận dạng)

SKU này được tính phí cho các yêu cầu đến API Tìm kiếm văn bản chỉ trả về mã nhận dạng.
  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau:

Các trường cho 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.
  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Tìm kiếm văn bản của Places Pro

SKU này là một SKU dữ liệu tính phí cho các trường mà bạn chỉ định trong yêu cầu Tìm kiếm văn bản nâng cao.
  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn chỉ yêu cầu các trường sau đây hoặc các trường có mức giá thấp hơn:

Các trường cho 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.postalAddress
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 đô la Mỹ, đối với việc sử dụng trong giai đoạn Xem trước.

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: API Tìm kiếm văn bản của API Địa điểm dành cho doanh nghiệp

SKU này tính phí cho các yêu cầu Tìm kiếm bằng văn bản có chứa bất kỳ trường nào của gói Enterprise.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn yêu cầu các trường sau:

Các trường cho 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

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Tìm kiếm bằng văn bản của API Địa điểm Enterprise + Atmosphere

SKU này tính phí cho các yêu cầu Tìm kiếm bằng văn bản có chứa bất kỳ trường không khí nào.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn 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

  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

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

SKU này tính phí cho các yêu cầu về Ảnh chi tiết về địa điểm.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hoạt động thanh toán được kích hoạt khi bạn yêu cầu ảnh từ API Thông tin chi tiết về địa điểm.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU sản phẩm của Địa điểm cũ

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à sau khi 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 yêu cầu API Địa điểm này cho phép bạn 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

SKU này là SKU dữ liệu tính phí cho các trường Dữ liệu cơ bản trong yêu cầu Thông tin chi tiết về địa điểm hoặc Tìm địa điểm. SKU này được tính phí ngoài SKU cơ sở cho yêu cầu đã kích hoạt SKU này.

Các trường trong danh mục Cơ bản được đưa vào chi phí cơ bản của yêu cầu về Địa điểm và không tính thêm phí.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt SKU Dữ liệu cơ bản được kích hoạt khi bạn yêu cầu bất kỳ trường nào sau đây:

Các trường cho SDK Android

Place.Field.ACCESSIBILITY_OPTIONS*
   * Sử dụng thay vì Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (không dùng nữa)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Sử dụng thay vì Place.Field.NAME (không dùng nữa)
Place.Field.FORMATTED_ADDRESS*
   * Sử dụng thay vì Place.Field.ADDRESS (không dùng nữa)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Sử dụng thay vì Place.Field.ICON_URL (không dùng nữa)
Place.Field.ID
Place.Field.LOCATION*
   * Sử dụng thay vì Place.Field.LAT_LNG (không dùng nữa)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Trường cho iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Các trường cho 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
wheelchair_accessible_entrance

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

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

SKU này là một SKU dữ liệu tính phí cho các trường Thông tin liên hệ trong yêu cầu Thông tin chi tiết về địa điểm hoặc Tìm địa điểm. SKU này được tính phí ngoài SKU cơ sở cho yêu cầu đã kích hoạt SKU này.

Bằng cách sử dụng tham số trường trong yêu cầu Chi tiết đị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ể chỉ giới hạn phản hồi ở 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í.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt 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:

Các trường cho SDK Android

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Sử dụng thay vì Place.Field.PHONE_NUMBER (không dùng nữa).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Các trường cho SDK iOS

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Các trường cho dịch vụ web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Thanh toán bằng mặt nạ trường

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

SKU: Dữ liệu về bầu khí quyển

SKU này tính phí cho các yêu cầu đến API Dữ liệu Atmosphere chỉ định các trường trong SKU này.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu có mặt nạ trường được chỉ định.
  Điều kiện kích hoạt Hệ thống sẽ kích hoạt tính năng thanh toán khi bạn yêu cầu bất kỳ trường nào sau đây:
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Yêu cầu của bạn được tính phí dựa trên các trường được cung cấp trong mặt nạ trường. Ví dụ:

  • Nếu mặt nạ trường của bạn chỉ bao gồm các trường của SKU này: Yêu cầu sẽ được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường của bạn bao gồm các trường từ các SKU khác: Yêu cầu sẽ được tính phí theo mức giá SKU cao nhất cho các trường được yêu cầu. Ví dụ: nếu bạn đưa các trường từ cả SKU Essentials và SKU Enterprise vào, thì yêu cầu sẽ được tính phí theo mức giá của SKU Enterprise.
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Tự động hoàn thành – Theo mỗi yêu cầu

Hóa đơn SKU này dành cho các yêu cầu không bao gồm mã thông báo phiên

Nếu gửi yêu cầu 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), bạn cũng sẽ bị tính phí SKU Tự động hoàn thành – Mỗi 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 API JavaScript của Maps có thể bị tính phí SKU Tự động hoàn thành – Mỗi yêu cầu khi bạn đưa ra yêu cầu từ một phiên Tự động hoàn thành không hợp lệ. Tình huống này có thể xảy ra khi người dùng đang nhập 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 nội dung gợi ý tự động hoàn thành.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hoạt động thanh toán được kích hoạt cho:
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

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

SKU này tính phí khi 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).

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Phiên
  Điều kiện kích hoạt Hoạt động thanh toán sẽ được kích hoạt nếu ứng dụng của bạn đưa ra 2 yêu cầu này trong một phiên:

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

  • 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
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

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

Bạn có thể yêu cầu tính năng tự động hoàn thành mà không mất phí. SKU này sẽ tính phí khi bạn yêu cầu Thông tin chi tiết về địa điểm tiếp theo dựa trên mức giá thông thường của Thông tin chi tiết về địa điểm.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Phiên
  Điều kiện kích hoạt SKU Tự động hoàn thành (bao gồm Thông tin chi tiết về địa điểm) – Theo phiên sẽ bị tính phí cho một phiên Tự động hoàn thành yêu cầu thông tin chi tiết về địa điểm. Cụ thể:
  • 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

Các trường trong yêu cầu:

Hãy nhớ chỉ định các trường mà bạn cần trong yêu cầu để tránh bị tính phí không cần thiết. Tuỳ thuộc vào những trường mà bạn chỉ định, 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 sau:

Nếu bạn không chỉ định các trường trong yêu cầu Chi tiết địa điểm, thì tất cả SKU dữ liệu sẽ được kích hoạt.

Nếu bạn chỉ yêu cầu làm mới Mã thông tin chi tiết về địa điểm (yêu cầu của bạn chỉ chỉ định trường place_id) trong một phiên tự động hoàn thành, thì phiên đó 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.
  Ví dụ

Ví dụ này minh hoạ một loạt yêu cầu theo nền tảng, dẫn đến các SKU sau trong hoá đơn của bạn khi bạn xem hoá đơn theo SKU:

  • Tự động hoàn thành (bao gồm cả Chi tiết địa điểm) – Mỗi phiên
  • Thông tin về địa điểm
  • Dữ liệu cơ bản

Ví dụ về yêu cầu theo nền tảng:

Yêu cầu Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (có FetchPlaceRequest bao gồm Mã địa điểm và trường ADDRESS)

Yêu cầu iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (bao gồm cả Mã địa điểm và trường GMSPlaceFieldFormattedAddress)

Yêu cầu dịch vụ web

Yêu cầu tự động hoàn thành thông tin về địa điểm (input="par", session_token: XYZ)
Yêu cầu tự động hoàn thành thông tin về đị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)

  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Tự động hoàn thành truy vấn – Mỗi yêu cầu

SKU cũ này tính phí cho các yêu cầu Tự động hoàn thành truy vấn.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt

SKU này được kích hoạt khi bạn tạo yêu cầu Tự động điền truy vấn bằng các dịch vụ sau:

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 yêu cầu Thông tin chi tiết về địa điểm tiếp theo sẽ được tính phí dựa trên SKU Thông tin chi tiết về địa điểm Pro.

  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Place Details Pro

SKU này tính phí cho các yêu cầu Thông tin chi tiết về địa điểm cũ.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hệ thống thanh toán được kích hoạt cho các yêu cầu 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.

SKU này cũng kích hoạt việc tính phí cho SKU Dữ liệu: Nếu bạn đưa các trường dữ liệu vào yêu cầu, thì yêu cầu đó có thể kích hoạt việc tính phí bổ sung cho SKU Dữ liệu: Basic (Cơ bản), Contact (Liên hệ) và Atmosphere (Môi trường). Chỉ chỉ định những trường dữ liệu mà bạn muốn để tránh các chi phí không cần thiết. Bạn sẽ bị tính phí cho SKU này cũng như cho dữ liệu mà bạn yêu cầ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ỉ 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 về địa điểm
    • Dữ liệu cơ bản
  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 về địa điểm
    • Dữ liệu liên hệ
  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 về địa điểm
    • Dữ liệu cơ bản
    • Dữ liệu liên hệ
    • Dữ liệu khí quyển
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Thông tin chi tiết về địa điểm – Làm mới mã nhận dạng

SKU này tính phí cho các yêu cầu đến API Thông tin chi tiết về địa điểm để làm mới mã địa điểm cũ.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hoạt động thanh toán được kích hoạt khi bạn 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).
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

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

SKU này tính phí cho các yêu cầu Tìm địa điểm trả về nhiều trường hơn ngoài Mã địa điểm.

SKU này cũng kích hoạt việc tính phí cho SKU Dữ liệu: Nếu bạn đưa các trường dữ liệu vào yêu cầu, thì yêu cầu đó có thể kích hoạt việc tính phí bổ sung cho SKU Dữ liệu: Basic (Cơ bản), Contact (Liên hệ) và Atmosphere (Môi trường). Chỉ chỉ định những trường dữ liệu mà bạn muốn để tránh các chi phí không cần thiết. Bạn sẽ bị tính phí cho SKU này cũng như cho dữ liệu mà bạn yêu cầu.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt SKU này tính phí cho các yêu cầu đối với các phương thức sau:
  • Tìm địa điểm hiện tại

SKU này cũng kích hoạt việc tính phí cho SKU Dữ liệu: Nếu bạn đưa các trường dữ liệu vào yêu cầu, thì yêu cầu đó có thể kích hoạt việc tính phí bổ sung cho SKU Dữ liệu: Basic (Cơ bản), Contact (Liên hệ) và Atmosphere (Môi trường). Chỉ chỉ định những trường dữ liệu mà bạn muốn để tránh các chi phí không cần thiết. Bạn sẽ bị tính phí cho SKU này cũng như cho dữ liệu mà bạn yêu cầu.
  Ví dụ

Các ví dụ sau đây cho biết bạn sẽ bị tính phí cho những SKU nào khi tạo yêu cầu Tìm địa điểm hiện tại và chỉ định các trường trong SKU dữ liệu Cơ bản, Thông tin liên hệ và Không gian. Để xem các SKU trên hoá đơn, hãy xem hoá đơn theo SKU như mô tả trong phần Phân tích mức sử dụng và chi phí theo SKU.

Bạn chỉ cần sử dụng trường ADDRESS để tạo yêu cầu Tìm địa điểm:

Hóa đơn của bạn cho thấy các SKU sau:

  • Tìm địa điểm hiện tại
  • Dữ liệu cơ bản

Bạn chỉ cần sử dụng trường PHONE_NUMBER để tạo yêu cầu Tìm địa điểm:

Hóa đơn của bạn cho thấy các SKU sau:

  • Tìm địa điểm hiện tại
  • Dữ liệu liên hệ

Bạn tạo một yêu cầu Tìm địa điểm bằng cả ba trường loại dữ liệu:

Hóa đơn của bạn cho thấy các SKU sau:

  • Tìm địa điểm hiện tại
  • Dữ liệu cơ bản
  • Dữ liệu liên hệ
  • Dữ liệu khí quyển
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

SKU: Tìm địa điểm – chỉ mã nhận dạng

SKU này tính phí cho các yêu cầu Tìm địa điểm chỉ trả về Mã địa điểm. Theo mặc định, nếu bạn không chỉ định trường nào trong yêu cầu Tìm địa điểm, thì hệ thống sẽ chỉ trả về mã địa điểm.

  Danh mục Essentials
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Bạn tạo một yêu cầu Tìm địa điểm mà không chỉ định trường nào hoặc chỉ chỉ định trường place_id: FindPlace(fields: place_id).
  Định giá Bảng giá chính
Bảng giá ở Ấn Độ

SKU: Địa điểm – Tìm kiếm lân cận

SKU này tính phí cho các yêu cầu Tìm kiếm ở gần.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt SKU này được kích hoạt khi bạn tạo yêu cầu Tìm kiếm lân cận bằng một trong các API sau:

Yêu cầu này không hỗ trợ việc chỉ định trường cần trả về. Phản hồi trả về một danh sách các địa điểm và một tập hợp con của các trường dữ liệu được hỗ trợ.

SKU này cũng kích hoạt việc tính phí cho SKU Dữ liệu: Nếu bạn đưa các trường dữ liệu vào yêu cầu, thì yêu cầu đó có thể kích hoạt việc tính phí bổ sung cho SKU Dữ liệu: Basic (Cơ bản), Contact (Liên hệ) và Atmosphere (Môi trường). Chỉ chỉ định những trường dữ liệu mà bạn muốn để tránh các chi phí không cần thiết. Bạn sẽ bị tính phí cho SKU này cũng như cho dữ liệu mà bạn yêu cầu.
  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). Hoá đơn của bạn sẽ hiển thị các SKU này khi bạn xem hoá đơn theo SKU:

  • Địa điểm
  • Dữ liệu cơ bản
  • Dữ liệu liên hệ
  • Dữ liệu khí quyển
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Địa điểm – Tìm kiếm bằng văn bản

SKU này tính phí cho các yêu cầu đối với dịch vụ Tìm kiếm văn bản về địa điểm.

  Danh mục Pro
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hệ thống sẽ kích hoạt tính năng thanh toán cho các yêu cầu đối với các dịch vụ sau:

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ợ chỉ định trường nào sẽ được trả về. Yêu cầu Tìm kiếm văn bản trả về một tập hợp con của các trường dữ liệu được hỗ trợ. Bạn sẽ bị tính phí cho yêu cầu Tìm kiếm bằng văn bản 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 môi trường xung quanh.

SKU Địa điểm – Tìm kiếm bằng văn bản cũng được kích hoạt bằng tiện ích Hộp tìm kiếm địa điểm 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 giao bánh pizza 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ụ

Nếu bạn đưa ra yêu cầu Tìm kiếm bằng văn bản, chẳng hạn như TextSearch(123 Main Street), thì hoá đơn của bạn sẽ hiển thị các SKU này khi bạn xem hoá đơn theo SKU:

  • Địa điểm – Tìm kiếm bằng văn bản
  • Dữ liệu cơ bản
  • Dữ liệu liên hệ
  • Dữ liệu khí quyển
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

SKU: Ảnh chi tiết về địa điểm trong API Địa điểm

SKU này tính phí cho dịch vụ Ảnh địa điểm cũ.

  Danh mục Doanh nghiệp
  Sự kiện có thể lập hoá đơn Yêu cầu
  Điều kiện kích hoạt Hoạt động thanh toán được kích hoạt cho:
  Định giá Bảng giá chính
Bảng giá tại Ấn Độ

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 QPM (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.