Package maps.fleetengine.v1

インデックス

• TripService（インターフェース）
• VehicleService（インターフェース）
• BatteryInfo（メッセージ）
• BatteryStatus（列挙型）
• BillingPlatformIdentifier（列挙型）
• ConsumableTrafficPolyline（メッセージ）
• CreateTripRequest（メッセージ）
• CreateVehicleRequest（メッセージ）
• DeviceSettings（メッセージ）
• GetTripRequest（メッセージ）
• GetVehicleRequest（メッセージ）
• LicensePlate（メッセージ）
• ListVehiclesRequest（メッセージ）
• ListVehiclesResponse（メッセージ）
• LocationPowerSaveMode（列挙型）
• LocationSensor（列挙型）
• NavigationStatus（列挙型）
• PolylineFormatType（列挙型）
• PowerSource（列挙型）
• ReportBillableTripRequest（メッセージ）
• ReportBillableTripRequest.SolutionType（列挙型）
• RequestHeader（メッセージ）
• RequestHeader.Platform（列挙型）
• RequestHeader.SdkType（列挙型）
• SearchTripsRequest（メッセージ）
• SearchTripsResponse（メッセージ）
• SearchVehiclesRequest（メッセージ）
• SearchVehiclesRequest.CurrentTripsPresent（列挙型）
• SearchVehiclesRequest.VehicleMatchOrder（列挙型）
• SearchVehiclesResponse（メッセージ）
• SpeedReadingInterval（メッセージ）
• SpeedReadingInterval.Speed（列挙型）
• StopLocation（メッセージ）
• TerminalLocation（メッセージ）
• TerminalPointId（メッセージ）（非推奨）
• TrafficPolylineData（メッセージ）
• Trip（メッセージ）
• TripStatus（列挙型）
• TripType（列挙型）
• TripView（列挙型）
• TripWaypoint（メッセージ）
• UpdateTripRequest（メッセージ）
• UpdateVehicleAttributesRequest（メッセージ）
• UpdateVehicleAttributesResponse（メッセージ）
• UpdateVehicleRequest（メッセージ）
• Vehicle（メッセージ）
• Vehicle.VehicleType（メッセージ）
• Vehicle.VehicleType.Category（列挙型）
• VehicleAttribute（メッセージ）
• VehicleAttributeList（メッセージ）
• VehicleLocation（メッセージ）
• VehicleMatch（メッセージ）
• VehicleMatch.VehicleMatchType（列挙型）
• VehicleState（列挙型）
• VisualTrafficReportPolylineRendering（メッセージ）
• VisualTrafficReportPolylineRendering.RoadStretch（メッセージ）
• VisualTrafficReportPolylineRendering.RoadStretch.Style（列挙型）
• Waypoint（メッセージ）
• WaypointType（列挙型）

TripService

ルート管理サービス。

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) Fleet Engine でルートを作成し、新しいルートを返します。

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) 特定のルートに関する情報を取得します。

ReportBillableTrip
rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty) 課金対象のルート利用状況を報告します。

SearchTrips
rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse) 特定の車両のすべてのルートを取得します。

UpdateTrip
rpc UpdateTrip(UpdateTripRequest) returns (Trip) ルートデータを更新します。

VehicleService

車両管理サービス。

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle) オンデマンドのライドシェアまたは配達のプロバイダに関連付けられた新しい車両をインスタンス化します。各 Vehicle には一意の車両 ID が必要です。 Vehicle を作成する場合、次の Vehicle フィールドが必要です。 vehicleState supportedTripTypes maximumCapacity vehicleType Vehicle の作成時に、次の Vehicle フィールドは無視されます。 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 その他のフィールドはすべて省略可能で、指定されている場合に使用されます。

GetVehicle
rpc GetVehicle(GetVehicleRequest) returns (Vehicle) Fleet Engine から車両を返します。

ListVehicles
rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse) リクエストのオプションに一致するプロバイダに関連付けられている車両を、ページ分けされたリストで返します。

SearchVehicles
rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse) リクエストのオプションに一致する車両のリストを返します。

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle) 更新された車両データを Fleet Engine に書き込みます。 Vehicle を更新するとき、次のフィールドはサーバーによって管理されるため、更新できません。 currentTrips availableCapacity current_route_segment_version waypoints_version 車両 name も更新できません。 attributes フィールドが更新されると、すべての車両属性がリクエストで指定された属性に置き換えられます。一部の属性のみを更新する場合は、UpdateVehicleAttributes メソッドをご覧ください。同様に、waypoints フィールドも更新できますが、車両上に現在あるすべての地点を含み、他の地点は含まれていない必要があります。

UpdateVehicleAttributes
rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse) 車両の属性を部分的に更新します。リクエストに記載されている属性のみが更新され、他の属性は変更されません。注: これは UpdateVehicle では異なり、attributes フィールド全体が UpdateVehicleRequest のフィールドで置き換えられ、リクエストにない属性は削除されます。

BatteryInfo

デバイスのバッテリーに関する情報。

フィールド
battery_status	BatteryStatus バッテリーの状態（フル、充電など）
power_source	PowerSource バッテリー電源のステータス。
battery_percentage	float 現在のバッテリー残量（0 ～ 100）。

BatteryStatus

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

列挙型
UNKNOWN_BATTERY_STATUS	バッテリーの状態が不明です。
BATTERY_STATUS_CHARGING	バッテリーを充電しています。
BATTERY_STATUS_DISCHARGING	バッテリーが放電中です。
BATTERY_STATUS_FULL	バッテリー残量: フル
BATTERY_STATUS_NOT_CHARGING	バッテリーが充電されていません。
BATTERY_STATUS_POWER_LOW	バッテリー残量が少なくなっています。

BillingPlatformIdentifier

リクエストが発行されたプラットフォームを示す値のセット。

列挙型
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED	デフォルト。未指定のプラットフォームに使用されます。
SERVER	プラットフォームはクライアント サーバーです。
WEB	このプラットフォームはウェブブラウザです。
ANDROID	プラットフォームは Android モバイル デバイスです。
IOS	プラットフォームは iOS モバイル デバイスです。
OTHERS	この一覧にない他のプラットフォーム。

ConsumableTrafficPolyline

車両の経路上の交通密度。

フィールド
speed_reading_interval[]	SpeedReadingInterval 前の地点から現在の地点までの経路の渋滞状況。
encoded_path_to_waypoint	string 前のウェイポイントから現在のウェイポイントまで、ドライバーが通っているパス。この経路にはランドマークが配置されており、クライアントが経路に沿った交通マーカーを表示できます（speed_reading_interval を参照）。デコードはまだサポートされていません。

CreateTripRequest

