Package maps.fleetengine.v1

BatteryStatus

バッテリーの状態（フル、充電など）

PowerSource

バッテリー電源のステータス。

float

現在のバッテリー残量（0 ～ 100）。

SpeedReadingInterval

前の地点から現在の地点までの経路上の速度です。

string

前の地点から現在の地点まで、ドライバーが通過する経路。この進路にはランドマークがあるため、クライアントは経路に沿って交通マーカーを表示できます（speed_reading_interval を参照）。デコードはまだサポートされていません。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

string

必須。一意のルート ID。次の制限事項が適用されます。

• 有効な Unicode 文字列を指定してください。
• 最大文字数は 64 文字です。
• Unicode 正規化フォーム C に従って正規化されています。
• ASCII 文字「/」、「:」、「?」、「,」、「#」を含めることはできません。

Trip

必須。作成するルート エンティティ。

ルートを作成する際は、以下のフィールドが必要です。

• trip_type
• pickup_point

指定すると、次のフィールドが使用されます。

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

その他の Trip フィールドはすべて無視されます。たとえば、すべてのルートは、作成リクエストで CANCELED の trip_status を渡しても、trip_status は NEW で始まります。

intermediate_destinations に対応しているルートは EXCLUSIVE のみです。

共有ルートに vehicle_id が設定されている場合、Trip.vehicle_waypoints のリストを指定して車両の残りの地点の順序を指定する必要があります。指定しない場合、地点の順序は不確定となります。

Trip.vehicle_waypoints を指定する場合、リストには車両のルートの残りのすべてのウェイポイントが含まれ、余分なウェイポイントが含まれないようにする必要があります。これらの地点の順序は、特定のルートで乗車地点が中間目的地の前に、すべての中間目的地が降車地点の前に配置されるようにする必要があります。EXCLUSIVE のルートの地点を他のルートとインターリーブすることはできません。

trip_id、waypoint_type、location の各フィールドが使用され、vehicle_waypoints のその他の TripWaypoint フィールドはすべて無視されます。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

string

必須。一意の車両 ID。次の制限事項が適用されます。

• 有効な Unicode 文字列を指定してください。
• 最大文字数は 64 文字です。
• Unicode 正規化フォーム C に従って正規化されています。
• ASCII 文字「/」、「:」、「?」、「,」、「#」を含めることはできません。

Vehicle

必須。作成する車両エンティティ。車両を作成する際は、以下のフィールドが必要です。

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

車両を作成する際、以下のフィールドは無視されます。

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

その他のフィールドはすべて省略可能で、指定されていれば使用されます。

LocationPowerSaveMode

バッテリー セーバーがオンのときにデバイスの位置情報機能がどのように動作するかを設定します。

bool

デバイスが現在省電力モードかどうか。

bool

デバイスが操作可能な状態かどうか。

BatteryInfo

