Jak korzystać z precyzyjnych linków Waze

Waze obsługuje interfejs API, który umożliwia programistom otwieranie aplikacji klienckiej lub strony internetowej Waze za pomocą zewnętrznego adresu URL. Ten adres URL jest dostępny w innej aplikacji mobilnej lub na stronie mobilnej.

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

https://waze.com/ul

Aplikacja Waze może znaleźć adres, oznaczyć go na mapie lub rozpocząć sesję nawigacji pod tym adresem lub do miejsca docelowego. Zależy to od parametrów przekazywanych 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 (i jest zainstalowana aplikacja Waze): otworzy się aplikacja Waze.
  • Urządzenie mobilne (a Waze nie jest zainstalowane): Waze otwiera się jako strona internetowa.

Jeśli masz zainstalowaną aplikację Waze, możesz używać adresu URL &wat://" do komunikacji między aplikacjami bez korzystania z internetu. Zamiast podstawowego adresu URL opisanego powyżej. Tej opcji używaj tylko wtedy, gdy masz pewność, że użytkownicy mają zainstalowaną aplikację Waze. W przeciwnym razie, gdy użytkownicy klikną link, nic się nie stanie.

Używanie precyzyjnych linków Waze

Możesz użyć poniższego adresu URL, aby uruchomić Waze z parametrami z aplikacji zewnętrznej, e-maila, SMS-a, linku do strony internetowej lub innego źródła.

Precyzyjne linki Waze używają tego adresu URL:

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

Poniżej znajdziesz kilka typowych zadań Waze dotyczących precyzyjnych linków.

Aby przejść do określonej lokalizacji:

  1. Otwórz mapę na żywo Waze i znajdź swoją lokalizację. Wpisz tekst w polu wyszukiwania lub powiększ go i kliknij konkretny fragment mapy.
  2. Kliknij ikonę udostępniania w prawym dolnym rogu mapy.
  3. Otworzy się okno dialogowe. Kliknij Udostępnij trasę dojazdu, a następnie skopiuj i wklej link.

Przykład

Poniższy przykład przedstawia wyśrodkowanie mapy na Times Square w Nowym Jorku:

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

Możesz przejść do tych ulubionych miejsc zapisanych w aplikacji Waze:

  • work
  • home

Użyj tego adresu URL, aby przejść do konkretnego ulubionego miejsca:

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

Poniższy przykład pokazuje, jak działa miejsce docelowe:

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

Wyszukaj adres o tej składni:

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

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

W następnym przykładzie wpisz frazę "66 Acacia Avenue&quot:

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

Pokaż na mapie

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

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

Minimalna wartość dla parametru magnification_level to 6 (najbliższa lub większość powiększenia). Maksymalna wartość dla wartości magnification_level to 8192 (największa lub najmniejsza powiększenie).

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

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

Połącz parametry

Możesz korzystać z tych samych parametrów w tym samym adresie URL, rozdzielając pary klucz-wartość znakiem &"" W poniższych przykładach pokazujemy, jak używać ich kombinacji:

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

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

  • Aby wyszukać adres, a następnie przejść do niego, wykonaj te czynności:

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

Uwzględnij utm_source

Jeśli uwzględnisz utm_source w swojej implementacji, możemy powiązać wykorzystanie z konkretnymi partnerami. Jeśli wystąpi problem, który ma wpływ na integrację, utm_source możemy skontaktować się z partnerem i zapewnić mu lepsze wrażenia. Więcej informacji znajdziesz w przykładzie w systemie iOS. Jeśli napotkasz problemy, skontaktuj się z nami.

Przykłady

Ta sekcja zawiera przykłady korzystania z interfejsu Waze Deep Links API na platformach Android i iOS.

Przykład Androida

Ten przykładowy fragment kodu powoduje uruchomienie Waze w celu wyszukania określonej lokalizacji, jeśli aplikacja Waze jest zainstalowana. Jeśli aplikacja Waze nie jest zainstalowana, w Google Play otwiera się jej strona:

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 reklamy na iOS

Ten przykładowy fragment kodu prowadzi do Waze/Lat, jeśli aplikacja Waze jest zainstalowana. W przeciwnym razie uruchamia App Store, by 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"]];
  }
}

Po skompilowaniu pakietu SDK iOS 9.0 lub nowszego musisz zaktualizować plik listy aplikacji i umieścić w nim ten kod:

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