CreateTrip リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
parent	string 必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
trip_id	string 必須。一意のルート ID。以下の制限が適用されます。 有効な Unicode 文字列を指定する必要があります。 最大文字数は 64 文字です。 Unicode 正規化フォーム C に従って正規化されます。 ASCII 文字「/」、「:」、「?」、「」、「#」を含めることはできません。
trip	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 フィールドは無視されます。

CreateVehicleRequest

CreateVehicle リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
parent	string 必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
vehicle_id	string 必須。一意の車両 ID。以下の制限が適用されます。 有効な Unicode 文字列を指定する必要があります。 最大文字数は 64 文字です。 Unicode 正規化フォーム C に従って正規化されます。 ASCII 文字「/」、「:」、「?」、「」、「#」を含めることはできません。
vehicle	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 その他のフィールドはすべて省略可能で、指定されている場合に使用されます。

DeviceSettings

モバイル デバイスのさまざまな設定に関する情報。

フィールド
location_power_save_mode	LocationPowerSaveMode バッテリー セーバーがオンのときに、デバイスで位置情報機能がどのように動作するかを示します。
is_power_save_mode	bool デバイスが現在省電力モードかどうか。
is_interactive	bool デバイスがインタラクティブな状態かどうか。
battery_info	BatteryInfo バッテリーの状態に関する情報。

GetTripRequest

