Waze-Deeplinks verwenden

Waze unterstützt eine API, mit der Entwickler die Waze-Clientanwendung oder ‑Webseite über eine externe URL öffnen können. Die URL kann über eine andere mobile App oder eine mobile Webseite aufgerufen werden.

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

https://waze.com/ul

Die Waze-App kann dann eine Adresse suchen, eine Adresse auf der Karte markieren oder eine Navigation 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 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 zuvor 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, E‑Mail, 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 finden Sie einige häufige Aufgaben für Waze-Deeplinks.

So rufen Sie einen bestimmten Ort auf:

  1. Öffnen Sie die Waze-Echtzeitkarte und suchen Sie nach Ihrem Standort. Geben Sie entweder Text 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 Routenbeschreibung teilen, kopieren Sie den Link und fügen Sie ihn ein.

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 „Arbeit“ 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

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 Minimalwert für magnification_level ist 6 (nächste oder höchste Vergrößerung). Der Maximalwert 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

URL-Parameter

In der folgenden Tabelle werden die Routing-Parameter beschrieben, die für Waze-Deeplinks verfügbar sind:

Parameter Erforderlich? Beschreibung
avoid_tolls Optional Gibt an, ob eine Route berechnet werden soll, auf der Mautstraßen vermieden werden. Legen Sie true oder t fest, um Mautstraßen zu vermeiden. Legen Sie dafür false oder f fest. Standardmäßig sind Mautgebühren zulässig (false).
avoid_ferries Optional Gibt an, ob eine Route berechnet werden soll, auf der Fähren vermieden werden. Legen Sie true oder t fest, um Fähren zu vermeiden. Legen Sie false oder f fest, um Fähren zuzulassen. Standardmäßig sind Fähren zulässig (false).
avoid_freeways Optional Gibt an, ob eine Route berechnet werden soll, auf der Autobahnen vermieden werden. Legen Sie true oder t fest, um Autobahnen zu vermeiden. Legen Sie false oder f fest, um Autobahnen zuzulassen. Standardmäßig sind Autobahnen zulässig (false).
avoid_dangerous_turns Optional Gibt an, ob gefährliche Abbiegungen vermieden werden sollen. Legen Sie true oder t fest, um gefährliche Abbiegungen zu vermeiden. Legen Sie false oder f fest, um gefährliche Abbiegungen zuzulassen. Standardmäßig werden gefährliche Abbiegungen vermieden (true).
avoid_trails Optional

Gibt die Routingeinstellungen für unbefestigte Straßen an. Unterstützte Werte:

  • avoid_all (Standard): Alle unbefestigten Straßen vermeiden.
  • allow: Unbefestigte Straßen zulassen.
  • avoid_long: Lange unbefestigte Straßen vermeiden.
vehicle_type Optional

Gibt den Fahrzeugtyp an. Unterstützte Werte:

  • private (Standard): Pkw.
  • taxi: Taxi.
  • motorcycle: Motorrad.

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 dorthin:

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

utm_source einschließen

Wenn Sie ein utm_source in Ihre Implementierung 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 die utm_source mit dem Partner in Verbindung setzen und ihm eine bessere Partnererfahrung bieten. Weitere Informationen finden Sie im iOS-Beispiel. Sollten Probleme auftreten, können Sie sich jederzeit an uns wenden.

Beispiele

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

Android-Beispiel

Im folgenden Code-Snippet wird Waze gestartet, um nach dem angegebenen Ort zu suchen, sofern 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 Code-Snippet-Beispiel ruft die Breiten- und Längengrade auf, 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 iOS SDK 9.0 und höher kompilieren, müssen Sie die Datei mit der Property-Liste Ihrer Anwendung mit Folgendem aktualisieren, um Waze einzubinden:

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