Package maps.fleetengine.v1

インデックス

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

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

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

共通のルートに対して vehicle_id が設定されている場合は、Trip.vehicle_waypoints のリストを指定して、車両の残りのウェイポイントの順序を指定する必要があります。そうしないと、ウェイポイントの順序が不確定になります。

Trip.vehicle_waypoints を指定した場合、リストには、車両のルートの残りのすべての地点(余分な地点を除く)を含める必要があります。これらのウェイポイントの順序は、特定のルートで、乗車地点が中間地点よりも前に、すべての中間地点が降車地点よりも前になるように並べる必要があります。EXCLUSIVE のルートのウェイポイントは、他のルートと交互に配置することはできません。

trip_idwaypoint_typelocation フィールドが使用され、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_TYPETrip.route 内)、または ENCODED_POLYLINE_TYPETrip.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_attributesrequired_one_of_attributesrequired_one_of_attributes_sets フィールドを置き換えるように設計されています。ここで空でない値を指定する場合は、required_attributesrequired_one_of_attributesrequired_one_of_attributes_sets の各フィールドを空にする必要があります。

このフィルタは、vehicle_stateon_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 オペレーティング システムの位置情報プロバイダ。

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

列挙型
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.112.1

device_model

string

呼び出し元の SDK が実行されているデバイスのモデル。フィールド値の例: iPhone12,1SM-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_typesTripType.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_typeSHARED が含まれている場合は、CURRENT_TRIPS_PRESENT_UNSPECIFIED 以外に設定する必要があります。

filter

string

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

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

このフィルタは、minimum_capacityvehicle_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_backtrue にすることはできません。
ANY 検索結果には、現在のルートが 5 つまで、地点が 10 か所までの車両が含まれます。この値を使用する場合、include_back_to_backtrue にすることはできません。

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

TripStatusENROUTE_TO_INTERMEDIATE_DESTINATION の場合、車両が次に通過する中間目的地を示す [0..N-1] の数値。TripStatusARRIVED_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_waypointremaining_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_idwaypoint_typelocation フィールドが使用され、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_secondseta_to_first_waypoint よりも優先されます。

remaining_time_seconds

Int32Value

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

車両を更新するときは、同じリクエスト内で remaining_time_secondseta_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_valuevalue を両方とも設定する場合は、両方を同一にする必要があります。設定しない場合はエラーがスローされます。どちらのフィールドにもレスポンスが入力されます。

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_backtrue で、この車両に有効なルートがある場合、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 複数の目的地を経由するルートの中間地点の地点。