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[¶m_name=value]
Waze Deep Links の一般的なタスクは以下のとおりです。
場所へのナビ
特定の場所に移動するには:
- Waze のライブマップを開き、 現在地を検索します。検索ボックスに入力するか、ズームインして特定の項目をクリックします 作成します。
- 共有アイコン をクリックします。 地図の右下隅に表示されます。
- ダイアログが表示されます。 [運転ルートを共有] をクリックし、リンクをコピーして貼り付けてください。
例
次の例では、地図の中心をニューヨークのタイムズ スクエアに配置します。
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>