Como usar links diretos do Waze

O Waze é compatível com uma API que permite aos desenvolvedores abrir o aplicativo cliente ou a página da Web do Waze por meio de um URL externo. O URL pode ser acessado em outro aplicativo para dispositivos móveis ou em uma página da Web para dispositivos móveis.

O URL base para usar links diretos do Waze é o seguinte:

https://waze.com/ul

O aplicativo Waze pode localizar um endereço, marcar um endereço no mapa ou iniciar uma sessão de navegação até um endereço ou destino com base nos parâmetros transmitidos a esse URL.

Como os links diretos funcionam

A configuração de sistema do usuário define se o Waze será aberto como um app cliente ou uma página da Web:

  • Computador: o Waze será aberto como uma página da Web.
  • Dispositivo móvel (e o app Waze está instalado): o app Waze é aberto.
  • Dispositivo móvel (e o Waze não está instalado): o Waze será aberto como uma página da Web.

Se você tiver certeza de que o app Waze está instalado, poderá usar o URL "waze://" para iniciar uma comunicação entre apps sem a experiência na Web. Ele substitui o URL base descrito acima. Use essa opção somente se tiver certeza de que os usuários têm o Waze instalado. Caso contrário, se os usuários tocarem no link, nada vai acontecer.

Usar links diretos do Waze

Use o URL abaixo para iniciar o Waze com parâmetros de um app de terceiros, e-mail, SMS, link da página da Web ou outra fonte.

Os links diretos do Waze usam o seguinte URL:

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

Confira a seguir algumas tarefas comuns de links diretos do Waze.

Para navegar até um local específico:

  1. Abra o mapa ao vivo do Waze e pesquise seu local. Digite na caixa de pesquisa ou aumente o zoom e clique em um segmento específico do mapa.
  2. Clique no ícone de compartilhamento no canto inferior direito do mapa.
  3. Uma caixa de diálogo será exibida. Clique em Compartilhar percurso e copie e cole o link.

Exemplo

O exemplo a seguir centraliza o mapa na Times Square, em Nova York:

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

Você pode navegar até os seguintes favoritos salvos no app Waze:

  • work
  • home

Use o seguinte URL para navegar até um local favorito especificado:

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

O exemplo a seguir define a meta como "trabalho":

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

Pesquise um endereço com a seguinte sintaxe:

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

Os valores transmitidos para os parâmetros precisam ter codificação de URL. Por exemplo, você precisa substituir espaços por %20.

O exemplo a seguir pesquisa "66 Acacia Avenue":

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

Mostrar no mapa

Use a sintaxe a seguir para definir o nível de ampliação (ou zoom) da visualização do mapa do Waze:

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

O valor mínimo de magnification_level é 6 (mais próximo ou maior ampliação). O valor máximo de magnification_level é 8.192 (mais distante ou menor ampliação).

O exemplo a seguir define o nível de ampliação como 8:

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

Combinar parâmetros

É possível usar os parâmetros juntos no mesmo URL separando os pares nome/valor com "&". Os exemplos a seguir mostram como usar combinações de parâmetros:

  • Para centralizar o mapa em Maryhill e ampliar o zoom para 10:

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

  • Para procurar um endereço e, em seguida, navegar até ele, faça o seguinte:

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

Incluir utm_source

Se você incluir um utm_source na implementação, poderemos associar o uso a parceiros específicos. Se ocorrer um problema que afete a integração, o utm_source vai permitir que entremos em contato com o parceiro e ofereçamos uma experiência melhor. Para mais detalhes, consulte o exemplo do iOS. Se você tiver algum problema, entre em contato conosco.

Exemplos

Esta seção fornece exemplos de como usar a API Waze Deep Links nas plataformas Android e iOS.

Exemplo do Android

O exemplo de snippet de código abaixo inicia o Waze para procurar o local especificado, se ele estiver instalado. Se o Waze não estiver instalado, a página do Waze no Google Play será aberta:

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

Exemplo do iOS

O exemplo de snippet de código a seguir navega para lat/lon se o Waze estiver instalado. Caso contrário, ele abre a App Store para instalar o 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"]];
  }
}

Ao compilar com o iOS SDK 9.0 e versões mais recentes, será necessário atualizar o arquivo de lista de propriedades do seu aplicativo com o seguinte para incluir o Waze:

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