Fleet Engine は、実際の車両フリートをモデル化し、オンデマンドのルートとスケジュール設定されたタスクのルート、到着予定時刻、交通状況、ステータスの更新を提供するバックエンド サービスです。Driver SDK の位置情報とルートデータを使用し、Consumer SDK やその他の Google Maps Platform API と連携します。
Fleet Engine サービス: 主な特長
- プロダクト: Fleet Engine サービス
- 別名: Fleet Engine、Fleet Engine API、Local Rides and Deliveries API
- カテゴリ: ルート
- プラットフォーム: ウェブサービス(REST)
- 実行場所: サーバー(バックエンド コード)
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Fleet Engine サービスの概要
Fleet Engine サービス: 使用する場面
Fleet Engine サービスを使用するケース:
- 車両とオンデマンドのルート(乗車、経由地、降車)をモデル化するバックエンドが必要です。これには、複数の目的地、連続したルート、共有ルートが含まれます。
- 車両に割り当てられた、スケジュール設定された配送タスクまたはサービス タスクをモデル化し、停車、結果、到着予定時刻を追跡する必要があります。
- リクエストされた乗車に一致する車両を検索または一覧表示するには、地域を指定する必要があります。
- Driver SDK の位置情報の更新によって、消費者のルートまたは配送の追跡と、フリート オペレーターの追跡を行う必要があります。
Fleet Engine サービスを使用すべきでない場合:
- Fleet Engine のルートやタスクのオーケストレーションを使用せずに、独自のデータベースまたはストリームからウェブマップにライブ GPS マーカーまたはアセットパスを表示する必要があります。代わりに Maps JavaScript API を使用してください。
- Fleet Engine のルートやタスクのオーケストレーションを使用せずに、Android アプリで独自のデータからライブ マーカーやパスを表示する必要があります。代わりに Maps SDK for Android を使用してください。
- Fleet Engine のルートやタスクのオーケストレーションを使用せずに、iOS アプリで独自のデータからライブ マーカーやパスを表示する必要がある。代わりに Maps SDK for iOS を使用してください。
- フリート全体の最適化されたルートプランを計算する必要があります。Fleet Engine は、提供されたソルバーからルートプランを取得するだけです。代わりに Route Optimization API を使用してください。
Fleet Engine サービス: 設定
- 有効にするサービス:
fleetengine.googleapis.com - 認証: サービス アカウント、JSON Web Token(JWT)、OAuth 2.0
- 使用状況の帰属: オプションのベータ版機能。Mobility パッケージ サービスへの呼び出しで、
X-Goog-Maps-Experience-IDHTTP ヘッダーを Mobility トランザクション ID(またはセッション ID などの関連 ID)に設定します。複数の ID を指定する場合は、カンマで区切ります。取引をレポートする際に、関連する ID をrelated_idsで渡します。 - 使ってみる: Fleet Engine サービスを設定する
- リファレンス: Fleet Engine サービスのリファレンス
- ポリシー: Fleet Engine サービスのポリシー
- リリースノート: Fleet Engine Service のリリースノート
公式の Fleet Engine サービス パッケージ:
- Maven:
com.google.maps:google-maps-fleetengine - Maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - go:
cloud.google.com/go/maps
Fleet Engine サービス: 関連プロダクト
- よく併用されるサービス: Driver SDK for Android、Driver SDK for iOS、Consumer SDK for Android、Consumer SDK for iOS、JavaScript Consumer SDK、Route Optimization API
Fleet Engine サービス: よくある間違い
- 問題: Fleet Engine へのリクエストが失敗することがあり、失敗すると、車両などのエンティティが存在しなくなることがあります(更新時に
NOT_FOUND)。修正: バックオフを使用して再試行を実装し(クライアント ライブラリはデフォルトで再試行します)、不足している車両またはタスクを現在の状態で再作成します。/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot をご覧ください。 - 問題: リクエストがクライアント ライブラリのデフォルトのタイムアウトよりも長くかかると、
DEADLINE_EXCEEDEDエラーが発生します。修正: RPC の再試行設定を調整します(Java クライアントのVehicleServiceSettingsのsetTotalTimeoutなど)。/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot をご覧ください。 - 問題: JWT に正しいクレームがないか、署名サービス アカウントに必要な Fleet Engine IAM ロールがない場合(「JWT にリクエストされたルートに一致するスコープが含まれていません」など)、
PERMISSION_DENIED(HTTP 403)が発生します。修正: サービス アカウントのロールを確認し、JWT クレームに、アクセス対象の車両、ルート、タスクのスコープが含まれていることを確認します。/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot をご覧ください。 - 問題: オンデマンド配車と配達からモビリティ パッケージに移行する場合、またはラスト ワンマイルのフリート ソリューションから Mobility Activate または Mobility Optimize に移行する場合、移行が完了するまで Mobility Billing API リクエストは HTTP 202 を返し、課金は発生しません。修正: 移行の数日前から数日後まで、Fleet Engine
ReportBillableTripと Mobility Billing API の両方を呼び出し、Cloud Logging でリクエスト数を比較してから、ReportBillableTrip呼び出しを削除します。/maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration をご覧ください。
Fleet Engine サービス: 以前の機能と非推奨の機能
UpdateVehicleLocationメソッド: 2024 年 5 月 1 日以降廃止。交換:VehicleServiceのUpdateVehicle。症状: 2024 年 2 月 1 日に非推奨、2024 年 5 月に廃止。SearchFuzzedVehiclesメソッド: 2024 年 5 月 1 日以降廃止。交換:VehicleServiceのSearchVehicles。症状: 2024 年 2 月 1 日に非推奨、2024 年 5 月に廃止。SearchTasksメソッド: 2024 年 5 月 1 日以降廃止。交換:DeliveryServiceのGetTaskTrackingInfo。症状: 2024 年 2 月 1 日に非推奨、2024 年 5 月に廃止。ReportBillableTripモビリティ パッケージに移行した後(オンデマンド配車と配達から任意のパッケージ、またはラスト ワンマイル フリート ソリューションから Activate または Optimize): レガシー。代替: Mobility Billing APIreportBillableEvent。症状: 契約固有。API のサポート終了ではありません。移行後、呼び出しで「無効な契約: このプロジェクト [...] は FleetEngine の使用を許可されていません」というエラーが返されることがあります。移行ガイドをご覧ください。
Fleet Engine サービスでできること
各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。
- 課金対象となる Fleet Engine のルートの使用状況を報告する。
- 新しい Fleet Engine のルートを作成して返します。
- Fleet Engine のルートに関する情報を返します。
- 指定した車両のすべての Fleet Engine のルートのリストを返します。
- Fleet Engine のルートのルートデータを更新する。
- オンデマンドのライドシェアまたは配達のプロバイダに関連付けられた新しい車両を Fleet Engine でインスタンス化します。
- Fleet Engine サービスから車両を返却します。
- 指定された条件に一致する、プロバイダに関連付けられた Fleet Engine 内の車両のページ分けされたリストを返します。
- 指定した条件に一致する Fleet Engine 内の車両のリストを返します。
- Fleet Engine で車両の車両データを更新します。
- Fleet Engine で車両の車両属性を更新する。
- Fleet Engine サービスから車両のルート情報を返します。