Perbarui integrasi Google Business Profile API Anda sebelum endpoint penting dinonaktifkan. Tinjau jadwal penghentian dan petunjuk untuk menghindari gangguan mulai April 2022.

Menelusuri listingan yang cocok

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

Dengan API Profil Bisnis, Anda dapat membuat platform bagi penjual agar dapat mengelola bisnis mereka di Google. Di platform tersebut, partner Anda dapat menelusuri listingan yang cocok dengan data nama, alamat, dan telepon bisnis mereka. Mereka dapat menetapkan kepemilikan lokasi, serta secara akurat menempatkan lokasi fisik bisnisnya menurut lintang dan bujur.

Sebelum memulai

Sebelum menggunakan API Profil Bisnis, Anda harus mendaftarkan aplikasi Anda dan mendapatkan kredensial OAuth 2.0. Untuk mengetahui detail cara mulai menggunakan API Profil Bisnis, lihat Penyiapan dasar.

Cara menggunakan data alamat

Untuk menggunakan data alamat dan geolokasi di platform Anda, Anda dapat menggunakan dua kumpulan API dan resource yang berbeda: API Profil Bisnis dan Maps API.

Resource Profil Bisnis yang umum digunakan

GoogleLocations API memungkinkan penjual melihat terlebih dulu apakah lokasi sudah diklaim di Profil Bisnis. Jika belum, penjual dapat segera meminta aksesnya.

Objek PostalAddress merepresentasikan alamat fisik bisnis.

Resource Google Maps yang umum digunakan

Places Widget Maps JavaScript umum digunakan dalam alur kerja partner untuk membuat peta interaktif. Selain itu, Maps API berikut juga berguna:

Satu atau nol kecocokan

Saat partner menelusuri listingan yang cocok untuk suatu lokasi, sasarannya adalah mempersempit hasil penelusurannya ke satu atau nol kecocokan. Artinya lokasi tersebut cocok dengan kriteria penelusuran mereka atau belum ada di Profil Bisnis.

Jika ada satu atau nol hasil yang cocok, gunakan metode accounts.locations.create untuk membuat listingan baru, atau ikuti panduan GoogleLocations untuk mengklaim kepemilikan listingan yang ada. Jika Google tidak dapat melakukan geocoding alamat, pembuatan lokasi akan gagal dan respons API akan mencakup permintaan untuk data LatLng. Untuk mendapatkan informasi tentang cara penjual dapat memberikan data LatLng mereka, lihat Penyesuaian manual data geolokasi.

Setelah koordinat LatLng ditentukan, listingan baru dibuat.

Kecocokan parsial dan lebih dari satu kecocokan

Saat pemilik bisnis atau tim operasi partner menelusuri listingan yang cocok dengan sebuah lokasi, informasi yang mereka masukkan mungkin hanya menampilkan hasil yang cocok sebagian, atau mereka mungkin menerima beberapa hasil yang cocok dengan kueri penelusurannya. Untuk mempersempit hasil penelusurannya ke satu atau nol hasil yang cocok, hasil yang cocok sebagian atau beberapa hasil yang cocok perlu diselesaikan secara manual dengan dua kasus penggunaan Maps API.

Saat pengguna platform partner menelusuri lokasi dan mendapatkan beberapa hasil yang cocok sebagian, mereka dapat menyelesaikan masalah ini dengan salah satu cara berikut:

  • Menganalisis alamat yang cocok sebagian dan memilih yang benar.
  • Mengedit atau mengetik ulang bagian alamat agar lebih akurat dan mempersempit hasilnya ke satu atau nol hasil yang cocok.
Pengguna mendapatkan beberapa hasil yang cocok sebagian dari penelusuran alamat mereka.

Pengguna memilih satu atau beberapa hasil yang cocok sepenuhnya

Terkadang, beberapa lokasi mungkin sepenuhnya cocok dengan alamat penelusuran pengguna. Misalnya, pengguna dapat memasukkan alamat berikut ke platform partner:

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

Misalnya hasil berikut ditampilkan, yang semuanya cocok dengan alamat yang diberikan:

  • Kasperson Printer Center, lokasi yang belum diverifikasi.
  • Bengo Seguro, lokasi yang telah diverifikasi.
  • Garush Productions, lokasi yang belum diverifikasi.

Pengguna perlu memilih bisnis yang cocok secara manual. Untuk memastikan konsumen diberi rute yang akurat ke bisnis, data lintang dan bujur (LatLng) untuk lokasi ini mungkin perlu disesuaikan agar memberikan akurasi yang lebih tinggi. Untuk mendapatkan informasi tentang cara pengguna dapat memasukkan LatLng secara manual, lihat Penyesuaian manual data geolokasi.

Penyesuaian manual data geolokasi

Bisnis dapat menambahkan koordinat lintang dan bujur (LatLng) lokasi mereka untuk meningkatkan akurasi listingannya di Profil Bisnis. Bisnis baru mungkin tidak mengetahui koordinat LatLng mereka, jadi sebagai gantinya mereka dapat secara manual menempatkan pin dengan Widget Tempat Maps JavaScript untuk menetapkan koordinat LatLng yang akurat.

Satu alamat ditetapkan ke tiga lokasi yang terpisah sejauh 1.500 kaki. Untuk secara akurat mengaitkan alamat bisnis dengan koordinat LatLng, penyesuaian manual koordinat setiap lokasi diperlukan.

Kualitas hasil penelusuran

Hasil penelusuran sangat bervariasi berdasarkan akurasi alamat yang ditelusuri untuk dan menurut wilayah geografis. Wilayah berkembang sering menunjukkan lebih sedikit tempat di Maps dan menggunakan format alamat Google secara tidak konsisten. Hal ini mengakibatkan hasil penelusuran berkualitas lebih rendah dan lebih sering memerlukan pemformatan alamat manual dan penggunaan Maps API.