Cómo usar los vínculos directos de Waze

Waze admite una API que permite a los desarrolladores abrir la aplicación cliente o la página web de Waze a través de una URL externa. Se puede acceder a la URL desde otra aplicación para dispositivos móviles o desde una página web para dispositivos móviles.

La URL base para usar los vínculos directos de Waze es la siguiente:

https://waze.com/ul

La aplicación de Waze puede ubicar una dirección, marcarla en el mapa o iniciar una sesión de navegación a una dirección o destino, según los parámetros que pases a esta URL.

Cómo funcionan los vínculos directos

La posibilidad de que Waze se abra como una app cliente o como una página web depende de la configuración del sistema del usuario:

  • Computadora de escritorio: Waze se abre como una página web.
  • Dispositivo móvil (y la app de Waze instalada): Se abrirá la app de Waze.
  • Dispositivo móvil (y Waze no está instalado): Waze se abre como una página web.

Si estás seguro de que la app de Waze está instalada, puedes usar la URL "waze://" para la comunicación entre aplicaciones sin la experiencia web. Esto reemplaza la URL base descrita anteriormente. Usa esta opción solo si estás seguro de que tus usuarios tienen Waze instalado. De lo contrario, si presionan el vínculo, no sucede nada.

Usa vínculos directos de Waze

Puedes utilizar la siguiente URL para iniciar Waze con parámetros de una app, correo electrónico, SMS, vínculo de página web o cualquier otra fuente de terceros.

Los vínculos directos de Waze utilizan la siguiente URL:

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

A continuación, se muestran varias tareas comunes de Vínculos directos de Waze.

Para navegar a una ubicación específica:

  1. Abre el mapa en tiempo real de Waze y busca tu ubicación. Escriba en el cuadro de búsqueda o acérquese y haga clic en un segmento específico del mapa.
  2. Haz clic en el ícono para compartir en la esquina inferior derecha del mapa.
  3. Aparecerá un cuadro de diálogo. Haz clic en Compartir las instrucciones sobre cómo llegar y, luego, copia y pega el vínculo.

Ejemplo

El siguiente ejemplo centra el mapa en Times Square en Nueva York:

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

Puedes navegar a los siguientes favoritos guardados en la app de Waze:

  • work
  • home

Usa la siguiente URL para navegar a un favorito especificado:

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

En el siguiente ejemplo, se configura el destino a trabajar:

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

Busca una dirección con la siguiente sintaxis:

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

Los valores que pases para los parámetros deben estar codificados en URL. Por ejemplo, debes reemplazar los espacios por %20.

El siguiente ejemplo busca "66 Acacia Avenue&quot:

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

Mostrar en el mapa

Usa la siguiente sintaxis para establecer el nivel de ampliación (o zoom) de la vista de mapa de Waze:

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

El valor mínimo para magnification_level es 6 (más grande o la mayor ampliación). El valor máximo para magnification_level es 8, 192 (la mayor o la menor ampliación).

En el siguiente ejemplo, se establece el nivel de ampliación en 8:

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

Combinar parámetros

Puedes usar los parámetros juntos en la misma URL mediante la separación de los pares nombre-valor con un "". En los siguientes ejemplos, se muestra cómo usar combinaciones de los parámetros:

  • Para centrar el mapa en Maryhill y acercar a 10:

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10
  • Para buscar una dirección y, a continuación, navega a esa dirección:

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

Incluir utm_source

Si incluyes un utm_source en tu implementación, podemos asociar su uso con socios específicos. Si surge algún problema que afecte la integración, utm_source nos permitirá hacer un seguimiento con el socio y brindarle una mejor experiencia. Para obtener más detalles, consulta el ejemplo de iOS. Si tienes algún problema, comunícate con nosotros.

Ejemplos

En esta sección, se proporcionan ejemplos de cómo usar la API de vínculos directos de Waze en las plataformas iOS y Android.

Ejemplo para Android

El siguiente ejemplo de fragmento de código inicia Waze para buscar la ubicación especificada, si Waze está instalado. Si Waze no está instalado, abre la página de Waze en 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);
}

Ejemplo de iOS

El siguiente ejemplo de fragmento de código navega a lat/lon si está instalado Waze; de lo contrario, inicia App Store para instalar 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"]];
  }
}

Cuando compilas con el SDK de iOS 9.0 y versiones posteriores, debes actualizar el archivo de lista de propiedades de tu aplicación con lo siguiente para incluir Waze:

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