Perhatian: Postingan yang terkait dengan COVID-19 sekarang diizinkan sementara untuk jaringan gerai. Selain itu, Google Bisnisku saat ini beroperasi dengan fungsi terbatas. Pelajari perubahan produk sementara lebih lanjut.

Menelusuri listingan yang cocok

Dengan Google My Business API, 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 Google My Business API, Anda harus mendaftarkan aplikasi Anda dan mendapatkan kredensial OAuth 2.0. Untuk mendapatkan detail tentang cara memulai Google My Business API, lihat Penyiapan dasar.

Cara menggunakan data alamat

Untuk menggunakan data alamat dan geolokasi platform, Anda dapat menggunakan dua dua kumpulan API dan resource yang berbeda: Google My Business API dan Maps API.

Resource Google Bisnisku yang umum digunakan

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

Objek PostalAddress merepresentasikan alamat fisik bisnis.

Resource Google Maps yang umum digunakan

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

Satu atau nol hasil yang cocok

Saat partner menelusuri listingan yang cocok untuk lokasi, sasarannya adalah mempersempit hasil penelusuran mereka ke satu atau nol hasil yang cocok. Artinya lokasi tersebut cocok dengan kriteria penelusuran mereka atau belum ada di Google Bisnisku.

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.

Hasil yang cocok sebagian dan beberapa hasil yang cocok

Saat pemilik bisnis atau tim operasi partner menelusuri listingan yang cocok dengan 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 dari 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 Google Bisnisku. Bisnis baru mungkin tidak mengetahui koordinat LatLngmereka, jadi sebagai gantinya mereka dapat secara manual menempatkan pin dengan Widget Places JavaScript Maps 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.