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

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

Timestamp

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

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

報告されたルートに使用された GMP プロダクト ソリューションのタイプ（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 の連結演算子（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>）。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_destination_index の更新時に UpdateTripRequest に渡して、intermediate_destinations が変更されないようにする必要があります。

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

出力専用。remaining_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

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

TerminalLocation

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

string

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

WaypointType

乗車や降車など、このルートでこの地点が果たす役割。

LatLng

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

string

前のウェイポイントから現在のウェイポイントまでのエンコードされたパス。

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

ConsumableTrafficPolyline

このウェイポイントまでの経路の交通状況。トラフィックは、Google Maps 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 フィールドと同じです。作成メソッドまたは更新メソッドでは、どちらのフィールドでも使用できますが、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

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