Di dunia yang sadar lokasi saat ini, pengguna mengharapkan akses yang lancar ke informasi tempat, rute, dan navigasi. Baik melalui aplikasi pesan, aplikasi penemuan konteks lokal, platform logistik dan transportasi, perencana perjalanan, atau platform listingan properti, pengguna sering kali perlu melihat detail lokasi dengan cepat atau menemukan rute terbaik dari A ke B. Meskipun developer dapat membuat pengalaman dalam aplikasi mereka sendiri, memanfaatkan antarmuka Google Maps yang komprehensif dan sudah dikenal memberikan pengalaman yang lebih baik.
URL Google Maps yang terstruktur dengan baik sangat penting untuk pengalaman pengguna yang lancar. URL yang salah akan mengganggu pengalaman ini, mengarahkan pengguna ke lokasi yang salah, menampilkan tampilan peta umum, bukan detail spesifik, atau bahkan menyebabkan link rusak. Hal ini membuat pengguna frustrasi dan mencegah mereka mencapai tujuan. Misalnya, meskipun dengan URL Maps yang valid, pengguna yang mengharapkan detail tentang bisnis tertentu mungkin malah membuka tampilan peta umum tanpa informasi yang relevan. Lihat contoh di bawah ini:
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152
URL Maps ini valid untuk membuka Google Maps dan menampilkan lokasi berdasarkan garis lintang dan bujur. Namun, aplikasi ini tidak memberikan detail tentang tempat tertentu kepada pengguna.
Menghubungkan aplikasi Anda dengan Google Maps secara lancar melalui URL yang akurat
Google Maps Platform (GMP) menawarkan dua metode utama untuk membuat URL yang akurat: Places API(Baru), yang memerlukan kunci API, dan URL Maps, yang gratis dan tidak memerlukan kunci. Solusi berikut menangani berbagai skenario dan kasus penggunaan:
Menggunakan kolom googleMapsUri atau googleMapsLinks GMP Places API(Baru)
GMP Places API(Baru) menampilkan serangkaian informasi komprehensif tentang tempat tertentu. Saat meminta kolom googleMapsUri atau googleMapsLinks
(dengan menentukannya dalam masker kolom), respons API akan menyertakan objek tempat.
Objek ini berisi URL yang telah diformat sebelumnya, yang dapat digunakan untuk langsung membuka tampilan yang sesuai, seperti tampilan detail tempat, di Google Maps.
Contoh:
Permintaan Place Details
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ -H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \ https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE
Respons Place Details:
{
"googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
"googleMapsLinks": {
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
"placeUri": "https://maps.google.com/?cid=3545450935484072529",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
}
}ChIJ3S-JXmauEmsRUcIaWtf4MzE dalam contoh di atas adalah ID Tempat Sydney Opera House dalam contoh di atas. ID Tempat adalah ID tekstual yang
secara unik mengidentifikasi tempat di database Google Places dan di Google Maps.
Mengambil ID Tempat tanpa biaya
Untuk mengambil ID Tempat secara terprogram, Anda dapat menggunakan fungsi Places API: Text Search(ID Only). Ini adalah metode tanpa biaya untuk mendapatkan ID Tempat. Pelajari lebih lanjut ID Tempat, dan permintaan Place API(Baru).
Permintaan Places API Text Search(ID Only):
curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Respons Places API Text Search(ID Only):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}ID tempat juga dapat diambil saat pengguna mengklik atau mengetuk POI di peta. Cari tahu detail selengkapnya tentang ikon POI yang dapat diklik(JavaScript, Android, iOS)
Penerapan
Saat menggunakan Places API, developer dapat mengekstrak kolom googleMapsUri atau googleMapsLinks dari respons dan menggunakannya untuk meluncurkan tampilan yang sesuai di aplikasi Google Maps atau di browser jika aplikasi tidak diinstal.
| Fitur | Deskripsi |
|---|---|
| directionsUri | Link untuk membuka Google Maps guna menampilkan rute dari lokasi pengguna saat ini ke tempat ini |
| placeUri | Link untuk membuka Google Maps ke halaman detail tempat untuk tempat ini |
| writeAReviewUri | Link untuk membuka Google Maps ke halaman penulisan ulasan untuk tempat ini |
| reviewsUri | Tautan untuk membuka Google Maps ke halaman ulasan tempat ini |
| photosUri | Link untuk membuka Google Maps ke halaman foto tempat ini |
Lihat panduan developer dan coba fitur ini sekarang.
Memanfaatkan URL Maps
Dengan menggunakan URL Maps, Anda dapat membuat URL lintas platform yang universal untuk meluncurkan Google Maps dan melakukan penelusuran, mendapatkan rute dan navigasi, serta menampilkan tampilan peta dan gambar panorama. Sintaksis URL sama, terlepas dari platform yang digunakan. Anda tidak memerlukan kunci Google API untuk menggunakan URL Maps.
Tindakan peta yang tersedia adalah:
Fungsi Penelusuran meluncurkan aplikasi Google Maps atau di browser jika aplikasi tidak diinstal yang menampilkan pin untuk tempat tertentu, atau melakukan penelusuran umum dan meluncurkan peta untuk menampilkan hasilnya.
Fungsi Rute meluncurkan aplikasi Google Maps atau di browser jika aplikasi tidak diinstal yang menampilkan rute antar-titik atau mengaktifkan navigasi belokan demi belokan di Google Maps untuk perangkat seluler.
Fungsi panorama Street View memungkinkan Anda meluncurkan penampil untuk menampilkan gambar Street View sebagai panorama interaktif.
Buka dokumentasi developer URL Peta GMP untuk mempelajari lebih banyak fungsi dan contoh.
Di sini kita akan membahas dua fungsi utama URL Maps:
Menampilkan detail tempat di Google Maps: Bagian ini menjelaskan cara membuat URL yang akan menampilkan detail untuk lokasi tertentu di Google Maps. Dokumen ini juga menjelaskan cara menggunakan tempat yang memiliki nama tidak unik dengan menggunakan ID Tempat dan kueri presisi.
Memberikan Rute menggunakan URL Maps: Bagian ini menjelaskan cara membuat URL yang memberikan rute antar-lokasi, termasuk rute dengan beberapa titik jalan dan navigasi belokan demi belokan.
Menampilkan detail tempat di Google Maps
Fungsi Penelusuran memerlukan dua parameter untuk menyelesaikan penelusuran tempat, yaitu query(wajib) dan query_place_id(opsional).
Parameter query wajib ada untuk semua permintaan penelusuran. API ini menerima nama tempat, atau koordinat lintang/bujur yang dipisahkan koma, atau istilah penelusuran umum.
Struktur URL Penelusuran:
https://www.google.com/maps/search/?api=1¶meters
Skenario 1: Menampilkan detail tempat untuk nama tempat unik
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Sekarang, pertimbangkan tempat dengan nama yang tidak unik. Apa yang terjadi jika Anda hanya menelusuri dengan nama tidak unik ini? Lihat skenario berikutnya.
Skenario 2: Menelusuri tempat dengan nama tempat yang tidak unik
https://www.google.com/maps/search/?api=1&query=7-Eleven
Karena nama tempat tidak unik, URL ini akan membuka daftar lokasi 7-Eleven terdekat dalam area tampilan. Kemudian, pengguna dapat memilih toko tertentu untuk melihat detailnya.
Untuk menghindari daftar lokasi dan langsung mengakses halaman detail tertentu, Anda dapat menggunakan metode yang lebih presisi. Lihat contoh berikutnya.
Skenario 3: Menampilkan detail tempat untuk nama tempat yang tidak unik
Saat berhadapan dengan nama tempat umum, penelusuran nama sederhana sering kali menampilkan daftar lokasi. Untuk menautkan langsung ke halaman detail tertentu, Anda dapat menggunakan salah satu metode berikut:
Metode 1: Menggunakan kueri presisi dengan Nama dan Alamat Tempat
https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia
Dalam URL ini, parameter query diformat sebagai nama tempat, alamat. Hal ini
membantu mempersempit penelusuran dan menautkan langsung ke lokasi yang diinginkan.
Metode 2: Menggunakan ID Tempat
ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps.
https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM
Di sini, ChIJGcmcg7ZC1moRAOacd3HoEwM adalah ID Tempat unik untuk tempat tertentu. Parameter query masih diperlukan, tetapi hanya akan digunakan jika Google Maps tidak dapat menemukan ID tempat.
Skenario 4: Menampilkan detail tempat menggunakan koordinat lintang dan bujur serta ID tempat
Dengan menggunakan ID Tempat, Google Maps akan menampilkan informasi tempat yang mendetail.
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
Mengambil ID Tempat tanpa biaya
Untuk mengambil ID Tempat secara terprogram, Anda dapat menggunakan fungsi Places API: Text Search(ID Only). Ini adalah metode tanpa biaya untuk mendapatkan ID Tempat. Pelajari lebih lanjut ID Tempat, dan permintaan Place API(Baru).
Permintaan Places API Text Search(ID Only):
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Respons Places API Text Search(ID Only):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}ID tempat juga dapat diambil saat pengguna mengklik atau mengetuk POI di peta. Cari tahu detail selengkapnya tentang ikon POI yang dapat diklik(JavaScript, Android, iOS)
Kesimpulan
Memberikan detail tempat yang akurat sangat penting untuk pengalaman yang positif. Untuk memastikan pengguna membuka halaman detail tempat yang benar, buat URL Penelusuran menggunakan salah satu format yang direkomendasikan berikut:
query=PLACE_NAME, ADDRESSquery=PLACE_NAME&query_place_id=PLACE_ID
Hindari penggunaan hanya koordinat lintang/bujur dalam parameter query jika tujuan Anda adalah menampilkan detail tempat tertentu. Format seperti
query=latitude,longitude, query=PLACE_NAME,latitude,longitude,
atau query=ADDRESS,latitude,longitude tidak akan secara konsisten mengarahkan ke halaman detail tempat yang diinginkan. Sebagai gantinya, garis lintang dan bujur lokasi akan ditampilkan.
Penelusuran kategoris menggunakan URL Maps
Dalam penelusuran kategoris, Anda memasukkan istilah penelusuran umum, dan Google Maps akan mencoba menemukan listingan yang cocok dengan kriteria Anda di dekat lokasi yang Anda tentukan. Jika tidak ada lokasi yang ditentukan, Google Maps akan mencoba menemukan listingan di sekitar lokasi Anda saat ini.
Skenario 1: Penelusuran tempat terdekat
https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Memberikan Rute menggunakan URL Maps
Fungsi Rute menampilkan jalur antara dua titik atau lebih yang ditentukan di peta, serta jarak dan waktu perjalanan. Hal ini memberi developer lebih banyak kontrol atas petunjuk yang diberikan. Dokumentasi Petunjuk Arah URL Maps GMP memberikan petunjuk mendetail tentang cara membuat URL untuk petunjuk arah yang disesuaikan.
Struktur URL Petunjuk Arah:
https://www.google.com/maps/dir/?api=1¶meters
Skenario 1: Menemukan rute terbaik dari lokasi pengguna saat ini ke tujuan
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving
URL ini akan membuka Google Maps dan menampilkan rute mengemudi dari lokasi pengguna saat ini.
Dalam URL ini, origin tidak ada. Jika origin tidak disertakan, jalur akan secara default
menuju lokasi awal yang paling relevan, seperti lokasi perangkat, jika tersedia.
Jika tidak ada, peta yang dihasilkan akan menyediakan formulir untuk memungkinkan pengguna memasukkan asal.
Nilai asal dan tujuan dapat berupa nama tempat, alamat, atau koordinat lintang/bujur yang dipisahkan koma.
travelmode adalah parameter opsional. Kolom ini menentukan metode perjalanan.
Parameter ini dapat ditetapkan sebagai:
- mengemudi
- berjalan kaki
- bersepeda
- sepeda motor
- transit
Jika tidak ada travelmode yang ditentukan, Google Maps akan menampilkan satu atau beberapa mode yang paling relevan untuk rute dan/atau preferensi pengguna yang ditentukan.
Developer juga dapat menentukan ID Tempat menggunakan parameter origin_place_id dan
destination_place_id. Menggunakan ID Tempat adalah jaminan terbaik bahwa Anda akan menautkan ke tempat yang tepat.
Mengambil ID Tempat tanpa biaya
Untuk mengambil ID Tempat secara terprogram, Anda dapat menggunakan fungsi Places API: Text Search(ID Only). Ini adalah metode tanpa biaya untuk mendapatkan ID Tempat. Pelajari lebih lanjut ID Tempat, dan permintaan Place API(Baru).
Permintaan Places API Text Search(ID Only):
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Respons Places API Text Search(ID Only):
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}ID tempat juga dapat diambil saat pengguna mengklik atau mengetuk POI di peta. Cari tahu detail selengkapnya tentang ikon POI yang dapat diklik(JavaScript, Android, iOS)
Skenario 3: Menyediakan Navigasi Belokan demi Belokan
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate
Menetapkan dir_action=navigate di URL akan meluncurkan Google Maps dalam mode navigasi belokan demi belokan jika lokasi pengguna saat ini(lokasi perangkat) tersedia dan digunakan sebagai asal (diberikan secara eksplisit atau digunakan secara implisit saat parameter asal dihilangkan). Jika tidak, pratinjau rute akan ditampilkan.
Navigasi belokan demi belokan diluncurkan saat dir_action=navigate disetel dan:
- Asal ditentukan dan dekat dengan lokasi pengguna saat ini
- Asal dihilangkan dan lokasi saat ini pengguna tersedia
Pratinjau rute diluncurkan saat:
dir_action=navigatetidak ditetapkandir_action=navigatedisetel dan asal ditentukan, dan asal tidak dekat dengan lokasi pengguna saat inidir_action=navigateditetapkan dan asal dihilangkan, serta lokasi pengguna saat ini tidak tersedia
Perhatikan bahwa navigasi tidak tersedia di semua produk Google Maps seperti Google Maps Web, dan/atau di antara semua tujuan. Dalam kasus tersebut, parameter ini akan diabaikan.
 |
 |
