Waze Derin Bağlantıları nasıl kullanılır?

Waze, geliştiricilerin Waze istemci uygulamasını ya da web sayfasını harici bir URL üzerinden açabilmelerini sağlayan bir API destekler. URL'ye başka bir mobil uygulamadan veya mobil web sayfasından erişilebilir.

Waze Derin Bağlantılarını kullanmak için gereken temel URL:

https://waze.com/ul

Ardından Waze uygulaması bir adres bulabilir, haritada bir adresi işaretleyebilir veya bu URL'ye ilettiğiniz parametrelere bağlı olarak bir adres ya da hedefe gitmek için navigasyon oturumu başlatabilir.

Derin bağlantıların işleyiş şekli

Waze'in bir istemci uygulaması olarak mı yoksa bir web sayfası olarak mı açılacağı, kullanıcının sistem yapılandırmasına bağlıdır:

  • Masaüstü: Waze web sayfası olarak açılır.
  • Mobil cihaz (ve Waze uygulaması yüklü): Waze uygulaması açılır.
  • Mobil cihaz (ve Waze yüklü değildir): Waze web sayfası olarak açılır.

Waze uygulamasının yüklü olduğundan eminseniz, web deneyimi olmadan uygulamadan uygulamaya iletişim için "waze://" URL'sini kullanabilirsiniz. Bu, yukarıda açıklanan temel URL'nin yerine geçer. Bu seçeneği yalnızca kullanıcılarınızın Waze'i yüklediğinden eminseniz kullanın. Aksi takdirde, kullanıcılar bağlantıya dokunursa hiçbir şey olmaz.

Waze Derin Bağlantılarını Kullan

Waze'i bir üçüncü taraf uygulaması, e-posta, SMS, web sayfası bağlantısı veya başka kaynaklardan gelen parametrelerle başlatmak için aşağıdaki URL'yi kullanabilirsiniz.

Waze Derin Bağlantıları aşağıdaki URL'yi kullanır:

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

Aşağıda, yaygın Waze derin bağlantıları görevlerinden birkaçı verilmiştir.

Belirli bir konuma gitmek için:

  1. Waze Live Map'i açın ve konumunuzu arayın. Arama kutusuna yazın veya yakınlaştırıp haritanın belirli bir bölümünü tıklayın.
  2. Haritanın sağ alt köşesindeki paylaş simgesini tıklayın.
  3. Bir iletişim kutusu görünür. Arabayla yol tarifini paylaş'ı tıklayın, ardından bağlantıyı kopyalayıp yapıştırın.

Örnek

Aşağıdaki örnekte, harita New York'taki Times Meydanı'nda ortalanmıştır:

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

Waze uygulamasında kayıtlı şu favorilere gidebilirsiniz:

  • work
  • home

Belirli bir favoriye gitmek için aşağıdaki URL'yi kullanın:

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

Aşağıdaki örnekte hedefi, kullanılacak şekilde ayarlayabilirsiniz:

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

Aşağıdaki söz dizimine sahip bir adresi arayın:

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

Parametreler için ilettiğiniz değerler URL olarak kodlanmalıdır. Örneğin, boşlukları %20 ile değiştirmelisiniz.

Aşağıdaki örnekte &"66 Acacia Avenue" aranır:

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

Haritada göster

Waze harita görünümünün büyütme düzeyini (ya da yakınlaştırma) ayarlamak için aşağıdaki söz dizimini kullanın:

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

magnification_level için minimum değer 6'dır (en yakın veya büyütme) Maksimum magnification_level değeri 8192'dir (en az veya en az büyütme).

Aşağıdaki örnekte büyütme düzeyi 8 olarak ayarlanmıştır:

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

Parametreleri birleştir

Ad-değer çiftlerini bir "&"; işaretiyle ayırarak parametreleri aynı URL'de birlikte kullanabilirsiniz. Aşağıdaki örneklerde, parametre kombinasyonlarının nasıl kullanılacağı gösterilmektedir:

  • Haritayı Maryhill'de ortalamak ve 10'a yakınlaştırmak için:

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

  • Bir adresi aramak ve ardından o adrese gitmek için:

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

utm_source değişkenini dahil et

Uygulamanıza bir utm_source eklerseniz kullanımı belirli iş ortaklarıyla ilişkilendirebiliriz. Entegrasyonu etkileyen bir sorun oluşursa utm_source, iş ortağıyla iletişime geçerek daha iyi bir iş ortağı deneyimi sunmamızı sağlar. Daha fazla bilgi için iOS örneğini inceleyin. Herhangi bir sorunla karşılaşırsanız bizimle iletişime geçebilirsiniz.

Örnekler

Bu bölümde, Waze Deep Links API'sinin Android ve iOS platformlarında nasıl kullanılacağına dair örnekler verilmektedir.

Android örneği

Waze yüklüyse aşağıdaki kod snippet'i örneği, belirtilen konumu aramak için Waze'i başlatır. Waze yüklü değilse Google Play'de Waze sayfasını açar:

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);
}

iOS örneği

Waze yüklüyse aşağıdaki kod snippet'i örneği lat/lon'a gider, aksi takdirde Waze'i yüklemek için App Store başlatılır:

- (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"]];
  }
}

iOS SDK 9.0 ve sonraki sürümleriyle derlediğinizde, uygulamanızın mülk listesi dosyasını Waze'i içerecek şekilde aşağıdaki şekilde güncellemeniz gerekir:

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