REST Resource: providers.vehicles

সম্পদ: যানবাহন

যানবাহন মেটাডেটা।

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "pastLocations": [
    {
      object (VehicleLocation)
    }
  ],
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। এই গাড়ির অনন্য নাম। ফর্ম্যাট হল providers/{provider}/vehicles/{vehicle} ।

vehicleState

enum ( VehicleState )

গাড়ির অবস্থা।

supportedTripTypes[]

enum ( TripType )

এই গাড়ির দ্বারা সমর্থিত ট্রিপ প্রকার।

currentTrips[]

string

শুধুমাত্র আউটপুট। বর্তমানে এই গাড়ির জন্য নির্ধারিত ট্রিপের জন্য tripId এর তালিকা৷

lastLocation

object ( VehicleLocation )

গাড়ির সর্বশেষ রিপোর্ট করা অবস্থান।

pastLocations[]

object ( VehicleLocation )

শুধুমাত্র ইনপুট। এই গাড়িটি অতীতে যে অবস্থানগুলি এখনও ফ্লিট ইঞ্জিনে রিপোর্ট করা হয়নি। এটি UpdateVehicleRequest এ ব্যবহার করা হয় এমন অবস্থান রেকর্ড করতে যা আগে সার্ভারে পাঠানো যায়নি। সাধারণত এটি ঘটে যখন গাড়িতে ইন্টারনেট সংযোগ থাকে না।

maximumCapacity

integer

এই গাড়িতে মোট কতজন আরোহী বহন করতে পারে। ড্রাইভার এই মান বিবেচনা করা হয় না. এই মান অবশ্যই একটির থেকে বেশি বা সমান হতে হবে৷

attributes[]

object ( VehicleAttribute )

গাড়ির বৈশিষ্ট্যের তালিকা। একটি গাড়ির সর্বাধিক 100টি বৈশিষ্ট্য থাকতে পারে এবং প্রতিটি বৈশিষ্ট্যের একটি অনন্য কী থাকতে হবে।

vehicleType

object ( VehicleType )

প্রয়োজন। এই গাড়ির ধরন। vehicles.search ফলাফলে যানবাহন ফিল্টার করতে ব্যবহার করা যেতে পারে। এছাড়াও ETA এবং রুট গণনাকে প্রভাবিত করে।

licensePlate

object ( LicensePlate )

গাড়ির লাইসেন্স প্লেটের তথ্য।

route[]
(deprecated)

object ( TerminalLocation )

বাতিল করা হয়েছে: পরিবর্তে Vehicle.waypoints ব্যবহার করুন।

currentRouteSegment

string

ড্রাইভার অ্যাপ পরবর্তী ওয়েপয়েন্টে যে পথটি নিতে চায় সেটি নির্দিষ্ট করে পলিলাইন। গাড়ির জন্য নির্ধারিত সমস্ত সক্রিয় ট্রিপের জন্য এই তালিকাটি Trip.current_route_segment এও ফেরত দেওয়া হয়।

দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র ড্রাইভার SDK দ্বারা ব্যবহারের জন্য উদ্দেশ্যে করা হয়েছে৷ ডিকোডিং এখনও সমর্থিত নয়।

currentRouteSegmentTraffic

object ( TrafficPolylineData )

শুধুমাত্র ইনপুট। ফ্লিট ইঞ্জিন যাত্রা ভাগাভাগি উন্নত করতে এই তথ্য ব্যবহার করে। দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র ড্রাইভার SDK দ্বারা ব্যবহারের জন্য উদ্দেশ্যে করা হয়েছে৷

currentRouteSegmentVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। currentRouteSegment সেগমেন্ট সেট করার সময়। এটি ক্লায়েন্টের দ্বারা সংরক্ষণ করা যেতে পারে এবং ভবিষ্যতের vehicles.get পাস করা যেতে পারে। রিটার্নিং রুটগুলি রোধ করার জন্য অনুরোধগুলি যা পরিবর্তিত হয়নি।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

currentRouteSegmentEndPoint

object ( TripWaypoint )

ওয়েপয়েন্ট যেখানে currentRouteSegment শেষ হয়। এটি vehicles.update চালকদের দ্বারা সরবরাহ করা যেতে পারে। হয় একটি ফুল ট্রিপ ওয়েপয়েন্ট, একটি ওয়েপয়েন্ট LatLng বা currentRouteSegment শেষ LatLng হিসাবে আপডেট কল। ফ্লিট ইঞ্জিন তখন একটি প্রকৃত ওয়েপয়েন্টে ইন্টারপোলেট করার জন্য যথাসাধ্য চেষ্টা করবে যদি এটি সম্পূর্ণরূপে নির্দিষ্ট করা না থাকে। এই ক্ষেত্রটি vehicles.update কলে উপেক্ষা করা হয় যদি না currentRouteSegment নির্দিষ্ট করা থাকে।

