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[¶m_name=value]
A continuación, se muestran varias tareas comunes de Vínculos directos de Waze.
Navegar a la ubicación
Para navegar a una ubicación específica:
- 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.
- Haz clic en el ícono para compartir en la esquina inferior derecha del mapa.
- 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
Navegar a favoritos
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
Búsqueda
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":
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>