Penggunaan dan Penagihan Places API

Penagihan dan harga untuk Places API

Untuk mengetahui informasi tentang cara Google menghitung penagihan dan harga, lihat daftar harga Google Maps Platform atau daftar harga Google Maps Platform - India.

SKU produk Places (Baru)

Klik ikon info info untuk melihat daftar isi halaman ini. Bagian berikut menguraikan detail untuk setiap SKU:

Kategori Apakah SKU termasuk dalam kategori SKU Essentials, Pro, atau Enterprise.
Peristiwa yang dapat ditagih Peristiwa yang ditagih untuk SKU.
Triggers Elemen kode yang memicu peristiwa yang dapat ditagih.
Harga Link ke tabel harga untuk grup SKU tersebut.

Tentang mask kolom

Untuk Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru), gunakan header FieldMask dalam permintaan API untuk menentukan daftar kolom yang akan ditampilkan dalam respons. Anda akan ditagih dengan SKU tertinggi yang berlaku untuk permintaan Anda. Artinya, jika Anda memilih kolom di SKU Essentials dan Pro, Anda akan ditagih berdasarkan SKU Pro.

Penggunaan penyamaran kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.

Tentang sesi Autocomplete (Baru)

Sesi Autocomplete (Baru) mencakup satu atau beberapa permintaan Autocomplete (Baru), dan permintaan Place Details (Baru) atau permintaan Address Validation. Token sesi yang sama diteruskan ke permintaan Autocomplete (Baru) dan ke permintaan Place Details (Baru) atau permintaan Alamat Validasi berikutnya.

Sesi dimulai dengan permintaan Autocomplete (Baru) pertama. Permintaan Place Details (Baru) atau permintaan Address Validation kemudian dibuat saat pengguna telah memilih salah satu saran Autocomplete (Baru). Jika sesi ditinggalkan, yang berarti tidak ada permintaan Place Details (Baru) atau permintaan Address Validation yang dibuat, permintaan Autocomplete (Baru) akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.

Setelah pengguna memilih tempat (artinya permintaan Place Details (New) atau permintaan Address Validation dibuat), Anda harus memulai sesi baru menggunakan token sesi baru.

Token sesi cocok untuk satu sesi dan tidak dapat digunakan untuk lebih dari satu sesi. Jika token sesi digunakan ulang, sesi tersebut dianggap tidak valid dan permintaan akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.

SKU: Autocomplete Requests

SKU ini menagih permintaan ke Autocomplete API yang tidak menggunakan sesi. Untuk informasi tentang penggunaan sesi guna membatasi jumlah permintaan yang ditagih selama satu sesi Autocomplete, lihat Token sesi atau SKU: Penggunaan Sesi Autocomplete.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu dalam kondisi berikut:

  • Permintaan Anda tidak menyertakan token sesi.
  • Permintaan Anda menyertakan token sesi, tetapi Anda meninggalkan sesi.
  • Permintaan Anda menyertakan token sesi, tetapi Anda menghentikan sesi dalam kondisi tertentu. Untuk informasi tentang Penggunaan Sesi Autocomplete, lihat Token sesi atau Penggunaan Sesi Autocomplete.
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete Session Usage

SKU ini menagih setiap permintaan ke Autocomplete (New) API yang menyertakan token sesi.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda mengirim permintaan ke Autocomplete (New) API yang menyertakan token sesi.

SKU ini berfungsi sebagai wrapper untuk SKU permintaan Autocomplete (Baru) yang memberikan cara bagi Anda untuk membatasi jumlah permintaan yang ditagih selama satu sesi Autocomplete. Untuk informasi tentang Penggunaan Sesi Autocomplete, lihat Token sesi.

Untuk mengetahui informasi selengkapnya, lihat Harga Autocomplete (Baru) dan sesi.

  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Essentials (IDs Only)

SKU ini menagih permintaan ke Place Details yang hanya menampilkan ID Tempat.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

Kolom untuk Layanan web

attributions
id
name*
photos

* Kolom name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Gunakan displayName untuk mengakses nama tekstual tempat tersebut.
  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Essentials

SKU ini menagih permintaan ke Place Details API yang mengambil kolom dalam SKU ini.
  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu saat Anda meminta kolom lokasi berikut:

Kolom untuk Layanan web

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Pro

