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

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

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

必須。作成する 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 での結合/論理積と、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> など）に関するものだけです。1 つのフィルタクエリで許可される制限の最大数は 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 m の範囲で指定してください。

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 での結合/論理積と、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> など）に関するものだけです。1 つのフィルタクエリで許可される制限の最大数は 50 です。

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

VehicleMatch

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

int32

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

int32

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

Speed

この期間の交通状況。

LatLng

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

Timestamp

停止が行われた時間を示します。

Timestamp

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

LatLng

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

TerminalPointId

非推奨: 代わりに point フィールドを指定してください。

string

非推奨: 代わりに point フィールドを指定してください。

string

サポート終了。

WaypointType

サポート終了: このデータは Vehicle.waypoint に含まれます。

string

サポート終了。

string

サポート終了。

string

サポート終了。

VisualTrafficReportPolylineRendering

顧客の乗車区間 1 区間のすべての地域の交通量を示すポリライン レンダリング。

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

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

LatLng

出力専用。そのルートで、rement_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 が最後に変更された時刻を示します。クライアント アプリでこの値をキャッシュに保存して GetTripRequest に渡して、remaining_waypoints のパスとトラフィックが更新された場合にのみ返されるようにする必要があります。

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

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

車両の速度（キロメートル/時）。非推奨: 代わりに 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

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

Int32Value

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

Int32Value

必須。リクエストで指定された乗車地点までの直線距離。

Timestamp

リクエストで指定された降車地点までの車両全体の運転到着予定時刻。ETA には、リクエストで指定された dropoff_point より前の任意の地点での停止も含まれます。値は、リクエストで降車地点が指定されている場合にのみ入力されます。値が空の場合は、ETA の計算エラーを示します。

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

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