Fleet Engine サービスのクイック リファレンス

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 サービス: 設定

公式の 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 サービス: よくある間違い

  • 問題: 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 API reportBillableEvent。症状: 契約固有。API のサポート終了ではありません。移行後、呼び出しで「無効な契約: このプロジェクト [...] は FleetEngine の使用を許可されていません」というエラーが返されることがあります。移行ガイドをご覧ください。

Fleet Engine サービスでできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。