Google Places API untuk memeriksa keberadaan usaha
Kolom Google Places API untuk memeriksa usaha
Minggu ini, Anda mungkin sedang menilai pengajuan yang hasil pemeriksaan biro kredit dan registrinya belum menjawab satu pertanyaan praktis: apakah usaha tersebut tercatat di alamat yang dicantumkan? Text Search (New) menerima nama usaha dan alamat yang dicantumkan, lalu menampilkan tempat yang cocok.
Cantumkan kolom yang Anda perlukan dalam field mask pada permintaan. Hasilnya menambahkan data tempat ke pengajuan, bukan data perusahaan. Data ini tidak menghubungkan tempat dengan nomor registrasi, direktur, atau laporan keuangan, sehingga pemeriksaan registri dan biro kredit tetap diperlukan.
Kolom dibagi ke dalam empat tingkat penagihan Text Search. Tabel berikut mencantumkan setiap kolom dan informasi yang disimpan:
| Tingkat Text Search | Data tersedia |
|---|---|
| Essentials (IDs Only) |
|
| Pro |
|
| Enterprise |
|
| Enterprise + Atmosphere |
|
Biaya permintaan mengikuti SKU tertinggi yang berlaku. Kolom yang dipilih menentukan tingkat biaya permintaan tersebut.
Memeriksa apakah usaha UKM masih beroperasi
Untuk pengajuan UKM, bandingkan nama dan alamat usaha yang dicantumkan dengan data tempat di Google. Pemeriksaan ini membantu menilai apakah usaha beroperasi di alamat tersebut. Dalam data Google, OPERATIONAL berarti usaha beroperasi di sana, tetapi belum tentu sedang buka saat itu. CLOSED_PERMANENTLY menimbulkan pertanyaan apakah usaha masih berada di alamat pengajuan. Jika movedPlaceId tersedia, cari tempat menggunakan ID tersebut. Pertimbangkan hasil ini bersama pemeriksaan registri dan biro kredit.
Untuk menilai kecocokan keterangan tempat dengan pengajuan, bandingkan bidang usaha yang dicantumkan dengan primaryType dan types. Jika usaha mencantumkan restoran dan hasilnya berjenis restaurant, keduanya cocok. Jika usaha mencantumkan grosir tetapi hasilnya berjenis toko pakaian, atau tempat tidak memiliki jenis utama, kasus tersebut perlu ditinjau oleh petugas. Hasil perbandingan dapat menjadi alasan untuk merujuk kasus, bukan dasar untuk langsung mengambil kesimpulan tentang usaha.
Jika usaha mencantumkan perdagangan ritel, bandingkan regularOpeningHours dengan jam operasional yang wajar untuk peritel. Tidak ada jam yang tercantum, atau jam yang tidak wajar untuk peritel, menjadi hal yang perlu ditinjau. Tempat yang buka 24 jam ditampilkan sebagai satu periode mulai hari 0, jam 0. Untuk melihat aktivitas publik, userRatingCount menunjukkan jumlah ulasan, sedangkan rating menunjukkan penilaian pengulas terhadap tempat dalam skala 1.0 hingga 5.0. Tiga ulasan hanya memberikan sedikit informasi publik bagi pemberi pinjaman. Delapan ratus ulasan menyediakan lebih banyak pendapat publik untuk dipertimbangkan, berapa pun nilai penilaiannya.
Memeriksa merchant BNPL sebelum mulai beroperasi
Sebelum mengaktifkan BNPL di toko merchant, gunakan status tempat untuk membedakan toko yang sudah beroperasi dari toko yang belum buka atau sedang berhenti beroperasi. Setiap status dapat menjadi pertimbangan untuk keputusan pendaftaran yang berbeda:
| Status tempat | Indikasi | Keputusan pendaftaran |
|---|---|---|
OPERATIONAL | Toko beroperasi | Lanjutkan |
FUTURE_OPENING dengan openingDate | Toko belum buka; tanggal menunjukkan kapan toko akan buka | Tunggu hingga tanggal pembukaan |
CLOSED_TEMPORARILY | Toko berhenti beroperasi sementara | Tahan pengajuan |
Jika consumerAlert terisi, Google mendeteksi aktivitas ulasan yang mencurigakan pada usaha tersebut atau pelanggaran kebijakan. Pertimbangkan informasi ini saat menilai rating toko.
Bandingkan websiteUri dan nationalPhoneNumber toko dengan informasi yang dimasukkan merchant saat pendaftaran. Gunakan hasil perbandingan untuk menilai kecocokan informasi yang disampaikan dan menentukan bobot ulasan.
Memeriksa fraud dan KYB berdasarkan jenis alamat usaha
Jika suatu alamat hanya menampilkan jenis alamat seperti street_address, premise atau subpremise, tanpa establishment, data tempat Google tidak menunjukkan adanya usaha yang beroperasi di sana. Pengecualiannya adalah usaha yang melayani pelanggan di alamat pelanggan. Untuk toko yang alamatnya dicantumkan sebagai alamat usaha, jenis coworking_space, business_center atau shipping_service dapat menunjukkan kantor virtual atau layanan kotak surat. Jika alamat toko yang diklaim berada di apartment_building atau housing_complex, alamat tersebut merupakan alamat hunian dan ketidakcocokannya berbeda. Gunakan data tempat saat meninjau fraud. Registrasi dan kepemilikan perusahaan tetap perlu diperiksa melalui registri dan pemeriksaan lainnya.
Usaha jasa kebersihan atau tukang ledeng mungkin mendatangi pelanggan dan tidak memiliki lokasi fisik di Google Maps. Untuk aturan KYB, perlakukan usaha dengan pureServiceAreaBusiness yang terisi sebagai usaha dengan area layanan. Periksa penanda ini sebelum merujuk alamat yang tidak memiliki establishment, agar usaha dengan area layanan tidak dinilai seperti toko yang seharusnya memiliki tempat usaha.
Pemeriksaan penagihan untuk kunjungan dan pemantauan portofolio
Untuk memantau portofolio, simpan ID tempat sejak pendaftaran dan gunakan kembali untuk memeriksa status terkini usaha serta apakah lokasinya sudah pindah. Pemrosesan batch dapat digunakan untuk pemeriksaan portofolio ini dan untuk praskoring portofolio nasabah. Hasilnya menunjukkan kondisi saat ini, bukan tren rating. Untuk mengetahui tren, rating sebelumnya perlu disimpan, tetapi ketentuan penggunaan tidak mengizinkannya.
Sebelum mengunjungi usaha yang menunggak, periksa apakah usaha tersebut masih beroperasi di alamat itu dan apakah lokasinya sudah pindah. businessStatus membantu menentukan apakah kunjungan masih relevan, movedPlaceId menunjukkan tempat yang perlu diperiksa berikutnya, dan currentOpeningHours membantu merencanakan waktu kunjungan untuk tujuh hari berikutnya. Jika aturan Places tidak dapat menyelesaikan kasus, kasus dapat dilanjutkan melalui manajemen kasus dengan peninjauan oleh petugas atau tugas untuk memperoleh data eksternal.
Tabel keputusan berikut merupakan contoh buatan, bukan hasil dari Places. Hasilnya adalah contoh keputusan yang dapat ditetapkan pemberi pinjaman, bukan rekomendasi. Aturan dalam tabel dijalankan berdasarkan urutan, dan baris pertama yang cocok akan digunakan:
| Baris | Kondisi | Contoh keputusan |
|---|---|---|
| 1 | businessStatus bernilai CLOSED_PERMANENTLY | Decline |
| 2 | businessStatus bernilai CLOSED_TEMPORARILY atau FUTURE_OPENING | Refer: usaha tutup sementara atau belum buka |
| 3 | pureServiceAreaBusiness bernilai true | Lanjut ke pemeriksaan berikutnya |
| 4 | Tempat tidak ditemukan, atau types-nya tidak memuat establishment | Refer: tidak ada kegiatan usaha di alamat tersebut |
| 5 | rating atau userRatingCount tidak tersedia | Refer: tidak ada aktivitas publik di Google |
| 6 | userRatingCount kurang dari 10 | Refer: aktivitas publik masih sedikit |
| 7 | primaryType berbeda dari bidang usaha yang dinyatakan | Refer: jenis usaha tidak cocok |
| 8 | Nilai lainnya | Lanjut ke pemeriksaan berikutnya |
Baris untuk nilai yang tidak tersedia ditempatkan sebelum baris perbandingan jumlah ulasan karena kolom yang kosong dapat berarti kolom itu tidak diminta, Google tidak memiliki nilainya, atau permintaan mengalami timeout. Pengujian terpisah pada decision engine dengan tabel keputusan pada 2026-10-03 menunjukkan risikonya: baris yang menyetujui rasio utang terhadap pendapatan antara 0 dan 35 juga menyetujui pemohon yang tidak memberikan nilai rasio tersebut. Perbandingan angka dapat membaca jumlah yang tidak tersedia sebagai nol, lalu mengarahkan pengajuan ke aturan yang seharusnya hanya berlaku untuk jumlah rendah. Baris 3 ditempatkan sebelum baris 4 hingga 7 agar tukang ledeng yang tidak memiliki toko maupun ulasan tidak dirujuk hanya karena kedua hal tersebut tidak ada.
API key Google Places untuk Places API (New)
API key Google Places adalah rangkaian karakter unik berupa huruf dan angka yang menghubungkan setiap permintaan dengan project Google Cloud dan akun penagihannya. Sebelum menggunakannya, aktifkan penagihan untuk project tersebut dan aktifkan Places API (New).
- Gunakan project Google Cloud dengan penagihan aktif.
- Aktifkan Places API (New) untuk project melalui konsol Google Cloud, atau jalankan
gcloud services enable "places.googleapis.com". Tunggu beberapa menit sebelum mengirim permintaan pertama. - Di halaman Google Maps Platform Keys & Credentials, pilih Create credentials, lalu API key. Di API restrictions, biarkan hanya Places API (New) yang dipilih dan hapus pilihan lainnya. Memilih API di sini tidak mengaktifkannya.
- Tambahkan pembatasan aplikasi, misalnya alamat IP server yang mengirim permintaan dengan key tersebut. Key tanpa pembatasan dapat digunakan untuk memanggil layanan Google Maps Platform apa pun, dan pemilik akunnya akan menanggung biaya penyalahgunaan.
- Kirim key melalui HTTPS di header
X-Goog-Api-Key, lalu cantumkan kolom yang ingin dikembalikan diX-Goog-FieldMask, seperti pada permintaan berikut.
curl -X POST -d '{
"textQuery" : "Bar Italia, 22 Frith Street, London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.primaryType' \
'https://places.googleapis.com/v1/places:searchText'
Pada 30 October 2026, permintaan tanpa key menghasilkan HTTP 403 dengan status PERMISSION_DENIED: “Method doesn't allow unregistered callers (callers without established identity). Please use API Key or other form of API consumer identity to call this API.” Tambahkan header key. Key yang kedaluwarsa menghasilkan HTTP 400 dengan status INVALID_ARGUMENT dan alasan API_KEY_INVALID: “API key expired. Please renew the API key.”
Places API (New) berbeda dari Places API (Legacy). Aktifkan Places API (New) untuk project dan tambahkan ke key. Jika aplikasi menggunakan keduanya, Google menyarankan penggunaan key terpisah untuk masing-masing API. Places API (New) hanya mengembalikan JSON, dan Text Search (New) mewajibkan field mask.
Ketentuan Google memengaruhi penyiapan Places API
Ketentuan Google Maps Platform membatasi penyimpanan informasi tempat secara umum. Ketentuannya menyatakan:
“Customer will not cache Google Maps Content except as expressly permitted under the Maps Service Specific Terms.”
Ketentuan khusus layanan memperbolehkan penyimpanan ID tempat dan penyimpanan sementara lintang serta bujur hingga 30 hari kalender berturut-turut. Setelah itu, koordinat harus dihapus. Ketentuan tersebut juga membatasi penggunaan Google Maps Content untuk meningkatkan model machine learning atau kecerdasan buatan, serta penggunaan konten Places API dengan peta non-Google. Penggunaan tanpa peta diperbolehkan.
Pembatasan kredit tersendiri berlaku untuk keputusan terkait individu yang melibatkan Places Aggregate API, produk yang berbeda. Penasihat hukum Anda dapat menilai bagaimana klausul tersebut berlaku terhadap penggunaan Places API. Ketentuannya menyatakan:
“directly or indirectly results in any decisions, scoring, or assessments” tentang seseorang terkait kredit.
Di Decisimo, simpan key Places di Credentials dan arahkan data source ke key tersebut. Atur Text Search (New) sebagai data source JSON POST dengan field mask. Panggilan pertama menggunakan field Pro dapat menangani pemeriksaan awal fraud dan keberadaan usaha. Untuk aplikasi yang lolos, panggilan kedua dapat meminta field Enterprise menggunakan place ID dari panggilan pertama untuk mencari detailnya. Cache dinonaktifkan secara default. Jika Anda mengaktifkannya untuk suatu tugas keputusan, tujuan penyimpanannya harus dimiliki pelanggan. Data source dalam tugas yang sama berjalan secara paralel. Data source yang membutuhkan lebih dari 15 detik akan mengalami timeout, sementara engine tetap berjalan.
AI Assistant dapat mengusulkan konfigurasi sumber data berdasarkan deskripsi API dan meminta kunci untuk Credentials. Seseorang dapat menerapkan usulan tersebut untuk mengisi formulir, dan tindakan itu tidak menyimpannya. Pilihan field dan caching tetap harus mengikuti ketentuan.
Pertanyaan yang sering diajukan tentang pemeriksaan Places API
Seberapa akurat data Google Places tentang status usaha, jenis tempat, dan jam operasional?
Google tidak menerbitkan angka akurasi atau cakupan per negara untuk status usaha, jenis tempat, atau jam operasional. Google juga tidak menjelaskan seberapa cepat penutupan usaha tercatat di businessStatus. Bukti yang tersedia di sini tidak menunjukkan bahwa rating, jumlah ulasan, atau pesaing di sekitar dapat memprediksi pembayaran kembali atau kerugian.
Apakah pengajuan harus ditolak jika jenis tempat tidak cocok?
Tidak. Jadikan ketidakcocokan sebagai alasan bagi petugas untuk meninjau kasus, bukan sebagai keputusan akhir tentang usaha tersebut.
Bagaimana jika Google tidak memberikan jenis utama?
Jadikan jenis yang tidak tersedia sebagai hal yang perlu ditinjau. Tempat mungkin tidak memiliki jenis utama yang didukung, sehingga ketiadaan jenis tersebut saja belum cukup untuk memutuskan pengajuan.
Apa manfaat jumlah ulasan saat menilai rating?
Jumlah ulasan menunjukkan seberapa banyak aktivitas publik yang mendasari rating. Rating 5.0 dari tiga ulasan dan 4.2 dari delapan ratus ulasan mencerminkan jumlah aktivitas publik yang sangat berbeda.