オンデマンドの賃走の経路の共有の概要

Fleet Engine ジャーニー シェアリングをオンデマンドの旅行に使用すると、 ユーザーが提供した注文、配車、その他のサービスの進行状況を追跡できます。

ユーザーアプリ

ジャーニーの共有とは

移動経路の共有は Fleet Engine のオンデマンド配車機能の一つで、 Consumer SDKルートデータをモデル化し、ルートを追跡するインターフェースを提供する Fleet Engine でホストされ、豊富な機能を備えたクラスを 消費者にルート情報を表示します。統合する SDK をアプリに組み込み、Fleet Engine 内で適切なロール プロファイルを 消費者のジャーニー情報の共有をサポートしています

ジャーニーの共有では、プラットフォーム固有の API を使用してジャーニーを構築できます。 アプリケーションにネイティブに共有します。Consumer SDK は サポートしています。

移動経路の共有を使用するメリット

旅程の共有をオンデマンドの旅行アプリケーションに統合することで、 ほぼリアルタイムでの包括的な車両モニタリング体験を 位置情報の更新、道路スナップされた位置の把握を支援します。お客様の 消費者は車両のルートが地図上に重ねて表示され、 配車や配達の状況を把握できます。

ジャーニー シェアでできること

Driver SDK と Fleet Engine からの情報を使用して、 モバイル SDK ビューとウェブサービス レスポンスには、次の機能が用意されています。

  • ブランディングのニーズに合わせて地図 UI をカスタマイズできます。

  • ルート上での車両の現在地と、 定期的に更新されます

  • 乗車場所と降車場所の到着予定時刻(ETA)。

  • 残りの距離。

  • ルートのライブ交通情報。

移動経路の共有の仕組み

大まかに言うと、移動経路の共有は次のメカニズムに依存しています。

  • 認証されたアプリユーザーがアクセスできるようにする適切な Fleet Engine ユーザーロール 注文に関連付けられているルートを取得する。
  • 消費者とルートの関連付け(貴社から提供された情報) バックエンドシステムです
  • Consumer SDK TripModelJourneySharingSession: 次の SDK クラス: 旅行データのモデル化と、ユーザーアプリでの旅行セッションの共有

移動経路の共有

Consumer SDK には他のインターフェースとクラスも用意されているため、 アプリのマッピング ユーザー インターフェースを作成して、消費者が 交通状況、地図上のマーカー、到着予定時刻、 ルートデータなどです

次の表は、共有経路のフローを示しています。

1 コンシューマ アプリがルートをリクエストします。 バックエンド サーバーがオンデマンドの出張リクエストを受け取り、 次のとおりです。 <ph type="x-smartling-placeholder">
    </ph>
  • Fleet Engine でルートを作成します。
  • Fleet Engine で車両にルートを割り当てます。
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 に保存されている位置情報へのアクセスを制御するには、次のことを行う必要があります。 次のとおりです。

  1. Fleet Engine 用の JSON Web Token(JWT)作成サービスを実装する サーバー上にあります

  2. ウェブアプリまたはモバイルアプリに認証トークン フェッチャーを実装する 位置情報へのアクセスを認証します。

対象 詳しくは、Android の設定ガイドをご覧ください。 iOSJavaScript

地図ビューとルート トラッカー

移動経路の共有には可視化のコンポーネントが含まれる 車両、地点、ドライバーの到着予定時刻の元データフィード または残りの走行距離を確認できます。

次の表に、これらのコンポーネントを示します。

コンポーネント 説明
移動経路の地図表示 地図ビューでは、行程のライフサイクルを管理し、地点を示します 車両の位置情報を 自動的に取得します 車両のルートがわかっている場合は、地図表示で車両のルートが更新されます。 ポリラインは、ルートに沿った車両の進行状況を示します。
JavaScript でのルート案内プロバイダ JavaScript ウェブアプリの場合、ルート位置情報プロバイダが位置情報をフィードします 共有されたジャーニー マップに、追跡しているオブジェクトの情報を追加します。詳細情報 詳しくは、 ルート位置情報プロバイダをインスタンス化する。 ルート位置情報プロバイダを使用すると、 trip: <ph type="x-smartling-placeholder">
    </ph>
  • ルートの乗車場所または降車場所。
  • ルートに割り当てられている車両の場所とルート。

追跡対象の位置情報オブジェクト

位置情報プロバイダは、地点やマップなどの地点、 次の表に示すとおりです。

追跡中の位置情報 説明
受け取り場所 乗車場所は、旅程の始点となる場所です。マーク 受け取り場所が表示されます。
宛先のロケーション 目的地とは、旅程の終点となる場所のことです。 降車場所が示されます。
地点の位置 ウェイポイントの場所は、 追跡するプロセスです厳密に言えば、ウェイポイントには 乗車場所と降車場所。ウェイポイントは通常、 ルート上の経由地ですたとえば、乗車と目的地の間の停留所、 配送ルート上の場所はウェイポイントの場所です詳細については、次をご覧ください: ルートの地点 Fleet Engine のドキュメントをご覧ください
車両の位置情報 車両の位置情報は、報告された車両の位置情報です。詳細情報 詳しくは、車両の位置をご覧ください。 Fleet Engine のドキュメントをご覧ください

地図のスタイルを設定する

マーカーとポリラインのスタイルで、 追跡された位置情報オブジェクトです次を使用: カスタム スタイル オプション。スタイルに合わせてデフォルトのスタイルを変更できます。 ウェブ アプリケーションの機能を提供します。

追跡中の場所の公開設定を管理する

Fleet Engine の事前定義された位置情報プロバイダは、次の公開設定ルールに従います。 追跡対象の位置情報オブジェクトですカスタムまたは派生型の 位置情報プロバイダ)は、公開設定ルールを変更できます。

  • ルートの途中でのみ車両が表示される: ルート 車両の共有先は、ルートに割り当てられてから 便利ですルートがキャンセルされると、車両の表示時間は長くなります。

  • 他のすべての位置マーカーを常に表示する: 他のすべての位置マーカー 出発地、目的地、地点が地図に常に表示されます。対象 例: 配達経路の共有や配達状況の共有 現在の場所の状態にかかわらず、 追跡や配送などができます

次のステップ

ジャーニーを共有するプラットフォームのドキュメントをご覧ください。