Penggunaan dan Penagihan Places SDK for Android

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Kesalahan: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

Places SDK for Android menggunakan model harga bayar sesuai penggunaan. Permintaan Places SDK for Android untuk Places SDK for Android ditagih berdasarkan SKU. Selain Persyaratan Penggunaan Google secara keseluruhan, ada batas penggunaan khusus untuk Places SDK for Android. Kelola biaya dan penggunaan Anda dengan alat yang tersedia di Google Cloud Console.

Cara penagihan Places SDK for Android

Places SDK for Android menggunakan model harga bayar sesuai penggunaan. API dan SDK Google Maps Platform ditagih berdasarkan SKU. Penggunaan dilacak untuk setiap SKU, dan setiap API atau SDK dapat memiliki lebih dari satu SKU produk. Biaya dihitung berdasarkan

Penggunaan SKU × Harga per penggunaan

Gunakan kalkulator Harga dan Penggunaan kami untuk memperkirakan biaya penggunaan Anda per API atau SDK. Untuk SKU Google Maps Platform yang memenuhi syarat, kredit Google Maps Platform senilai $200 USD tersedia setiap bulan untuk setiap akun penagihan. Kredit ini akan otomatis diterapkan1 ke SKU yang memenuhi syarat.

Harga untuk Places SDK for Android

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, 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: Data Dasar, Data Kontak, dan Data Suasana.

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 Data Dasar akan dikenai biaya berdasarkan SKU Data Dasar dan SKU Place Details.

SKU: Basic Data

Dengan menggunakan parameter kolom dalam permintaan Place Details atau Find Place, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Basic tercakup dalam biaya dasar permintaan Places dan tidak akan dikenai biaya tambahan. SKU Basic Data terpicu jika ada permintaan untuk kolom berikut:

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, atau Place.Field.UTC_OFFSET
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes, atau GMSPlaceFieldViewport
  • 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, atau wheelchair_accessible_entrance
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
Biaya permintaan Tempat
+ USD0,00		 Biaya permintaan Tempat
+ USD0,00		 Biaya permintaan Tempat
+ 0,00 USD