Kesimpulan
Dengan membuat URL Maps dengan benar, Anda dapat memastikan pengguna mendapatkan informasi yang tepat yang mereka butuhkan dengan cepat dan efisien.
Selalu tentukan tujuan, dan gunakan ID Tempat jika memungkinkan untuk akurasi yang terjamin
Jika tujuannya adalah memberikan navigasi langsung, sertakan parameter dir_action=navigate untuk memicu navigasi belokan demi belokan. Navigasi akan dimulai dari lokasi pengguna saat ini jika lokasi perangkat tersedia dan digunakan sebagai asal (ditetapkan secara eksplisit atau dihilangkan)
Memilih pendekatan yang tepat untuk aplikasi Anda
Anda memiliki dua opsi utama: memanfaatkan URL yang telah diformat sebelumnya yang disediakan oleh Places API atau membuat URL Maps secara manual di aplikasi Anda. Setiap pendekatan memiliki kelebihan dan kekurangan masing-masing.
Places API:
Kolom
googleMapsUridangoogleMapsLinksdalam respons Detail Tempat menyediakan URL siap pakai. Hal ini mengurangi waktu pengembangan dan meminimalkan risiko error dalam pemformatan URL.Memberikan lebih sedikit kontrol atas konfigurasi rute. Meskipun
googleMapsLinksmenawarkan petunjuk dasar, aplikasi ini tidak mendukung titik jalan atau penyesuaian lanjutan. Selain itu, pemicuan navigasi belokan demi belokan secara langsung relatif kurang mudah.
URL Maps:
Menawarkan fleksibilitas dan kontrol yang lebih besar. Developer dapat membuat URL untuk menampilkan detail tempat dan mengonfigurasi berbagai aspek petunjuk arah, termasuk menambahkan titik jalan, menentukan mode perjalanan, dan memulai navigasi belokan demi belokan.
Memerlukan pemahaman yang lebih mendalam tentang parameter dan struktur URL. Konstruksi manual meningkatkan potensi terjadinya error jika tidak dilakukan dengan hati-hati.
Meningkatkan kualitas URL Maps dengan parameter UTM
Untuk membantu Google lebih memahami cara developer mengintegrasikan URL Maps dan untuk memastikan performa yang optimal, sebaiknya sertakan parameter pelacakan UTM dalam pembuatan URL Anda. Dengan menambahkan parameter utm_source dan utm_campaign, Anda
memberikan data berharga yang memungkinkan kami menganalisis pola penggunaan dan meningkatkan kualitas produk URL Maps.
Untuk parameter utm_source, gunakan nama aplikasi Anda. Parameter
utm_campaign harus mencerminkan tindakan yang diinginkan pengguna, seperti
"location_sharing", "place_details_search", atau "directions_request".
Misalnya, URL dengan parameter UTM mungkin terlihat seperti ini:
https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search
Dengan menggunakan parameter ini secara konsisten, kami dapat mengidentifikasi area yang perlu ditingkatkan, memecahkan masalah dengan lebih efektif, dan pada akhirnya memberikan pengalaman yang lebih baik bagi semua pengguna.
Langkah Berikutnya
Bacaan lebih lanjut yang disarankan:
Kontributor
Penulis utama:
Teresa Qin | Google Maps Platform Solutions Engineer