インデックス
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 |
---|
Fleet Engine でルートを作成し、新しいルートを返します。 |
GetTrip |
---|
特定のルートに関する情報を取得します。 |
ReportBillableTrip |
---|
課金対象のルート利用状況を報告します。 |
SearchTrips |
---|
特定の車両のすべてのルートを取得します。 |
UpdateTrip |
---|
ルートデータを更新します。 |
VehicleService
車両管理サービス。
CreateVehicle |
---|
オンデマンドのライドシェアまたは配達のプロバイダに関連付けられた新しい車両をインスタンス化します。各
その他のフィールドはすべて省略可能で、指定されている場合に使用されます。 |
GetVehicle |
---|
Fleet Engine から車両を返します。 |
ListVehicles |
---|
リクエストのオプションに一致するプロバイダに関連付けられている車両を、ページ分けされたリストで返します。 |
SearchVehicles |
---|
リクエストのオプションに一致する車両のリストを返します。 |
UpdateVehicle |
---|
更新された車両データを Fleet Engine に書き込みます。
車両
|
UpdateVehicleAttributes |
---|
車両の属性を部分的に更新します。リクエストに記載されている属性のみが更新され、他の属性は変更されません。注: これは |
BatteryInfo
デバイスのバッテリーに関する情報。
フィールド | |
---|---|
battery_status |
バッテリーの状態(フル、充電など) |
power_source |
バッテリー電源のステータス。 |
battery_percentage |
現在のバッテリー残量(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[] |
前の地点から現在の地点までの経路の渋滞状況。 |
encoded_path_to_waypoint |
前のウェイポイントから現在のウェイポイントまで、ドライバーが通っているパス。この経路にはランドマークが配置されており、クライアントが経路に沿った交通マーカーを表示できます( |
CreateTripRequest
CreateTrip リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
parent |
必須。 |
trip_id |
必須。一意のルート ID。以下の制限が適用されます。
|
trip |
必須。作成する旅行エンティティ。 ルートを作成する際は、以下のフィールドが必要です。
指定すると、次のフィールドが使用されます。
その他の [ルート] フィールドはすべて無視されます。たとえば、作成リクエストで
共通のルートに対して
|
CreateVehicleRequest
CreateVehicle
リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
parent |
必須。 |
vehicle_id |
必須。一意の車両 ID。以下の制限が適用されます。
|
vehicle |
必須。作成する Vehicle エンティティ。車両を作成する場合、以下のフィールドが必要です。
車両を作成する際、以下のフィールドは無視されます。
その他のフィールドはすべて省略可能で、指定されている場合に使用されます。 |
DeviceSettings
モバイル デバイスのさまざまな設定に関する情報。
フィールド | |
---|---|
location_power_save_mode |
バッテリー セーバーがオンのときに、デバイスで位置情報機能がどのように動作するかを示します。 |
is_power_save_mode |
デバイスが現在省電力モードかどうか。 |
is_interactive |
デバイスがインタラクティブな状態かどうか。 |
battery_info |
バッテリーの状態に関する情報。 |
GetTripRequest
GetTrip リクエスト メッセージです。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
name |
必須。 |
view |
返される Trip フィールドのサブセットとその解釈。 |
current_route_segment_version |
|
remaining_waypoints_version |
|
route_format_type |
返された現在の経路形式、 |
current_route_segment_traffic_version |
|
remaining_waypoints_route_version |
|
GetVehicleRequest
GetVehicle
リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
name |
必須。 |
current_route_segment_version |
|
waypoints_version |
|
LicensePlate
車両のナンバー プレート情報。個人を特定できる情報が保存されないように、エンティティの一部として保存されるのは、ナンバー プレートに関する最小限の情報のみです。
フィールド | |
---|---|
country_code |
必須。CLDR の国/地域コード。たとえば、米国は |
last_character |
ナンバー プレートの最後の桁または「-1」ナンバー プレートに数値がないことを示します。
|
ListVehiclesRequest
ListVehicles
リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
parent |
必須。 |
page_size |
返される車両の最大数。デフォルト値: 100。 |
page_token |
前回の |
minimum_capacity |
車両に必要な最小容量を指定します。返されるすべての車両の |
trip_types[] |
指定されたルートタイプの少なくとも 1 つをサポートする車両へのレスポンスを制限します。 |
maximum_staleness |
指定された期間内に Fleet Engine に位置情報の更新を送信した車両へのレスポンスを制限します。静止している車両が位置情報を送信し続けている場合、古い車両とはみなされません。指定する場合は、有効な正の期間である必要があります。 |
vehicle_type_categories[] |
必須。指定されたタイプカテゴリのいずれかを持つ車両へのレスポンスを制限します。 |
required_attributes[] |
呼び出し元は、
指定された属性を持つ車両にレスポンスを制限します。このフィールドは論理積(AND)演算です。指定できる required_attributes は最大 50 個です。車両で許可される最大属性数と一致します。繰り返される各文字列は「key:value」形式にする必要があります。 |
required_one_of_attributes[] |
各 |
required_one_of_attribute_sets[] |
レスポンスを、 |
vehicle_state |
この車両状態を持つ車両へのレスポンスを制限します。 |
on_trip_only |
現在のルートの車両のみを返却してください。 |
filter |
省略可。車両をリストするときに適用するフィルタクエリ。フィルタ構文の例については、http://aip.dev/160 をご覧ください。 このフィールドは、 このフィルタは、 サポートされているクエリは、車両属性( また、すべての属性は文字列として格納されるため、属性に対してサポートされている比較は文字列の比較のみです。数値やブール値と比較するには、値を文字列として扱うために明示的に引用符で囲む必要があります(例: |
viewport |
省略可。返される車両を、最後に確認された場所がビューポートで定義された長方形の領域内にあった車両に制限するフィルタ。 |
ListVehiclesResponse
ListVehicles
レスポンス メッセージ。
フィールド | |
---|---|
vehicles[] |
リクエストの条件に一致する車両。返される車両の最大数は、リクエストの |
next_page_token |
車両の次のページを取得するためのトークン。リクエスト条件を満たす車両がこれ以上ない場合は空です。 |
total_size |
必須。すべてのページでのリクエスト条件に一致する車両の合計数。 |
LocationPowerSaveMode
モバイル デバイスで「バッテリー セーバー」モードが有効になっているときに、位置情報機能がどのように動作するか機能がオンになっていることを確認します。(https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
列挙型 | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
未定義の場所 PowerSaveMode |
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 オペレーティング システムの位置情報プロバイダ。 |
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 |
必須。 |
country_code |
必須。旅行を行う国の 2 文字の国コード。価格は国コードに従って定義されます。 |
platform |
リクエストが発行されたプラットフォーム。 |
related_ids[] |
報告されるルートに直接関連する識別子。通常、ルート ID が利用可能になる前に行われた事前予約の ID(セッション ID など)です。 |
solution_type |
報告されたルートで使用されている Google マーケティング プラットフォーム サービス ソリューションのタイプ(例: |
ソリューション タイプ
報告するルートのさまざまなソリューション タイプのセレクタ。
列挙型 | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
デフォルト値。下位互換性を確保するため、API はデフォルトで ON_DEMAND_RIDESHARING_AND_DELIVERIES を使用します。これは、サポートされている最初のソリューション タイプです。 |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
その解決策が、オンデマンドのライドシェアリングと配達です。 |
RequestHeader
RequestHeader には、すべての Fleet Engine RPC リクエストに共通するフィールドが含まれています。
フィールド | |
---|---|
language_code |
en-US、sr-Latn などの BCP-47 言語コード。詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier を参照してください。何も指定しない場合、レスポンスは任意の言語で返されます。そのような名前が存在する場合は、英語が優先されます。フィールド値の例: |
region_code |
必須。リクエスト送信元のリージョンの CLDR リージョン コード。フィールド値の例: |
sdk_version |
呼び出し元の SDK のバージョン(該当する場合)。バージョンの形式は「major.minor.patch」です(例: |
os_version |
呼び出し元の SDK が実行されているオペレーティング システムのバージョン。フィールド値の例: |
device_model |
呼び出し元の SDK が実行されているデバイスのモデル。フィールド値の例: |
sdk_type |
リクエストを送信する SDK のタイプ。 |
maps_sdk_version |
呼び出し元の SDK が依存する MapSDK のバージョン(該当する場合)。バージョンの形式は「major.minor.patch」です(例: |
nav_sdk_version |
呼び出し元の SDK が依存する NavSDK のバージョン(該当する場合)。バージョンの形式は「major.minor.patch」です(例: |
platform |
呼び出し元の SDK のプラットフォーム。 |
manufacturer |
呼び出し元の SDK に含まれる Android デバイスのメーカー。Android SDK にのみ適用されます。フィールド値の例: |
android_api_level |
呼び出し元の SDK の Android API レベル。Android SDK にのみ適用されます。フィールド値の例: |
trace_id |
リクエストを識別するために、ロギングのために提供できる 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 |
標準の Fleet Engine リクエスト ヘッダー。 |
parent |
必須。 |
vehicle_id |
リクエスト内のルートに関連付けられている車両。指定しない場合、返されるルートには以下の情報は含まれません。
|
active_trips_only |
true に設定した場合、レスポンスにはドライバーのルートに影響するルートが含まれます。 |
page_size |
設定しない場合、返される結果の数はサーバーが決定します。 |
page_token |
前の結果から続行するには、以前に |
minimum_staleness |
指定すると、 |
SearchTripsResponse
SearchTrips レスポンス メッセージ。
フィールド | |
---|---|
trips[] |
リクエストされた車両のルートのリスト。 |
next_page_token |
このトークンを SearchTripsRequest で渡して、リストの結果を表示します。API は呼び出しのたびにルートリストを返し、それ以上の結果がなくなると、ルートリストは空になります。 |
SearchVehiclesRequest
SearchVehicles
リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
parent |
必須。 |
pickup_point |
必須。検索する近くの乗車地点。 |
dropoff_point |
顧客が意図する持ち込み場所。 |
pickup_radius_meters |
必須。乗車地点を中心とした車両検索半径を定義します。検索半径内の車両のみが返されます。値は 400 ~ 10,000 m の範囲で指定してください。 |
count |
必須。返される車両の最大数を指定します。値は 1 ~ 50 の範囲で指定してください。 |
minimum_capacity |
必須。旅行の対象となる乗客の人数を指定します。1 以上の値を指定してください。ドライバは容量値で考慮されません。 |
trip_types[] |
必須。提案されたルートのタイプを表します。タイプを 1 つだけ含める必要があります。 |
maximum_staleness |
指定した期間内に Fleet Engine に位置情報の更新を送信した車両のみに検索を制限します。静止している車両が位置情報を送信し続けている場合、古い車両とはみなされません。このフィールドが設定されていない場合、サーバーはデフォルト値として 5 分を使用します。 |
vehicle_types[] |
必須。検索対象を、指定したタイプのいずれかを持つ車両に制限します。少なくとも 1 つの車両タイプを指定する必要があります。カテゴリが |
required_attributes[] |
呼び出し元は、
検索対象を、指定した属性を持つ車両のみに制限します。このフィールドは論理積(AND)演算です。指定できる required_attributes は最大 50 個です。車両で許可される最大属性数と一致します。 |
required_one_of_attributes[] |
検索範囲を、各 |
required_one_of_attribute_sets[] |
検索を |
order_by |
必須。結果の表示順序の基準を指定します。 |
include_back_to_back |
有効なルートが 1 つある車両がこの検索の対象となるかどうかを示します。このフィールドは、 デフォルト値は |
trip_id |
この |
current_trips_present |
アクティブなルートを持つ車両がこの検索の対象となるかどうかを示します。 |
filter |
省略可。車両を検索するときに適用するフィルタクエリ。フィルタ構文の例については、http://aip.dev/160 をご覧ください。 このフィールドは、 このフィルタは、 サポートされているクエリは、車両属性( また、すべての属性は文字列として格納されるため、属性に対してサポートされている比較は文字列の比較のみです。数値やブール値と比較するには、値を文字列として扱うために明示的に引用符で囲む必要があります(例: |
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[] |
|
SpeedReadingInterval
経路の連続セグメントに表示される交通密度インジケーター。SpeedReadingInterval は、点 P_0、P_1、...、P_N(ゼロベースのインデックス)を持つパスが与えられると、間隔を定義し、次のカテゴリを使用してトラフィックを記述します。
フィールド | |
---|---|
start_polyline_point_index |
パス内のこの区間の開始インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。 |
end_polyline_point_index |
パス内のこの区間の終了インデックス。JSON では、インデックスが 0 の場合、フィールドに値が入力されていないように見えます。 |
speed |
この期間の交通状況。 |
速度
交通データに基づいたポリラインの速度分類。
列挙型 | |
---|---|
SPEED_UNSPECIFIED |
デフォルト値。この値は使用されません。 |
NORMAL |
通常の速度で、速度低下は検出されません。 |
SLOW |
軽い渋滞が検出されましたが、渋滞は発生していません。 |
TRAFFIC_JAM |
渋滞を検知しました。 |
StopLocation
停車地(乗車または降車)が行われた実際の場所。
フィールド | |
---|---|
point |
必須。実際の場所を示します。 |
timestamp |
停止が行われた時間を示します。 |
stop_time |
入力のみの非推奨です。タイムスタンプ フィールドを使用します。 |
TerminalLocation
ウェイポイントの位置を記述します。
フィールド | |
---|---|
point |
必須。ルートの地点の位置を示します。 |
terminal_point_id |
非推奨: 代わりに |
access_point_id |
非推奨: 代わりに |
trip_id |
サポート終了。 |
terminal_location_type |
サポート終了: このデータは |
TerminalPointId
非推奨: Fleet Engine で TerminalPoint のサポートを終了しました。TerminalLocation.point
を代わりに使用してください。
フィールド | |
---|---|
value |
サポート終了。 |
共用体フィールド Id 。非推奨です。Id は次のいずれかになります。 |
|
place_id |
サポート終了。 |
generated_id |
サポート終了。 |
TrafficPolylineData
車両ルート上の交通状況。
フィールド | |
---|---|
traffic_rendering |
顧客の乗車区間 1 区間のすべての地域の交通量を示すポリライン レンダリング。 |
ルート
ルートのメタデータ。
フィールド | |
---|---|
name |
出力専用。形式は「providers/{provider}/trips/{trip}」です。 |
vehicle_id |
このルートを行う車両の ID。 |
trip_status |
ルートの現在のステータス。 |
trip_type |
ルートのタイプ。 |
pickup_point |
お客様が集荷すると示している場所。 |
actual_pickup_point |
入力のみの顧客が迎えに来た実際の場所。このフィールドは、プロバイダが実際の受け取り情報に関するフィードバックを提供するためのものです。 |
actual_pickup_arrival_point |
入力のみのドライバーが乗車地点に到着した実際の時刻と場所。このフィールドは、乗車地点での実際の到着情報についてプロバイダがフィードバックを提供するためのものです。 |
pickup_time |
出力専用。乗客が乗車する推定時刻、または乗車時刻の実際の時刻のいずれかを指定します。 |
intermediate_destinations[] |
ルートで(乗車と降車に加えて)中間地点の停車地。最初は共有ルートではサポートされていません。 |
intermediate_destinations_version |
|
intermediate_destination_index |
|
actual_intermediate_destination_arrival_points[] |
入力のみの中間目的地にドライバーが到着した実際の時刻と場所。このフィールドは、中間地点の実際の到着情報に関するフィードバックを提供するために使用します。 |
actual_intermediate_destinations[] |
入力のみの顧客が中間地点で乗車した実際の時刻と場所。このフィールドは、中間目的地での実際の乗車情報に関するフィードバックを提供するために使用します。 |
dropoff_point |
お客様が降車すると示されている場所。 |
actual_dropoff_point |
入力のみのお客様が降車した実際の時刻と場所。このフィールドは、プロバイダが実際の降車情報に関するフィードバックを提供するためのものです。 |
dropoff_time |
出力専用。乗客が最終目的地で降車される推定時刻、または実際に降車される時刻のいずれか。 |
remaining_waypoints[] |
出力専用。現在地から降車地点までのフルパス(両端を含む)。この経路には、他のルートのウェイポイントが含まれる場合があります。 |
vehicle_waypoints[] |
このフィールドでは、ルートのウェイポイントの手動順序付けがサポートされています。割り当てられている車両の残りのすべての地点と、そのルートの乗車地点と降車地点がすべて含まれます。ルートが車両に割り当てられていない場合、このフィールドは無視されます。プライバシー上の理由から、このフィールドは |
route[] |
出力専用。そのルートで、rement_waypoints の最初の通行先までの予想ルート。最初のウェイポイントは別のルートに属している可能性があります。 |
current_route_segment |
出力専用。次のウェイポイントへのエンコードされたパス。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。デコードはまだサポートされていません。 |
current_route_segment_version |
出力専用。ルートが最後に変更された時刻を示します。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。 |
current_route_segment_traffic |
出力専用。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。 |
current_route_segment_traffic_version |
出力専用。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。 |
current_route_segment_end_point |
出力専用。 |
remaining_distance_meters |
出力専用。 |
eta_to_first_waypoint |
出力専用。次の地点( |
remaining_time_to_first_waypoint |
出力専用。ルートデータが返された時点から |
remaining_waypoints_version |
出力専用。 |
remaining_waypoints_route_version |
出力専用。 |
number_of_passengers |
変更不可。このルートの乗客数を示します。運転手は含まれません。車両が |
last_location |
出力専用。ルート上で最後に報告された車両の位置を示します。 |
last_location_snappable |
出力専用。車両の |
view |
入力される 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 |
このウェイポイントの位置。 |
trip_id |
このウェイポイントに関連付けられたルート。 |
waypoint_type |
乗車や降車など、このルートでこの地点が果たす役割。 |
path_to_waypoint[] |
前のウェイポイントから現在のウェイポイントまでのパス。リスト内の最初のウェイポイントは定義されていません。このフィールドは、リクエストされた場合にのみ入力されます。 |
encoded_path_to_waypoint |
前のウェイポイントから現在のウェイポイントまでのエンコードされたパス。 注: このフィールドは、Driver SDK と Consumer SDK による使用のみを目的としています。デコードはまだサポートされていません。 |
traffic_to_waypoint |
このウェイポイントまでの経路の交通状況。交通状況を利用できるのは、Google Map Platform 配車と配達ソリューションのお客様のみです。 |
distance_meters |
前のウェイポイントから現在のウェイポイントまでのパス距離。リスト内の最初のウェイポイントは定義されていません。 |
eta |
このウェイポイントの予想到着時刻。リスト内の最初のウェイポイントは定義されていません。 |
duration |
前の地点からこの地点までの移動時間。リスト内の最初のウェイポイントは定義されていません。 |
UpdateTripRequest
UpdateTrip リクエスト メッセージです。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
name |
必須。 |
trip |
必須。更新に関連付けられたルート。 次のフィールドは、Fleet Engine によって維持されます。Trip.update で更新しないでください。
共通のルートの
複数の目的地を含むルートで競合状態を回避するには、ルートのステータスを |
update_mask |
必須。ルートで更新する項目を示すフィールド マスク。 |
UpdateVehicleAttributesRequest
UpdateVehicleAttributes
リクエスト メッセージ。
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
name |
必須。 |
attributes[] |
必須。更新する車両属性。記載されていない属性の変更や削除は行われません。 |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
レスポンス メッセージ。
フィールド | |
---|---|
attributes[] |
必須。車両属性の完全なリスト(新規属性、変更された属性、変更されていない属性を含む)。 |
UpdateVehicleRequest
UpdateVehicle リクエスト メッセージ
フィールド | |
---|---|
header |
標準の Fleet Engine リクエスト ヘッダー。 |
name |
必須。 |
vehicle |
必須。適用する
同様に、 |
update_mask |
必須。更新する |
車両
車両のメタデータ。
フィールド | |
---|---|
name |
出力専用。この車両の一意の名前。形式は |
vehicle_state |
車両の状態。 |
supported_trip_types[] |
この車両でサポートされているルートタイプ。 |
current_trips[] |
出力専用。この車両に現在割り当てられているルートの |
last_location |
最後に報告された車両の位置情報。 |
maximum_capacity |
この車両が乗車できる乗客の総数。この値では、ドライバは考慮されません。1 以上の値を指定してください。 |
attributes[] |
車両属性のリスト。車両には最大 100 個の属性を設定でき、各属性には一意のキーが必要です。 |
vehicle_type |
必須。この車両のタイプ。 |
license_plate |
車両のナンバー プレート情報。 |
route[] |
非推奨: 代わりに |
current_route_segment |
ドライバー アプリが次のウェイポイントまで進む予定のルートを指定するポリライン。このリストは、車両に割り当てられているすべてのアクティブなルートについて 注: このフィールドは、Driver SDK による使用のみを目的としています。デコードはまだサポートされていません。 |
current_route_segment_traffic |
入力のみのFleet Engine はこの情報を使用して旅程の共有を改善します。注: このフィールドは、Driver SDK による使用のみを目的としています。 |
current_route_segment_version |
出力専用。 |
current_route_segment_end_point |
|
remaining_distance_meters |
|
eta_to_first_waypoint |
車両を更新するときは、同じリクエスト内で |
remaining_time_seconds |
入力のみの 車両を更新するときは、同じリクエスト内で |
waypoints[] |
この車両に割り当てられている残りのウェイポイント。 |
waypoints_version |
出力専用。 |
back_to_back_enabled |
運転手が連続したルートを受け入れるかどうかを示します。 |
navigation_status |
車両のナビゲーション ステータス。 |
device_settings |
入力のみのドライバーが使用しているモバイル デバイスの設定に関する情報。 |
VehicleType
車両のタイプ。
フィールド | |
---|---|
category |
車両タイプのカテゴリ |
カテゴリ
車両タイプのカテゴリ
列挙型 | |
---|---|
UNKNOWN |
デフォルト。未指定または認識できない車両カテゴリで使用されます。 |
AUTO |
自動車。 |
TAXI |
タクシーとして機能する車両(通常はライセンス取得済みまたは規制対象の車両)。 |
TRUCK |
一般的に、大容量の車両。 |
TWO_WHEELER |
オートバイ、原動機付き自転車、その他の二輪車 |
BICYCLE |
人力の輸送。 |
PEDESTRIAN |
歩道を歩く、または走る、人の移動手段。 |
VehicleAttribute
車両属性を Key-Value ペアとして記述します。「key:value」256 文字以内で指定してください。
フィールド | |
---|---|
key |
属性のキー。キーにコロン(:)を含めることはできません。 |
value |
属性の値。 |
共用体フィールド vehicle_attribute_value 。属性の値。文字列、ブール値、ダブル型のいずれかになります。vehicle_attribute_value は次のいずれかになります。 |
|
string_value |
文字列型の属性値。 注: これは、最終的にサポートが終了する |
bool_value |
ブール値型属性値。 |
number_value |
二重型の属性値。 |
VehicleAttributeList
車両属性のリストのデータ型。
フィールド | |
---|---|
attributes[] |
このコレクションの属性のリスト。 |
VehicleLocation
特定の時点での車両の位置、速度、方角。
フィールド | |
---|---|
location |
車両の位置。Fleet Engine に送信される場合、車両の位置情報は GPS 位置情報です。レスポンスで受け取る車両の位置は、GPS による位置情報、補足的な位置情報、その他の推定された位置情報のいずれかです。ソースは |
horizontal_accuracy |
非推奨: 代わりに |
latlng_accuracy |
|
heading |
車両が動いている方向(度数)。0 は北を表します。有効な範囲は [0,360] です。 |
bearing_accuracy |
非推奨: 代わりに |
heading_accuracy |
精度は |
altitude |
WGS84 からの高度(メートル単位)。 |
vertical_accuracy |
非推奨: 代わりに |
altitude_accuracy |
精度は |
speed_kmph |
車両の速度(キロメートル/時)。非推奨: 代わりに |
speed |
車両の速度(メートル/秒) |
speed_accuracy |
精度は |
update_time |
センサーの時計に基づいて |
server_time |
出力専用。サーバーが位置情報を受信した時刻。 |
location_sensor |
位置情報の提供元( |
is_road_snapped |
|
is_gps_sensor_enabled |
入力のみのモバイル デバイスで GPS センサーが有効になっているかどうかを示します。 |
time_since_update |
入力のみのこの場所が最初にサーバーに送信されてからの時間(秒)。最初の更新ではゼロになります。時刻が不明な場合(アプリの再起動など)、この値はゼロにリセットされます。 |
num_stale_updates |
入力のみの非推奨: ビジネス情報が古くなっているかどうかを判断するために、他のシグナルが使用されるようになりました。 |
raw_location |
未加工の車両の位置(ロードスナッパーによる未処理)。 |
raw_location_time |
未加工の場所に関連付けられたタイムスタンプ。 |
raw_location_sensor |
未加工の位置情報のソース。デフォルトは |
raw_location_accuracy |
半径で表した |
supplemental_location |
統合するアプリによって提供される補助的な場所。 |
supplemental_location_time |
補助的な場所に関連付けられたタイムスタンプ。 |
supplemental_location_sensor |
補助的な場所のソース。デフォルトは |
supplemental_location_accuracy |
半径で表した |
road_snapped |
非推奨: 代わりに |
VehicleMatch
車両 SearchVehiclesRequest
のアクティブなルートの地点に一致する車両の車両と、関連する推定値が含まれます。
フィールド | |
---|---|
vehicle |
必須。リクエストに一致する車両。 |
vehicle_pickup_eta |
リクエストで指定された乗車地点までの車両の運転開始到着予定時刻。空の値は、車両の到着予定時刻の計算に失敗したことを示します。 |
vehicle_pickup_distance_meters |
車両の現在地からリクエストで指定された乗車地点までの距離(既存のルートの中間乗車地点または降車地点を含む)。この距離は、算出した運転(ルート)距離と、ナビゲーションの終点からリクエストされた乗車地点までの直線距離を足したものになります。(ナビゲーションの終点からリクエストされた乗車地点までの距離は通常、狭い)。空の値は、距離の計算エラーを示します。 |
vehicle_pickup_straight_line_distance_meters |
必須。リクエストで指定された乗車地点までの直線距離。 |
vehicle_dropoff_eta |
リクエストで指定された降車地点までの車両全体の運転到着予定時刻。ETA には、リクエストで指定された |
vehicle_pickup_to_dropoff_distance_meters |
リクエストで指定された乗車地点から降車地点までの車両の走行距離(メートル単位)。距離は 2 つの地点間ののみであり、車両の位置や、車両が乗車地点や降車地点を訪れる前に訪れる必要のある地点は含まれません。値は、リクエストで |
trip_type |
必須。乗車地点までの到着予定時刻の計算に使用されたリクエストの貸し出しタイプ。 |
vehicle_trips_waypoints[] |
到着予定時刻の計算に使用されるウェイポイントの順序付きリスト。このリストには、車両の位置情報、その車両の有効なルートの乗車地点、リクエストで指定された乗車地点が含まれます。空のリストは、車両の到着予定時刻の計算に失敗したことを示します。 |
vehicle_match_type |
一致する車両のタイプ。 |
requested_ordered_by |
車両の一致を並べ替えるためにリクエストされた順序。 |
ordered_by |
この車両に使用された実際の注文。通常、これは 'order_by'フィールドに返されます。ただし、内部サーバーエラーなどの特定の状況では、別のメソッド( |
VehicleMatchType
一致する車両のタイプ。
列挙型 | |
---|---|
UNKNOWN |
不明な車両マッチタイプ |
EXCLUSIVE |
車両にルートが割り当てられていないため、乗車場所に移動できる。 |
BACK_TO_BACK |
車両は現在ルートに割り当てられていますが、進行中のルートを完了した後、乗車場所まで進むことができます。到着予定時刻と距離の計算では、既存のルートが考慮されます。 |
CARPOOL |
相乗りに十分な対応能力がある。 |
CARPOOL_BACK_TO_BACK |
車両は現在アクティブなルートを終了してから乗車地点に到着します。到着予定時刻と距離の計算では、既存のルートが考慮されます。 |
VehicleState
Vehicle
の状態。
列挙型 | |
---|---|
UNKNOWN_VEHICLE_STATE |
デフォルト。指定されていない、または認識できない車両の状態に使用されます。 |
OFFLINE |
車両は新しいルートを受け付けていない。注: 車両は割り当てられたルートを完了している間も、この状態で運転を継続する場合があります。 |
ONLINE |
車両が新しいルートを受け付けている。 |
VisualTrafficReportPolylineRendering
経路に沿ったポリラインの一部の部分に色を付ける方法を説明します。
フィールド | |
---|---|
road_stretch[] |
省略可。ポリラインに沿ってレンダリングする必要がある道路の延伸。ストレッチは重複しないことを保証し、必ずしもルート全体にまたがるとは限りません。 スタイルを設定する道路ストレッチがない場合、クライアントはルートにデフォルトを適用する必要があります。 |
RoadStretch
レンダリングする 1 つの道路区間。
フィールド | |
---|---|
style |
必須。適用するスタイル。 |
offset_meters |
必須。スタイルは |
length_meters |
必須。スタイルを適用するパスの長さ。 |
スタイル
交通量のスタイル。交通速度を示します。
列挙型 | |
---|---|
STYLE_UNSPECIFIED |
スタイルが選択されていません。 |
SLOWER_TRAFFIC |
トラフィックが減っている。 |
TRAFFIC_JAM |
渋滞している。 |
ウェイポイント
SearchVehiclesResponse
内の VehicleMatch
のルート上の中間ポイントを表します。このコンセプトは、他のすべてのエンドポイントで TripWaypoint
として表されます。
フィールド | |
---|---|
lat_lng |
このウェイポイントの位置。 |
eta |
車両がこの地点に到着する推定時間。 |
WaypointType
地点のタイプ。
列挙型 | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
不明なまたは未指定の地点の種類。 |
PICKUP_WAYPOINT_TYPE |
乗客またはアイテムを受け取るための地点。 |
DROP_OFF_WAYPOINT_TYPE |
乗客やアイテムを降ろすための地点。 |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
複数の目的地を経由するルートの中間地点の地点。 |