Referensi cepat URL Maps

Dengan URL Maps, Anda dapat membuat URL lintas platform yang universal untuk meluncurkan Google Maps guna melakukan penelusuran, mendapatkan rute dan navigasi, menampilkan tampilan peta, membuat daftar pendek tempat, atau menampilkan panorama Street View. Sintaksis URL sama di setiap platform, dan tidak memerlukan kunci API.

URL Maps: fakta penting

  • Produk: Maps URLs
  • Juga dikenal sebagai: URL Google Maps
  • Kategori: Maps
  • Platform: Skema URL
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan URL Maps

Maps URL: kapan harus menggunakannya

Gunakan URL Maps saat:

  • Anda memerlukan link dari aplikasi Android, aplikasi iOS, atau situs Anda yang membuka Google Maps untuk menelusuri tempat atau menampilkan hasil penelusuran.
  • Anda perlu membuka Google Maps dengan rute di antara titik, secara opsional dengan titik jalan, mode perjalanan, atau navigasi belokan demi belokan.
  • Anda perlu membuka Google Maps ke tampilan peta, daftar singkat tempat, atau panorama Street View tanpa menggunakan kunci API.
  • Anda memerlukan satu sintaksis URL yang berfungsi sama di Android, iOS, dan browser desktop.

Jangan gunakan URL Maps jika:

  • Anda sudah meminta Place Details dan menginginkan link Google Maps yang telah diformat sebelumnya untuk suatu tempat (kolom googleMapsUri atau googleMapsLinks). Gunakan Places API (Baru).
  • Anda memerlukan fitur khusus seluler saat meluncurkan aplikasi Google Maps; gunakan Google Maps Intents untuk Android atau Skema URL Google Maps untuk iOS.

URL Maps: penyiapan

  • Atribusi penggunaan: Tambahkan parameter kueri opsional utm_source (nama aplikasi Anda) dan utm_campaign (tindakan yang diinginkan pengguna, misalnya place_details_search) ke URL Maps.
  • Memulai: Menyiapkan URL Maps

URL Maps: kesalahan umum

  • Masalah: URL penelusuran yang hanya berisi lintang/bujur di query menampilkan pin, tetapi tidak menampilkan detail tempat di peta atau panel samping. Perbaikan: Gunakan query=PLACE_NAME,ADDRESS atau tambahkan query_place_id bersama query untuk menampilkan detail tempat tertentu. Lihat /maps/documentation/urls/get-started.
  • Masalah: Parameter ID tempat (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) tidak berfungsi sendiri. Perbaikan: Selalu sertakan parameter dasar yang cocok (query, origin, destination, atau waypoints) saat Anda meneruskan parameter ID tempat. Lihat /maps/documentation/urls/get-started.
  • Masalah: Parameter waypoints diabaikan pada produk Google Maps yang tidak mendukung titik jalan dan memiliki batas jumlah yang bergantung pada platform, dan dir_action=navigate diabaikan jika navigasi tidak tersedia. Perbaikan: Gunakan maksimal tiga titik jalan untuk link yang dibuka di browser seluler (sembilan untuk link yang dibuka di browser desktop), dan jangan bergantung pada waypoints atau dir_action=navigate yang berfungsi di setiap produk atau rute Google Maps. Lihat /maps/documentation/urls/get-started#directions-action.
  • Masalah: Maps dan Street View menggunakan endpoint @ yang sama, sehingga URL peta tanpa tindakan yang tepat mungkin tidak menampilkan peta. Perbaikan: Tetapkan map_action=map untuk tampilan peta dan map_action=pano untuk panorama Street View. Lihat /maps/documentation/urls/get-started.
  • Masalah: Jika api=1 tidak ada di URL Maps, semua parameter akan diabaikan dan Google Maps akan membuka tampilan defaultnya. Perbaikan: Sertakan api=1 di setiap URL Maps (1 adalah satu-satunya nilai yang valid). Lihat /maps/documentation/urls/get-started#forming-the-url.