SKU ini menagih kolom yang Anda tentukan dalam permintaan Place Details Pro.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom tarif yang lebih rendah:

Kolom untuk Layanan web

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

* Kolom googleMapsLinks berada dalam tahap Pratinjau pra-GA dan tidak ada biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau.

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Enterprise

SKU ini menagih permintaan Places yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:

Kolom untuk Layanan web

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

Jika Anda menghentikan sesi Autocomplete dengan panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details Essentials, Pro, Enterprise, atau Enterprise + Atmosphere, panggilan tersebut akan ditagih dengan SKU: Place Details Enterprise + Atmosphere. Untuk informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.
  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Enterprise + Atmosphere

SKU ini menagih panggilan ke Place Details API yang meminta kolom atmosfer yang ditentukan.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

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

    * Khusus Penelusuran Teks dan Penelusuran Langsung

Jika sesi Autocomplete dihentikan oleh panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details Essentials, Pro, Enterprise, atau Enterprise + Atmosphere, panggilan tersebut akan ditagih dengan SKU: Place Details Enterprise + Atmosphere. Untuk informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.
  Contoh penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Pro

SKU ini menagih kolom yang Anda tentukan dalam permintaan Nearby Search Pro.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom tarif yang lebih rendah:

Kolom untuk Layanan 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

* Kolom places.googleMapsLinks berada dalam tahap Pratinjau pre-GA dan tidak ada biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau.

** Kolom places.name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Gunakan places.displayName untuk mengakses nama tekstual tempat tersebut.

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Enterprise

SKU ini menagih permintaan Penelusuran Langsung yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Pemicu

SKU ini dipicu saat Anda meminta kolom berikut:

Kolom untuk Layanan web

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Enterprise + Atmosphere

SKU ini menagih permintaan penelusuran terdekat yang menyertakan kolom atmosfer yang ditentukan.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

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

    * Khusus Penelusuran Teks dan Penelusuran Langsung
  Contoh penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Essentials (IDs Only)

SKU ini ditagih untuk permintaan ke Text Search API yang hanya menampilkan ID.
  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu jika Anda hanya meminta kolom berikut:

Kolom untuk Layanan web

places.attributions
places.id
places.name*
nextPageToken

* Kolom places.name berisi nama resource tempat dalam bentuk: places/PLACE_ID. Gunakan places.displayName untuk mengakses nama tekstual tempat tersebut.
  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Pro

SKU ini adalah SKU Data yang menagih kolom yang Anda tentukan dalam permintaan Text Search Pro.
  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom dengan tarif lebih rendah:

Kolom untuk Layanan 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

* Kolom places.googleMapsLinks berada dalam tahap Pratinjau pra-GA dan tidak ada biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau.

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Enterprise

SKU ini menagih permintaan Text Search yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:

Kolom untuk Layanan web

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Enterprise + Atmosphere

SKU ini menagih permintaan Text Search yang menyertakan kolom atmosfer.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:

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

    * Khusus Penelusuran Teks dan Penelusuran Langsung

  Contoh penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Place Details Photos

SKU ini menagih permintaan Place Details Photos.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu saat Anda meminta foto dari Place Details API.
  Harga Tabel harga utama
Tabel harga India

SKU produk Places lama

Tentang sesi Autocomplete

Sesi Autocomplete mencakup beberapa permintaan Autocomplete (untuk mendapatkan saran tempat saat pengguna mengetik), dan maksimal satu permintaan Places Details (untuk mendapatkan detail tempat yang dipilih oleh pengguna). Token sesi yang sama diteruskan ke Autocomplete dan permintaan Place Detail berikutnya. Sesi diawali dengan permintaan Autocomplete pertama (yang biasanya terjadi saat pengguna mulai mengetik). Panggilan Places Details dilakukan saat pengguna telah memilih salah satu saran Autocomplete. Jika saran tidak dipilih, panggilan Places Details tidak akan dilakukan.

Setelah pengguna memilih tempat (yaitu, setelah panggilan Places Details dilakukan), Anda harus memulai sesi baru menggunakan token sesi baru.

Sesi Autocomplete dapat dibuat dari API berikut:

Token sesi cocok untuk satu sesi pengguna dan tidak dapat digunakan untuk lebih dari satu sesi pengguna. Jika token sesi digunakan ulang, sesi tersebut dianggap tidak valid dan permintaan akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.

