Ada versi yang lebih baru dari dokumen ini dengan contoh cara menggunakan Places API dan Routes API baru.
Biasanya, saat pengguna berkendara ke lokasi menarik (POI), mereka sebenarnya memerlukan navigasi ke lokasi terdekat seperti tempat parkir atau titik akses. Bayangkan pengemudi yang perlu pergi ke bandara atau pusat belanja. Saat menuju bandara, pengemudi mencoba mencapai terminal atau titik penurunan penumpang, bukan ke pusat kompleks bandara. Demikian pula, lahan parkir di samping pusat perbelanjaan mungkin merupakan opsi yang jauh lebih baik bagi pengguna yang memiliki mobil. Dalam hal ini, saat mengembangkan aplikasi atau layanan untuk memandu pengemudi, temukan lokasi yang akan dituju terlebih dahulu, lalu tawarkan tujuan opsional kepada pengemudi di dekat lokasi tersebut. Pendekatan ini memungkinkan Anda memberikan layanan yang lebih baik kepada pelanggan dan menunjukkan bahwa Anda menghargai waktu mereka, dengan upaya pengembangan yang kecil tetapi cerdas yang memanfaatkan data lokasi yang disediakan oleh Google Maps Platform.
Tampilan sederhana sistem yang terlibat saat memandu pengemudi ke lokasi dengan mobil
Kami akan menunjukkan cara menggunakan Places API dan Directions API secara berurutan atau kombinasi untuk mengidentifikasi lokasi yang tepat untuk parkir di dekat tujuan Anda. Solusi ini bertujuan untuk menghilangkan ketidakpastian dan beberapa interaksi untuk menemukan tempat parkir saat mengemudi setelah lebih dekat ke tujuan akhir. Mari kita lihat dua contoh cara penerapan kasus ini secara mendetail.
Contoh 1 - objek wisata tanpa tempat parkir
Mari kita pilih lokasi yang tidak terhubung langsung ke tepi jalan sehingga rute harus diambil secara terpisah, tujuan adalah Notre Dame di Paris, dan sebagai titik awal, mari kita gunakan stasiun kereta api Gare de l'Est (48.87697775149635, 2.3592247806755564).
Sopir meninggalkan stasiun sekitar 16 menit ke utara Notre Dame. Notre Dame adalah objek wisata terkenal di sebuah pulau dengan akses jembatan, beberapa jalan satu arah, dan tidak ada tempat parkir besar di dekatnya, sehingga ini akan menjadi tantangan yang menarik.
Permintaan Places API
Contoh permintaan Places API ini menggunakan “penelusuran teks” untuk menemukan Notre Dame. Lihat dokumentasi developer untuk mengetahui detailnya. “YOUR_KEY” dalam contoh ini adalah kunci API yang Anda miliki untuk Places API dan Directions API Google Maps Platform yang diaktifkan di Konsol Google Cloud. Untuk penjelasan yang lebih mendetail, lihat dokumentasi untuk memulai Google Maps Platform.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
Respons untuk permintaan di atas memberikan koordinat lintang & bujur berikut:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Seperti yang dapat Anda lihat, koordinat tersebut memang menunjukkan Notre Dame.
|
|
Sebagai developer atau penyedia layanan, sebaiknya minta driver secara otomatis untuk mencari parkir di dekat Notre Dame. Pengalaman pengguna akan berbeda-beda, bergantung pada perangkat dan layar, tetapi teks pop-up yang tidak mencolok dan hilang setelah beberapa saat mungkin patut dipertimbangkan dalam hal ini. Untuk menemukan tempat parkir di dekat Notre Dame, lakukan penelusuran teks Places API dengan parameter jenis “parking” dan radius “300” yang ditetapkan. Contoh ini akan membiaskan hasil ke area parkir dalam jarak 300 meter dari Notre Dame.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
Hasil pertama adalah “Parking Saemes Maubert-Lagrange” di 48.850591, 2.3486436. Mari kita gunakan lokasi ini di bagian berikutnya saat kita melakukan permintaan Directions API.
Permintaan Directions API
Untuk menemukan rute dari stasiun ke area parkir di dekat Notre Dame, Anda harus melakukan permintaan Directions API. Cukup tetapkan parameter asal dan tujuan. Lihat dokumentasi developer untuk opsi lainnya.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
Respons Directions API biasanya berisi beberapa saran rute. Setiap rute terdiri dari beberapa “segmen” dan segmen tersebut berisi beberapa “langkah” yang menunjukkan jarak dan koordinat perjalanan. Untuk menemukan koordinat akhir yang dapat dijangkau dengan mobil, gunakan kolom “end_location” dari langkah terakhir dari segmen terakhir dalam rute yang Anda pilih.
Lokasi ini mungkin tampak bukan pilihan pertama, tetapi saat melihat peta atau Google Street View, Anda akan menemukan bahwa lokasi ini berada dalam jarak jalan kaki yang sangat singkat, sekitar 6-7 menit, dari Notre Dame.
Rute jalan kaki dari area parkir ke Notre Dame
Ringkasan untuk contoh 1
Seperti yang dapat Anda lihat, menemukan area parkir untuk mobil hanya memerlukan beberapa panggilan API dan menampilkan saran kepada pengemudi. Hal ini menghemat waktu pengguna karena mereka tidak perlu mengemudi di jalan satu arah atau mencari tempat untuk memarkir mobil di objek wisata yang ramai. Sebagai ringkasan, kita melakukan permintaan API berikut:
- Permintaan Places API untuk menemukan koordinat Notre Dame
- Permintaan Places API untuk menemukan area parkir dalam jarak 300 meter dari koordinat tersebut
- Permintaan Directions API untuk menemukan rute ke area parkir
Contoh 2 - Memandu ke terminal di bandara besar
"types" : [ "airport", "point_of_interest", "establishment" ],
Namun, siapa pun yang pernah mengunjungi bandara besar tahu bahwa diperlukan waktu yang cukup lama untuk berpindah antar-terminal jika Anda tiba di lokasi yang salah. Dalam hal ini, karena jenis hasil penelusuran adalah “bandara”, sebaiknya ikuti kueri secara otomatis untuk menelusuri “terminal” menggunakan lokasi bandara heathrow London (51.47016927594547, -0.45432767852489075). Dalam contoh ini, Anda juga dapat melihat batasan opsional radius penelusuran 3.000 meter.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
Kueri di atas memberi kita daftar terminal dan setiap titik penjemputan di terminal tersebut. Dari daftar hasil, kita dapat menemukan “London Heathrow Airport Terminal 5” dan ID tempatnya:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Dengan parameter “place_id”, kita dapat memberi tahu Directions API bahwa kita mencoba mencapai suatu tempat, bukan beberapa koordinat arbitrer.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Sekali lagi, seperti pada contoh sebelumnya, dengan membaca semua langkah dalam respons JSON, Anda akan menemukan bagian terakhir perjalanan dan koordinat lintang & bujur lokasi akhir (51.47079979999999,-0.4896765).
Ringkasan untuk contoh 2
Seperti pada contoh sebelumnya, upaya pengembangan untuk memberikan panduan yang lebih baik kepada pengemudi sangat kecil dan manfaat penghematan waktu bagi pengemudi mudah diukur. Kami melakukan permintaan berikut:
- Permintaan Places API untuk menemukan bandara Heathrow
- Permintaan Places API untuk menemukan semua terminal yang dekat dengan koordinat bandara Heathrow
- Permintaan Directions API untuk mendapatkan rute ke terminal 5
Kesimpulan
Seperti yang dapat Anda lihat, upaya pengembangan yang diperlukan untuk memberikan layanan premium kepada pelanggan yang bepergian dengan mobil cukup kecil dan memungkinkan Anda dengan mudah menunjukkan bagaimana Anda memikirkan kebutuhan pelanggan.
Untuk tujuan pengembangan, Anda dapat menggunakan banyak library dan alat yang tersedia untuk membantu Anda mem-build layanan bagi pelanggan. Lihat repositori GitHub untuk Google Maps Platform kami yang tersedia secara publik.
Tindakan Berikutnya
Penulis utama
Mikko Toivanen | Engineer Solusi Google Maps Platform