Panduan penerapan Transaksi yang Diperkaya

Ringkasan

web iOS API

Google Maps Platform tersedia untuk web (JS, TS), Android, dan iOS, sekaligus menawarkan API layanan web untuk mendapatkan informasi tentang tempat, rute, dan jarak. Panduan ini hanya mencantumkan contoh untuk satu platform, tetapi link dokumentasi disediakan untuk penerapan pada platform lainnya.

Pernyataan transaksi sering kali sulit dipahami oleh pengguna, misalnya menggunakan singkatan seperti “ACMEHCORP”, bukan nama penjual seperti “Acme Houseware”, yang dapat menyebabkan peningkatan panggilan dukungan pelanggan dan sengketa yang mahal. Transaksi yang Diperkaya menyederhanakan transaksi ini dan membuatnya intuitif dengan memberikan nama lengkap penjual dan kategori bisnis, foto muka bangunan, alamat dan lokasi penjual pada peta, info kontak lengkap, dan lainnya. Solusi ini membantu meningkatkan transparansi dan kepuasan pengguna, serta dapat mengurangi panggilan dukungan pelanggan, menaikkan NPS, dan meningkatkan waktu yang dihabiskan dalam aplikasi.

Transaksi yang Diperkaya—yang panduan penerapan dan tips penyesuaiannya kami sediakan dalam topik ini—adalah solusi yang kami rekomendasikan sebagai kombinasi optimal dari berbagai API Google Maps Platform untuk membangun pengalaman histori transaksi yang memuaskan bagi pengguna. Panduan penerapan ini akan menunjukkan cara mencocokkan lokasi dengan penjual tertentu dan menampilkan informasi mendetail tentang penjual tersebut.

Layar contoh transaksi yang diperkaya
Layar contoh transaksi yang diperkaya (klik untuk memperbesar)

Mengaktifkan API

Untuk menerapkan Transaksi yang Diperkaya, Anda harus mengaktifkan API berikut di Konsol Google Cloud. Hyperlink berikut mengarahkan Anda ke Konsol Google Cloud untuk mengaktifkan setiap API untuk project yang dipilih:

Untuk informasi selengkapnya tentang penyiapan, lihat Memulai Google Maps Platform.

Bagian panduan penerapan

Berikut adalah penerapan dan penyesuaian yang akan kami bahas dalam topik ini.

  • Ikon tanda centang adalah langkah penerapan inti.
  • Ikon bintang adalah penyesuaian yang opsional, tetapi direkomendasikan untuk menyoroti solusi.
Mencocokkan penjual melalui Google Maps Platform Mengaitkan penjual dalam histori transaksi dengan tempat di Google Maps Platform.
Menampilkan detail penjual Tampilkan transaksi dengan data lengkap yang menunjukkan informasi berguna tentang penjual, sehingga pengguna dapat mengenali transaksi dengan cepat.
Menambahkan peta lokasi penjual Tambahkan peta lokasi penjual.

Mencocokkan penjual melalui Google Maps Platform

Contoh ini menggunakan: Places API

Diagram berikut menunjukkan cara aplikasi Anda mencocokkan transaksi penjual untuk menampilkan hasil menggunakan Place Details dari database penjual yang ada atau melalui permintaan Place Search:

Matriks alur pencocokan penjual
Matriks alur pencocokan penjual (klik untuk memperbesar)

Mendapatkan ID tempat Google Maps Platform

Anda mungkin memiliki database penjual dengan informasi dasar seperti nama bisnis dan alamatnya. Untuk mendapatkan informasi yang dimiliki Google Maps Platform tentang tempat tersebut, termasuk informasi kontak dan informasi dari pengguna, Anda memerlukan ID tempat Google Maps Platform yang sesuai dengan setiap penjual di database Anda.

Agar dapat memperoleh ID tempat untuk bisnis, buat permintaan ke endpoint /findplacefromtext di Places API dan minta hanya kolom place_id untuk menagih permintaan sebagai panggilan Find Place - ID only tanpa biaya. Jika penjual memiliki beberapa lokasi, gunakan nama penjual bersama nama kota atau jalan. Kualitas data yang ditampilkan oleh panggilan akan bervariasi, sehingga Anda perlu memvalidasi apakah hasil yang ditampilkan benar-benar cocok dengan penjual yang diinginkan.

Berikut adalah contoh permintaan ID tempat untuk kantor Google Taipei menggunakan nama penjual dan kota:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Pastikan untuk mengenkode parameter input di permintaan API ke URL.

Menyimpan ID tempat

Untuk menyimpan informasi dari Google Maps Platform tentang penjual untuk permintaan mendatang, Anda dapat menyimpan ID tempat ini tanpa batas waktu di database sebagai atribut data penjual. Anda hanya perlu melakukan permintaan Find Place satu kali per penjual. Anda juga dapat menelusuri ID tempat setiap kali pengguna meminta detail transaksi.