Permintaan Autocomplete dan Places Details yang menggunakan sesi ditagih berdasarkan SKU yang berbeda.

Tentang SKU Data Tempat

Tiga SKU Data Tempat adalah: Basic Data, Contact Data, dan Atmosphere Data.

Satu atau beberapa SKU Data terpicu untuk:

  • Android: setiap permintaan ke fetchPlace() atau findCurrentPlace()
  • iOS: setiap panggilan ke fetchPlaceFromPlaceID: atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • Layanan web: setiap permintaan Tempat bergantung pada kolom yang ditentukan dalam permintaan

SKU Data selalu dikenai biaya selain SKU dasar untuk permintaan yang memicunya. Misalnya, permintaan Place Details yang menyertakan kolom Basic Data akan dikenai biaya berdasarkan SKU Basic Data dan SKU Place Details.

Untuk layanan web, permintaan Places API berikut memungkinkan Anda menentukan kolom data yang akan ditampilkan:

Untuk layanan web, panggilan Places API berikut TIDAK mendukung penetapan kolom yang ditampilkan. Panggilan ini selalu menampilkan semua data Tempat, yang menagih biaya untuk tiga SKU Data Tempat selain biaya untuk setiap permintaan API:

SKU: Basic Data

SKU ini adalah SKU Data yang menagih kolom Basic Data dalam permintaan Place Details atau Find Place. SKU ini dikenai biaya selain SKU dasar untuk permintaan yang memicunya.

Kolom pada kategori Basic tercakup dalam biaya dasar permintaan Places dan tidak akan dikenai biaya tambahan.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU Basic Data terpicu saat Anda meminta salah satu kolom berikut:

Kolom untuk Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
   * Gunakan sebagai ganti Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (tidak digunakan lagi)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Gunakan sebagai ganti Place.Field.NAME (tidak digunakan lagi)
Place.Field.FORMATTED_ADDRESS*
   * Gunakan sebagai ganti Place.Field.ADDRESS (tidak digunakan lagi)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Gunakan sebagai ganti Place.Field.ICON_URL (tidak digunakan lagi)
Place.Field.ID
Place.Field.LOCATION*
   * Gunakan sebagai ganti Place.Field.LAT_LNG (tidak digunakan lagi)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET.

Kolom untuk iOS

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Kolom untuk Layanan 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

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Contact Data

SKU ini adalah SKU Data yang menagih kolom Contact Data dalam permintaan Place Details atau Find Place. SKU ini dikenai biaya selain SKU dasar untuk permintaan yang memicunya.

Dengan parameter kolom dalam permintaan Place Details atau Find Place untuk layanan web, atau array Place.Field untuk Android atau iOS, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Kontak akan dikenai biaya tambahan.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU Contact Data terpicu jika ada permintaan untuk kolom berikut:

Kolom untuk Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Gunakan sebagai pengganti Place.Field.PHONE_NUMBER (tidak digunakan lagi).
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

Kolom untuk iOS SDK

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Kolom untuk Layanan web

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  Penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Atmosphere Data

SKU ini menagih permintaan ke Atmosphere Data API yang menentukan kolom dalam SKU ini.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers Penagihan dipicu saat Anda meminta salah satu kolom berikut:
  Contoh penagihan mask kolom

Permintaan Anda ditagih berdasarkan kolom yang diberikan dalam mask kolom. Contoh:

  • Jika mask kolom Anda hanya menyertakan kolom dari SKU ini: Permintaan akan ditagih dengan tarif untuk SKU ini.
  • Jika mask kolom Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete – Per Request

SKU ini menagih permintaan yang tidak menyertakan token sesi

Jika Anda membuat permintaan dari sesi Autocomplete yang tidak valid (misalnya, sesi yang menggunakan ulang token sesi), Anda juga akan dikenai biaya untuk SKU Autocomplete – Per Request.

Permintaan Autocomplete dari Widget Place Autocomplete Maps JavaScript API mungkin dikenai biaya SKU Autocomplete – Per Request saat Anda membuat permintaan dari sesi Autocomplete yang tidak valid. Situasi ini dapat terjadi saat pengguna mengetik atau menyalin/menempel beberapa alamat yang berbeda ke widget dan tidak selalu memilih prediksi pelengkapan otomatis.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk:
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete without Place Details – Per Session

