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 über eine andere mobile Anwendung oder eine mobile Webseite zugegriffen werden.

Die Basis-URL für Waze-Deeplinks ist:

https://waze.com/ul

Die Waze App kann dann eine Adresse suchen, eine Adresse auf der Karte markieren oder eine Navigationssitzung zu einer Adresse oder einem Ziel starten. Das hängt davon ab, 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:

  • Desktop: 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 sicher sind, dass die Waze App installiert ist, können Sie die URL „waze://“ für die App-zu-App-Kommunikation ohne die Weboberfläche verwenden. Diese URL 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

Mit der folgenden URL können Sie Waze mit Parametern aus einer Drittanbieter-App, einer E‑Mail, einer SMS, einem Link auf einer Webseite oder einer anderen Quelle starten.

Für Waze-Deeplinks wird die folgende URL verwendet:

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

Im Folgenden sind einige häufige Aufgaben für Waze-Deeplinks aufgeführt.

So navigieren Sie zu einem bestimmten Standort:

  1. Öffnen Sie die Waze-Echtzeitkarte und suchen Sie nach Ihrem Standort. Geben Sie dazu entweder etwas in das Suchfeld ein oder zoomen Sie heran und klicken Sie auf ein bestimmtes Segment der Karte.
  2. Klicken Sie rechts unten auf der Karte auf das Freigabesymbol .
  3. Ein Dialogfeld wird angezeigt. Klicken Sie auf Wegbeschreibung teilen und kopieren Sie den Link.

Beispiel

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

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

Sie können zu den folgenden Favoriten navigieren, die in der Waze App gespeichert sind:

  • work
  • home

Verwenden Sie die folgende URL, um zu einem bestimmten Favoriten zu navigieren:

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

Im folgenden Beispiel wird das Ziel auf „work“ festgelegt:

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

Suchen Sie mit der folgenden Syntax nach einer Adresse:

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

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

Im folgenden Beispiel wird nach „Kastanienallee 66“ gesucht:

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

Auf der Karte anzeigen

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

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

Der Mindestwert für magnification_level ist 6 (nächste oder höchste Vergrößerung). Der Höchstwert für magnification_level ist 8192 (am weitesten entfernt oder geringste Vergrößerung).

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, indem Sie die Name-Wert-Paare mit einem „&“ trennen. In den folgenden Beispielen wird gezeigt, wie Sie Kombinationen der Parameter verwenden:

  • 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 navigieren dann zu dieser Adresse:

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

`utm_source` einfügen

Wenn Sie in Ihrer Implementierung utm_source einfügen, können wir die Nutzung bestimmten Partnern zuordnen. Wenn ein Problem auftritt, das sich auf die Integration auswirkt, können wir uns über utm_source an den Partner wenden und ihm eine bessere Partnererfahrung bieten. Weitere Informationen finden Sie im iOS-Beispiel. Bei Fragen können Sie sich jederzeit an uns wenden.

Beispiele

In diesem Abschnitt finden Sie Beispiele für die Verwendung der Waze-Deeplinks API auf den Android- und iOS-Plattformen.

Android-Beispiel

Das folgende Codebeispiel startet Waze, um nach dem 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);
}

iOS-Beispiel

Das folgende Codebeispiel navigiert zu den Breiten- und Längengraden, wenn Waze installiert ist. Andernfalls wird der App Store geöffnet, 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"]];
  }
}

Wenn Sie mit dem iOS SDK 9.0 und höher kompilieren, müssen Sie die Property List Datei Ihrer Anwendung mit dem Folgenden aktualisieren, um Waze einzufügen:

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