Cara menggunakan Deep Link Waze

Waze mendukung API yang memungkinkan developer membuka aplikasi klien atau halaman web Waze melalui URL eksternal. URL dapat diakses dari dalam aplikasi seluler atau halaman web seluler.

URL dasar untuk menggunakan Deep Link Waze adalah:

https://waze.com/ul

Aplikasi Waze kemudian dapat menemukan alamat, menandai alamat di peta, atau memulai sesi navigasi ke alamat atau tujuan, berdasarkan parameter yang Anda teruskan ke URL ini.

Cara kerja Deep Link

Apakah Waze terbuka sebagai aplikasi klien atau halaman web bergantung pada konfigurasi sistem pengguna:

  • Desktop: Waze terbuka sebagai halaman web.
  • Perangkat seluler (dan aplikasi Waze diinstal): Aplikasi Waze akan terbuka.
  • Perangkat seluler (dan Waze tidak diinstal): Waze terbuka sebagai halaman web.

Jika Anda yakin aplikasi Waze telah diinstal, Anda dapat menggunakan URL "waze://" untuk komunikasi aplikasi ke aplikasi tanpa pengalaman web. Hal ini menggantikan URL dasar yang dijelaskan di atas. Hanya gunakan opsi ini jika Anda yakin bahwa pengguna Anda telah menginstal Waze; jika tidak, jika pengguna mengetuk link, tidak akan terjadi apa-apa.

Menggunakan Deep Link Waze

Anda dapat menggunakan URL berikut untuk meluncurkan Waze dengan parameter dari aplikasi pihak ketiga, email, SMS, link halaman web, atau sumber lainnya.

Deep Link Waze menggunakan URL berikut:

https://waze.com/ul?param_name=value[&param_name=value]

Berikut adalah sejumlah tugas Deep Link Waze yang umum.

Untuk membuka lokasi tertentu:

  1. Buka Peta Langsung Waze dan telusuri lokasi Anda. Ketik di kotak penelusuran atau perbesar dan klik pada segmen tertentu di peta.
  2. Klik ikon berbagi di sudut kanan bawah peta.
  3. Dialog akan muncul. Klik Bagikan rute mobil, lalu salin dan tempelkan link.

Contoh

Contoh berikut memusatkan peta di Times Square di New York:

https://www.waze.com/ul?ll=40.75889500%2C-73.98513100&navigate=yes&zoom=17

Anda dapat bernavigasi ke favorit yang disimpan berikut di aplikasi Waze:

  • work
  • home

Gunakan URL berikut untuk menavigasi ke favorit tertentu:

https://waze.com/ul?favorite=favorite&navigate=yes

Contoh berikut menyetel tujuan agar berfungsi:

https://waze.com/ul?favorite=work&navigate=yes

Telusuri alamat dengan sintaksis berikut:

https://waze.com/ul?q=search_terms

Nilai yang Anda teruskan untuk parameter harus dienkode ke URL. Misalnya, Anda harus mengganti spasi dengan %20.

Contoh berikut menelusuri "66 Acacia Avenue":

https://waze.com/ul?q=66%20Acacia%20Avenue

Tampilkan di peta

Gunakan sintaksis berikut untuk menetapkan tingkat pembesaran peta (atau zoom) tampilan peta Waze:

https://waze.com/ul?z=magnification_level

Nilai minimum untuk magnification_level adalah 6 (terdekat atau pembesaran maksimum). Nilai maksimum untuk magnification_level adalah 8192 (pembesaran terjauh atau paling sedikit).

Contoh berikut menetapkan tingkat pembesaran ke 8:

https://waze.com/ul?z=8

Gabungkan parameter

Anda dapat menggunakan parameter bersama-sama di URL yang sama dengan memisahkan pasangan nilai-nama dengan "&". Contoh berikut menunjukkan cara menggunakan kombinasi parameter:

  • Untuk memusatkan peta di Maryhill dan memperbesarnya ke 10:

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10

  • Untuk menelusuri alamat dan kemudian menavigasi ke alamat tersebut:

    https://waze.com/ul?q=66%20Acacia%20Avenue&ll=45.6906304,-120.810983&navigate=yes

Sertakan utm_source

Jika Anda menyertakan utm_source dalam penerapan Anda, kami dapat mengaitkan penggunaan dengan partner tertentu. Jika terjadi masalah yang memengaruhi integrasi, utm_source memungkinkan kami menindaklanjutinya dengan partner dan memberi mereka pengalaman partner yang lebih baik. Untuk detail selengkapnya, lihat contoh iOS. Jika Anda mengalami masalah, jangan ragu untuk menghubungi kami.

Contoh

Bagian ini menyediakan contoh cara menggunakan Waze Deep Links API di platform Android dan iOS.

Contoh Android

Contoh cuplikan kode berikut meluncurkan Waze untuk mencari lokasi yang ditentukan, jika Waze diinstal. Jika Waze tidak diinstal, halaman Waze akan terbuka di Google Play:

try {
  // Launch Waze to look for Hawaii:
  String url = "https://waze.com/ul?q=Hawaii";
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
  startActivity(intent);
} catch (ActivityNotFoundException ex) {
  // If Waze is not installed, open it in Google Play:
  Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("market://details?id=com.waze"));
  startActivity(intent);
}

Contoh iOS

Contoh cuplikan kode berikut menavigasi ke lintang/bujur jika Waze diinstal; jika tidak, App Store akan diluncurkan untuk menginstal Waze:

- (void) navigateToLatitude:(double)latitude longitude:(double)longitude
{
  if ([[UIApplication sharedApplication]
    canOpenURL:[NSURL URLWithString:@"waze://"]]) {
      NSString *bundleIdentifier = NSBundle.mainBundle.bundleIdentifier;
      // Waze is installed. Launch Waze and start navigation
      NSString *urlStr =
        [NSString stringWithFormat:@"https://waze.com/ul?ll=%f,%f&navigate=yes&utm_source=%s",
        latitude, longitude, bundleIdentifier];
      [[UIApplication sharedApplication] openURL:[NSURL URLWithString:urlStr]];
  } else {
    // Waze is not installed. Launch AppStore to install Waze app
    [[UIApplication sharedApplication] openURL:[NSURL
      URLWithString:@"http://itunes.apple.com/us/app/id323229106"]];
  }
}

Saat mengompilasi dengan iOS SDK 9.0 dan yang lebih baru, Anda harus memperbarui file daftar properti aplikasi dengan yang berikut ini untuk menyertakan Waze:

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>waze</string>
</array>