Utilizzare Waze Deep Links

Waze supporta un'API che consente agli sviluppatori di aprire la pagina web o l'applicazione client di Waze tramite un URL esterno. Puoi accedere all'URL da un'altra app per dispositivi mobili o da una pagina web per dispositivi mobili.

L'URL di base per utilizzare Waze Deep Links è:

https://waze.com/ul

A seconda dei parametri trasmessi a questo URL, l'app di Waze può poi individuare un indirizzo, contrassegnarne uno sulla mappa o avviare una sessione di navigazione verso un indirizzo o destinazione.

Come funzionano i link diretti

Waze si apre come applicazione client o pagina web in base alla configurazione del sistema dell'utente:

  • Computer desktop: Waze si apre come pagina web.
  • Dispositivo mobile (e l'app di Waze è installata): si apre l'app di Waze.
  • Dispositivo mobile (e Waze non è installato): Waze si apre come pagina web.

Se hai la certezza di aver installato l'app di Waze, puoi comunicare da un'app all'altra senza l'esperienza sul Web utilizzando l'URL "waze://", anziché quello di base indicato sopra. Utilizza questa opzione solo se gli utenti hanno installato Waze; in caso contrario, se gli utenti toccano il link, non accadrà nulla.

Utilizzare Waze Deep Links

Puoi utilizzare il seguente URL per lanciare Waze con parametri di app di terze parti, indirizzi email, SMS, link a pagine web o altre origini.

Waze Deep Links utilizza il seguente URL:

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

Di seguito sono riportate alcune attività comuni di Waze Deep Links.

Raggiungere una località

Per raggiungere una località specifica:

  1. Apri la Live Map di Waze, cerca la tua località nella barra di ricerca o aumentando lo zoom e facendo clic su un segmento specifico della mappa.
  2. Fai clic sull'icona di condivisione nell'angolo in basso a destra della mappa.
  3. Viene visualizzata una finestra popup. Fai clic su Condividi indicazioni stradali, poi copia e incolla il link.

Esempio

Il seguente esempio centra la mappa su Times Square a New York:

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

Raggiungere i Preferiti

Puoi raggiungere i seguenti Preferiti salvati nell'app di Waze:

  • work
  • home

Utilizza il seguente URL per raggiungere un determinato luogo preferito:

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

L'esempio riportato di seguito consente di impostare la destinazione di lavoro:

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

Eseguire una ricerca

Cerca un indirizzo utilizzando la sintassi riportata di seguito.

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

I valori trasmessi per i parametri devono essere codificati come URL. Ad esempio, devi sostituire gli spazi con %20.

Il seguente esempio cerca "66 Acacia Avenue":

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

Mostrare sulla mappa

Utilizza la seguente sintassi per impostare il livello di ingrandimento, ovvero lo zoom, della mappa della visualizzazione mappa di Waze:

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

Il valore minimo di magnification_level è 6 (più vicino o ingrandimento massimo). Il valore massimo di magnification_level è 8192 (più lontano o ingrandimento minimo).

L'esempio riportato di seguito consente di impostare il livello di ingrandimento su 8:

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

Combinare i parametri

Puoi utilizzare i parametri insieme nello stesso URL separando le coppie nome/valore con una "&". I seguenti esempi mostrano come utilizzare le combinazioni dei parametri:

  • Per centrare la mappa su Maryhill ed eseguire lo zoom fino a 10:

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10
  • Per cercare un indirizzo e raggiungerlo:

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

Esempi

Questa sezione fornisce esempi di utilizzo dell'API Waze Deep Links su piattaforme Android e iOS.

Esempio per Android

Il seguente esempio di snippet di codice avvia Waze per cercare la località specificata, se Waze è installato; in caso contrario, apre la pagina Waze in 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);
}

Esempio per iOS

Il seguente esempio di snippet di codice raggiunge la latitudine/longitudine se Waze è installato; in caso contrario, avvia l'App Store per installare Waze:

- (void) navigateToLatitude:(double)latitude longitude:(double)longitude
{
  if ([[UIApplication sharedApplication]
    canOpenURL:[NSURL URLWithString:@"waze://"]]) {
      // Waze is installed. Launch Waze and start navigation
      NSString *urlStr =
        [NSString stringWithFormat:@"https://waze.com/ul?ll=%f,%f&navigate=yes",
        latitude, longitude];
      [[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"]];
  }
}

Quando esegui la compilazione con l'SDK 9.0 e versioni successive per iOS, per includere Waze, devi aggiornare il file dell'elenco delle proprietà dell'app con quanto indicato di seguito:

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