Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

https://waze.com/ul

この URL に渡すパラメータに応じて、Waze アプリケーションは住所を特定したり、地図上に住所をマークしたり、住所または目的地へのナビゲーションセッションを開始したりできます。

ディープリンクの仕組み

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

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

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

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

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

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

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

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

目的地に移動する

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

Waze ライブマップを開き、ビジネスを検索します。検索ボックスにテキストを入力するか、ズームインして地図の特定のセグメントをクリックします。
地図の右下にある共有アイコンをクリックします。
ダイアログが表示されます。[**運転ルートを共有**] をクリックし、リンクをコピーして貼り付けます。
注: ライブマップでの表示のズームレベルは、埋め込みコードに反映されます。ズームレベルは 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に置き換える必要があります。

次の例では、「六本木 6-10-1」を検索します。

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 の例をご覧ください。ご不明な点がございましたら、お気軽にお問い合わせください。 reach out to us。

例

このセクションでは、Android プラットフォームと iOS プラットフォームで Waze ディープリンク API を使用する方法の例を示します。

Android の例

次のコードスニペットの例では、Waze がインストールされている場合、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>