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ı daha sonra bu URL'ye ilettiğiniz parametrelere bağlı olarak bir adresi bulabilir, haritada bir adresi 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, daha önce 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 derin bağlantı 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 dizimini kullanarak 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 8.192'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

URL parametreleri

Aşağıdaki tabloda, Waze derin bağlantıları için kullanılabilen yönlendirme parametreleri açıklanmaktadır:

Parametre Zorunlu mu? Açıklama
avoid_tolls İsteğe bağlı Ücretli geçişlerden kaçınan bir rota hesaplanıp hesaplanmayacağını belirtir. Ücretli geçişleri kullanmamak için true veya t olarak ayarlayın. Ücretli yollara izin vermek için false veya f olarak ayarlayın. Varsayılan olarak ücretli yollara izin verilir (false).
avoid_ferries İsteğe bağlı Feribotları kullanmayan bir rota hesaplanıp hesaplanmayacağını belirtir. Feribotları kullanmamak için true veya t olarak ayarlayın. Feribotlara izin vermek için false veya f olarak ayarlayın. Varsayılan olarak feribotlara izin verilir (false).
avoid_freeways İsteğe bağlı Otoyollardan kaçınan bir rota hesaplanıp hesaplanmayacağını belirtir. Otoyolları kullanmamak için true veya t olarak ayarlayın. Otoyollara izin vermek için false veya f olarak ayarlayın. Varsayılan olarak otoyollara izin verilir (false).
avoid_dangerous_turns İsteğe bağlı Tehlikeli dönüşlerden kaçınılıp kaçınılmayacağını belirtir. Tehlikeli dönüşlerden kaçınmak için true veya t olarak ayarlayın. Tehlikeli dönüşlere izin vermek için false veya f olarak ayarlayın. Varsayılan olarak tehlikeli dönüşlerden kaçınılır (true).
avoid_trails İsteğe bağlı

Asfaltsız yollar için yönlendirme tercihlerini belirtir. Desteklenen değerler:

  • avoid_all (Varsayılan): Tüm asfaltlanmamış yollardan kaçının.
  • allow: Asfaltsız yollara izin verin.
  • avoid_long: Uzun asfaltsız yollardan kaçının.
vehicle_type İsteğe bağlı

Araç türünü belirtir. Desteklenen değerler:

  • private (Varsayılan): Yolcu aracı.
  • taxi: Taksi aracı.
  • motorcycle: Motosiklet.

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>