Using Waze Deep Links

Waze supports an API that enables developers to open the Waze client application or web page through an external URL. The URL can be accessed from within another mobile application or a mobile web page.

The base URL to use Waze Deep Links is:

The Waze application can then locate an address, mark an address on the map, or start a navigation session to an address or destination, depending on which parameters you pass to this URL.

How Deep Links work

Whether Waze opens as a client app or a web page depends on the user's system configuration:

  • Desktop: Waze opens as a web page
  • Mobile device (and the Waze app is installed): The Waze app opens
  • Mobile device (and Waze isn’t installed): Waze opens as a web page

If you are sure that the Waze app is installed, you can use the URL "waze://" for app-to-app communication without the web experience. This is in place of the base URL described above. Please only use this option if you’re sure that your users have Waze installed; otherwise, if users tap the link, nothing will happen.

Using Waze Deep Links

You can use the following URL to launch Waze with parameters from a 3rd party app, email, SMS, web page link, or other source.

Waze Deep Links uses the following URL:[&param_name=value]

The following are a number of common Waze Deep Links tasks.

To navigate to a specific location:

  1. Open the Waze Live Map, search for your location either in the search bar or by zooming in and clicking on a specific segment of the map.
  2. Click the share icon in the bottom right corner of the map.
  3. A pop-up should appear. Click Share driving directions, copy and paste the link.


The following example centers the map on Times Square in New York:

You can navigate to the following favorites saved in the Waze app:

  • work
  • home

Use the following URL to navigate to a specified favorite:

The following example sets the destination to work:

Search for an address using the following syntax.

Values that you pass for the parameters must be URL-encoded. For example, you must replace spaces with %20.

The following example searches for "66 Acacia Avenue":

Show on map

Use the following syntax to set the map's magnification level (or zoom) of the Waze map view:

The minimum value for magnification_level is 6 (closest, or most magnification). The maximum value for magnification_level is 8192 (farthest, or least magnification).

The following example sets the magnification level to 8:

Combining parameters

You can use the parameters together in the same URL by separating the name/value pairs with an "&". The following examples show how to use combinations of the parameters:

  • To center the map on Maryhill and zoom to 10:,-120.810983&z=10
  • To search for an address and then navigate to that address:,-120.810983&navigate=yes


This section provides examples of using the Waze Deep Links API on the Android and iOS platforms.

Android example

The following code snippet example launches Waze to look for the specified location, if Waze is installed. If Waze is not installed, it opens the Waze page in Google Play:

  // Launch Waze to look for Hawaii:
  String url = "";
  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" ) );

iOS example

The following code snippet example navigates to lat/lon if Waze is installed; otherwise, it launches the App Store to install 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:@",%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

When compiling with iOS SDK 9.0 and later, you must update your application's property list file with the following to include Waze: