Waze-Deeplinks verwenden

Waze unterstützt eine API, mit der Entwickler die Waze-Clientanwendung oder -Webseite über eine externe URL öffnen können. Auf die URL kann von einer anderen mobilen App oder einer mobilen Webseite aus zugegriffen werden.

Die Basis-URL zur Verwendung von Waze-Deeplinks ist:

https://waze.com/ul

Die Waze-Anwendung kann dann eine Adresse suchen, eine Adresse auf der Karte markieren oder eine Navigationssitzung zu einer Adresse oder einem Ziel starten, je nachdem, welche Parameter Sie an diese URL übergeben.

Funktionsweise von Deeplinks

Ob Waze als Client-App oder als Webseite geöffnet wird, hängt von der Systemkonfiguration des Nutzers ab:

  • Computer: Waze wird als Webseite geöffnet.
  • Mobilgerät (und die Waze App ist installiert): Die Waze App wird geöffnet.
  • Mobilgerät (und Waze ist nicht installiert): Waze wird als Webseite geöffnet.

Wenn Sie sich sicher sind, dass die Waze App installiert ist, können Sie die URL „waze://“ für die App-zu-App-Kommunikation ohne Weboberfläche verwenden. Dies ersetzt die oben beschriebene Basis-URL. Verwenden Sie diese Option nur, wenn Sie sicher sind, dass Ihre Nutzer Waze installiert haben. Andernfalls passiert nichts, wenn Nutzer auf den Link tippen.

Waze-Deeplinks verwenden

Sie können die folgende URL verwenden, um Waze mit Parametern aus einer Drittanbieter-App, per E-Mail, per SMS, über einen Webseitenlink oder aus einer anderen Quelle zu starten.

Waze Deeplinks verwenden die folgende URL:

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

Nachfolgend finden Sie einige häufige Deeplink-Aufgaben in Waze.

So navigieren Sie zu einem bestimmten Ort:

  1. Öffnen Sie die Waze-Echtzeit-Karte und suchen Sie nach Ihrem Standort. Geben Sie entweder das Suchfeld ein oder zoomen Sie heran und klicken Sie auf ein bestimmtes Segment der Karte.
  2. Klicken Sie in der rechten unteren Ecke der Karte auf das Freigabesymbol .
  3. Ein Dialogfeld wird angezeigt. Klicken Sie auf Wegbeschreibung teilen, kopieren Sie den Link und fügen Sie ihn ein.

Beispiel

Im folgenden Beispiel wird die Karte auf dem Times Square in New York zentriert:

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

Sie können die folgenden Favoriten in der Waze App aufrufen:

  • work
  • home

Mit der folgenden URL können Sie einen bestimmten Favoriten aufrufen:

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

Im folgenden Beispiel wird als Ziel festgelegt:

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

Suchen Sie nach einer Adresse mit der folgenden Syntax:

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

Werte, die Sie für die Parameter übergeben, müssen URL-codiert sein. Ersetzen Sie beispielsweise Leerzeichen durch %20.

Im folgenden Beispiel wird nach &;66 Acacia Avenue" gesucht:

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

Auf Karte anzeigen

Verwenden Sie die folgende Syntax, um die Vergrößerungsstufe (oder Zoomfunktion) der Waze-Kartenansicht festzulegen:

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

Der Mindestwert für magnification_level ist 6 (am nächsten oder größte Vergrößerung). Der Höchstwert für magnification_level ist 8192 (am weitesten oder niedrigste Vergrößerungsfaktor).

Im folgenden Beispiel wird die Vergrößerungsstufe auf 8 festgelegt:

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

Parameter kombinieren

Sie können die Parameter in derselben URL verwenden. Trennen Sie dazu die Name/Wert-Paare durch ein &-Zeichen. Die folgenden Beispiele zeigen, wie Kombinationen der Parameter verwendet werden können:

  • So zentrieren Sie die Karte auf Maryhill und zoomen auf 10:

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

  • So suchen Sie nach einer Adresse und gehen dann zu dieser Adresse:

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

utm_source einschließen

Wenn du ein utm_source in deine Implementierung aufnimmst, können wir die Nutzung mit bestimmten Partnern verknüpfen. Wenn ein Problem auftritt, das sich auf die Integration auswirkt, können wir uns mit utm_source an den Partner wenden und ihm eine bessere Erfahrung bieten. Weitere Informationen findest du im Beispiel für iOS. Bei Problemen können Sie sich jederzeit an uns wenden.

Beispiele

Dieser Abschnitt enthält Beispiele für die Verwendung der Waze Deep Links API auf Android- und iOS-Plattformen.

Android-Beispiel

Im folgenden Code-Snippet-Beispiel wird Waze gestartet, um den angegebenen Standort zu suchen, wenn Waze installiert ist. Wenn Waze nicht installiert ist, wird die Waze-Seite in Google Play geöffnet:

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

Beispiel für iOS

Im folgenden Code-Snippet-Beispiel wird „lat/lon“ aufgerufen, wenn Waze installiert ist. Andernfalls wird der App Store gestartet, um Waze zu installieren:

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

Bei der Kompilierung mit dem iOS SDK 9.0 oder höher müssen Sie die Eigenschaftsliste Ihrer Anwendung so aktualisieren, dass sie Waze enthält:

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