SKU: Contact Data

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 Contact akan dikenai biaya tambahan. SKU Contact Data terpicu jika ada permintaan untuk kolom berikut:

  • Android: Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, atau Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber, atau GMSPlaceFieldWebsite
  • Layanan web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours, atau website
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
Biaya permintaan Tempat
+ 0,003 USD per 1 panggilan
(+ 3,00 USD per 1.000)		 Biaya permintaan Tempat
+ 0,0024 USD per 1 panggilan
(+ 2,40 USD per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

SKU: Atmosphere Data

Dengan menggunakan parameter kolom dalam permintaan Place Details atau Find Place, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Atmosphere akan dikenai biaya tambahan. SKU Atmosphere Data terpicu jika ada permintaan untuk kolom berikut:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.TAKEOUT, atau Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch, atau GMSPlaceFieldServesVegetarianFood.
  • JavaScript: Lihat Kolom (Place Details)
  • Layanan web: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, atau user_ratings_total.
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
Biaya permintaan Tempat
+ 0,005 USD per 1 panggilan
(+ 5,00 USD per 1.000)		 Biaya permintaan Tempat
+ 0,004 USD per 1 panggilan
(+ 4,00 USD per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

SKU: Autocomplete – Per Request

SKU Autocomplete – Per Request dikenai biaya untuk panggilan atau permintaan apa pun yang tidak menyertakan token sesi:

Panggilan yang dilakukan dari sesi Autocomplete yang tidak valid (misalnya, sesi yang menggunakan ulang token sesi) juga dikenai biaya untuk SKU Autocomplete – Per Request.

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

RENTANG VOLUME BULANAN
(Harga per PERMINTAAN)
0—100.000 100.001—500.000 500.000+
USD0,00283 per 1 permintaan
(USD2,83 per 1.000)		 USD0,00227 per 1 permintaan
(USD2,27 per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

SKU: Autocomplete without Place Details – Per Session

SKU Autocomplete without Place Details – Per Session dikenai biaya untuk sesi Autocomplete yang tidak menyertakan permintaan Place Details (dalam waktu beberapa menit pada awal sesi).

RENTANG VOLUME BULANAN
(Harga per SESI)
0—100.000 100.001—500.000 500.000+
USD0,017 per 1 panggilan
(USD17,00 per 1.000)		 USD0,0136 per 1 panggilan
(USD13,60 per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

Contoh

Jika aplikasi Anda melakukan dua panggilan berikut dalam satu sesi:

Android

iOS

Layanan web

Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Autocomplete without Place Details – Per Session (harga mulai dari USD0,017 per sesi)

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

SKU Autocomplete (included with Place Details) – Per Session dikenai biaya untuk sesi Autocomplete yang menyertakan salah satu dari:

  • Android: panggilan ke fetchPlace()
  • iOS: panggilan ke fetchPlaceFromPlaceID:
  • Layanan web: permintaan Place Details

Permintaan Autocomplete tersedia tanpa biaya, dan panggilan Place Details selanjutnya akan dikenai biaya berdasarkan harga Place Details reguler.

Permintaan Place Details menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere) – bergantung pada kolom yang ditentukan dalam permintaan.

Jika Anda tidak menentukan kolom dalam permintaan Place Details, semua SKU Data akan terpicu (Basic, Contact, dan Atmosphere).

Permintaan pembaruan ID Place Details (permintaan yang hanya menentukan kolom place_id) selama sesi pelengkapan otomatis akan ditagih sebagai SKU: Autocomplete without Place Details – Per Session.

RENTANG VOLUME BULANAN
(Harga per SESI)
0—100.000 100.001—500.000 500.000+
USD0,00 USD0,00 USD0,00

Contoh

Jika aplikasi Anda melakukan tiga panggilan berikut dalam satu sesi:

Android

iOS

Layanan web

Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Autocomplete (disertakan dengan Place Details) – Per Session (dikenai biaya USD0,00)
  • Place Details (harga mulai dari USD0,017 per sesi)
  • Basic Data (dikenai biaya USD0,00)

SKU: Place Details

Biaya yang dikenai untuk panggilan Place Details adalah sebagai berikut:

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,017 per 1 panggilan
(USD17,00 per 1.000)		 USD0,0136 per 1 panggilan
(USD13,60 per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

SKU Place Details dibuat dari API berikut:

Dengan API dan layanan web, SKU Place Details akan dikenai biaya meskipun token sesi diberikan atau tidak.

Panggilan atau permintaan Place Details juga menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere), bergantung pada kolom yang ditentukan dalam panggilan atau permintaan tersebut. Jika TIDAK ADA kolom yang ditentukan dalam panggilan atau permintaan Place Details, SEMUA SKU Data akan terpicu, dan Anda akan dikenai biaya untuk panggilan atau permintaan Place Details ditambah biaya semua data.

Contoh

  1. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan hanya menentukan 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 (harga mulai dari USD0,017 per sesi)
    • Basic Data (dikenai biaya USD0,00)
  2. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan hanya menentukan kolom PHONE_NUMBER
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom nomor telepon: getPlaceDetails(fields: formatted_phone_number)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details (harga mulai dari USD0,017 per sesi)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
  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 (ini merupakan setelan default untuk jenis permintaan ini jika Anda tidak menentukan kolom): getPlaceDetails().
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details (harga mulai dari USD0,017 per sesi)
    • Basic Data (dikenai biaya USD0,00)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
    • Atmosphere Data (harga mulai dari USD0,005 per permintaan)

SKU: Find Current Place

Find Current Place dikenai biaya untuk panggilan ke findCurrentPlace() (Android) atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,030 per 1 panggilan
(USD30,00 per 1.000)		 USD0,024 per 1 panggilan
(USD24,00 per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

Panggilan ke findCurrentPlace() (Android) atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) juga menghasilkan SKU Data Basic, Contact, dan/atau Atmosphere), bergantung pada kolom yang ditentukan dalam panggilan tersebut. Tentukan kolom data yang akan membatasi respons hanya untuk kolom tersebut. Anda akan dikenai biaya untuk panggilan Find Current Place dan data yang diminta.

Contoh

  1. Anda memanggil findCurrentPlace() (Android) atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) dan menentukan hanya kolom ADDRESS. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Current Place (harga mulai dari USD0,030 per permintaan)
    • Basic Data (dikenai biaya USD0,00)
  2. Anda memanggil findCurrentPlace() (Android) atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) dan menentukan kolom PHONE_NUMBER. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Current Place (harga mulai dari USD0,030 per permintaan)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
  3. Anda memanggil findCurrentPlace() (Android) atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) dan menentukan kolom dari ketiga kumpulan jenis data. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Current Place (harga mulai dari USD0,030 per permintaan)
    • Basic Data (dikenai biaya USD0,00)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
    • Atmosphere Data (harga mulai dari USD0,005 per permintaan)

SKU: Place Photo

SKU Place Photo dikenai biaya untuk:

Untuk layanan JavaScript, pemanggilan metode PlacePhoto.getUrl() tidak akan menimbulkan penagihan hingga URL-nya benar-benar digunakan untuk mendapatkan data piksel.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,007 per 1 panorama
(USD7,00 per 1.000)		 USD0,0056 per 1 panorama
(USD5,60 per 1.000)		 Hubungi Bagian Penjualan untuk mengetahui harga volume

Pembatasan berdasarkan Persyaratan Penggunaan

Untuk mengetahui informasi tentang persyaratan penggunaan, lihat bagian Pembatasan Lisensi dalam Persyaratan Layanan Google Maps Platform.

Mengelola biaya penggunaan

Untuk mengelola biaya penggunaan Google Maps Platform API, tetapkan batas kuota harian pada semua permintaan ke API yang dapat ditagih. Kuota harian direset pada tengah malam waktu Pasifik.

Untuk melihat atau mengubah batas kuota Places SDK for Android:

  1. Di Cloud Console, buka halaman Quotas Google Maps Platform.
  2. Klik drop-down API dan pilih Places SDK for Android.
  3. Untuk melihat batas kuota, scroll ke bawah ke kartu Requests.
    Tabel mencantumkan nama dan batas kuota.
  4. Untuk mengubah batas kuota, klik ikon Edit untuk batas tersebut.
    Pada dialog yang muncul, di kolom Quota Limit, masukkan batas kuota harian yang dapat ditagih (hingga batas kuota maksimum yang ditentukan oleh Google jika ada) dan klik Save.

Jika penggunaan API mencapai batas kuota yang dapat ditagih pada hari yang ditentukan, aplikasi Anda tidak akan dapat mengakses API untuk sisa hari tersebut.

  1. Pengguna di India harus membuat akun penagihan Google Cloud Platform sebelum membuat akun penagihan Google Maps Platform agar dapat menerima kredit Maps Platform. ↩