remainingDistanceMeters

integer

currentRouteSegment জন্য অবশিষ্ট ড্রাইভিং দূরত্ব। গাড়ির জন্য নির্ধারিত সমস্ত সক্রিয় ট্রিপের জন্য Trip.remaining_distance_meters এও এই মান ফেরত দেওয়া হয়। currentRouteSegment ক্ষেত্র খালি থাকলে মানটি অনির্দিষ্ট থাকে।

etaToFirstWaypoint

string ( Timestamp format)

waypoints ফিল্ডে প্রথম এন্ট্রিতে ETA। waypoints ক্ষেত্র খালি থাকলে বা Vehicle.current_route_segment ক্ষেত্রটি খালি থাকলে মানটি অনির্দিষ্ট থাকে।

একটি যানবাহন আপডেট করার সময়, একই অনুরোধে etaToFirstWaypoint উপর remainingTimeSeconds TimeSeconds অগ্রাধিকার নেয়।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

remainingTimeSeconds

integer

শুধুমাত্র ইনপুট। currentRouteSegment জন্য অবশিষ্ট ড্রাইভিং সময়। waypoints ক্ষেত্র খালি থাকলে বা Vehicle.current_route_segment ক্ষেত্রটি খালি থাকলে মানটি অনির্দিষ্ট থাকে। এই মানটি etaToFirstWaypoint - current_time সাথে মিলে যাওয়া উচিত যদি সব পক্ষ একই ঘড়ি ব্যবহার করে।

একটি যানবাহন আপডেট করার সময়, একই অনুরোধে etaToFirstWaypoint উপর remainingTimeSeconds TimeSeconds অগ্রাধিকার নেয়।

waypoints[]

object ( TripWaypoint )

এই যানবাহনের জন্য নির্ধারিত বাকি পথপয়েন্ট।

waypointsVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। শেষবার waypoints ফিল্ড আপডেট করা হয়েছিল। ক্লায়েন্টদের এই মানটি ক্যাশে করা উচিত এবং এটিকে GetVehicleRequest এ পাস করা উচিত যাতে এটি আপডেট করা হলেই waypoints ফিল্ডটি ফেরত দেওয়া হয়।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

backToBackEnabled

boolean

ড্রাইভার ব্যাক-টু-ব্যাক ট্রিপ গ্রহণ করে কিনা তা নির্দেশ করে। যদি true , vehicles.search অন্তর্ভুক্ত করতে পারে যদিও এটি বর্তমানে একটি ট্রিপে বরাদ্দ করা হয়েছে। ডিফল্ট মান false ।

navigationStatus

enum ( NavigationStatus )

গাড়ির নেভিগেশন স্ট্যাটাস।

deviceSettings

object ( DeviceSettings )

শুধুমাত্র ইনপুট। ড্রাইভার দ্বারা ব্যবহৃত মোবাইল ডিভাইসের সেটিংস সম্পর্কে তথ্য।

যানবাহন রাজ্য

একটি Vehicle অবস্থা।

Enums
UNKNOWN_VEHICLE_STATE ডিফল্ট, অনির্দিষ্ট বা অস্বীকৃত যানবাহনের অবস্থার জন্য ব্যবহৃত।
OFFLINE যানবাহন নতুন ট্রিপ গ্রহণ করা হয় না. দ্রষ্টব্য: গাড়িটি নির্ধারিত একটি ট্রিপ সম্পূর্ণ করার সময় এই অবস্থায় কাজ চালিয়ে যেতে পারে।
ONLINE যানবাহন নতুন ভ্রমণ গ্রহণ করছে।

যানবাহন বৈশিষ্ট্য

একটি গাড়ির বৈশিষ্ট্যকে একটি মূল-মান জোড়া হিসাবে বর্ণনা করে। "কী:মান" স্ট্রিং দৈর্ঘ্য 256 অক্ষরের বেশি হতে পারে না।

JSON প্রতিনিধিত্ব 
{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}
ক্ষেত্র
key

string

বৈশিষ্ট্য এর কী. কীগুলিতে কোলন অক্ষর (:) থাকতে পারে না।

value

string

বৈশিষ্ট্যের মান।

ইউনিয়ন ক্ষেত্রের vehicle_attribute_value । অ্যাট্রিবিউটের মান, স্ট্রিং, বুল বা ডাবল টাইপের হতে পারে। vehicle_attribute_value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
stringValue

string

স্ট্রিং টাইপ করা বৈশিষ্ট্য মান.

