Waze derin bağlantılarını kullanma

Waze, geliştiricilerin harici bir URL aracılığıyla Waze istemci uygulamasını veya web sayfasını açmasına olanak tanıyan bir API'yi destekler. URL'ye başka bir mobil uygulamadan veya mobil web sayfasından erişilebilir.

Waze derin bağlantılarını kullanmak için temel URL:

https://waze.com/ul

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

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

Waze'in istemci uygulaması veya web sayfası olarak açılması, 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ğilse): Waze web sayfası olarak açılır.

Waze uygulamasının yüklendiğinden eminseniz web deneyimi olmadan uygulamadan uygulamaya iletişim için "waze://" URL'sini kullanabilirsiniz. Bu, yukarıda açıklanan temel URL'nin yerine kullanılır. 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 dokunduğunda hiçbir şey olmaz.

Waze derin bağlantılarını kullanma

Waze'i üçüncü taraf bir uygulama, e-posta, SMS, web sayfası bağlantısı veya başka bir kaynaktan 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, sık kullanılan bazı Waze Deep Links görevleri verilmiştir.

Belirli bir konuma gitmek için:

  1. Waze Canlı Haritası'nı açın ve konumunuzu arayın. Arama kutusuna yazın veya haritanın belirli bir bölümünü yakınlaştırıp tıklayın.
  2. Haritanın sağ alt köşesindeki paylaş simgesini tıklayın.
  3. Bir iletişim kutusu açılır. Araba 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ı'na ortalanmıştır:

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

Waze uygulamasına kaydedilen aşağıdaki 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 hedef, iş olarak ayarlanmıştır:

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

Aşağıdaki söz dizimiyle bir adres arayın:

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

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

Aşağıdaki örnekte "Akasya Bulvarı, No 610" aranmaktadır:

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

Haritada göster

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

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

Minimum magnification_level değeri 6'dır (en yakın veya en fazla büyütme). Maksimum magnification_level değeri 8192'dir (en uzak 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ştirme

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

  • Haritayı Maryhill'in ortasına getirmek ve 10 kat yakınlaştırmak için:

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

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

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

utm_source parametresini ekleyin

Uygulamanıza bir utm_source dahil ederseniz kullanımı belirli iş ortaklarıyla ilişkilendirebiliriz. Entegrasyonu etkileyen bir sorun oluşursa utm_source iş ortağıyla iletişime geçmemize ve daha iyi bir iş ortağı deneyimi sunmamıza olanak tanır. Daha fazla bilgi için iOS örneğine bakın. Herhangi bir sorunla karşılaşırsanız bize ulaşabilirsiniz.

Örnekler

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

Android örneği

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

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

Aşağıdaki kod snippet'i örneği, Waze yüklüyse enlem/boylama gider, aksi takdirde Waze'i yüklemek için App Store'u başlatı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ümlerle derleme yaptığınızda Waze'i dahil etmek için uygulamanızın özellik listesi dosyasını aşağıdakilerle güncellemeniz gerekir:

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