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 akan memerlukan navigasi ke lokasi terdekat seperti tempat parkir atau titik akses. Bayangkan seorang pengemudi yang perlu pergi ke bandara atau pusat perbelanjaan. Saat menuju bandara, pengemudi mencoba mencapai terminal atau titik pengantaran, bukan pusat kompleks bandara. Demikian pula, tempat parkir di sebelah pusat perbelanjaan mungkin merupakan opsi yang jauh lebih baik bagi pengguna yang membawa mobil. Dalam hal ini, saat mengembangkan aplikasi atau layanan untuk memandu pengemudi, pertama-tama temukan lokasi yang akan dituju, lalu tawarkan tujuan opsional di dekat lokasi tersebut kepada pengemudi. Dengan pendekatan ini, Anda dapat 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 dari sistem yang terlibat saat memandu pengemudi ke suatu lokasi dengan mobil
Kami akan menunjukkan cara menggunakan Places API dan Directions API secara berurutan atau bersama-sama 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 berkendara lebih dekat ke tujuan akhir. Mari kita lihat dua contoh 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, tujuannya adalah Notre Dame di Paris dan sebagai titik awal, mari kita gunakan stasiun kereta Gare de l’Est (48.87697775149635, 2.3592247806755564).
Pengemudi meninggalkan stasiun sekitar 16 menit di utara Notre Dame. Notre Dame adalah daya tarik wisata terkenal di sebuah pulau dengan akses jembatan, beberapa jalan satu arah dan tidak ada tempat parkir besar di dekatnya, jadi 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 Google Cloud Console. Untuk penjelasan yang lebih mendetail, lihat dokumentasi tentang cara 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 terhadap 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 pengembang atau penyedia layanan, sebaiknya Anda secara otomatis meminta pengemudi untuk bertanya, "Mencari tempat parkir di dekat Notre Dame?". Pengalaman pengguna akan berbeda-beda, tergantung perangkat dan layar, tetapi teks pop-up yang muncul sebentar saja mungkin perlu dipertimbangkan dalam kasus ini. Untuk menemukan tempat parkir di dekat Notre Dame, lakukan pencarian teks Places API dengan tipe “parkir” dan parameter radius “300” ditetapkan. Contoh ini akan mengarahkan 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 “Parkir Saemes Maubert-Lagrange” di 48.850591, 2.3486436. Mari gunakan lokasi ini di bagian berikutnya saat kita melakukan permintaan API Directions.
Permintaan Directions API
Untuk menemukan rute dari stasiun ke area parkir di dekat Notre Dame, Anda perlu membuat 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 API Arah 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 dicapai dengan mobil, gunakan kolom “end_location” pada langkah terakhir dari bagian terakhir rute yang Anda pilih.
Lokasi ini mungkin tampak bukan pilihan pertama, tetapi saat Anda melihat peta atau Google Street View, Anda akan menemukan bahwa lokasi ini berada dalam jarak berjalan kaki yang sangat dekat, sekitar 6-7 menit, dari Notre Dame.
Rute jalan kaki dari area parkir ke Notre Dame
Ringkasan 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 berkeliling di jalan satu arah atau mencoba menemukan tempat untuk memarkir mobil di objek wisata yang ramai. Sebagai ringkasan, kami 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 perlu waktu yang cukup lama untuk berpindah antar-terminal jika Anda kebetulan tiba di lokasi yang salah. Dalam hal ini, karena jenis hasil penelusuran adalah “bandara”, maka berguna untuk menindaklanjuti kueri secara otomatis untuk menelusuri “terminal” menggunakan lokasi bandara London Heathrow (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 masing-masing titik pengantaran 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 sedang 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 dari perjalanan dan koordinat lintang & bujur lokasi akhir (51.47079979999999,-0.4896765).
Ringkasan contoh 2
Seperti pada contoh sebelumnya, upaya pengembangan untuk menyediakan panduan yang lebih baik bagi pengemudi sangat kecil dan manfaat dalam hal penghematan waktu bagi pengemudi mudah diukur. Kami melakukan permintaan berikut:
- Permintaan API Tempat untuk menemukan bandara Heathrow
- Permintaan API Tempat untuk menemukan semua terminal yang dekat dengan koordinat bandara Heathrow
- Permintaan API Arah untuk mendapatkan rute ke terminal 5
Kesimpulan
Seperti yang Anda lihat, upaya pengembangan yang dibutuhkan untuk menyediakan layanan premium kepada pelanggan Anda yang bepergian dengan mobil agak kecil dan memungkinkan Anda dengan mudah menunjukkan bagaimana Anda memikirkan kebutuhan pelanggan Anda.
Untuk tujuan pengembangan, Anda dapat menggunakan banyak library dan alat yang tersedia untuk membantu Anda membangun layanan bagi pelanggan. Lihatlah repositori GitHub kami yang tersedia untuk umum untuk Google Maps Platform.
Tindakan Berikutnya
Penulis utama
Mikko Toivanen | Insinyur Solusi Google Maps Platform