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 mapę i kliknij konkretny segment.
  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 przykładzie poniżej ustawiamy poziom powiększenia na 8:

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

Parametry adresu URL

W tabeli poniżej znajdziesz opis parametrów routingu dostępnych w przypadku linków bezpośrednich Waze:

Parametr Wymagany? Opis
avoid_tolls Opcjonalny Określa, czy obliczyć trasę, która omija drogi płatne. Ustaw wartość true lub t, aby unikać opłat. Ustaw wartość false lub f, aby zezwolić na drogi płatne. Domyślnie opłaty są dozwolone (false).
avoid_ferries Opcjonalny Określa, czy obliczyć trasę, która omija promy. Ustaw wartość true lub t, aby unikać promów. Ustaw wartość false lub f, aby zezwolić na przeprawy promowe. Domyślnie promy są dozwolone (false).
avoid_freeways Opcjonalny Określa, czy obliczyć trasę, która omija autostrady. Ustaw wartość true lub t, aby unikać autostrad. Ustaw na false lub f, aby zezwolić na korzystanie z autostrad. Domyślnie autostrady są dozwolone (false).
avoid_dangerous_turns Opcjonalny Określa, czy należy unikać niebezpiecznych zakrętów. Ustaw na true lub t, aby uniknąć niebezpiecznych zakrętów. Ustaw wartość false lub f, aby zezwolić na niebezpieczne skręty. Domyślnie unikamy niebezpiecznych zakrętów (true).
avoid_trails Opcjonalny

Określa preferencje dotyczące wyznaczania tras po drogach nieutwardzonych lub szlakach. Obsługiwane wartości to:

  • avoid_all (domyślnie): unikaj wszystkich szlaków.
  • allow: Zezwól na szlaki.
  • avoid_long: Unikaj długich szlaków.
vehicle_type Opcjonalny

Określa typ pojazdu. Obsługiwane wartości to:

  • private (domyślnie): pojazd osobowy.
  • taxi: taksówka.
  • motorcycle: motocykl.

Łą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>