Jak korzystać z precyzyjnych linków Waze

Waze obsługuje interfejs API, który umożliwia deweloperom otwieranie aplikacji klienckiej Waze lub strony internetowej za pomocą zewnętrznego adresu URL. Dostęp do adresu URL można uzyskać z innej aplikacji mobilnej lub mobilnej strony internetowej.

Podstawowy adres URL do korzystania z precyzyjnych linków Waze to:

https://waze.com/ul

Aplikacja Waze może następnie zlokalizować adres, zaznaczyć go na mapie lub rozpocząć sesję nawigacji do adresu lub miejsca docelowego na podstawie parametrów przekazanych do tego adresu URL.

Jak działają precyzyjne linki

To, czy Waze otworzy się jako aplikacja kliencka czy strona internetowa, zależy od konfiguracji systemu użytkownika:

  • Komputer: Waze otwiera się jako strona internetowa.
  • Urządzenie mobilne (z zainstalowaną aplikacją Waze): otwiera się aplikacja Waze.
  • Urządzenie mobilne (bez zainstalowanej aplikacji Waze): Waze otworzy się jako strona internetowa.

Jeśli masz pewność, że aplikacja Waze jest zainstalowana, możesz użyć adresu URL „waze://” do komunikacji między aplikacjami bez korzystania z internetu. Zastępuje on podstawowy adres URL opisany powyżej. Używaj tej opcji tylko wtedy, gdy masz pewność, że użytkownicy mają zainstalowaną aplikację Waze. W przeciwnym razie po kliknięciu linku nic się nie stanie.

Korzystanie z precyzyjnych linków Waze

Aby uruchomić Waze z parametrami z aplikacji innej firmy, e-maila, SMS-a, linku na stronie internetowej lub innego źródła, możesz użyć tego adresu URL.

Precyzyjne linki Waze korzystają z tego adresu URL:

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

Poniżej znajdziesz kilka typowych zadań związanych z linkami bezpośrednimi Waze.

Aby przejść do konkretnej lokalizacji:

  1. Otwórz mapę na żywo Waze i wyszukaj swoją lokalizację. Wpisz tekst w polu wyszukiwania lub powiększ widok i kliknij konkretny segment mapy.
  2. W prawym dolnym rogu mapy kliknij ikonę udostępniania .
  3. Pojawi się okno. Kliknij Udostępnij wskazówki dojazdu, a następnie skopiuj i wklej link.

Przykład

Ten przykład wyśrodkowuje mapę na Times Square w Nowym Jorku:

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

Możesz wyznaczyć trasę dojazdu do tych ulubionych miejsc zapisanych w aplikacji Waze:

  • work
  • home

Aby przejść do określonego ulubionego miejsca, użyj tego adresu URL:

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

W tym przykładzie miejsce docelowe jest ustawione na działające:

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

Wyszukaj adres, używając tej składni:

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

Wartości przekazywane w parametrach muszą być zakodowane na potrzeby adresu URL. Musisz na przykład zastąpić spacje znakiem %20.

W tym przykładzie wyszukiwane jest hasło „ul. Akacjowa 66”:

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

Pokaż na mapie

Aby ustawić poziom powiększenia (lub zoom) widoku mapy Waze, użyj tej składni:

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

Minimalna wartość dla magnification_level to 6 (najbliższe lub największe powiększenie). Maksymalna wartość dla magnification_level to 8192 (najdalsze oddalenie lub najmniejsze powiększenie).

W tym przykładzie poziom powiększenia jest ustawiony na 8:

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

Łączenie parametrów

Możesz używać tych parametrów razem w tym samym adresie URL, oddzielając pary nazwa–wartość znakiem „&”. Poniższe przykłady pokazują, jak używać kombinacji parametrów:

  • Aby wyśrodkować mapę na Maryhill i powiększyć ją do poziomu 10:

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

  • Aby wyszukać adres, a potem do niego dojechać:

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

Uwzględnij utm_source

Jeśli w implementacji umieścisz znak utm_source, będziemy mogli powiązać użycie z konkretnymi partnerami. Jeśli wystąpi problem, który ma wpływ na integrację, utm_source umożliwia nam skontaktowanie się z partnerem i zapewnienie mu lepszej obsługi. Więcej informacji znajdziesz w przykładzie dla iOS. Jeśli napotkasz jakiekolwiek problemy, skontaktuj się z nami.

Przykłady

W tej sekcji znajdziesz przykłady użycia interfejsu Waze Deep Links API na platformach Android i iOS.

Przykład na Androida

Poniższy przykładowy fragment kodu uruchamia Waze w celu wyszukania określonej lokalizacji, jeśli Waze jest zainstalowana. Jeśli Waze nie jest zainstalowana, otworzy się strona Waze w Google Play:

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

Przykład na iOS

Ten przykładowy fragment kodu przekierowuje do współrzędnych geograficznych, jeśli aplikacja Waze jest zainstalowana. W przeciwnym razie otwiera App Store, aby zainstalować Waze:

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

Jeśli kompilujesz aplikację za pomocą pakietu iOS SDK w wersji 9.0 lub nowszej, musisz zaktualizować plik listy właściwości aplikacji, aby uwzględnić Waze:

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