バッテリーの状態に関する情報。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider}/trips/{trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

TripView

返す必要がある Trip フィールドのサブセットとその解釈。

Timestamp

Trip.route または Trip.current_route_segment データを取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降にルートデータが変更されていない場合、レスポンスの route フィールドは設定されません。最小値が指定されていない場合は、ルートデータが常に取得されます。

Timestamp

Trip.remaining_waypoints を取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降変更されていない場合、レスポンスに remaining_waypoints は設定されません。このフィールドが指定されていない場合、常に remaining_waypoints が取得されます。

PolylineFormatType

返される現在のルート形式、LAT_LNG_LIST_TYPE（Trip.route 内）または ENCODED_POLYLINE_TYPE（Trip.current_route_segment 内）。デフォルトは LAT_LNG_LIST_TYPE です。

Timestamp

Trip.current_route_segment_traffic を取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降トラフィック データが変更されていない場合、レスポンスに current_route_segment_traffic フィールドは設定されません。最小値が指定されていない場合は、トラフィック データが常に取得されます。トラフィックを利用できるのは、オンデマンド配車と配達ソリューションのお客様のみです。

Timestamp

Trip.remaining_waypoints.traffic_to_waypoint データと Trip.remaining_waypoints.path_to_waypoint データを取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降にデータが変更されていない場合、上記のフィールドはレスポンスに設定されません。remaining_waypoints_route_version を指定しない場合、トラフィックとパスは常に取得されます。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

Timestamp

Vehicle.current_route_segment を取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降ルートが変更されていない場合、レスポンスの current_route_segment フィールドは設定されません。最小値が指定されていない場合は、常に current_route_segment が取得されます。

Timestamp

Vehicle.waypoints データを取得する最小タイムスタンプ（この値を含まない）を示します。このタイムスタンプ以降、地点が変更されていない場合、レスポンスに vehicle.waypoints データは設定されません。このフィールドが指定されていない場合、常に vehicle.waypoints が取得されます。

string

必須。CLDR 国/地域コード。たとえば、米国の場合は US、インドの場合は IN です。

string

ナンバー プレートの最後の桁、またはナンバー プレートに数値が含まれていない場合は「-1」。

• 「ABC 1234」->「4」
• 「AB 123 CD」->「3」
• 「ABCDEF」->「-1」

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

int32

返却する車両の最大数。デフォルト値: 100。

string

前の ListVehicles の呼び出しで提供された next_page_token の値。これにより、車両のグループをページ分けできます。リクエストのフィルタ条件が前回の ListVehicles 呼び出しのフィルタ条件と同じでない場合、値は未定義になります。

Int32Value

車両に必要な最小キャパシティを指定します。返されるすべての車両の maximum_capacity は、この値以上になります。設定する場合は、0 以上にする必要があります。

TripType

指定したルートタイプのうち少なくとも 1 つをサポートする車両にのみレスポンスを制限します。

Duration

指定した期間内に位置情報の更新データを Fleet Engine に送信した車両へのレスポンスを制限します。位置情報を送信している静止車両は、最新ではないとは見なされません。存在する場合は、有効な正の値の期間を指定する必要があります。

Category

必須。指定されたタイプ カテゴリのいずれかを持つ車両へのレスポンスを制限します。UNKNOWN は許可されていません。

string

呼び出し元は、required_attributes フィールド、required_one_of_attributes フィールド、required_one_of_attribute_sets フィールドを自由に組み合わせて複雑な論理演算を作成できます。

required_attributes はリストです。required_one_of_attributes はリストのリストを許可するメッセージを使用します。2 つのフィールドを組み合わせることで、次の式を構成できます。

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

レスポンスを、指定された属性を持つ車両に制限します。このフィールドは論理積（AND）演算です。指定できる required_attributes の数は 50 個までです。車両で使用できる属性の最大数と同じです。繰り返される各文字列は、「key:value」の形式にする必要があります。

string

各 VehicleAttributeList で指定された属性の少なくとも 1 つを持つ車両へのレスポンスを制限します。各リスト内で、車両が少なくとも 1 つの属性に一致する必要があります。このフィールドは、各 VehicleAttributeList における包括的な分離/OR 演算と、VehicleAttributeList のコレクションに対する論理和/AND 演算です。繰り返される各文字列は、「key1:value1|key2:value2|key3:value3」の形式にする必要があります。

string

required_one_of_attribute_sets は追加機能を提供します。

required_one_of_attributes と同様に、required_one_of_attribute_sets はリストのリストを許可するメッセージを使用し、次のような式を許可します。

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

VehicleAttributeList 内のすべての属性に一致する車両にのみレスポンスを制限します。各リスト内で、車両がすべての属性に一致する必要があります。このフィールドは、各 VehicleAttributeList における論理積/AND 演算と、VehicleAttributeList のコレクション全体における包括的な分離/OR 演算です。繰り返される各文字列は、「key1:value1|key2:value2|key3:value3」の形式にする必要があります。

VehicleState

この車両ステータスを持つ車両へのレスポンスを制限します。

bool

現在のルートの車両のみを返す。

string

省略可。車両を一覧表示するときに適用するフィルタクエリ。フィルタ構文の例については、http://aip.dev/160 をご覧ください。

このフィールドは、required_attributes、required_one_of_attributes、required_one_of_attributes_sets の各フィールドを置き換えるように設計されています。空でない値を指定する場合は、required_attributes、required_one_of_attributes、required_one_of_attributes_sets の各フィールドを空にする必要があります。

このフィルタは、vehicle_state や on_trip_only などの他の制約との AND 句として機能します。

なお、サポートされているクエリは車両属性（attributes.<key> = <value>、attributes.<key1> = <value1> AND attributes.<key2> = <value2> など）のみです。フィルタクエリで許容される制限の最大数は 50 です。

また、すべての属性は文字列として格納されるため、属性との比較でサポートされるのは文字列比較のみです。数値またはブール値と比較するには、値を文字列として扱われるように明示的に引用符で囲む必要があります（例: attributes.<key> = "10"、attributes.<key> = "true"）。

Viewport

省略可。返される車両を、最後に確認された場所がビューポートによって定義された長方形の領域内にあった車両に限定するフィルタ。

Vehicle

リクエストの条件に一致する車両。返される車両の最大数は、リクエストの page_size フィールドによって決まります。

string

車両の次のページを取得するためのトークン。リクエスト条件を満たす車両が他にない場合は空になります。

int64

必須。すべてのページにおいて、リクエスト条件に一致する車両の合計数。

string

必須。providers/{provider}/billableTrips/{billable_trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

string

必須。ルートの所在国の 2 文字の国コード。価格は国コードに従って定義されます。

BillingPlatformIdentifier

リクエストが発行されたプラットフォーム。

string

報告されたルートに直接関連する識別子。通常は、ルート ID が利用可能になる前に行われた事前予約オペレーションの ID（セッション ID など）です。related_ids の数は 50 に制限されています。

SolutionType

報告されたルートに使用される Google マーケティング プラットフォーム サービス ソリューションのタイプ（ON_DEMAND_RIDESHARING_AND_DELIVERIES など）。

string

en-US や sr-Latn などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。指定しない場合、レスポンスは任意の言語で作成できます。そのような名前が存在する場合は、英語が優先されます。フィールド値の例: en-US。

string

必須。リクエスト送信元のリージョンの CLDR リージョン コード。フィールド値の例: US。

string

呼び出し元の SDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 1.1.2）。

string

呼び出し元の SDK が実行されているオペレーティング システムのバージョン。フィールド値の例: 4.4.1、12.1。

string

呼び出し元の SDK が実行されているデバイスのモデル。フィールド値の例: iPhone12,1、SM-G920F。

SdkType

リクエストを送信する SDK のタイプ。

string

呼び出し元の SDK が依存している MapSDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 5.2.1）。

string

呼び出し元 SDK が依存する NavSDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 2.1.0）。

Platform

呼び出し元 SDK のプラットフォーム。

string

呼び出し元 SDK の Android デバイスのメーカー。Android SDK にのみ適用されます。フィールド値の例: Samsung。

int32

呼び出し元 SDK の Android API レベル。Android SDK にのみ適用されます。フィールド値の例: 23。

string

オプションの ID。リクエストを識別するためにログ記録に使用できます。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

string

リクエスト内のルートに関連付けられている車両。指定しない場合、返されるルートに以下は含まれません。

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

true に設定すると、ドライバーのルートに影響するルートがレスポンスに含まれます。

int32

設定されていない場合、返される結果の数はサーバーが決定します。

string

以前の結果から続行するには、以前に SearchTripsResponse で返された値に設定します。

Duration

指定すると、時刻 (current - minimum_staleness) 以降に更新されていないルートが返されます。

Trip

リクエストされた車両のルートのリスト。

string

このトークンを SearchTripsRequest に渡して、リスト結果をページ分割します。API は呼び出しごとにルートリストを返し、結果が残っていない場合はルートリストが空になります。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

TerminalLocation

必須。検索する付近の乗車ポイント。

TerminalLocation

お客様の降車場所。trip_types に TripType.SHARED が含まれている場合、このフィールドは必須です。

int32

必須。乗車地点を中心とした車両検索の半径を定義します。検索半径内の車両のみが返されます。値は 400 ～ 10,000 メートルの範囲で指定してください。

int32

必須。返す車両の最大数を指定します。値は 1 ～ 50 の範囲で指定してください。

int32

必須。ルートの人数を指定します。1 以上の値を指定してください。ドライバは容量の値に考慮されません。

TripType

必須。提案されたルートのタイプを表します。タイプを 1 つだけ含める必要があります。UNKNOWN_TRIP_TYPE は使用できません。検索対象を、そのルートタイプに対応できる車両に限定します。

Duration

検索を、指定した期間内に Fleet Engine に位置情報の更新を送信した車両のみに限定します。位置情報を送信している静止車両は、最新ではないとは見なされません。このフィールドが設定されていない場合、サーバーはデフォルト値として 5 分を使用します。

VehicleType

必須。検索対象を、指定されたタイプのいずれかを持つ車両に制限します。車両タイプを少なくとも 1 つ指定する必要があります。カテゴリが UNKNOWN の VehicleTypes は使用できません。

VehicleAttribute

呼び出し元は、required_attributes フィールド、required_one_of_attributes フィールド、required_one_of_attribute_sets フィールドを自由に組み合わせて複雑な論理演算を作成できます。

required_attributes はリストです。required_one_of_attributes はリストのリストを許可するメッセージを使用します。2 つのフィールドを組み合わせることで、次の式を構成できます。

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

検索対象を、指定した属性を持つ車両のみに制限します。このフィールドは論理積（AND）演算です。指定できる required_attributes の数は 50 個までです。車両で使用できる属性の最大数と同じです。

VehicleAttributeList

検索対象を、各 VehicleAttributeList で指定された属性の少なくとも 1 つを持つ車両に限定します。各リスト内で、車両が少なくとも 1 つの属性に一致する必要があります。このフィールドは、各 VehicleAttributeList における包括的な分離/OR 演算と、VehicleAttributeList のコレクションに対する論理和/AND 演算です。

VehicleAttributeList

required_one_of_attribute_sets は追加機能を提供します。

required_one_of_attributes と同様に、required_one_of_attribute_sets はリストのリストを許可するメッセージを使用し、次のような式を許可します。

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

VehicleAttributeList 内のすべての属性を持つ車両のみに検索を制限します。各リスト内で、車両がすべての属性に一致する必要があります。このフィールドは、各 VehicleAttributeList における論理積/AND 演算と、VehicleAttributeList のコレクション全体における包括的な分離/OR 演算です。

VehicleMatchOrder

必須。結果の順序付けの基準を指定します。

bool

1 つの有効なルートを含む車両がこの検索の対象となるかどうかを示します。このフィールドは、current_trips_present が指定されていない場合にのみ使用されます。current_trips_present が指定されておらず、このフィールドが false の場合、ルートが割り当てられている車両は検索結果から除外されます。current_trips_present が指定されておらず、このフィールドが true の場合、ステータスが ENROUTE_TO_DROPOFF の有効なルートが 1 つ含まれる車両が検索結果に含まれます。current_trips_present が指定されている場合、このフィールドを true に設定することはできません。

デフォルト値は false です。

string

この SearchVehicleRequest に関連付けられているルートを表します。

CurrentTripsPresent

有効なルートがある車両がこの検索の対象となるかどうかを示します。trip_type に SHARED が含まれている場合は、CURRENT_TRIPS_PRESENT_UNSPECIFIED 以外に設定する必要があります。

string

省略可。車両の検索時に適用するフィルタクエリ。フィルタ構文の例については、http://aip.dev/160 をご覧ください。

このフィールドは、required_attributes、required_one_of_attributes、required_one_of_attributes_sets の各フィールドを置き換えるように設計されています。空でない値を指定する場合は、required_attributes、required_one_of_attributes、required_one_of_attributes_sets の各フィールドを空にする必要があります。

このフィルタは、minimum_capacity や vehicle_types などの他の制約との AND 句として機能します。

なお、サポートされているクエリは車両属性（attributes.<key> = <value>、attributes.<key1> = <value1> AND attributes.<key2> = <value2> など）のみです。フィルタクエリで許容される制限の最大数は 50 です。

また、すべての属性は文字列として格納されるため、属性との比較でサポートされるのは文字列比較のみです。数値またはブール値と比較するには、値を文字列として扱われるように明示的に引用符で囲む必要があります（例: attributes.<key> = "10"、attributes.<key> = "true"）。

VehicleMatch

SearchVehiclesRequest 条件に一致する車両のリスト。SearchVehiclesRequest.order_by フィールドに基づいて並べ替えられます。

int32

パス内のこの区間の開始インデックス。JSON では、インデックスが 0 の場合、フィールドにデータが入力されていないように見えます。

int32

パス内のこの区間の終了インデックス。JSON では、インデックスが 0 の場合、フィールドにデータが入力されていないように見えます。

Speed

この区間のトラフィック速度。

LatLng

必須。実際の場所を表します。

Timestamp

停車地が発生した時間を示します。

Timestamp

入力のみ。非推奨です。タイムスタンプ フィールドを使用します。

LatLng

必須。ルートの地点の地点を示します。

TerminalPointId

終点の ID。

string

廃止されました。

string

廃止されました。

WaypointType

非推奨: Vehicle.waypoint にこのデータが含まれます。

string

終点の一意の ID。

string

廃止されました。

string

廃止されました。

VisualTrafficReportPolylineRendering

顧客の乗車区間におけるすべての地域の交通速度を示すポリライン レンダリング。

string

出力専用。形式は「providers/{provider}/trips/{trip}」です。

string

このルートを走行する車両の ID。

TripStatus

ルートの現在のステータス。

TripType

ルートのタイプ。

TerminalLocation

お客様が集荷と指定した場所。

StopLocation

入力のみ。お客様が集荷された日時と場所。このフィールドは、プロバイダが実際の受け取りに関する情報に関するフィードバックを提供するためのものです。

StopLocation

入力のみ。ドライバーが乗車ポイントに到着する実際の時刻と場所。このフィールドは、プロバイダが乗車場所への実際の到着情報についてフィードバックを提供するためのものです。

Timestamp

出力専用。今後乗客が乗車する予定時刻、または乗車時刻の実際の時刻のいずれか。

TerminalLocation

（乗車と降車に加えて）リクエストの対象となる中間の駅 / 停留所。現時点では、この機能は共有ルートではサポートされていません。

Timestamp

intermediate_destinations が最後に変更された時刻を示します。intermediate_destinations が変更されないように、intermediate_destination_index の更新時にサーバーがこの値をキャッシュに保存して UpdateTripRequest に渡す必要があります。

int32

TripStatus が ENROUTE_TO_INTERMEDIATE_DESTINATION の場合、[0..N-1] の数値で、車両が次に通過する中間目的地を示します。TripStatus が ARRIVED_AT_INTERMEDIATE_DESTINATION の場合、[0..N-1] の数値で車両がどの中間目的地にあるかを示します。この値はプロバイダが設定します。intermediate_destinations がない場合、このフィールドは無視されます。

StopLocation

入力のみ。ドライバーが中間目的地に到着した実際の時刻と場所。このフィールドは、プロバイダが中間目的地での実際の到着情報についてフィードバックを提供するためのものです。

StopLocation

入力のみ。お客様が中間の配送先から集荷された日時と場所。このフィールドは、プロバイダが中間目的地での実際の乗車情報に関するフィードバックを提供するためのものです。

TerminalLocation

お客様が持ち込みを予定している場所。

StopLocation

入力のみ。お客様が放棄した日時と場所。これは、プロバイダが実際の持ち込み情報に関するフィードバックを提供するためのものです。

Timestamp

出力専用。乗客が最終目的地で降車する推定時刻、または降車する実際の時刻のいずれか。

TripWaypoint

出力専用。現在地から降車場所までのフルパス（両端を含む）。この経路には、他のルートの地点を含めることができます。

TripWaypoint

このフィールドでは、ルートのウェイポイントを手動で順序付けできます。割り当てられた車両の残りのすべての地点と、このルートの乗車地点と降車地点が含まれています。ルートが車両に割り当てられていない場合、Fleet Engine はこのフィールドを無視します。プライバシー上の理由から、このフィールドは UpdateTrip 呼び出しと CreateTrip 呼び出しでのみサーバーによって入力され、GetTrip 呼び出しでは入力されません。

LatLng

出力専用。現在のルートで、replication_waypoints の最初のエントリーまでのルートが予想されます。最初のウェイポイントは別のルートに属している場合があります。

string

出力専用。次のウェイポイントへのエンコードされたパス。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。デコードはまだサポートされていません。

Timestamp

出力専用。経路が最後に変更された時刻を示します。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。

ConsumableTrafficPolyline

出力専用。current_route_segment 付近の交通状況を示します（利用可能な場合）。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。

Timestamp

出力専用。current_route_segment_traffic が最後に変更された時刻を示します。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。

TripWaypoint

出力専用。current_route_segment が終了する地点。

Int32Value

出力専用。current_route_segment フィールドの残りの運転距離。ルートが車両に割り当てられていない場合、またはルートが完了またはキャンセルされた場合は、値は指定されません。

Timestamp

出力専用。次の地点（remaining_waypoints フィールドの最初のエントリ）までの到着予定時刻です。ルートが車両に割り当てられていない場合、またはルートが非アクティブ（完了またはキャンセル）の場合、値は指定されません。

Duration

出力専用。ルートデータが返された時点から Trip.eta_to_first_waypoint の時刻までの時間。ルートが車両に割り当てられていない場合、またはルートが非アクティブ（完了またはキャンセル）の場合、値は指定されません。

Timestamp

出力専用。remaining_waypoints が最後に変更された時間（地点が追加、削除、または変更された時間）を示します。

Timestamp

出力専用。remaining_waypoints.path_to_waypoint と remaining_waypoints.traffic_to_waypoint が最後に変更された時刻を示します。remaining_waypoints のパスとトラフィックが更新された場合にのみ返されるように、クライアント アプリはこの値をキャッシュに保存して GetTripRequest に渡す必要があります。

int32

変更不可。このルートの乗客数を示します。運転手は含みません。SearchVehicles レスポンスで車両に返すには、利用可能なキャパシティが必要です。

VehicleLocation

出力専用。ルート上で最後に報告された車両の位置を示します。

bool

出力専用。車両の last_location を current_route_segment にスナップできるかどうかを示します。last_location または current_route_segment が存在しない場合は false。Fleet Engine によって計算されます。クライアントからの更新は無視されます。

TripView

入力される Trip フィールドのサブセットと、その解釈方法。

TerminalLocation

このウェイポイントの位置。

string

このウェイポイントに関連付けられたルート。

WaypointType

このルートにおいてこの地点が果たす役割（乗車や降車など）。

LatLng

前のウェイポイントから現在のウェイポイントまでのパス。リストの最初のウェイポイントで未定義です。このフィールドは、リクエストされた場合にのみ入力されます。

string

前の地点から現在の地点までのエンコードされたパス。

注: このフィールドは、Driver SDK と Consumer SDK による使用のみを対象としています。デコードはまだサポートされていません。

ConsumableTrafficPolyline

この地点までの経路の交通状況です。交通状況のデータを利用できるのは、Google Map Platform 配車と配達ソリューションのお客様のみです。

Int32Value

前のウェイポイントから現在のウェイポイントまでのパス距離。リストの最初のウェイポイントで未定義です。

Timestamp

この地点に到着する予定時刻です。リストの最初のウェイポイントで未定義です。

Duration

前の地点からこの地点までの移動時間です。リストの最初のウェイポイントで未定義です。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider}/trips/{trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-consumer-project など）である必要があります。

Trip

必須。更新情報に関連付けられたルート。

Fleet Engine によって維持されるフィールドは次のとおりです。Trip.update を使用して更新しないでください。

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

共有ルートの Trip.vehicle_id を更新する場合は、Trip.vehicle_waypoints のリストを指定して残りの地点の順序を指定する必要があります。指定しない場合、順序は不定になります。

Trip.vehicle_waypoints を指定する場合、リストには車両のルートの残りのすべてのウェイポイントが含まれ、余分なウェイポイントが含まれないようにする必要があります。これらの地点の順序は、特定のルートで乗車地点が中間目的地の前に、すべての中間目的地が降車地点の前に配置されるようにする必要があります。EXCLUSIVE のルートの地点を他のルートとインターリーブすることはできません。trip_id、waypoint_type、location の各フィールドが使用され、vehicle_waypoints のその他の TripWaypoint フィールドはすべて無視されます。

複数の目的地を含むルートの競合状態を回避するには、ルートのステータスを ENROUTE_TO_INTERMEDIATE_DESTINATION に更新する際に Trip.intermediate_destinations_version を指定する必要があります。渡される Trip.intermediate_destinations_version は、Fleet Engine のバージョンと一致している必要があります。有効になっていない場合、リクエストは失敗します。

FieldMask

必須。ルート内で更新するフィールドを示すフィールド マスク。update_mask には少なくとも 1 つのフィールドが必要です。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）である必要があります。

VehicleAttribute

必須。更新する車両属性。記載されていない属性の変更や削除は行われません。

VehicleAttribute

必須。車両属性の完全なリスト（新しい属性、変更された属性、元の属性を含む）。

RequestHeader

標準の Fleet Engine リクエスト ヘッダー。

string

必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。{provider} は、この呼び出しを行うサービス アカウントがメンバーとなっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。

Vehicle

必須。適用する Vehicle エンティティ値。Vehicle を更新するときに、次のフィールドはサーバーによって管理されているため、更新されないことがあります。

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

attributes フィールドが更新されると、車両のすべての属性がリクエストで指定された属性に置き換えられます。一部の属性のみを更新する場合は、UpdateVehicleAttributes メソッドをご覧ください。

同様に、waypoints フィールドも更新できますが、車両上のすべてのウェイポイントが含まれていなければなりません。他のウェイポイントを含めることはできません。

FieldMask

必須。Vehicle のどのフィールドを更新するかを示すフィールド マスク。フィールド名を少なくとも 1 つ指定する必要があります。

string

出力専用。この車両の一意の名前。形式は providers/{provider}/vehicles/{vehicle} です。

VehicleState

車両の状態。

TripType

この車両でサポートされているルートのタイプ。

string

出力専用。この車両に現在割り当てられているルートの trip_id のリスト。

VehicleLocation

最後に報告された車両の位置。

int32

この車両の乗車人数の合計。この値ではドライバは考慮されません。1 以上の値を指定してください。

VehicleAttribute

車両属性のリスト。車両に指定できる属性は最大 100 個で、各属性には一意のキーが必要です。

VehicleType

必須。この車両のタイプ。SearchVehicles の結果で車両をフィルタするために使用できます。到着予定時刻やルートの計算にも影響します。

LicensePlate

車両のナンバー プレート情報。

TerminalLocation

非推奨: 代わりに Vehicle.waypoints を使用してください。

string

ドライバー アプリが次のウェイポイントまで進むルートを指定するポリライン。このリストは、車両に割り当てられているすべての有効なルートについて、Trip.current_route_segment でも返されます。

注: このフィールドは、Driver SDK による使用のみを目的としています。デコードはまだサポートされていません。

TrafficPolylineData

入力のみ。Fleet Engine はこの情報を使用して、ジャーニーの共有を改善します。注: このフィールドは、Driver SDK による使用のみを目的としています。

Timestamp

出力専用。current_route_segment が設定された時刻。変更されていないルートを返さないように、クライアントで保存して将来の GetVehicle リクエストに渡すこともできます。

TripWaypoint

current_route_segment が終了する地点。運転手は UpdateVehicle 呼び出しで、完全なルートの地点、地点の LatLng、または current_route_segment の最後の LatLng として指定できます。Fleet Engine は、完全に指定されていない場合、実際の地点に補間しようと最善を尽くします。current_route_segment も指定されていない限り、このフィールドは UpdateVehicle の呼び出しでは無視されます。

Int32Value

current_route_segment の残りの運転距離。この値は、車両に割り当てられているすべての有効なルートの Trip.remaining_distance_meters でも返されます。current_route_segment フィールドが空の場合、値は指定されません。

Timestamp

waypoints フィールドの最初のエントリの到着予定時刻。waypoints フィールドが空の場合、または Vehicle.current_route_segment フィールドが空の場合、値は指定されません。

車両を更新する場合、同じリクエスト内で remaining_time_seconds が eta_to_first_waypoint よりも優先されます。

Int32Value

入力のみ。current_route_segmentの残りの運転時間。waypoints フィールドが空の場合、または Vehicle.current_route_segment フィールドが空の場合、値は指定されません。すべての関係者が同じ時計を使用している場合、この値は eta_to_first_waypoint - current_time と一致する必要があります。

車両を更新する場合、同じリクエスト内で remaining_time_seconds が eta_to_first_waypoint よりも優先されます。

TripWaypoint

この車両に割り当てられている残りのウェイポイント。

Timestamp

出力専用。waypoints フィールドが最後に更新された時刻。waypoints フィールドが更新された場合にのみ返されるように、クライアントはこの値をキャッシュに保存して GetVehicleRequest に渡す必要があります。

bool

連続したルートを運転手が受け入れているかどうかを示します。true の場合、SearchVehicles に車両が現在ルートに割り当てられている場合でも、車両が含まれる可能性があります。デフォルト値は false です。

NavigationStatus

車両のナビゲーション ステータス。

DeviceSettings

入力のみ。ドライバが使用しているモバイル デバイスの設定に関する情報。

Category

車種カテゴリ

string

属性のキー。キーにコロン（:）を含めることはできません。

string

属性の値。

string

文字列型の属性値。

注: これは、最終的にサポートが終了する value フィールドと同じです。create メソッドまたは update メソッドでは、どちらのフィールドも使用できますが、string_value を使用することを強くおすすめします。string_value と value の両方が設定されている場合、これらは同一である必要があります。そうでない場合はエラーがスローされます。レスポンスにはどちらのフィールドも入力されます。

bool

ブール値型の属性値。

double

二重型属性値。

VehicleAttribute

このコレクション内の属性のリスト。

LatLng

車両の位置。Fleet Engine に送信された場合、車両の位置は GPS 位置情報となります。レスポンスで受信された車両の位置は、GPS 位置、補足位置、その他の推定位置のいずれかになります。ソースは location_sensor で指定します。

DoubleValue

非推奨: 代わりに latlng_accuracy を使用してください。

DoubleValue

location の精度（半径としてのメートル単位）。

Int32Value

車両の移動方向（度単位）。0 は北を表します。有効な範囲は [0,360] です。

DoubleValue

非推奨: 代わりに heading_accuracy を使用してください。

DoubleValue

heading の精度（度単位）。

DoubleValue

WGS84 からの高度（メートル単位）。

DoubleValue

非推奨: 代わりに altitude_accuracy を使用してください。

DoubleValue

altitude の精度（メートル単位）。

Int32Value

車両の速度（km/時）。非推奨: 代わりに speed を使用してください。

DoubleValue

車両の速度（メートル/秒）

DoubleValue

speed の精度（メートル/秒）。

Timestamp

センサーのクロックに基づき、センサーが location をレポートした時刻。

Timestamp

出力専用。サーバーが位置情報を受信した時刻。

LocationSensor

位置情報のプロバイダ（GPS など）。

BoolValue

location が道路にスナップされるかどうか。

BoolValue

入力のみ。モバイル デバイスで GPS センサーが有効になっているかどうかを示します。

Int32Value

入力のみ。この場所が最初にサーバーに送信されてからの時間（秒）。最初の更新ではゼロになります。時刻が不明な場合（アプリが再起動された場合など）、この値はゼロにリセットされます。

Int32Value

入力のみ。非推奨: 位置情報が古くなっているかどうかを判断するために、他のシグナルが使用されるようになりました。

LatLng

未加工の車両の位置情報（ロード スナッパーで処理されていない）。

Timestamp

元の場所に関連付けられたタイムスタンプ。

LocationSensor

未加工の場所のソース。デフォルトは GPS です。

DoubleValue

半径で表した raw_location の精度（メートル単位）。

LatLng

統合するアプリによって提供される補助的な位置情報。

Timestamp

補助的な場所に関連付けられたタイムスタンプ。

LocationSensor

補助的な場所のソース。デフォルトは CUSTOMER_SUPPLIED_LOCATION です。

DoubleValue

半径で表した supplemental_location の精度（メートル単位）。

bool

非推奨: 代わりに is_road_snapped を使用してください。

Vehicle

必須。リクエストに一致する車両。

Timestamp

リクエストで指定された乗車場所までの車両の運転 ETA。空の値は、車両の到着予定時刻を計算できなかったことを示します。SearchVehiclesRequest.include_back_to_back が true で、この車両に有効なルートがある場合、vehicle_pickup_eta には現在のアクティブなルートを完了するために必要な時間が含まれます。

Int32Value

車両の現在地からリクエストで指定された乗車ポイントまでの距離（既存のルートの中間乗車地点または降車地点を含む）。この距離は、計算された運転（ルート）距離と、ナビゲーションの終点とリクエストされた乗車ポイントの間の直線距離で構成されます。（ナビゲーションの終点からリクエストされた乗車ポイントまでの距離は通常短いです）。空の値は、距離の計算でエラーが発生したことを示します。

Int32Value

必須。リクエストで指定された乗車場所から車両までの直線距離。

Timestamp

リクエストで指定された降車場所までの車両の到着予定時刻。ETA には、リクエストで指定された dropoff_point の前にある任意の地点での停車地も含まれます。この値は、降車地点がリクエストで指定されている場合にのみ入力されます。空の値は、到着予定時刻の計算中にエラーが発生したことを示します。

Int32Value

リクエストで指定された乗車地点から降車地点までの車両の走行距離（メートル単位）。距離は 2 地点間の範囲のみであり、車両の位置や、車両が乗車ポイントまたは降車地点を訪問する前に訪問する必要があるその他のポイントは含まれません。この値は、リクエストで dropoff_point が指定されている場合にのみ入力されます。空の値は、リクエストで指定された乗車地点から降車地点までの距離を計算できなかったことを示します。

TripType

必須。乗車場所までの到着予定時刻を計算するために使用されたリクエストのルートタイプ。

Waypoint

到着予定時刻の計算に使用されるウェイポイントの順序付きリスト。このリストには、車両の位置情報、車両のアクティブなルートの乗車地点、リクエストで提供された乗車地点が含まれます。空のリストは、車両の到着予定時刻を計算できなかったことを示します。

VehicleMatchType

車両の一致タイプ。

VehicleMatchOrder

車両の一致の並べ替えにリクエストされた順序。

VehicleMatchOrder

この車両に使用された実際の注文。通常、これはリクエストの 'order_by' フィールドと一致しますが、内部サーバーエラーなどの特定の状況では、別のメソッド（PICKUP_POINT_STRAIGHT_DISTANCE など）が使用されることがあります。

RoadStretch

省略可。ポリラインに沿ってレンダリングされる道路の範囲。ストレッチは重複しないことが保証されており、必ずしもルート全体にわたるとは限りません。

道路のストレッチによるスタイル設定がない場合は、クライアントはルートにデフォルトを適用する必要があります。

Style

必須。適用するスタイル。

int32

必須。スタイルは [offset_meters, offset_meters + length_meters) の間に適用する必要があります。

int32

必須。スタイルを適用するパスの長さ。

LatLng

このウェイポイントの位置。

Timestamp

車両がこの地点に到着する推定時刻。