Untuk memastikan Anda selalu memiliki informasi yang paling akurat, perbarui ID Tempat setiap 12 bulan menggunakan permintaan Place Details dengan parameter place_id.

Jika Place Details yang Anda tampilkan tidak cocok dengan penjual tempat pengguna melakukan transaksi, sebaiknya Anda mengizinkan pengguna memberikan masukan tentang kualitas kecocokan penjual.

Menampilkan detail penjual

Contoh ini menggunakan: Places API Juga tersedia: Places SDK for Android | Places SDK for iOS | Places Library, Maps JavaScript API

Anda dapat membagikan Place Details yang perlu diketahui pengguna setelah mereka mengunjungi salah satu lokasi Anda. Dengan Place Details yang lengkap seperti informasi kontak, jam buka, rating pengguna, dan foto pengguna, aplikasi Anda dapat mengingatkan pengguna tentang transaksi yang sudah selesai. Setelah melakukan panggilan ke Places API untuk mendapatkan Place Details, Anda dapat memfilter dan merender respons dalam jendela informasi, sidebar web, atau dengan cara lain yang Anda sukai.

Layar contoh detail penjual
Layar contoh detail penjual (klik untuk memperbesar)

Untuk meminta Place Details, Anda memerlukan ID tempat dari setiap lokasi Anda. Lihat Mendapatkan ID tempat untuk mengambil ID tempat lokasi Anda.

Permintaan Place Details berikut menampilkan alamat, koordinat, situs, nomor telepon, rating, dan jam buka dalam output json untuk ID tempat Google Taipei 101:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Menambahkan peta lokasi penjual

Contoh ini menggunakan: Geocoding API | Maps Static API Juga tersedia: Android | iOS

Menentukan lokasi penjual

Maps Static API menerima alamat atau koordinat untuk menempatkan penanda. Jika data penjual sudah memiliki alamat, Anda dapat langsung membuka bagian berikutnya, tetapi sebaiknya gunakan koordinat agar peta lebih akurat, bukan alamat.

Jika database penjual Anda memiliki alamat, tetapi tidak memiliki koordinat geografis dan Anda belum meminta Place Details, Anda dapat menggunakan Geocoding API untuk mengonversi alamat menjadi koordinat lintang/bujur di sisi server, menyimpan koordinat di database Anda, dan memperbarui koordinat setidaknya sekali setiap 30 hari.

Berikut adalah contoh penggunaan Geocoding API untuk mendapatkan lintang dan bujur ID tempat kantor Google Taipei:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Menambahkan penanda untuk lokasi penjual ke peta

Karena pengguna akan melihat peta untuk mengonfirmasi transaksi, bukan melihat-lihat atau bernavigasi, sebaiknya buat peta dengan interaktivitas terbatas.

Untuk desktop dan web seluler, buat URL Maps Static API dengan satu penanda pada lintang/bujur atau alamat penjual. Anda dapat menggunakan Maps Static API dengan menggunakan panggilan layanan web, yang akan membuat peta versi foto dengan mempertimbangkan parameter yang Anda tetapkan. Untuk perangkat seluler, langsung ke bagian berikutnya, Menambahkan peta di aplikasi seluler.

Panggilan berikut menampilkan peta jalan, dengan ukuran 640x480 piksel, yang berpusat pada penanda di kantor Google Taipei dengan tingkat zoom default. Panggilan tersebut juga menentukan penanda lokasi pengiriman berwarna merah dan gaya peta berbasis Cloud:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Ini diperinci ke dalam bagian-bagian berikut:

URL API https://maps.googleapis.com/maps/api/staticmap?
Ukuran gambar size=640x480
Penanda lokasi penjual (Menggunakan encoding URL) markers=color:red%7C25.033976%2C121.5645389
Gaya peta berbasis Cloud map_id=b224095f76859890
Kunci API key=YOUR_API_KEY
Tanda tangan digital (Pelajari cara menandatangani permintaan secara digital) signature=BASE64_SIGNATURE
Parameter saluran solusi (Lihat dokumentasi parameter) solution_channel=GMP_guides_enrichedtransactions_v1_a

Ini menjadi gambar seperti yang ditunjukkan di bawah:

Gambar peta statis Kantor Google Taipei

Anda juga dapat menggunakan alamat sebagai lokasi penanda:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Untuk opsi parameter tambahan, lihat dokumentasi Maps Static API.

Menambahkan peta di aplikasi seluler

Jika menggunakan Maps SDK for Android atau Maps SDK for iOS, Anda dapat menempatkan penanda menggunakan koordinat dari informasi di Place Details.

Karena pengguna akan melihat peta untuk mengonfirmasi transaksi, bukan melihat-lihat atau bernavigasi, pilih peta dengan interaktivitas terbatas.