Navigation Connect API の概要

欧州経済領域(EEA)のデベロッパー

Navigation Connect API は、ドライバーが Google マップと Waze のナビゲーションを使用する状況を企業のシステムに接続するサービスです。この機能では、アプリのディープリンクとともに乗車承認トークンを使用します。これにより、ドライバーはリンクまたはボタンをタップして、選択したユーザーアプリでナビゲーションを開始できます。ドライバーが移動経路をナビゲートしている間、リアルタイムの現在地、高精度の到着予定時刻、移動経路のライフサイクル ステータスなどの位置情報を継続的に受信できます。

Navigation Connect API は、Navigation SDK の軽量な代替手段です。カスタム ナビゲーション インターフェースを構築してアプリに埋め込む必要はなく、スタンドアロンの Google マップアプリと Waze アプリを使用してルートを検索します。また、ドライバーのセッションをバックエンドに安全にリンクします。ドライバーが乗車を開始すると、使い慣れたナビゲーション インターフェースが表示されます。ただし、乗車データの共有に関する同意を求めるプロンプト(12 か月ごとに必要)と、アプリに戻るためのブランドの付いた戻るボタンが追加されています。

Navigation Connect API を使用する理由

Navigation Connect API を使用すると、Google マップまたは Waze からのリアルタイムのルート位置情報と到着予定時刻の更新をバックエンド プロセスに直接統合できます。これにより、ドライバーが好みのナビゲーション アプリ(Google マップまたは Waze)を使用している間も、重要なビジネス上の意思決定を推進し、正確な最新情報を顧客と共有できます。

使用例には、次のようなものがあります。

  • ライドシェアの透明性を高める: ライドシェアの利用者と乗客に、ドライバーの現在地と到着予定時刻に関する正確なリアルタイムの最新情報を提供します。
  • 配送状況の追跡を強化: リアルタイムの交通情報と経路データに基づいて、正確な配送予定時刻をお客様に通知します。
  • フリート管理と配車を改善する: リアルタイムのドライバーの位置情報を追跡することで、オンデマンド サービス(故障支援、メンテナンス、輸送など)を提供するフリートやモバイル ワークフォースの配車に関する情報に基づいた意思決定を行うことができます。

Navigation Connect API でできること

Navigation Connect API を使用すると、Google マップまたは Waze からリアルタイムの位置情報と到着予定時刻の更新をバックエンドで直接受信できます。

  • 邪魔にならない形で乗車を追跡: Google マップまたは Waze を使用するというドライバーの選択を変更したり、ユーザー エクスペリエンスを変更したりすることなく、乗車を追跡します。
  • リアルタイムの位置情報にアクセスする: ルート全体を通じて、ドライバーのリアルタイムの位置情報、残りの距離、経過時間を継続的に取得します。
  • ルートのライフサイクルをモニタリングする: ルートデータの更新頻度を構成して、ルートの正確なステータスを追跡し、ドライバーが移動中、到着、ルートの一時停止をすぐに把握できます。
  • 到着予定時刻を取得して共有する: Google のリアルタイム ルート アルゴリズムにより、精度の高い到着予定時刻の最新情報を取得できます。
  • 残りのルートと交通状況を追跡する: ドライバーの現在地から最終目的地までの残りのルートのポリラインとリアルタイムの交通状況を、Google マップまたは Waze に表示されるとおりに取得します。この機能は、Navigation Connect Enterprise SKU をトリガーします。
    • 動的トリミング: 車両が移動すると、Navigation Connect はドライバーのアクティブなルート ポリライン(アプリでナビゲートされる完全なルート)を自動的にトリミングし、残りのルート(ドライバーの現在地から目的地までのセグメント)のみを受信できるようにします。
    • 更新の頻度: ルートと交通状況は、ルートの再計算、クライアントサイドの事前対応型ルート変更、交通状況の変化に応じて自動的に更新されます。
  • ルート逸脱の追跡(Waze のみ): ドライバーがルートから外れたことを検出し、逸脱した正確な場所と時間を特定します。また、逸脱がドライバーによるもの(例: 曲がり角を間違えた)か、システムによるもの(例: 渋滞を回避するためのルート変更)かを識別します。この機能により、Navigation Connect Enterprise SKU がトリガーされます。
  • データを柔軟に取り込む: 直接 REST API 呼び出しを使用してリアルタイムのルートデータを使用するか、Google Cloud Pub/Sub サブスクリプションを使用して更新を効率的にストリーミングします。

Navigation Connect API の仕組み

Navigation Connect API は、モバイル アプリケーション ID とセッション構成を含む CreateTrip リクエストを受け付けます。サービスは一意の乗車インスタンスを生成し、乗車トークンを返します。このトークンは、Google マップまたは Waze のディープリンクに追加されます。ドライバーがナビゲーションを起動して同意すると、サービスはリアルタイムのナビゲーション データを処理し、位置情報、到着予定時刻、残りの距離などのテレメトリーの更新を返します。

リソース

次の表は、Navigation Connect API を介して利用可能なリソースと、返されるデータをまとめたものです。詳細については、Navigation Connect API リファレンスをご覧ください。

データ リソース 返されたデータ

JSON 形式の認証とモバイルアプリの識別子。

トリップを作成するをご覧ください。

Google マップまたは Waze で接続を初期化するために使用される一意のルートトークン。

Google マップまたは Waze を起動するをご覧ください。

JSON 形式の一意の乗車 ID とプルまたはプッシュ メソッド。

ルートデータを取得するをご覧ください。

以下を含むリアルタイムのルート テレメトリー:

  • トリップのステータスとメタデータ
  • 現在地(緯度/経度)
  • 予定到着時刻(ETA)
  • 残りの距離と時間

ルートデータを処理するをご覧ください。

Navigation Connect API の使用方法

1 セットアップする Google Cloud プロジェクトを設定するから始め、以降の手順を完了します。
2 トリップを作成する Navigation Connect API 呼び出しを送信して、一意の ID でルートを作成し、トークンを保存します。
3 Google マップまたは Waze を起動する トリップトークンを渡し、Google マップまたは Waze を起動して、ルートデータのデータ共有を有効にします。
4 ルートデータを取得する Navigation Connect API 呼び出しを送信して、ルートデータを取得します。必要に応じて、Google Cloud Pub/Sub を使用して更新をサブスクライブします。
5 ルートデータを処理する ルートのステータスとその他のルートデータを処理する方法を理解する。