SKU ini ditagih saat untuk sesi Autocomplete yang tidak menyertakan permintaan Place Details (dalam waktu beberapa menit pada awal sesi).

  Kategori Pro
  Peristiwa yang dapat ditagih Sesi
  Triggers Penagihan dipicu jika aplikasi Anda mengeluarkan dua permintaan berikut dalam satu sesi:

Saat melihat tagihan berdasarkan SKU, Anda akan melihat SKU berikut tercantum:

  • Autocomplete without Place Details – Per Session
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete (included with Place Details) – Per Session

Permintaan untuk pelengkapan otomatis tersedia tanpa biaya. SKU ini ditagih saat Anda meminta Place Details selanjutnya berdasarkan harga Place Details reguler.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Sesi
  Triggers SKU Autocomplete (included with Place Details) – Per Session dikenai biaya untuk sesi Autocomplete yang meminta detail tempat. Secara khusus:
  • Android: panggilan ke fetchPlace()
  • iOS: panggilan ke fetchPlaceFromPlaceID:
  • Layanan web: permintaan Place Details

Kolom dalam permintaan:

Pastikan untuk menentukan kolom yang Anda perlukan dalam permintaan untuk menghindari tagihan yang tidak perlu. Bergantung pada kolom yang Anda tentukan, permintaan Place Details juga menghasilkan SKU Data berikut:

Jika Anda tidak menentukan kolom dalam permintaan Place Details, semua SKU Data akan terpicu.

Jika Anda hanya meminta pembaruan ID Place Details (permintaan Anda hanya menentukan kolom place_id) selama sesi pelengkapan otomatis, sesi tersebut akan ditagih sebagai SKU: Autocomplete without Place Details – Per Session.
  Contoh

Contoh ini mengilustrasikan serangkaian permintaan, menurut platform, yang akan menghasilkan SKU berikut dalam tagihan Anda, saat Anda melihat tagihan berdasarkan SKU:

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data

Contoh permintaan menurut platform:

Permintaan Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (dengan FetchPlaceRequest yang menyertakan ID Tempat dan kolom ADDRESS)

Permintaan iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (yang menyertakan ID Tempat dan kolom GMSPlaceFieldFormattedAddress)

Permintaan layanan web

