Fleet Engine ジャーニー シェアリングをオンデマンドの旅行に使用すると、 ユーザーが提供した注文、配車、その他のサービスの進行状況を追跡できます。
ジャーニーの共有とは
移動経路の共有は Fleet Engine のオンデマンド配車機能の一つで、 Consumer SDKルートデータをモデル化し、ルートを追跡するインターフェースを提供する Fleet Engine でホストされ、豊富な機能を備えたクラスを 消費者にルート情報を表示します。統合する SDK をアプリに組み込み、Fleet Engine 内で適切なロール プロファイルを 消費者のジャーニー情報の共有をサポートしています
ジャーニーの共有では、プラットフォーム固有の API を使用してジャーニーを構築できます。 アプリケーションにネイティブに共有します。Consumer SDK は サポートしています。
移動経路の共有を使用するメリット
旅程の共有をオンデマンドの旅行アプリケーションに統合することで、 ほぼリアルタイムでの包括的な車両モニタリング体験を 位置情報の更新、道路スナップされた位置の把握を支援します。お客様の 消費者は車両のルートが地図上に重ねて表示され、 配車や配達の状況を把握できます。
ジャーニー シェアでできること
Driver SDK と Fleet Engine からの情報を使用して、 次の機能を提供します。
ブランディングのニーズに合わせて地図 UI をカスタマイズできます。
ルート上での車両の現在地と、 定期的に更新されます
乗車場所と降車場所の到着予定時刻（ETA）。
残りの距離。
ルートのライブ交通情報。
移動経路の共有の仕組み
大まかに言えば、移動経路の共有は次のメカニズムに依存しています。
- 認証されたアプリユーザーがアクセスできるようにする適切な Fleet Engine ユーザーロール 注文に関連付けられているルートを取得する。
- 消費者とルートの関連付け（貴社から提供された情報） バックエンドシステムです
- Consumer SDK
TripModelとJourneySharingSession: 次の SDK クラス: 旅行データのモデル化と、ユーザーアプリでの旅行セッションの共有
Consumer SDK には他のインターフェースとクラスも用意されているため、 アプリのマッピング ユーザー インターフェースを作成して、消費者が 交通状況、地図上のマーカー、到着予定時刻、 ルートデータなどです
この表は共有経路のフローを示しています。
| 1 | コンシューマ アプリがルートをリクエストします。 | バックエンド サーバーがオンデマンドの出張リクエストを受け取り、
次のとおりです。
|
| 2 | ドライバーがルートを承諾する | ドライバーアプリはルート ID とルート情報を取得し、ドライバーは 旅行が承認されます。 |
| 3 | ユーザーアプリがジャーニーへのアクセスをリクエストする | ユーザーアプリがバックエンドからルート ID を取得し、 移動手段の共有を開始します |
| 4 | ドライバーがルートを開始する | ドライバーがドライバー用アプリを使用して、ルートが 起動すると、アプリは Driver SDK を介してバックエンド サーバーに通知します。 たとえば、運転手が レストランを出発しようとしている、または乗車場所に車で移動しようとしている。 |
| 5 | Fleet Engine がプロセスの共有を開始 | Fleet Engine が追跡を開始し、 アプリの進捗状況を確認できます |
| 6 | 消費者向けアプリでジャーニーを表示 | コンシューマ アプリがコンシューマに通知し、 取り組みの進捗に合わせて ジャーニーを更新しています |
| 7 | ルートが完了またはキャンセルされた | ドライバーがルートをキャンセルまたは完了すると、 ドライバーアプリが位置情報追跡を無効にし、バックエンド サーバーが ルートをキャンセルまたは完了としてマークするよう Fleet Engine に指示します。 |
| 8 | 一般ユーザー向けアプリが経路の共有を停止 | 旅程が「キャンセル」または「完了」と表示されます。 |
| 9 | このプロセスは次のルートでも繰り返されます。 | 新しいルートが作成され、プロセスが繰り返されます。 |
ジャーニーの共有の使用方法
ジャーニーの共有を開始する方法を確認するには、お使いのプラットフォームを選択してください。
Android
| 1 | Android で Consumer SDK をセットアップする | アプリでオンデマンドの賃走の経路を共有するには、Consumer SDK をセットアップします。詳しくは、Android Consumer SDK を入手するをご覧ください。 |
| 2 | 経路の共有のビジュアル インターフェースを設定する | 地図を定義し、ベクターマップのサポートを追加して、ジャーニーのインターフェースを設定します。詳しくは、地図を設定するをご覧ください。 |
| 3 | 旅を共有する | ルートをフォローして、適切な車両の位置を消費者と共有します。詳しくは、ルートを追跡するをご覧ください。 |
| 5 | 移動状況を更新して移動エラーを処理する | 移動距離や到着予定時刻など、移動の詳細を更新し、移動中のエラーを処理します。詳細については、次をご覧ください: 移動状況を更新する ルートエラーの処理。 |
| 5 | ジャーニーが完了したら、共有を停止する | 消費者への車両の位置情報の共有を停止するには、ルートのフォローを解除します。詳しくは、ルートのフォローを停止するをご覧ください。 |
iOS
| 1 | iOS で Consumer SDK を設定する | アプリでオンデマンドの賃走の経路を共有するには、Consumer SDK をセットアップします。詳しくは、iOS Consumer SDK を入手するをご覧ください。 |
| 2 | 経路の共有のビジュアル インターフェースを設定する | マップビューを初期化し、地図イベントを処理して、ジャーニーのインターフェースを設定します。詳しくは、地図を設定するをご覧ください。 |
| 3 | 旅を共有する | ルートをフォローして、適切な車両の位置を消費者と共有します。詳しくは、ルートを追跡するをご覧ください。 |
| 5 | 移動状況を更新して移動エラーを処理する | 移動距離や到着予定時刻など、移動の詳細を更新し、移動中のエラーを処理します。詳細については、次をご覧ください: 移動状況を更新する ルートエラーの処理。 |
| 5 | ジャーニーが完了したら、共有を停止する | 消費者への車両の位置情報の共有を停止するには、ルートのフォローを解除します。詳しくは、ルートのフォローを停止するをご覧ください。 |
JavaScript
| 1 | JavaScript で移動経路の共有を設定する | アプリでオンデマンドの賃走の経路を共有するには、Consumer SDK をセットアップします。詳細については、JavaScript Consumer SDK をセットアップするをご覧ください。 |
| 2 | 移動経路の共有マップを読み込んでカスタマイズする | Maps JavaScript API を有効にし、ジャーニーのインターフェースをセットアップする認可を設定します。詳しくは、地図を設定するをご覧ください。 |
| 3 | 旅を共有する | ルートをフォローして、適切な車両の位置を消費者と共有します。詳しくは、ルートを追跡するをご覧ください。 |
| 5 | 移動状況を更新して移動エラーを処理する | 移動距離や到着予定時刻など、移動の詳細を更新し、移動中のエラーを処理します。詳細については、次をご覧ください: 移動状況を更新して確認する ルートエラーの処理。 |
| 5 | ジャーニーが完了したら、共有を停止する | 消費者への車両の位置情報の共有を停止するには、ルートのフォローを解除します。詳しくは、経路の共有を停止するをご覧ください。 |
コンポーネント
このセクションでは、工程を共有するために必要な 2 つのコンポーネントの概要を説明します。
必要に応じて、以下のテクノロジーを使用して、履歴の共有機能をカスタマイズすることもできます。 components:
認証トークン取得ツール
Fleet Engine に保存されている位置情報へのアクセスを制御するには、次のことを行う必要があります。 次のとおりです。
Fleet Engine 用の JSON Web Token（JWT）作成サービスを実装する サーバー上にあります。
ウェブアプリまたはモバイルアプリに認証トークン フェッチャーを実装する 位置情報へのアクセスを認証します。
対象 詳しくは、Android の設定ガイドをご覧ください。 iOS、JavaScript。
地図ビューとルート トラッカー
移動経路の共有には可視化のコンポーネントが含まれる 車両、地点、ドライバーの到着予定時刻の元データフィード または残りの走行距離を確認できます。
次の表に、これらのコンポーネントを示します。
| コンポーネント | 説明 |
|---|---|
| 移動経路の地図表示 | 地図ビューでは、行程のライフサイクルを管理し、地点を示します 車両の位置情報を 自動的に取得します 車両のルートがわかっている場合は、地図表示で車両のルートが更新されます。 ポリラインは、ルートに沿った車両の進行状況を示します。 |
| JavaScript でのルート案内プロバイダ | JavaScript ウェブアプリの場合、ルート位置情報プロバイダが位置情報をフィードします
共有されたジャーニー マップに、追跡しているオブジェクトの情報を追加します。詳細
詳しくは、
ルート位置情報プロバイダをインスタンス化する。
ルート位置情報プロバイダを使用すると、
trip:
|
追跡対象の位置情報オブジェクト
位置情報プロバイダは、地点やマップなどの地点、 次の表に示すとおりです。
| 追跡中の位置情報 | 説明 |
|---|---|
| 受け取り場所 | 乗車場所は、旅程の始点となる場所です。マーク 受け取り場所が表示されます。 |
| 宛先のロケーション | 目的地とは、旅程の終点となる場所のことです。 降車場所が示されます。 |
| 地点の位置 | ウェイポイントの場所は、 追跡するプロセスです技術的に言うとウェイポイントには 乗車場所と降車場所。ウェイポイントは通常、 ルート上の経由地ですたとえば、乗車と目的地の間の停留所、 配送ルート上の場所はウェイポイントの場所です詳細については、次をご覧ください: ルートの地点 Fleet Engine のドキュメントをご覧ください |
| 車両の位置情報 | 車両の位置情報は、報告された車両の位置情報です。詳細 詳しくは、車両の位置をご覧ください。 Fleet Engine のドキュメントをご覧ください |
地図のスタイルを設定する
マーカーとポリラインのスタイルで、 追跡された位置情報オブジェクトです次を使用: カスタム スタイル オプション。スタイルに合わせてデフォルトのスタイルを変更できます。 ウェブ アプリケーションの機能を提供します。
追跡中の場所の公開設定を管理する
Fleet Engine の事前定義された位置情報プロバイダは、次の公開設定ルールに従います。 追跡対象の位置情報オブジェクトですカスタムまたは派生型の 位置情報プロバイダ）は、公開設定ルールを変更できます。
ルートの途中でのみ車両が表示される: ルート 車両の共有先は、ルートに割り当てられてから 便利ですルートがキャンセルされると、車両の表示時間は長くなります。
他のすべての位置マーカーを常に表示する: 他のすべての位置マーカー 出発地、目的地、地点が地図に常に表示されます。対象 例: 配達経路の共有や配達状況の共有 現在の場所の状態にかかわらず、 追跡や配送などができます
次のステップ
ジャーニーを共有するプラットフォームのドキュメントをご覧ください。