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_status を CANCELED として渡しても、すべてのルートの 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

必須。作成する 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

BCP-47 言語コード（en-US や sr-Latn など）。詳しくは、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

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

string

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

string

サポート終了。

WaypointType

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

string

サポート終了。

string

サポート終了。

string

サポート終了。

VisualTrafficReportPolylineRendering

お客様の乗車ルートの区間全体のすべての地域の交通状況をポリラインでレンダリングしたものです。

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

このフィールドでは、ルートの経由地を手動で並べ替えることができます。割り当てられた車両の残りのすべてのウェイポイントと、このルートの乗車と降車のウェイポイントが含まれます。ルート車両が割り当てられていない場合、このフィールドは無視されます。プライバシー上の理由から、このフィールドは GetTrip 呼び出しではなく、UpdateTrip 呼び出しと CreateTrip 呼び出しでのみサーバーが入力します。

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

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

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

リクエストで指定された降車地点までの車両の総走行所要時間。所要時間には、リクエストで指定された dropoff_point の前に立ち寄る地点での停車時間も含まれます。この値は、リクエストで集荷ポイントが指定されている場合にのみ入力されます。値が空の場合は、所要時間の計算中にエラーが発生したことを示します。

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

車両の一致のタイプ。

VehicleMatchOrder

車両の一致を並べ替えるためにリクエストされた順序。ordered_by と同じです。

VehicleMatchOrder

車両の一致を並べ替えるためにリクエストされた順序。requested_ordered_by と同じです。

RoadStretch

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

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

Style

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

int32

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

int32

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

LatLng

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

Timestamp

車両がこのウェイポイントに到着する予定時刻。