Ada versi yang lebih baru dari dokumen ini dengan contoh cara menggunakan Places API dan Routes API baru.
Biasanya, saat berkendara ke lokasi menarik (POI), pengguna 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 memiliki 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 api 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 Konsol Google Cloud. 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 developer atau penyedia layanan, sebaiknya tanyakan secara otomatis kepada pengemudi, “Mencari tempat parkir di dekat Notre Dame?”. Pengalaman pengguna akan berbeda-beda, bergantung pada perangkat dan layar, tetapi teks pop-up kecil yang menghilang setelah beberapa saat dapat dipertimbangkan dalam kasus 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 memihak hasil ke area parkir dalam radius 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 membuat permintaan Directions API.
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 Direction 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” langkah terakhir dari segmen terakhir dalam 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 Anda karena mereka tidak perlu berkendara di jalan satu arah atau mencoba menemukan tempat untuk memarkir mobil di tempat 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 memberikan panduan yang lebih baik kepada pengemudi sangat kecil dan manfaat penghematan waktu bagi pengemudi dapat diukur dengan mudah. 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 cara Anda memikirkan kebutuhan pelanggan.
Untuk tujuan pengembangan, Anda dapat menggunakan banyak library dan alat yang tersedia untuk membantu Anda membangun layanan bagi pelanggan. Lihat repositori GitHub untuk Google Maps Platform kami yang tersedia secara publik.
Tindakan Berikutnya
Penulis utama
Mikko Toivanen | Google Maps Platform Solutions Engineer