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 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ỏ 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ẽ 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 phần 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ính năng 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ính năng Tự động hoàn thành.
  Định giá Bảng giá chính
Bảng giá tại Ấ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.

Lưu ý: Nếu không sử dụng phiên có tính năng Tự động hoàn thành (Mới), bạn sẽ được tính phí theo yêu cầu đối với tính năng Tự động hoàn thành bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành.

Để 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á tại Ấ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:

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

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:

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

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:
  • 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, đối với việc sử dụng trong giai đoạn Xem trước.

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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 – Chi tiết đị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:
  • 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.

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:
  • 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 rộng rãi và không tính phí, tức là khoản thanh toán là 0 đô la khi 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.

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:

  • 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

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:

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

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:
  • 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 Bản dùng thử trước khi phát hành rộng rãi 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 Bản dùng thử.

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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:
  • 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

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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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ì lệnh gọi Chi tiết về địa điểm sẽ không được thực hiện.

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ệ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 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:
  • 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
    Place.Field.UTC_OFFSET.
  • iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    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
    wheelchair_accessible_entrance
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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: Dữ liệu liên hệ

SKU này là SKU dữ liệu tính phí cho các trường Dữ liệu 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 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í.

  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:
  • 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
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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: 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 Hoạt động thanh toán được kích hoạt khi bạn yêu cầu bất kỳ trường nào sau đây:
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
Place.Field.USER_RATING_COUNT
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.
Xem Trường (Thông tin chi tiết về địa điểm)
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
user_ratings_total.
  Ví dụ về việc sử dụng mặt nạ trường cho việc thanh toán

Dưới đây là ví dụ về cách tính phí yêu cầu dựa trên các trường mà bạn chọn trong mặt nạ trường.

  • Nếu mặt nạ trường yêu cầu của bạn chỉ bao gồm các trường của SKU này: Yêu cầu được tính phí theo mức giá của SKU này. Ví dụ: bạn có thể yêu cầu một hoặc nhiều trường từ SKU này và được tính phí theo mức giá của SKU này.
  • Nếu mặt nạ trường yêu cầu 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 thêm các trường từ một số SKU, chẳng hạn như SKU Essentials và SKU Enterprise, 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 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 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ỉ khác nhau 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á tại Ấ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 bao gồm bất kỳ yêu cầu 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 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 mà bạn chỉ định trong yêu cầu.

Nếu bạn không yêu cầu các trường cụ thể 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 (Essentials, Pro, Enterprise và Enterprise + Atmosphere). Chỉ chỉ định những trường bạn cần để tránh bị tính phí không cần thiế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ụ

Nếu ứng dụng của bạn đưa ra 3 lệnh gọi sau trong một phiên:

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ự độ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
  Đị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ỉ 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ỉ 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.

  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). Hóa đơn của bạn cho thấy các SKU sau:
    • Tìm địa điểm
    • Dữ liệu cơ bản
  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). Hóa đơn của bạn cho thấy các SKU sau:
    • Tìm địa điểm
    • Dữ liệu liên hệ
  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). Hóa đơn của bạn cho thấy các SKU sau:
    • Tìm đị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: 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á tại Ấ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ệDữ liệu môi trường.

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 cụm từ 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ểmmụ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.