Waze ディープリンクの使用方法

Waze は、デベロッパーが Waze クライアント アプリケーションやウェブページを開くことができる API をサポートしています 外部 URL 経由で通信できます別のモバイルアプリやモバイル デバイスからこの URL にアクセスできる ウェブページ。

Waze ディープリンクを使用するためのベース URL は次のとおりです。

https://waze.com/ul

Waze アプリケーションはその後、住所を見つけたり、地図上にマークをつけたり、 ナビゲーション セッションから特定の住所または目的地まで、 URL。

ディープリンクの仕組み

Waze がクライアント アプリとウェブページのどちらとして開くかは、ユーザーのシステム設定によって異なります。

  • パソコン: Waze がウェブページとして開きます。
  • モバイル デバイス(かつ Waze アプリがインストールされている): Waze アプリが開きます。
  • モバイル デバイス(かつ Waze がインストールされていない): Waze がウェブページとして開きます。

Waze アプリがすでにインストールされているなら、URL「waze://」を使用できます ウェブ エクスペリエンスなしでのアプリ間通信。これは、前述のベース URL に代わるものです。 ご覧ください。このオプションは、ユーザーが Waze を確実にインストールしている場合にのみ使用してください。それ以外の場合 ユーザーがリンクをタップしても何も起こりません。

Waze ディープリンクを使用する

次の URL を使用して、サードパーティ製アプリ、メール、SMS、 ウェブページへのリンク、その他のソースです。

Waze ディープリンクは以下の URL を使用します。

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

Waze Deep Links の一般的なタスクは以下のとおりです。

特定の場所に移動するには:

  1. Waze のライブマップを開き、 現在地を検索します。検索ボックスに入力するか、ズームインして特定の項目をクリックします 作成します。
  2. 共有アイコン をクリックします。 地図の右下隅に表示されます。
  3. ダイアログが表示されます。 [運転ルートを共有] をクリックし、リンクをコピーして貼り付けてください。

次の例では、地図の中心をニューヨークのタイムズ スクエアに配置します。

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

Waze アプリに保存された以下のお気に入りに移動できます。

  • work
  • home

指定したお気に入りに移動するには、次の URL を使用します。

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

次の例では、宛先が機能するように設定します。

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

次の構文で住所を検索します。

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

パラメータとして渡す値は、URL エンコードする必要があります。たとえば、サーバー モジュールを 「%20」を含むスペース。

次の例では、「66 Acacia Avenue」を検索します。

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

地図に表示します

次の構文を使用して、Waze の表示倍率(またはズーム)を設定します。 地図表示:

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

magnification_level の最小値は 6 です(最も近い、または最大の倍率)。 magnification_level の最大値は 8192(最も遠い 選択します。

次の例では、拡大レベルを 8 に設定しています。

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

パラメータを結合する

複数のパラメータを同じ URL で使用するには、名前と値のペアを 「&」次の例は、パラメータの組み合わせの使用方法を示しています。

  • 地図の中心をメアリーヒルに合わせ、10 度にズームするには:

    https://waze.com/ul?ll=45.6906304,-120.810983&z=10
  • 住所を検索してその住所に移動するには:

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

utm_source を含める

実装に utm_source を含めると、利用状況と 特定します統合に影響する問題が発生した場合、utm_source では、パートナー様をフォローアップし、より良いパートナー エクスペリエンスをご提供します。詳細 詳しくは、iOS の例をご覧ください。障害が発生した場合に 問題がある場合は、 お問い合わせください

このセクションでは、Android と iOS で Waze Deep Links API を使用する方法の例を示します。 説明します。

Android の例

次のコード スニペットの例では、指定された場所を探すために Waze が インストールされています。Waze がインストールされていない場合は、Google Play で Waze ページが開きます。

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

iOS の例

次のコード スニペットの例では、Waze がインストールされている場合は緯度/経度に移動します。それ以外の場合は、 App Store を起動して 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"]];
  }
}

iOS SDK 9.0 以降でコンパイルする場合は、アプリのプロパティ リストを更新する必要があります。 ファイルに Waze を含めるには、

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