দ্রষ্টব্য: এটি value ক্ষেত্রের অনুরূপ যা শেষ পর্যন্ত অবমূল্যায়িত হবে। পদ্ধতি তৈরি বা আপডেট করার জন্য, যেকোন একটি ক্ষেত্র ব্যবহার করা যেতে পারে, তবে stringValue ব্যবহার করার জন্য এটি দৃঢ়ভাবে সুপারিশ করা হয়। যদি stringValue এবং value উভয়ই সেট করা থাকে, তাহলে সেগুলি অবশ্যই অভিন্ন হতে হবে বা একটি ত্রুটি নিক্ষেপ করা হবে৷ উভয় ক্ষেত্র প্রতিক্রিয়ায় জনবহুল।

boolValue

boolean

বুলিয়ান টাইপ করা বৈশিষ্ট্য মান।

numberValue

number

ডাবল টাইপ করা বৈশিষ্ট্য মান.

যানবাহনের ধরন

গাড়ির ধরন।

JSON প্রতিনিধিত্ব 
{
  "category": enum (Category)
}
ক্ষেত্র
category

enum ( Category )

যানবাহনের ধরন বিভাগ

শ্রেণী

যানবাহনের ধরন বিভাগ

Enums
UNKNOWN ডিফল্ট, অনির্দিষ্ট বা অচেনা যানবাহন বিভাগের জন্য ব্যবহৃত।
AUTO একটি অটোমোবাইল।
TAXI যে কোনো যানবাহন যা ট্যাক্সি হিসেবে কাজ করে (সাধারণত লাইসেন্সপ্রাপ্ত বা নিয়ন্ত্রিত)।
TRUCK সাধারণত, একটি বড় স্টোরেজ ক্ষমতা সহ একটি যান।
TWO_WHEELER একটি মোটরসাইকেল, মোপেড বা অন্যান্য দুই চাকার যান
BICYCLE মানব চালিত পরিবহন।
PEDESTRIAN একজন মানব পরিবহনকারী, সাধারণত হাঁটা বা দৌড়ানো, পথচারী পথ ধরে ভ্রমণ করে।

লাইসেন্সপ্লেট

গাড়ির লাইসেন্স প্লেটের তথ্য। ব্যক্তিগতভাবে-শনাক্তকরণযোগ্য তথ্য সংরক্ষণ এড়াতে, সত্তার অংশ হিসাবে লাইসেন্স প্লেট সম্পর্কে শুধুমাত্র ন্যূনতম তথ্য সংরক্ষণ করা হয়।

JSON প্রতিনিধিত্ব 
{
  "countryCode": string,
  "lastCharacter": string
}
ক্ষেত্র
countryCode

string

প্রয়োজন। CLDR দেশ/অঞ্চল কোড। উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রের জন্য US , বা ভারতের জন্য IN ।

lastCharacter

string

লাইসেন্স প্লেটের শেষ সংখ্যা বা "-1" কোন সাংখ্যিক মান বোঝাতে লাইসেন্স প্লেটে উপস্থিত নেই।

  • "ABC 1234" -> "4"
  • "AB 123 CD" -> "3"
  • "ABCDEF" -> "-1"

ট্রাফিক পলিলাইন ডেটা

প্রত্যাশিত যানবাহন রুট বরাবর ট্রাফিক অবস্থা.

JSON প্রতিনিধিত্ব 
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
ক্ষেত্র
trafficRendering

object ( VisualTrafficReportPolylineRendering )

একটি পলিলাইন রেন্ডারিং যে সমস্ত অঞ্চলের জন্য গ্রাহকের যাত্রার এক প্রসারিত ট্রাফিক কত দ্রুত।

VisualTrafficReportPolylineRendering

ক্লায়েন্টদের রুট বরাবর পলিলাইনের একটি অংশকে কীভাবে রঙ করা উচিত তা বর্ণনা করে।

JSON প্রতিনিধিত্ব 
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
ক্ষেত্র
roadStretch[]

object ( RoadStretch )

ঐচ্ছিক। রাস্তার প্রসারিত যা পলিলাইন বরাবর রেন্ডার করা উচিত। স্ট্রেচগুলিকে ওভারল্যাপ না করার গ্যারান্টি দেওয়া হয়, এবং অগত্যা সম্পূর্ণ রুট স্প্যান করে না।

শৈলীতে প্রসারিত রাস্তার অনুপস্থিতিতে, ক্লায়েন্টকে রুটের জন্য ডিফল্ট প্রয়োগ করতে হবে।

রোড স্ট্রেচ

একটি রাস্তা প্রসারিত যে রেন্ডার করা উচিত.

JSON প্রতিনিধিত্ব 
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
ক্ষেত্র
style

enum ( Style )

প্রয়োজন। প্রয়োগ করার শৈলী।

offsetMeters

integer

প্রয়োজন। শৈলীটি [offsetMeters, offsetMeters + lengthMeters) এর মধ্যে প্রয়োগ করা উচিত।

lengthMeters

integer