Places Autocomplete Request (input="par", session_token: XYZ)
Places Autocomplete Request (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  Harga Tabel harga utama
Tabel harga India

SKU: Query Autocomplete – Per Request

SKU lama ini menagih untuk permintaan Query Autocomplete.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda membuat permintaan Autocomplete Kueri menggunakan layanan berikut:

Harga menurut sesi Autocomplete tidak didukung menggunakan Query Autocomplete. Permintaan Place Details selanjutnya akan dikenai biaya berdasarkan SKU Place Details Pro.

  Harga Tabel harga utama
Tabel harga India

SKU: Place Details Pro

SKU ini menagih permintaan Place Details lama.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk permintaan dari API berikut:

Dengan API dan layanan web, SKU Place Details akan dikenai biaya, baik Anda memberikan token sesi atau tidak.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.
  Contoh
  1. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: panggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan tentukan hanya kolom ADDRESS
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom alamat: getPlaceDetails(fields: formatted_address)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Basic Data
  2. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: panggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan tentukan hanya kolom PHONE_NUMBER
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan kolom nomor telepon: getPlaceDetails(fields: formatted_phone_number)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Data Kontak
  3. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan menentukan semua kolom
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan semua kolom (jenis permintaan ini adalah default jika Anda tidak menentukan kolom): getPlaceDetails().
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Basic Data
    • Data Kontak
    • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Place Details – ID Refresh

SKU ini menagih permintaan ke Place Details API yang memperbarui ID tempat yang lama.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu saat Anda membuat permintaan Place Details dengan menentukan hanya kolom ID tempat: getPlaceDetails(fields: place_id).
  Harga Tabel harga utama
Tabel harga India

SKU: Find Place

SKU ini menagih permintaan ke Find Place yang menampilkan lebih banyak kolom selain ID Tempat.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini menagih permintaan ke metode berikut:
  • Cari Tempat Saat Ini

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.
  Contoh

Contoh berikut menunjukkan SKU yang ditagih saat Anda membuat permintaan Find Current Place dan menentukan kolom dari SKU data Basic, Contact, dan Atmosphere. Untuk melihat SKU di tagihan, lihat tagihan berdasarkan SKU seperti yang dijelaskan dalam Menganalisis penggunaan dan biaya per SKU.

Anda membuat permintaan Find Place hanya dengan kolom ADDRESS:

Tagihan Anda menampilkan SKU berikut:

  • Cari Tempat Saat Ini
  • Basic Data

Anda membuat permintaan Find Place hanya dengan kolom PHONE_NUMBER:

Tagihan Anda menampilkan SKU berikut:

  • Cari Tempat Saat Ini
  • Data Kontak

Anda membuat permintaan Find Place dengan ketiga kolom jenis data:

Tagihan Anda menampilkan SKU berikut:

  • Cari Tempat Saat Ini
  • Basic Data
  • Data Kontak
  • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Find Place – ID only

SKU ini menagih permintaan ke Find Place yang hanya menampilkan ID Tempat. Secara default, jika Anda tidak menentukan kolom apa pun dalam permintaan Find Place, hanya ID tempat yang akan ditampilkan.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Anda mengirimkan permintaan Find Place tanpa menentukan kolom apa pun, atau Anda hanya menentukan kolom place_id: FindPlace(fields: place_id).
  Harga Tabel harga utama
Tabel harga India

SKU: Places – Nearby Search

SKU ini menagih permintaan Nearby Search.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini dipicu saat Anda membuat permintaan Penelusuran Langsung menggunakan salah satu API berikut:

Permintaan ini tidak mendukung penentuan kolom yang akan ditampilkan. Respons akan menampilkan daftar tempat dan subkumpulan kolom data yang didukung.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.
  Contoh

Anda mengirimkan permintaan Nearby Search, seperti NearbySearch (San Francisco, 100 meters). Tagihan Anda akan menampilkan SKU ini saat melihat tagihan berdasarkan SKU:

  • Tempat
  • Basic Data
  • Data Kontak
  • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Places – Text Search

SKU ini menagih permintaan ke layanan Places Text Search.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk permintaan ke layanan berikut:

Permintaan Text Search menampilkan daftar tempat, tetapi tidak mendukung penetapan kolom yang ditampilkan. Permintaan Text Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya untuk permintaan Text Search serta semua SKU jenis data: Basic Data, Contact Data, dan Atmosphere Data.

SKU Place – Text Search juga dipicu oleh metode getPlaces() pada widget Place SearchBox Maps JavaScript API setelah pengguna memilih kueri tempat (ikon: kaca pembesar), bukan hasil (ikon: pin), seperti yang digambarkan di sini:

Pilihan Kueri Widget Kotak Penelusuran Places Details
Pada hasil widget kotak penelusuran, setelah mengetik "pizza" di kotak penelusuran, lihat bahwa pizza delivery memiliki ikon kaca pembesar di sampingnya, yang menunjukkan bahwa itu adalah kueri tempat (dan bukan hasil).
  Contoh

Jika Anda membuat permintaan Text Search, seperti TextSearch(123 Main Street), tagihan Anda akan menampilkan SKU berikut saat melihat tagihan berdasarkan SKU:

  • Tempat - Penelusuran Teks
  • Basic Data
  • Data Kontak
  • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Photos

SKU ini menagih layanan Places Photo lama.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk:
  Harga Tabel harga utama
Tabel harga India

Batas penggunaan lainnya

Meskipun tidak ada jumlah maksimum permintaan per hari, batas penggunaan berikut tetap berlaku:

  • Places API (Baru): Batas kapasitas adalah 600 QPM (permintaan per menit) per metode API per project. Artinya, setiap metode API memiliki kuota terpisah.

  • Places API: Batas kapasitas adalah 6.000 QPM (permintaan per menit). Metrik ini dihitung sebagai jumlah permintaan sisi klien dan sisi server untuk semua aplikasi yang menggunakan kredensial project yang sama.

Pembatasan berdasarkan Persyaratan Penggunaan

Untuk mengetahui informasi tentang persyaratan penggunaan, lihat kebijakan untuk Places API, dan bagian Pembatasan Lisensi dalam Persyaratan Layanan Google Maps Platform.