Penggunaan dan Penagihan Places API

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

Places API menggunakan model harga bayar sesuai penggunaan. Permintaan Places API menghasilkan panggilan ke salah satu SKU. Selain Persyaratan Penggunaan Google secara keseluruhan, ada batas penggunaan khusus untuk Places API. Kelola biaya dan penggunaan Anda dengan alat yang tersedia di Google Cloud Console.

Cara penagihan Places API

Places API 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 API

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

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

Permintaan data akan dikenai biaya selain biaya permintaan Tempat. Biaya data selalu ditagih bersama dengan permintaan Tempat.

Untuk layanan web, panggilan Places API berikut mendukung penetapan kolom data yang 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

Dengan 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, atau GMSPlaceFieldCurbsidePickup.
  • 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: Query Autocomplete – Per Request

SKU Autocomplete Autocomplete – Per Request dikenai biaya untuk setiap permintaan ke:

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

Harga menurut sesi Autocomplete tidak didukung menggunakan Query Autocomplete. Panggilan Places Details selanjutnya akan dikenai biaya berdasarkan harga Places Details reguler.


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: Place Details – ID Refresh

Gunakan permintaan Place Details untuk memperbarui ID tempat yang lama. Jenis permintaan ini tersedia tanpa biaya.

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

Contoh

Kirimkan permintaan Place Details dengan menentukan hanya kolom ID tempat: getPlaceDetails(fields: place_id). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Place Details – ID Refresh (dikenai biaya USD0,00)

SKU: Find Place

Find Place dikenai biaya untuk permintaan Find Place.

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

Permintaan Find Place juga menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere), bergantung pada kolom yang ditentukan dalam permintaan. Sama seperti permintaan Place Details, Anda dapat menggunakan parameter kolom dalam permintaan Find Place guna membatasi respons hanya untuk kolom yang telah ditentukan. Anda akan dikenai biaya untuk permintaan Find Place dan data yang diminta. Secara default, jika TIDAK ADA kolom yang diminta, hanya ID tempat yang akan ditampilkan, sehingga tidak menimbulkan biaya data tambahan.

Contoh

  1. Anda mengirimkan permintaan Find Place dan menentukan hanya kolom alamat: FindPlace(fields: formatted_address). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Place (harga mulai dari USD0,017 per panggilan)
    • Basic Data (dikenai biaya USD0,00)
  2. Anda mengirimkan permintaan Find Place dan menentukan kolom nomor telepon: FindPlace(fields: formatted_phone_number). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Place (harga mulai dari USD0,017 per panggilan)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
  3. Anda mengirimkan permintaan Find Place dan menentukan kolom dari ketiga kumpulan jenis data: FindPlace(fields: formatted_address, opening_hours, price_level). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Find Place (harga mulai dari USD0,017 per panggilan)
    • Basic Data (dikenai biaya USD0,00)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
    • Atmosphere Data (harga mulai dari 0,005 USD per permintaan)

SKU: Find Place – ID only

Find Place – ID only dikenai biaya untuk permintaan Find Place yang hanya menentukan ID Tempat untuk ditampilkan. Secara default, jika tidak ada kolom yang ditentukan dalam permintaan Find Place, hanya ID tempat yang akan ditampilkan.

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

Contoh

Anda mengirimkan permintaan Find Place dan hanya menentukan kolom place_id: FindPlace(fields: place_id). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Find Place – ID only (dikenai biaya 0,00 USD)

Place – Nearby Search dikenai biaya untuk permintaan ke layanan Place Nearby Search Maps JavaScript API (nearbySearch()), atau ke layanan Nearby Search Places API

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,32 per 1 panggilan
(USD32,00 per 1.000)
USD0,0256 per 1 panggilan
(USD25,60 per 1.000)
Hubungi Bagian Penjualan untuk mengetahui harga volume

Permintaan Nearby Search menampilkan daftar tempat, tetapi tidak mendukung penetapan kolom yang ditampilkan. Permintaan Nearby Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya permintaan Nearby Search dengan harga mulai dari USD0,032 per permintaan, serta semua SKU jenis data (Basic Data, Contact Data, dan Atmosphere Data).

Contoh

Anda mengirimkan permintaan Nearby Search, seperti NearbySearch (San Francisco, 100 meters). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Place - Nearby Search (harga mulai dari USD0,032 per panggilan)
  • Basic Data (dikenai biaya USD0,00)
  • Contact Data (harga mulai dari USD0,003 per permintaan)
  • Atmosphere Data (harga mulai dari USD0,005 per permintaan)

Place – Text Search dikenai biaya untuk permintaan ke layanan Place Text Search Maps JavaScript API (textSearch()), atau ke Layanan Text Search Places API.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,32 per 1 panggilan
(USD32,00 per 1.000)
USD0,0256 per 1 panggilan
(USD25,60 per 1.000)
Hubungi Bagian Penjualan untuk mengetahui harga volume

Permintaan Text Search menampilkan daftar tempat, tetapi tidak mendukung penentuan kolom yang ditampilkan. Permintaan Text Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya permintaan Text Search dengan harga mulai dari USD0,032 per permintaan, serta semua SKU jenis data (Basic Data, Contact Data, dan Atmosphere Data).

SKU Place – Text Search juga dibuat dengan metode widget Place SearchBox Maps JavaScript API: getPlaces() setelah pengguna memilih kueri tempat (ikon: kaca pembesar), bukan hasil (ikon: pin), seperti yang digambarkan sebagai berikut:

Pilihan Kueri Widget Kotak Penelusuran Place Details
Di hasil widget kotak penelusuran, setelah mengetik "pizza" di kotak penelusuran, perhatikan bahwa pesan-antar pizza memiliki ikon kaca pembesar di sampingnya, yang menunjukkan bahwa ini adalah kueri tempat (dan bukan hasil).

Contoh

Anda mengirimkan permintaan Text Search, seperti TextSearch(123 Main Street). Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Place - Text Search (harga mulai dari USD0,032 per panggilan)
  • 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

Batas penggunaan lainnya

Meskipun tidak ada jumlah maksimum permintaan per hari, batas penggunaan berikut masih berlaku saat menggunakan Places API:

  • Batas kapasitas adalah 100 permintaan per detik. 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 pada 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 API:

  1. Di Cloud Console, buka halaman Quotas Google Maps Platform.
  2. Klik drop-down API dan pilih Places API.
  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.