প্রয়োজন। পথের দৈর্ঘ্য যেখানে শৈলী প্রয়োগ করতে হবে।

শৈলী

ট্র্যাফিক শৈলী, ট্র্যাফিক গতি নির্দেশ করে।

Enums
STYLE_UNSPECIFIED কোনো শৈলী নির্বাচন করা হয়নি।
SLOWER_TRAFFIC যান চলাচলের গতি কমে যাচ্ছে।
TRAFFIC_JAM যানজট লেগেই আছে।

ডিভাইস সেটিংস

মোবাইল ডিভাইসে বিভিন্ন সেটিংস সম্পর্কে তথ্য।

JSON প্রতিনিধিত্ব 
{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}
ক্ষেত্র
locationPowerSaveMode

enum ( LocationPowerSaveMode )

ব্যাটারি সেভার চালু থাকা অবস্থায় ডিভাইসে অবস্থান বৈশিষ্ট্যগুলি কীভাবে আচরণ করতে সেট করা হয়।

isPowerSaveMode

boolean

ডিভাইসটি বর্তমানে পাওয়ার সেভ মোডে আছে কিনা।

isInteractive

boolean

ডিভাইসটি ইন্টারেক্টিভ অবস্থায় আছে কিনা।

batteryInfo

object ( BatteryInfo )

ব্যাটারির অবস্থা সম্পর্কে তথ্য।

LocationPowerSaveMode

ডিভাইসগুলির "ব্যাটারি সেভার" বৈশিষ্ট্য চালু থাকলে মোবাইল ডিভাইসে আচরণ করার জন্য অবস্থান বৈশিষ্ট্যগুলি কীভাবে কনফিগার করা হয়৷ ( https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode() )

Enums
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 প্রোভাইডারদের কাছে সমস্ত অনুরোধ থ্রোটল করবে।

ব্যাটারি তথ্য

ডিভাইসের ব্যাটারি সম্পর্কে তথ্য।

JSON প্রতিনিধিত্ব 
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
ক্ষেত্র
batteryStatus

enum ( BatteryStatus )

ব্যাটারির স্থিতি, পূর্ণ হোক বা চার্জ হচ্ছে ইত্যাদি।

powerSource

enum ( PowerSource )

ব্যাটারি শক্তি উৎসের অবস্থা।

batteryPercentage

number

বর্তমান ব্যাটারি শতাংশ [0-100]।

ব্যাটারি স্ট্যাটাস

ব্যাটারির স্থিতি, পূর্ণ হোক বা চার্জ হচ্ছে ইত্যাদি।

Enums
UNKNOWN_BATTERY_STATUS ব্যাটারির অবস্থা অজানা।
BATTERY_STATUS_CHARGING ব্যাটারি চার্জ করা হচ্ছে।
BATTERY_STATUS_DISCHARGING ব্যাটারি ডিসচার্জ হচ্ছে।
BATTERY_STATUS_FULL ব্যাটারি পূর্ণ।
BATTERY_STATUS_NOT_CHARGING ব্যাটারি চার্জ হচ্ছে না।
BATTERY_STATUS_POWER_LOW ব্যাটারির শক্তি কম।

পাওয়ারসোর্স

ব্যাটারি চার্জ করার জন্য ব্যবহৃত চার্জারের প্রকার।

Enums
UNKNOWN_POWER_SOURCE পাওয়ার উৎস অজানা।
POWER_SOURCE_AC পাওয়ার সোর্স একটি এসি চার্জার।
POWER_SOURCE_USB পাওয়ার উৎস একটি USB পোর্ট।
POWER_SOURCE_WIRELESS পাওয়ার সোর্স ওয়্যারলেস।
POWER_SOURCE_UNPLUGGED ব্যাটারি আনপ্লাগ করা হয়.

পদ্ধতি

create

 একটি অন-ডিমান্ড রাইডশেয়ার বা ডেলিভারি প্রদানকারীর সাথে যুক্ত একটি নতুন গাড়ির সূচনা করে।

delete

 ফ্লিট ইঞ্জিন থেকে একটি যানবাহন মুছে দেয়।

get

 ফ্লিট ইঞ্জিন থেকে একটি গাড়ি ফেরত দেয়।

list

 অনুরোধের বিকল্পগুলির সাথে মেলে এমন একটি প্রদানকারীর সাথে যুক্ত যানবাহনের একটি পৃষ্ঠাযুক্ত তালিকা প্রদান করে।
অনুরোধের বিকল্পগুলির সাথে মেলে এমন যানবাহনের একটি তালিকা প্রদান করে৷

update

 ফ্লিট ইঞ্জিনে আপডেট করা যানবাহনের ডেটা লেখে।

updateAttributes

 আংশিকভাবে একটি গাড়ির বৈশিষ্ট্য আপডেট করে।