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

Waze, geliştiricilerin Waze istemci uygulamasını veya web sayfasını açmasına olanak tanıyan bir API'yi destekler Harici bir URL üzerinden. URL'ye başka bir mobil uygulamadan veya bir mobil cihazdan erişilebilir web sayfası.

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

https://waze.com/ul

Waze uygulaması daha sonra bir adresi bulabilir, haritada bir adresi işaretleyebilir veya bir adrese veya hedefe gitmek için navigasyon oturumundan çıkmanız gerekebilir. URL'yi tıklayın.

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

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

  • Masaüstü: Waze bir 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ğil): Waze web sayfası olarak açılır.

Waze uygulamasının yüklü olduğundan eminseniz "waze://" URL'sini kullanabilirsiniz şunun için: web deneyimi olmadan uygulamadan uygulamaya iletişim Bu, açıklanan temel URL'nin yerine geçer bölümünü ziyaret edin. Bu seçeneği sadece kullanıcılarınızda Waze'in yüklü olduğundan eminseniz kullanın; aksi takdirde Kullanıcılar bağlantıya dokunursa hiçbir şey olmaz.

Waze Derin Bağlantılarını Kullanın

Waze'i bir üçüncü taraf uygulamasından, e-posta, SMS, web sayfası bağlantısı veya başka bir kaynak.

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

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

Yaygın Waze Derin Bağlantı görevlerinden bazıları şunlardır:

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 belirli bir kullanıcıyı tıklayın seçmeniz gerekir.
  2. Paylaşım simgesini tıklayın. sağ alt köşesinde görebilirsiniz.
  3. Bir iletişim kutusu görüntülenir. 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ı aşağıdaki favorilere gidebilirsiniz:

  • work
  • home

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

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

Aşağıdaki örnekte hedef, çalışma olarak ayarlanmaktadır:

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 kodlanmış olmalıdır. Örneğin, %20 ile alan.

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

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

Haritada göster

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

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

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

Aşağıdaki örnekte büyütme seviyesi 8 olarak ayarlanmaktadır:

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

Parametreleri birleştir

Ad-değer çiftlerini bir "&" yazın. Aşağıdaki örneklerde parametre kombinasyonlarının nasıl kullanılacağı gösterilmektedir:

  • Maryhill'de haritayı 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 söz konusu 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 birlikte çalışır. Entegrasyonu etkileyen bir sorun oluşursa utm_source Böylece, iş ortağıyla takip edebiliyor ve ona daha iyi bir iş ortağı deneyimi sunabiliyoruz. Daha fazla iOS örneğine göz atın. Herhangi bir sorunlar için lütfen bize ulaşın.

Örnekler

Bu bölümde, Android ve iOS'te Waze Derin Bağlantılar API'sinin nasıl kullanılacağına dair örnekler verilmiştir. platformlar.

Android örneği

Aşağıdaki kod snippet'i örneği, Waze'in belirtilen konumu bulmak için Waze'i başlatır, eğer Waze yüklendi. 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

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 açar:

- (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ümleri ile derleme yaptığınızda uygulamanızın özellik listesini güncellemeniz gerekir Waze'i dahil etmek için şunları içeren bir dosya oluşturun:

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