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
Widget Tempat Maps JavaScript umum digunakan dalam alur kerja partner untuk membuat peta interaktif. Selain itu, Maps API berikut juga berguna:
- Menampilkan prediksi tempat dengan Place Autocomplete dan Place Details. Untuk mendapatkan detail harga, lihat SKU: Autocomplete (disertakan dengan Places Details) – Per Sesi.
- Kueri untuk informasi tempat dengan Place Search. Untuk mendapatkan detail harga, lihat SKU: Find Place.
- Memberikan geocoding dan geocoding terbalik alamat dengan Geocoding. Untuk mendapatkan detail harga, lihat SKU: Geocoding.
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.
Pengguna mempersempit penelusuran mereka
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.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=4&hl=id)
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.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=4&hl=id)
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.