GetTrip リクエスト メッセージです。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
name	string 必須。providers/{provider}/trips/{trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
view	TripView 返される Trip フィールドのサブセットとその解釈。
current_route_segment_version	Timestamp Trip.route データまたは Trip.current_route_segment データを取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降にルートデータが変更されていない場合、レスポンスの route フィールドはありません。最小値が指定されていない場合、ルートデータは常に取得されます。
remaining_waypoints_version	Timestamp Trip.remaining_waypoints を取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降変更されていない場合、レスポンスに remaining_waypoints は設定されません。このフィールドを省略すると、常に remaining_waypoints が取得されます。
route_format_type	PolylineFormatType 返された現在の経路形式、LAT_LNG_LIST_TYPE（Trip.route 内）、または ENCODED_POLYLINE_TYPE（Trip.current_route_segment 内）。デフォルトは LAT_LNG_LIST_TYPE です。
current_route_segment_traffic_version	Timestamp Trip.current_route_segment_traffic を取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降にトラフィック データが変更されていない場合、レスポンスの current_route_segment_traffic フィールドは設定されません。最小値が指定されていない場合、常にトラフィック データが取得されます。交通状況を利用できるのは、オンデマンド配車および配達ソリューションのお客様のみです。
remaining_waypoints_route_version	Timestamp Trip.remaining_waypoints.traffic_to_waypoint データと Trip.remaining_waypoints.path_to_waypoint データを取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降にデータが変更されていない場合、上記のフィールドはレスポンスに設定されません。remaining_waypoints_route_version が指定されていない場合、トラフィックとパスは常に取得されます。

GetVehicleRequest

GetVehicle リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
name	string 必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
current_route_segment_version	Timestamp Vehicle.current_route_segment を取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降、ルートが変更されていない場合、レスポンスの current_route_segment フィールドは設定されません。最小値が指定されていない場合、常に current_route_segment が取得されます。
waypoints_version	Timestamp Vehicle.waypoints データを取得する最小のタイムスタンプ（その値を含まない）を示します。このタイムスタンプ以降、地点が変更されていない場合、レスポンスに vehicle.waypoints データは設定されません。このフィールドを省略すると、常に vehicle.waypoints が取得されます。

LicensePlate

車両のナンバー プレート情報。個人を特定できる情報が保存されないように、エンティティの一部として保存されるのは、ナンバー プレートに関する最小限の情報のみです。

フィールド
country_code	string 必須。CLDR の国/地域コード。たとえば、米国は US、インドは IN です。
last_character	string ナンバー プレートの最後の桁または「-1」ナンバー プレートに数値がないことを示します。 「ABC 1234」->「4」 「AB 123 CD」->「3」 「ABCDEF」->「-1」

ListVehiclesRequest

ListVehicles リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
parent	string 必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
page_size	int32 返される車両の最大数。デフォルト値: 100。
page_token	string 前回の ListVehicles 呼び出しによって提供された next_page_token の値。これにより、車両のグループをページ分割できます。リクエストのフィルタ条件が、前回の ListVehicles 呼び出しのフィルタ条件と同じでない場合、値は定義されません。
minimum_capacity	Int32Value 車両に必要な最小容量を指定します。返されるすべての車両の maximum_capacity は、この値以上になります。設定する場合は 0 以上にする必要があります。
trip_types[]	TripType 指定されたルートタイプの少なくとも 1 つをサポートする車両へのレスポンスを制限します。
maximum_staleness	Duration 指定された期間内に Fleet Engine に位置情報の更新を送信した車両へのレスポンスを制限します。静止している車両が位置情報を送信し続けている場合、古い車両とはみなされません。指定する場合は、有効な正の期間である必要があります。
vehicle_type_categories[]	Category 必須。指定されたタイプカテゴリのいずれかを持つ車両へのレスポンスを制限します。UNKNOWN は許可されていません。
required_attributes[]	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」形式にする必要があります。
required_one_of_attributes[]	string 各 VehicleAttributeList で指定された属性を少なくとも 1 つ持つ車両にレスポンスを制限します。各リスト内で、車両は少なくとも 1 つの属性に一致する必要があります。このフィールドは、各 VehicleAttributeList での包括的な分離/OR 演算と、VehicleAttributeList のコレクション全体の結合/AND 演算です。繰り返される各文字列は、「key1:value1|key2:value2|key3:value3」の形式にする必要があります。
required_one_of_attribute_sets[]	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」の形式にする必要があります。
vehicle_state	VehicleState この車両状態を持つ車両へのレスポンスを制限します。
on_trip_only	bool 現在のルートの車両のみを返却してください。
filter	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	Viewport 省略可。返される車両を、最後に確認された場所がビューポートで定義された長方形の領域内にあった車両に制限するフィルタ。

ListVehiclesResponse

ListVehicles レスポンス メッセージ。

フィールド
vehicles[]	Vehicle リクエストの条件に一致する車両。返される車両の最大数は、リクエストの page_size フィールドによって決まります。
next_page_token	string 車両の次のページを取得するためのトークン。リクエスト条件を満たす車両がこれ以上ない場合は空です。
total_size	int64 必須。すべてのページでのリクエスト条件に一致する車両の合計数。

LocationPowerSaveMode

モバイル デバイスが「バッテリー セーバー」のとき、位置情報機能が動作する仕組み機能がオンになっていることを確認します。(https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

列挙型
UNKNOWN_LOCATION_POWER_SAVE_MODE	未定義の LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE	位置情報プロバイダがバッテリー セーバーの影響を受けないか、バッテリー セーバーがオフになっている。
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF	バッテリー セーバーがオンになっていて、デバイスが非インタラクティブ モードの場合は、GPS ベースの位置情報プロバイダを無効にする必要があります。
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF	バッテリー セーバーがオンになっていて、デバイスが非インタラクティブ モードの場合は、位置情報プロバイダをすべて無効にする必要があります。
LOCATION_MODE_FOREGROUND_ONLY	位置情報プロバイダはすべて引き続き利用できますが、位置情報の修正はフォアグラウンド アプリに対してのみ提供する必要があります。
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF	位置情報がオフになることはありませんが、デバイスがインタラクティブでない場合、LocationManager はプロバイダへのすべてのリクエストをスロットリングします。

LocationSensor

位置情報の特定に使用されたセンサーまたは手法。

列挙型
UNKNOWN_SENSOR	センサーが指定されていないか、不明です。
GPS	GPS またはアシスト GPS。
NETWORK	アシスト GPS、携帯電話の基地局 ID、Wi-Fi アクセス ポイント。
PASSIVE	携帯電話の基地局 ID または Wi-Fi アクセス ポイント。
ROAD_SNAPPED_LOCATION_PROVIDER	モバイル デバイスによって、道路の位置として最も可能性が高いと判定された場所。
CUSTOMER_SUPPLIED_LOCATION	独立した情報源からの顧客指定のビジネス情報。通常、この値は Driver SDK を実行しているモバイル デバイス以外のソースから提供される場所に使用されます。元のソースが他の列挙値のいずれかによって記述されている場合は、その値を使用します。CUSTOMER_SUPPLIED_LOCATION とマークされた場所は、通常、車両の last_location.supplemental_location_sensor によって指定されます。
FLEET_ENGINE_LOCATION	Fleet Engine によって、利用可能なシグナルに基づいて計算されたロケーション。出力専用。この値は、リクエストで受け取った場合拒否されます。
FUSED_LOCATION_PROVIDER	Android の融合された位置予測プロバイダです。
CORE_LOCATION	Apple オペレーティング システムの位置情報プロバイダ。

NavigationStatus

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

列挙型
UNKNOWN_NAVIGATION_STATUS	ナビゲーション ステータスが指定されていません。
NO_GUIDANCE	ドライバー アプリのナビゲーションが FREE_NAV モードになっています。
ENROUTE_TO_DESTINATION	ターンバイターン方式のナビが利用可能になり、ドライバー アプリのナビゲーションが GUIDED_NAV モードになりました。
OFF_ROUTE	車両が提案されたルートを外れた。
ARRIVED_AT_DESTINATION	車両が目的地から約 50 m 以内にあること。

PolylineFormatType

ポリライン フォーマットのタイプ。

列挙型
UNKNOWN_FORMAT_TYPE	形式が指定されていないか、不明です。
LAT_LNG_LIST_TYPE	google.type.LatLng のリスト。
ENCODED_POLYLINE_TYPE	ポリライン圧縮アルゴリズムでエンコードされたポリライン。デコードはまだサポートされていません。

PowerSource

バッテリーの充電に使用している充電器のタイプ。

列挙型
UNKNOWN_POWER_SOURCE	電源が不明です。
POWER_SOURCE_AC	電源は AC 充電器です。
POWER_SOURCE_USB	電源は USB ポートです。
POWER_SOURCE_WIRELESS	電源はワイヤレスです。
POWER_SOURCE_UNPLUGGED	バッテリーが電源から外されている。

ReportBillableTripRequest

ReportBillableTrip リクエスト メッセージです。

フィールド
name	string 必須。providers/{provider}/billableTrips/{billable_trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
country_code	string 必須。旅行を行う国の 2 文字の国コード。価格は国コードに従って定義されます。
platform	BillingPlatformIdentifier リクエストが発行されたプラットフォーム。
related_ids[]	string 報告されるルートに直接関連する識別子。通常、ルート ID が利用可能になる前に行われた事前予約の ID（セッション ID など）です。related_ids の数は 50 個に制限されています。
solution_type	SolutionType 報告されたルートで使用されている Google マーケティング プラットフォーム サービス ソリューションのタイプ（例: ON_DEMAND_RIDESHARING_AND_DELIVERIES）。

ソリューション タイプ

報告するルートのさまざまなソリューション タイプのセレクタ。

列挙型
SOLUTION_TYPE_UNSPECIFIED	デフォルト値。下位互換性を確保するため、API はデフォルトで ON_DEMAND_RIDESHARING_AND_DELIVERIES を使用します。これは、サポートされている最初のソリューション タイプです。
ON_DEMAND_RIDESHARING_AND_DELIVERIES	その解決策が、オンデマンドのライドシェアリングと配達です。

RequestHeader

RequestHeader には、すべての Fleet Engine RPC リクエストに共通するフィールドが含まれています。

フィールド
language_code	string en-US、sr-Latn などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。何も指定しない場合、レスポンスは任意の言語で返されます。そのような名前が存在する場合は、英語が優先されます。フィールド値の例: en-US。
region_code	string 必須。リクエスト送信元のリージョンの CLDR リージョン コード。フィールド値の例: US。
sdk_version	string 呼び出し元の SDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 1.1.2）。
os_version	string 呼び出し元の SDK が実行されているオペレーティング システムのバージョン。フィールド値の例: 4.4.1、12.1。
device_model	string 呼び出し元の SDK が実行されているデバイスのモデル。フィールド値の例: iPhone12,1、SM-G920F。
sdk_type	SdkType リクエストを送信する SDK のタイプ。
maps_sdk_version	string 呼び出し元の SDK が依存する MapSDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 5.2.1）。
nav_sdk_version	string 呼び出し元の SDK が依存する NavSDK のバージョン（該当する場合）。バージョンの形式は「major.minor.patch」です（例: 2.1.0）。
platform	Platform 呼び出し元の SDK のプラットフォーム。
manufacturer	string 呼び出し元の SDK に含まれる Android デバイスのメーカー。Android SDK にのみ適用されます。フィールド値の例: Samsung。
android_api_level	int32 呼び出し元の SDK の Android API レベル。Android SDK にのみ適用されます。フィールド値の例: 23。
trace_id	string リクエストを識別するために、ロギングのために提供できる ID（省略可）。

プラットフォーム

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

列挙型
PLATFORM_UNSPECIFIED	デフォルト値。プラットフォームを省略すると、この値が使用されます。
ANDROID	Android からのリクエスト。
IOS	iOS からのリクエスト。
WEB	ウェブからリクエストが送られている。

SdkType

SDK の種類の例。

列挙型
SDK_TYPE_UNSPECIFIED	デフォルト値。この値は、sdk_type が省略されている場合に使用されます。
CONSUMER	呼び出し元の SDK は Consumer です。
DRIVER	呼び出し元の SDK は Driver です。
JAVASCRIPT	呼び出し元の SDK は JavaScript です。

SearchTripsRequest

SearchTrips リクエスト メッセージです。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
parent	string 必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
vehicle_id	string リクエスト内のルートに関連付けられている車両。指定しない場合、返されるルートには以下の情報は含まれません。 current_route_segment remaining_waypoints remaining_distance_meters eta_to_first_waypoint
active_trips_only	bool true に設定した場合、レスポンスにはドライバーのルートに影響するルートが含まれます。
page_size	int32 設定しない場合、返される結果の数はサーバーが決定します。
page_token	string 前の結果から続行するには、以前に SearchTripsResponse で返された値に設定します。
minimum_staleness	Duration 指定すると、(current - minimum_staleness) 以降に更新されていないルートを返します。

SearchTripsResponse

SearchTrips レスポンス メッセージ。

フィールド
trips[]	Trip リクエストされた車両のルートのリスト。
next_page_token	string このトークンを SearchTripsRequest で渡して、リストの結果を表示します。API は呼び出しのたびにルートリストを返し、それ以上の結果がなくなると、ルートリストは空になります。

SearchVehiclesRequest

SearchVehicles リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
parent	string 必須。providers/{provider} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
pickup_point	TerminalLocation 必須。検索する近くの乗車地点。
dropoff_point	TerminalLocation 顧客が意図する持ち込み場所。trip_types に TripType.SHARED が含まれている場合、このフィールドは必須です。
pickup_radius_meters	int32 必須。乗車地点を中心とした車両検索半径を定義します。検索半径内の車両のみが返されます。値は 400 ～ 10,000 m の範囲で指定してください。
count	int32 必須。返される車両の最大数を指定します。値は 1 ～ 50 の範囲で指定してください。
minimum_capacity	int32 必須。旅行の対象となる乗客の人数を指定します。1 以上の値を指定してください。ドライバは容量値で考慮されません。
trip_types[]	TripType 必須。提案されたルートのタイプを表します。タイプを 1 つだけ含める必要があります。UNKNOWN_TRIP_TYPE は使用できません。検索対象のルートタイプをサポートできる車両のみに限定します。
maximum_staleness	Duration 指定した期間内に Fleet Engine に位置情報の更新を送信した車両のみに検索を制限します。静止している車両が位置情報を送信し続けている場合、古い車両とはみなされません。このフィールドが設定されていない場合、サーバーはデフォルト値として 5 分を使用します。
vehicle_types[]	VehicleType 必須。検索対象を、指定したタイプのいずれかを持つ車両に制限します。少なくとも 1 つの車両タイプを指定する必要があります。カテゴリが UNKNOWN の VehicleTypes は使用できません。
required_attributes[]	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 個です。車両で許可される最大属性数と一致します。
required_one_of_attributes[]	VehicleAttributeList 検索範囲を、各 VehicleAttributeList で指定された属性の 1 つ以上を持つ車両のみに限定します。各リスト内で、車両は少なくとも 1 つの属性に一致する必要があります。このフィールドは、各 VehicleAttributeList での包括的な分離/OR 演算と、VehicleAttributeList のコレクション全体の結合/AND 演算です。
required_one_of_attribute_sets[]	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 演算です。
order_by	VehicleMatchOrder 必須。結果の表示順序の基準を指定します。
include_back_to_back	bool 有効なルートが 1 つある車両がこの検索の対象となるかどうかを示します。このフィールドは、current_trips_present が指定されていない場合にのみ使用されます。current_trips_present が指定されておらず、このフィールドが false の場合、ルートが割り当てられている車両は検索結果から除外されます。current_trips_present が指定されておらず、このフィールドが true の場合、検索結果にはステータスが ENROUTE_TO_DROPOFF の有効なルートが 1 つある車両が含まれる可能性があります。current_trips_present が指定されている場合、このフィールドを true に設定することはできません。 デフォルト値は false です。
trip_id	string この SearchVehicleRequest に関連付けられたルートを示します。
current_trips_present	CurrentTripsPresent アクティブなルートを持つ車両がこの検索の対象となるかどうかを示します。trip_type に SHARED が含まれている場合は、CURRENT_TRIPS_PRESENT_UNSPECIFIED 以外に設定する必要があります。
filter	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"）。

CurrentTripsPresent

車両の現在のルートに対する制限のタイプを指定します。

列挙型
CURRENT_TRIPS_PRESENT_UNSPECIFIED	ルートが存在する車両の在庫状況は、include_back_to_back フィールドで管理されます。
NONE	ルート情報のない車両が検索結果に表示されることがあります。この値を使用する場合、include_back_to_back を true にすることはできません。
ANY	検索結果には、現在のルートが 5 つまで、地点が 10 か所までの車両が含まれます。この値を使用する場合、include_back_to_back を true にすることはできません。

VehicleMatchOrder

レスポンスで車両が一致する順序を指定します。

列挙型
UNKNOWN_VEHICLE_MATCH_ORDER	デフォルト。指定されていない、または認識できない車両の一致順序に使用されます。
PICKUP_POINT_ETA	乗車場所までの車両運転時間の昇順。
PICKUP_POINT_DISTANCE	乗車場所までの車両走行距離の昇順。
DROPOFF_POINT_ETA	降車地点までの車両運転時間の昇順。この順序は、リクエストで降車地点が指定されている場合にのみ使用できます。
PICKUP_POINT_STRAIGHT_DISTANCE	車両で最後に報告された場所から乗車地点までの直線距離の昇順。
COST	設定された一致費用の昇順。マッチ費用は、直線距離と到着予定時刻の加重計算として定義されます。重み付けはデフォルト値で設定され、お客様ごとに変更できます。プロジェクトでこれらの重みを変更する必要がある場合は、Google サポートにお問い合わせください。

SearchVehiclesResponse

SearchVehicles レスポンス メッセージ。

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

SpeedReadingInterval

経路の連続セグメントに表示される交通密度インジケーター。SpeedReadingInterval は、点 P_0、P_1、...、P_N（ゼロベースのインデックス）を持つパスが与えられると、間隔を定義し、次のカテゴリを使用してトラフィックを記述します。

フィールド
start_polyline_point_index	int32 パス内のこの区間の開始インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。
end_polyline_point_index	int32 パス内のこの区間の終了インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。
speed	Speed この期間の交通状況。

速度

交通データに基づいたポリラインの速度分類。

列挙型
SPEED_UNSPECIFIED	デフォルト値。この値は使用されません。
NORMAL	通常の速度で、速度低下は検出されません。
SLOW	軽い渋滞が検出されましたが、渋滞は発生していません。
TRAFFIC_JAM	渋滞を検知しました。

StopLocation

停車地（乗車または降車）が行われた実際の場所。

フィールド
point	LatLng 必須。実際の場所を示します。
timestamp	Timestamp 停止が行われた時間を示します。
stop_time (deprecated)	Timestamp この項目は非推奨です。 入力のみの非推奨です。タイムスタンプ フィールドを使用します。

TerminalLocation

ウェイポイントの位置を記述します。

フィールド
point	LatLng 必須。ルートの地点の位置を示します。
terminal_point_id (deprecated)	TerminalPointId この項目は非推奨です。 非推奨: 代わりに point フィールドを指定してください。
access_point_id (deprecated)	string この項目は非推奨です。 非推奨: 代わりに point フィールドを指定してください。
trip_id (deprecated)	string この項目は非推奨です。 サポート終了。
terminal_location_type (deprecated)	WaypointType この項目は非推奨です。 サポート終了: このデータは Vehicle.waypoint に含まれます。

TerminalPointId

この項目は非推奨です。

非推奨: Fleet Engine で TerminalPoint のサポートを終了しました。TerminalLocation.point を代わりに使用してください。

フィールド
value (deprecated)	string この項目は非推奨です。 サポート終了。
共用体フィールド Id。非推奨です。Id は次のいずれかになります。
place_id (deprecated)	string この項目は非推奨です。 サポート終了。
generated_id (deprecated)	string この項目は非推奨です。 サポート終了。

TrafficPolylineData

車両ルート上の交通状況。

フィールド
traffic_rendering	VisualTrafficReportPolylineRendering 顧客の乗車区間 1 区間のすべての地域の交通量を示すポリライン レンダリング。

ルート

ルートのメタデータ。

フィールド
name	string 出力専用。形式は「providers/{provider}/trips/{trip}」です。
vehicle_id	string このルートを行う車両の ID。
trip_status	TripStatus ルートの現在のステータス。
trip_type	TripType ルートのタイプ。
pickup_point	TerminalLocation お客様が集荷すると示している場所。
actual_pickup_point	StopLocation 入力のみの顧客が迎えに来た実際の場所。このフィールドは、プロバイダが実際の受け取り情報に関するフィードバックを提供するためのものです。
actual_pickup_arrival_point	StopLocation 入力のみのドライバーが乗車地点に到着した実際の時刻と場所。このフィールドは、乗車地点での実際の到着情報についてプロバイダがフィードバックを提供するためのものです。
pickup_time	Timestamp 出力専用。乗客が乗車する推定時刻、または乗車時刻の実際の時刻のいずれかを指定します。
intermediate_destinations[]	TerminalLocation ルートで（乗車と降車に加えて）中間地点の停車地。最初は共有ルートではサポートされていません。
intermediate_destinations_version	Timestamp intermediate_destinations が最後に変更された時刻を示します。サーバーでは、intermediate_destinations が変更されないようにするために、intermediate_destination_index の更新時にこの値をキャッシュに保存し、UpdateTripRequest に渡す必要があります。
intermediate_destination_index	int32 TripStatus が ENROUTE_TO_INTERMEDIATE_DESTINATION の場合、車両が次に通過する中間目的地を示す [0..N-1] の数値。TripStatus が ARRIVED_AT_INTERMEDIATE_DESTINATION の場合、車両がどの中間目的地にいるかを示す [0..N-1] の数値。この値はプロバイダによって設定されます。intermediate_destinations がない場合、このフィールドは無視されます。
actual_intermediate_destination_arrival_points[]	StopLocation 入力のみの中間目的地にドライバーが到着した実際の時刻と場所。このフィールドは、中間地点の実際の到着情報に関するフィードバックを提供するために使用します。
actual_intermediate_destinations[]	StopLocation 入力のみの顧客が中間地点で乗車した実際の時刻と場所。このフィールドは、中間目的地での実際の乗車情報に関するフィードバックを提供するために使用します。
dropoff_point	TerminalLocation お客様が降車すると示されている場所。
actual_dropoff_point	StopLocation 入力のみのお客様が降車した実際の時刻と場所。このフィールドは、プロバイダが実際の降車情報に関するフィードバックを提供するためのものです。
dropoff_time	Timestamp 出力専用。乗客が最終目的地で降車される推定時刻、または実際に降車される時刻のいずれか。
remaining_waypoints[]	TripWaypoint 出力専用。現在地から降車地点までのフルパス（両端を含む）。この経路には、他のルートのウェイポイントが含まれる場合があります。
vehicle_waypoints[]	TripWaypoint このフィールドでは、ルートのウェイポイントの手動順序付けがサポートされています。割り当てられている車両の残りのすべての地点と、そのルートの乗車地点と降車地点がすべて含まれます。ルートが車両に割り当てられていない場合、このフィールドは無視されます。プライバシー上の理由から、このフィールドは UpdateTrip 呼び出しと CreateTrip 呼び出しでのみサーバーによって設定され、GetTrip 呼び出しでは設定されません。
route[]	LatLng 出力専用。そのルートで、rement_waypoints の最初の通行先までの予想ルート。最初のウェイポイントは別のルートに属している可能性があります。
current_route_segment	string 出力専用。次のウェイポイントへのエンコードされたパス。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。デコードはまだサポートされていません。
current_route_segment_version	Timestamp 出力専用。ルートが最後に変更された時刻を示します。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。
current_route_segment_traffic	ConsumableTrafficPolyline 出力専用。current_route_segment 沿いの交通状況を表示します（利用可能な場合）。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。
current_route_segment_traffic_version	Timestamp 出力専用。current_route_segment_traffic が最後に変更された時刻を示します。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。
current_route_segment_end_point	TripWaypoint 出力専用。current_route_segment の終点となる地点。
remaining_distance_meters	Int32Value 出力専用。current_route_segment フィールドの残りの走行距離。ルートが車両に割り当てられていない場合、ルートが完了またはキャンセルされた場合、値は指定されません。
eta_to_first_waypoint	Timestamp 出力専用。次の地点（remaining_waypoints フィールドの最初のエントリ）までの到着予定時刻。ルートが車両に割り当てられていない場合、またはルートが無効（完了またはキャンセルされた）の場合、値は指定されません。
remaining_time_to_first_waypoint	Duration 出力専用。ルートデータが返された時点から Trip.eta_to_first_waypoint の時点までの時間。ルートが車両に割り当てられていない場合、またはルートが無効（完了またはキャンセルされた）の場合、値は指定されません。
remaining_waypoints_version	Timestamp 出力専用。remaining_waypoints が最後に変更された時刻（ウェイポイントが追加、削除、変更された時刻）を示します。
remaining_waypoints_route_version	Timestamp 出力専用。remaining_waypoints.path_to_waypoint と remaining_waypoints.traffic_to_waypoint が最後に変更された時刻を示します。クライアント アプリでこの値をキャッシュに保存して GetTripRequest に渡して、remaining_waypoints のパスとトラフィックが更新された場合にのみ返されるようにする必要があります。
number_of_passengers	int32 変更不可。このルートの乗客数を示します。運転手は含まれません。車両が SearchVehicles レスポンスで返されるには、利用可能な容量が必要です。
last_location	VehicleLocation 出力専用。ルート上で最後に報告された車両の位置を示します。
last_location_snappable	bool 出力専用。車両の last_location を current_route_segment にスナップできるかどうかを示します。last_location または current_route_segment が存在しない場合は false。Fleet Engine によって計算されます。クライアントからの更新は無視されます。
view	TripView 入力される Trip フィールドのサブセットと、それらの解釈方法。

TripStatus

ルートの進行状況。

列挙型
UNKNOWN_TRIP_STATUS	デフォルト。指定されていない、または認識できないルートのステータスに使用されます。
NEW	新しく作成されたルート。
ENROUTE_TO_PICKUP	ドライバーは乗車地点に向かっています。
ARRIVED_AT_PICKUP	ドライバーが乗車地点に到着しました。
ARRIVED_AT_INTERMEDIATE_DESTINATION	運転手は中間目的地に到着し、乗客を待っています。
ENROUTE_TO_INTERMEDIATE_DESTINATION	ドライバーは（降車地点ではなく）中間目的地に向かっています。
ENROUTE_TO_DROPOFF	運転手は乗客を迎えに行き、次の目的地に向かっています。
COMPLETE	利用者が降車し、経路は完了しています。
CANCELED	ドライバー、乗客、またはライドシェア プロバイダによって乗車前にキャンセルされた。

TripType

ルートのタイプ。

列挙型
UNKNOWN_TRIP_TYPE	デフォルト。指定されていない、または認識できないルートタイプに使用されます。
SHARED	このルートでは、車両を他のルートと共有する場合があります。
EXCLUSIVE	車両専用のルートです。

TripView

GetTrip レスポンス内のさまざまな Trip フィールドのセット用のセレクタ。コンテキストについては AIP-157 をご覧ください。今後、ビューが追加される可能性はあります。

列挙型
TRIP_VIEW_UNSPECIFIED	デフォルト値。下位互換性を確保するため、API はデフォルトで SDK ビューになります。安定性とサポートを確保するため、SDK 以外の TripView を選択することをおすすめします。
SDK	公開されているライブラリを使用して解釈またはサポートできないフィールドが含まれます。
JOURNEY_SHARING_V1S	[ルート] フィールドには、移動経路の共有ユースケースでデータが入力されます。このビューはサーバー間通信を目的としています。

TripWaypoint

車両のルート上の停車地点または車両の行程の終点を表します。

フィールド
location	TerminalLocation このウェイポイントの位置。
trip_id	string このウェイポイントに関連付けられたルート。
waypoint_type	WaypointType 乗車や降車など、このルートでこの地点が果たす役割。
path_to_waypoint[]	LatLng 前のウェイポイントから現在のウェイポイントまでのパス。リスト内の最初のウェイポイントは定義されていません。このフィールドは、リクエストされた場合にのみ入力されます。
encoded_path_to_waypoint	string 前のウェイポイントから現在のウェイポイントまでのエンコードされたパス。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。デコードはまだサポートされていません。
traffic_to_waypoint	ConsumableTrafficPolyline このウェイポイントまでの経路の交通状況。交通状況を利用できるのは、Google Map Platform 配車と配達ソリューションのお客様のみです。
distance_meters	Int32Value 前のウェイポイントから現在のウェイポイントまでのパス距離。リスト内の最初のウェイポイントは定義されていません。
eta	Timestamp このウェイポイントの予想到着時刻。リスト内の最初のウェイポイントは定義されていません。
duration	Duration 前の地点からこの地点までの移動時間。リスト内の最初のウェイポイントは定義されていません。

UpdateTripRequest

UpdateTrip リクエスト メッセージです。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
name	string 必須。providers/{provider}/trips/{trip} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-consumer-project など）にする必要があります。
trip	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 のバージョンと一致する必要があります。そうでない場合、リクエストは失敗します。
update_mask	FieldMask 必須。ルートで更新する項目を示すフィールド マスク。update_mask には少なくとも 1 つのフィールドが必要です。

UpdateVehicleAttributesRequest

UpdateVehicleAttributes リクエスト メッセージ。

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
name	string 必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。プロバイダは、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
attributes[]	VehicleAttribute 必須。更新する車両属性。記載されていない属性の変更や削除は行われません。

UpdateVehicleAttributesResponse

UpdateVehicleAttributes レスポンス メッセージ。

フィールド
attributes[]	VehicleAttribute 必須。車両属性の完全なリスト（新規属性、変更された属性、変更されていない属性を含む）。

UpdateVehicleRequest

UpdateVehicle リクエスト メッセージ

フィールド
header	RequestHeader 標準の Fleet Engine リクエスト ヘッダー。
name	string 必須。providers/{provider}/vehicles/{vehicle} の形式で指定してください。{provider} は、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）にする必要があります。
vehicle	Vehicle 必須。適用する Vehicle エンティティ値。Vehicle を更新する際、以下のフィールドはサーバーによって管理されるため、更新されないことがあります。 available_capacity current_route_segment_version current_trips name waypoints_version attributes フィールドが更新されると、すべての車両属性がリクエストで指定された属性に置き換えられます。一部の属性のみを更新する場合は、UpdateVehicleAttributes メソッドをご覧ください。 同様に、waypoints フィールドも更新できますが、車両上に現在あるすべての地点を含み、他の地点は含まれていない必要があります。
update_mask	FieldMask 必須。更新する Vehicle のフィールドを指定するフィールド マスク。少なくとも 1 つのフィールド名を指定する必要があります。

車両

車両のメタデータ。

フィールド
name	string 出力専用。この車両の一意の名前。形式は providers/{provider}/vehicles/{vehicle} です。
vehicle_state	VehicleState 車両の状態。
supported_trip_types[]	TripType この車両でサポートされているルートタイプ。
current_trips[]	string 出力専用。この車両に現在割り当てられているルートの trip_id のリスト。
last_location	VehicleLocation 最後に報告された車両の位置情報。
maximum_capacity	int32 この車両が乗車できる乗客の総数。この値では、ドライバは考慮されません。1 以上の値を指定してください。
attributes[]	VehicleAttribute 車両属性のリスト。車両には最大 100 個の属性を設定でき、各属性には一意のキーが必要です。
vehicle_type	VehicleType 必須。この車両のタイプ。SearchVehicles の結果で車両をフィルタするために使用できます。到着予定時刻やルートの計算にも影響します。
license_plate	LicensePlate 車両のナンバー プレート情報。
route[] (deprecated)	TerminalLocation この項目は非推奨です。 非推奨: 代わりに Vehicle.waypoints を使用してください。
current_route_segment	string ドライバー アプリが次のウェイポイントまで進む予定のルートを指定するポリライン。このリストは、車両に割り当てられているすべてのアクティブなルートについて Trip.current_route_segment でも返されます。 注: このフィールドは、Driver SDK による使用のみを目的としています。デコードはまだサポートされていません。
current_route_segment_traffic	TrafficPolylineData 入力のみのFleet Engine はこの情報を使用して旅程の共有を改善します。注: このフィールドは、Driver SDK による使用のみを目的としています。
current_route_segment_version	Timestamp 出力専用。current_route_segment が設定された時刻。変更されていないルートが返されるのを防ぐため、クライアントで保存し、将来の GetVehicle リクエストで渡すことができます。
current_route_segment_end_point	TripWaypoint current_route_segment の終点となる地点。これは、ドライバーが UpdateVehicle 呼び出しで、完全なトリップのウェイポイント、ウェイポイントの LatLng、または current_route_segment の最後の LatLng として指定できます。地点が完全に指定されていない場合、Fleet Engine は可能な限り実際の地点に補間しようとします。current_route_segment も指定されていない限り、UpdateVehicle の呼び出しではこのフィールドは無視されます。
remaining_distance_meters	Int32Value current_route_segment の残りの走行距離。この値は、車両に割り当てられているすべてのアクティブなルートの Trip.remaining_distance_meters でも返されます。current_route_segment フィールドが空の場合、値が指定されていません。
eta_to_first_waypoint	Timestamp waypoints フィールドの最初のエントリの到着予定時刻。waypoints フィールドが空の場合、または Vehicle.current_route_segment フィールドが空の場合、値は指定されません。 車両を更新するときは、同じリクエスト内で remaining_time_seconds が eta_to_first_waypoint よりも優先されます。
remaining_time_seconds	Int32Value 入力のみのcurrent_route_segment の残りの運転時間。waypoints フィールドが空の場合、または Vehicle.current_route_segment フィールドが空の場合、値は指定されません。すべてのパーティが同じクロックを使用している場合、この値は eta_to_first_waypoint - current_time と一致する必要があります。 車両を更新するときは、同じリクエスト内で remaining_time_seconds が eta_to_first_waypoint よりも優先されます。
waypoints[]	TripWaypoint この車両に割り当てられている残りのウェイポイント。
waypoints_version	Timestamp 出力専用。waypoints フィールドが最後に更新された時刻。クライアントはこの値をキャッシュに保存して GetVehicleRequest に渡して、waypoints フィールドが更新された場合にのみ返されるようにする必要があります。
back_to_back_enabled	bool 運転手が連続したルートを受け入れるかどうかを示します。true の場合、SearchVehicles には車両が現在ルートに割り当てられている場合でも、車両が含まれることがあります。デフォルト値は false です。
navigation_status	NavigationStatus 車両のナビゲーション ステータス。
device_settings	DeviceSettings 入力のみのドライバーが使用しているモバイル デバイスの設定に関する情報。

VehicleType

車両のタイプ。

フィールド
category	Category 車両タイプのカテゴリ

カテゴリ

車両タイプのカテゴリ

列挙型
UNKNOWN	デフォルト。未指定または認識できない車両カテゴリで使用されます。
AUTO	自動車。
TAXI	タクシーとして機能する車両（通常はライセンス取得済みまたは規制対象の車両）。
TRUCK	一般的に、大容量の車両。
TWO_WHEELER	オートバイ、原動機付き自転車、その他の二輪車
BICYCLE	人力の輸送。
PEDESTRIAN	歩道を歩く、または走る、人の移動手段。

VehicleAttribute

車両属性を Key-Value ペアとして記述します。「key:value」256 文字以内で指定してください。

フィールド
key	string 属性のキー。キーにコロン（:）を含めることはできません。
value	string 属性の値。
共用体フィールド vehicle_attribute_value。属性の値。文字列、ブール値、ダブル型のいずれかになります。vehicle_attribute_value は次のいずれかになります。
string_value	string 文字列型の属性値。 注: これは、最終的にサポートが終了する value フィールドと同じです。create メソッドまたは update メソッドではどちらのフィールドも使用できますが、string_value を使用することを強くおすすめします。string_value と value を両方とも設定する場合は、両方を同一にする必要があります。設定しない場合はエラーがスローされます。どちらのフィールドにもレスポンスが入力されます。
bool_value	bool ブール値型属性値。
number_value	double 二重型の属性値。

VehicleAttributeList

車両属性のリストのデータ型。

フィールド
attributes[]	VehicleAttribute このコレクションの属性のリスト。

VehicleLocation

特定の時点での車両の位置、速度、方角。

フィールド
location	LatLng 車両の位置。Fleet Engine に送信される場合、車両の位置情報は GPS 位置情報です。レスポンスで受け取る車両の位置は、GPS による位置情報、補足的な位置情報、その他の推定された位置情報のいずれかです。ソースは location_sensor で指定します。
horizontal_accuracy (deprecated)	DoubleValue この項目は非推奨です。 非推奨: 代わりに latlng_accuracy を使用してください。
latlng_accuracy	DoubleValue location の精度（メートル単位、半径）。
heading	Int32Value 車両が動いている方向（度数）。0 は北を表します。有効な範囲は [0,360] です。
bearing_accuracy (deprecated)	DoubleValue この項目は非推奨です。 非推奨: 代わりに heading_accuracy を使用してください。
heading_accuracy	DoubleValue 精度は heading 度です。
altitude	DoubleValue WGS84 からの高度（メートル単位）。
vertical_accuracy (deprecated)	DoubleValue この項目は非推奨です。 非推奨: 代わりに altitude_accuracy を使用してください。
altitude_accuracy	DoubleValue 精度は altitude です（メートル単位）。
speed_kmph (deprecated)	Int32Value この項目は非推奨です。 車両の速度（キロメートル/時）。非推奨: 代わりに speed を使用してください。
speed	DoubleValue 車両の速度（メートル/秒）
speed_accuracy	DoubleValue 精度は speed メートル/秒です。
update_time	Timestamp センサーの時計に基づいて location がレポートされた時刻。
server_time	Timestamp 出力専用。サーバーが位置情報を受信した時刻。
location_sensor	LocationSensor 位置情報の提供元（GPS など）。
is_road_snapped	BoolValue location を道路にスナップするかどうか。
is_gps_sensor_enabled	BoolValue 入力のみのモバイル デバイスで GPS センサーが有効になっているかどうかを示します。
time_since_update	Int32Value 入力のみのこの場所が最初にサーバーに送信されてからの時間（秒）。最初の更新ではゼロになります。時刻が不明な場合（アプリの再起動など）、この値はゼロにリセットされます。
num_stale_updates (deprecated)	Int32Value この項目は非推奨です。 入力のみの非推奨: ビジネス情報が古くなっているかどうかを判断するために、他のシグナルが使用されるようになりました。
raw_location	LatLng 未加工の車両の位置（ロードスナッパーによる未処理）。
raw_location_time	Timestamp 未加工の場所に関連付けられたタイムスタンプ。
raw_location_sensor	LocationSensor 未加工の位置情報のソース。デフォルトは GPS です。
raw_location_accuracy	DoubleValue 半径で表した raw_location の精度（メートル単位）。
supplemental_location	LatLng 統合するアプリによって提供される補助的な場所。
supplemental_location_time	Timestamp 補助的な場所に関連付けられたタイムスタンプ。
supplemental_location_sensor	LocationSensor 補助的な場所のソース。デフォルトは CUSTOMER_SUPPLIED_LOCATION です。
supplemental_location_accuracy	DoubleValue 半径で表した supplemental_location の精度（メートル単位）。
road_snapped (deprecated)	bool この項目は非推奨です。 非推奨: 代わりに is_road_snapped を使用してください。

VehicleMatch

車両 SearchVehiclesRequest のアクティブなルートの地点に一致する車両の車両と、関連する推定値が含まれます。

フィールド
vehicle	Vehicle 必須。リクエストに一致する車両。
vehicle_pickup_eta	Timestamp リクエストで指定された乗車地点までの車両の運転開始到着予定時刻。空の値は、車両の到着予定時刻の計算に失敗したことを示します。SearchVehiclesRequest.include_back_to_back が true で、この車両に有効なルートがある場合、vehicle_pickup_eta には現在アクティブなルートの完了に必要な時間が含まれます。
vehicle_pickup_distance_meters	Int32Value 車両の現在地からリクエストで指定された乗車地点までの距離（既存のルートの中間乗車地点または降車地点を含む）。この距離は、算出した運転（ルート）距離と、ナビゲーションの終点からリクエストされた乗車地点までの直線距離を足したものになります。（ナビゲーションの終点からリクエストされた乗車地点までの距離は通常、狭い）。空の値は、距離の計算エラーを示します。
vehicle_pickup_straight_line_distance_meters	Int32Value 必須。リクエストで指定された乗車地点までの直線距離。
vehicle_dropoff_eta	Timestamp リクエストで指定された降車地点までの車両全体の運転到着予定時刻。ETA には、リクエストで指定された dropoff_point より前の任意の地点での停止も含まれます。値は、リクエストで降車地点が指定されている場合にのみ入力されます。値が空の場合は、ETA の計算エラーを示します。
vehicle_pickup_to_dropoff_distance_meters	Int32Value リクエストで指定された乗車地点から降車地点までの車両の走行距離（メートル単位）。距離は 2 つの地点間ののみであり、車両の位置や、車両が乗車地点や降車地点を訪れる前に訪れる必要のある地点は含まれません。値は、リクエストで dropoff_point が指定された場合にのみ入力されます。空の値は、リクエストで指定された乗車地点から降車地点までの距離が計算されなかったことを示します。
trip_type	TripType 必須。乗車地点までの到着予定時刻の計算に使用されたリクエストの貸し出しタイプ。
vehicle_trips_waypoints[]	Waypoint 到着予定時刻の計算に使用されるウェイポイントの順序付きリスト。このリストには、車両の位置情報、その車両の有効なルートの乗車地点、リクエストで指定された乗車地点が含まれます。空のリストは、車両の到着予定時刻の計算に失敗したことを示します。
vehicle_match_type	VehicleMatchType 一致する車両のタイプ。
requested_ordered_by	VehicleMatchOrder 車両の一致を並べ替えるためにリクエストされた順序。
ordered_by	VehicleMatchOrder この車両に使用された実際の注文。通常、これは 'order_by'フィールドに返されます。ただし、内部サーバーエラーなどの特定の状況では、別のメソッド（PICKUP_POINT_STRAIGHT_DISTANCE など）が使用されることがあります。

VehicleMatchType

一致する車両のタイプ。

列挙型
UNKNOWN	不明な車両マッチタイプ
EXCLUSIVE	車両にルートが割り当てられていないため、乗車場所に移動できる。
BACK_TO_BACK	車両は現在ルートに割り当てられていますが、進行中のルートを完了した後、乗車場所まで進むことができます。到着予定時刻と距離の計算では、既存のルートが考慮されます。
CARPOOL	相乗りに十分な対応能力がある。
CARPOOL_BACK_TO_BACK	車両は現在アクティブなルートを終了してから乗車地点に到着します。到着予定時刻と距離の計算では、既存のルートが考慮されます。

VehicleState

Vehicle の状態。

列挙型
UNKNOWN_VEHICLE_STATE	デフォルト。指定されていない、または認識できない車両の状態に使用されます。
OFFLINE	車両は新しいルートを受け付けていない。注: 車両は割り当てられたルートを完了している間も、この状態で運転を継続する場合があります。
ONLINE	車両が新しいルートを受け付けている。

VisualTrafficReportPolylineRendering

経路に沿ったポリラインの一部の部分に色を付ける方法を説明します。

フィールド
road_stretch[]	RoadStretch 省略可。ポリラインに沿ってレンダリングする必要がある道路の延伸。ストレッチは重複しないことを保証し、必ずしもルート全体にまたがるとは限りません。 スタイルを設定する道路ストレッチがない場合、クライアントはルートにデフォルトを適用する必要があります。

RoadStretch

レンダリングする 1 つの道路区間。

フィールド
style	Style 必須。適用するスタイル。
offset_meters	int32 必須。スタイルは [offset_meters, offset_meters + length_meters) の間に適用する必要があります。
length_meters	int32 必須。スタイルを適用するパスの長さ。

スタイル

交通量のスタイル。交通速度を示します。

列挙型
STYLE_UNSPECIFIED	スタイルが選択されていません。
SLOWER_TRAFFIC	トラフィックが減っている。
TRAFFIC_JAM	渋滞している。

ウェイポイント

SearchVehiclesResponse 内の VehicleMatch のルート上の中間ポイントを表します。このコンセプトは、他のすべてのエンドポイントで TripWaypoint として表されます。

フィールド
lat_lng	LatLng このウェイポイントの位置。
eta	Timestamp 車両がこの地点に到着する推定時間。

WaypointType

地点のタイプ。

列挙型
UNKNOWN_WAYPOINT_TYPE	不明なまたは未指定の地点の種類。
PICKUP_WAYPOINT_TYPE	乗客またはアイテムを受け取るための地点。
DROP_OFF_WAYPOINT_TYPE	乗客やアイテムを降ろすための地点。
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE	複数の目的地を経由するルートの中間地点の地点。