Waze admite una API que permite a los desarrolladores abrir la aplicación o página web del cliente 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 un página web.
La URL base para utilizar vínculos directos de Waze es la siguiente:
https://waze.com/ul
Así, la app de Waze puede ubicar una dirección, marcarla en el mapa o iniciar de navegación a una dirección o un destino, según los parámetros que pases a esta URL.
Cómo funcionan los vínculos directos
El hecho de que Waze se abra como una app cliente o como una página web depende de la configuración del sistema que tenga el usuario:
- Computadoras: Waze se abre como una página web.
- Dispositivo móvil (y la app de Waze está instalada): Se abre la app de Waze.
- Dispositivo móvil (y Waze no está instalado): Waze se abre como una página web.
Si tienes la certeza de que la app de Waze está instalada, puedes utilizar la URL "waze://" para comunicación de app a app sin la experiencia web. Reemplaza la URL base que se describe arriba. Utiliza esta opción solo si estás seguro de que tus usuarios tienen Waze instalado. De lo contrario, si los usuarios presionan el vínculo, no sucede nada.
Cómo utilizar vínculos directos de Waze
Puedes usar la siguiente URL para iniciar Waze con parámetros desde una app, un correo electrónico, SMS o un vínculo de página web o alguna otra fuente.
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 algunas tareas comunes de los vínculos directos de Waze.
Navegar a la ubicación
Para navegar a una ubicación específica, sigue estos pasos:
- Abre el mapa en tiempo real de Waze. busca tu ubicación. Escribe en el cuadro de búsqueda o acerca la imagen y haz clic en un segmento del mapa.
- Haz clic en el ícono para compartir
en
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
En el siguiente ejemplo, se 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:
workhome
Usa la siguiente URL para navegar a un favorito específico:
https://waze.com/ul?favorite=favorite&navigate=yes
En el siguiente ejemplo, se establece el destino para que funcione:
https://waze.com/ul?favorite=work&navigate=yes
Buscar
Busca una dirección con la siguiente sintaxis:
https://waze.com/ul?q=search_terms
Los valores que pasas para los parámetros deben estar codificados en formato URL. Por ejemplo, debes reemplazar
espacios con %20.
En el siguiente ejemplo, se busca "66 Acacia Avenue":
https://waze.com/ul?q=66%20Acacia%20Avenue
Mostrar en el mapa
Usa la siguiente sintaxis para configurar el nivel de ampliación (o zoom) del mapa para la app de Waze. vista de mapa:
https://waze.com/ul?z=magnification_level
El valor mínimo para magnification_level es 6 (el más cercano o con el mayor nivel de ampliación). El valor máximo para magnification_level es 8192 (más lejano o 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 si separas 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 acercarlo a 10, sigue estos pasos:
https://waze.com/ul?ll=45.6906304,-120.810983&z=10
Para buscar una dirección y luego navegar a ella:
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 el uso con
socios específicos. Si se produce un problema que afecta la integración, utm_source
nos permite hacer un seguimiento con el socio y proporcionarle una mejor experiencia. Para ver más
consulta el ejemplo de iOS. Si te topas con
problemas, no dudes en
comunícate con nosotros.
Ejemplos
En esta sección, se proporcionan ejemplos de cómo utilizar la API de vínculos directos de Waze en iOS y Android y plataformas de Google Cloud.
Ejemplo para Android
El siguiente ejemplo de fragmento de código inicia Waze para buscar la ubicación especificada, si Waze está esté instalado. Si Waze no está instalado, se abrirá 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
En el siguiente ejemplo de fragmento de código, se navega a las coordenadas de latitud y longitud si Waze está instalado. De lo contrario, inicia la 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 realizas compilaciones con el SDK de iOS 9.0 y versiones posteriores, debes actualizar la lista de propiedades de tu aplicación. con la siguiente información para incluir a Waze:
<key>LSApplicationQueriesSchemes</key> <array> <string>waze</string> </array>