このページは Cloud Translation API によって翻訳されました。

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

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

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

https://waze.com/ul

Waze アプリケーションは、この URL に渡されたパラメータに基づいて、住所の特定、地図上で住所のマーク付け、住所または目的地へのナビゲーションセッションの開始を行うことができます。

ディープリンクの仕組み

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

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

Waze アプリがインストールされていることを確認したら、URL を使用して、ウェブエクスペリエンスなしでアプリ間の通信を行うことができます。これは、上記のベース URL の代わりになります。このオプションは、ユーザーが Waze がインストールされていることがわかっている場合にのみ使用してください。そうしないと、ユーザーがリンクをタップしても何も起こりません。

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

次の URL を使用して、サードパーティ製アプリ、メール、SMS、ウェブページリンク、またはその他のソースからのパラメータで Waze を起動できます。

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

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

Waze ディープリンクの一般的なタスクのいくつかを次に示します。

場所へのナビを開始

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

Waze Live Maps を開いて現在地を検索します。検索ボックスに入力するか、ズームインして、地図の特定のセグメントをクリックします。
地図の右下にある共有アイコンをクリックします。
ダイアログが表示されます。[運転ルートを共有] をクリックし、リンクをコピーして貼り付けます。
注: ライブマップのビューのズームレベルは、埋め込みコードに反映されます。ズームレベルは、zoom パラメータを使用して変更できます。詳細については、URL パラメータをご覧ください。

例

以下のサンプルでは、ニューヨークのタイムズスクエアを中心に地図を配置しています。

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 の最大値は 8, 192（最も拡大率が最も大きい、または最小）です。

次の例では、拡大レベルを 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 がインストールされている場合は緯度/経度に移動し、そうでない場合は Waze をインストールするため App Store を起動します。

- (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>