REST Resource: providers.trips

সম্পদ: ট্রিপ

ট্রিপ মেটাডেটা।

JSON প্রতিনিধিত্ব 
{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। "providers/{provider}/trips/{trip}" ফর্ম্যাটে

vehicleId

string

এই ট্রিপ করা গাড়ির আইডি।

tripStatus

enum ( TripStatus )

ভ্রমণের বর্তমান অবস্থা।

tripType

enum ( TripType )

ভ্রমণের ধরন।

pickupPoint

object ( TerminalLocation )

লোকেশন যেখানে গ্রাহক ইঙ্গিত করে যে তাদের তোলা হবে।

actualPickupPoint

object ( StopLocation )

শুধুমাত্র ইনপুট। প্রকৃত অবস্থান কখন এবং কোথায় গ্রাহক নেওয়া হয়েছিল। এই ক্ষেত্রটি প্রদানকারীর জন্য প্রকৃত পিকআপ তথ্য সম্পর্কে প্রতিক্রিয়া প্রদান করার জন্য।

actualPickupArrivalPoint

object ( StopLocation )

শুধুমাত্র ইনপুট। পিকআপ পয়েন্টে ড্রাইভারের আগমনের প্রকৃত সময় এবং অবস্থান। এই ক্ষেত্রটি প্রদানকারীর জন্য পিকআপ পয়েন্টে প্রকৃত আগমনের তথ্য সম্পর্কে প্রতিক্রিয়া প্রদান করার জন্য।

pickupTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। হয় আনুমানিক ভবিষ্যত সময় যখন রাইডার(গুলি) পিক আপ করা হবে, অথবা প্রকৃত সময় যখন তাদের তোলা হয়েছিল।

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"

intermediateDestinations[]

object ( TerminalLocation )

মধ্যবর্তী স্টপ যাতে ট্রিপ অনুরোধ করে (পিকআপ এবং ড্রপঅফ ছাড়াও)। প্রাথমিকভাবে এটি শেয়ার্ড ট্রিপের জন্য সমর্থিত হবে না।

intermediateDestinationsVersion

string ( Timestamp format)

intermediateDestinations শেষ কবে পরিবর্তন করা হয়েছিল তা নির্দেশ করে৷ আপনার সার্ভারের উচিত এই মানটি ক্যাশে করা এবং এটিকে UpdateTripRequest এ পাস করা উচিত যখন intermediateDestinationIndex আপডেট করা হয় যাতে intermediateDestinations পরিবর্তন না হয়।

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"

intermediateDestinationIndex

integer

যখন TripStatus ENROUTE_TO_INTERMEDIATE_DESTINATION হয়, তখন [0..N-1] এর মধ্যে একটি সংখ্যা নির্দেশ করে যে গাড়িটি পরবর্তী কোন মধ্যবর্তী গন্তব্যটি অতিক্রম করবে। যখন TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION হয়, তখন [0..N-1] এর মধ্যে একটি সংখ্যা নির্দেশ করে যে গাড়িটি কোন মধ্যবর্তী গন্তব্যে রয়েছে। প্রদানকারী এই মান সেট করে। কোনো intermediateDestinations না থাকলে, এই ক্ষেত্রটি উপেক্ষা করা হয়।

actualIntermediateDestinationArrivalPoints[]

object ( StopLocation )

শুধুমাত্র ইনপুট। একটি মধ্যবর্তী গন্তব্যে ড্রাইভারের আগমনের প্রকৃত সময় এবং অবস্থান। এই ক্ষেত্রটি প্রদানকারীর জন্য মধ্যবর্তী গন্তব্যে প্রকৃত আগমনের তথ্যের উপর প্রতিক্রিয়া প্রদান করার জন্য।

actualIntermediateDestinations[]

object ( StopLocation )

শুধুমাত্র ইনপুট। প্রকৃত সময় এবং অবস্থান কখন এবং কোথায় গ্রাহককে মধ্যবর্তী গন্তব্য থেকে তোলা হয়েছিল। এই ক্ষেত্রটি প্রদানকারীর জন্য মধ্যবর্তী গন্তব্যে প্রকৃত পিকআপ তথ্য সম্পর্কে প্রতিক্রিয়া প্রদান করার জন্য।

dropoffPoint

object ( TerminalLocation )

অবস্থান যেখানে গ্রাহক নির্দেশ করে যে তাদের বাদ দেওয়া হবে।

actualDropoffPoint

object ( StopLocation )

শুধুমাত্র ইনপুট। প্রকৃত সময় এবং অবস্থান কখন এবং কোথায় গ্রাহককে বাদ দেওয়া হয়েছিল। এই ক্ষেত্রটি প্রদানকারীর প্রকৃত ড্রপঅফ তথ্য সম্পর্কে প্রতিক্রিয়া প্রদানের জন্য।

dropoffTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। হয় আনুমানিক ভবিষ্যত সময় যখন রাইডার(দের) চূড়ান্ত গন্তব্যে নামানো হবে, অথবা প্রকৃত সময় যখন তাদের নামানো হয়েছিল।

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"

remainingWaypoints[]

object ( TripWaypoint )

শুধুমাত্র আউটপুট। বর্তমান অবস্থান থেকে ড্রপঅফ পয়েন্ট পর্যন্ত সম্পূর্ণ পথ, অন্তর্ভুক্ত। এই পথ অন্যান্য ট্রিপ থেকে ওয়েপয়েন্ট অন্তর্ভুক্ত করতে পারে.

vehicleWaypoints[]

object ( TripWaypoint )

এই ক্ষেত্রটি ট্রিপের জন্য ওয়েপয়েন্টের ম্যানুয়াল ক্রম সমর্থন করে। এটিতে নির্ধারিত গাড়ির জন্য বাকি সমস্ত পথপয়েন্ট, সেইসাথে এই ট্রিপের জন্য পিকআপ এবং ড্রপ-অফ ওয়েপয়েন্ট রয়েছে। যদি ট্রিপটি কোনো যানবাহনের জন্য নির্ধারিত না থাকে, তাহলে ফ্লিট ইঞ্জিন এই ক্ষেত্রটিকে উপেক্ষা করে। গোপনীয়তার কারণে, এই ক্ষেত্রটি শুধুমাত্র trips.update এবং trips.create কলে সার্ভার দ্বারা পপুলেট করা হয়, trips.get কলে নয়।

route[]

object ( LatLng )

শুধুমাত্র আউটপুট। অবশিষ্ট ওয়েপয়েন্টে প্রথম প্রবেশের জন্য এই ট্রিপের জন্য প্রত্যাশিত রুট। মনে রাখবেন যে প্রথম ওয়েপয়েন্ট একটি ভিন্ন ট্রিপের অন্তর্গত হতে পারে।

currentRouteSegment

string

শুধুমাত্র আউটপুট। পরবর্তী ওয়েপয়েন্টে একটি এনকোড করা পথ।

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

currentRouteSegmentVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। শেষ কবে রুট পরিবর্তন করা হয়েছিল তা নির্দেশ করে।

দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র ড্রাইভার SDK এবং উপভোক্তা SDK দ্বারা ব্যবহারের জন্য উদ্দিষ্ট৷

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"

currentRouteSegmentTraffic

object ( ConsumableTrafficPolyline )

শুধুমাত্র আউটপুট। currentRouteSegment সাথে ট্রাফিক অবস্থা নির্দেশ করে যখন তারা উপলব্ধ থাকে।

দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র ড্রাইভার SDK এবং উপভোক্তা SDK দ্বারা ব্যবহারের জন্য উদ্দিষ্ট৷

currentRouteSegmentTrafficVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। currentRouteSegmentTraffic ট্রাফিক শেষ কবে পরিবর্তন করা হয়েছিল তা নির্দেশ করে৷

দ্রষ্টব্য: এই ক্ষেত্রটি শুধুমাত্র ড্রাইভার SDK এবং উপভোক্তা SDK দ্বারা ব্যবহারের জন্য উদ্দিষ্ট৷

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 শেষ হয়।

remainingDistanceMeters

integer

শুধুমাত্র আউটপুট। currentRouteSegment ক্ষেত্রের অবশিষ্ট ড্রাইভিং দূরত্ব৷ যদি ট্রিপটি কোনও গাড়ির জন্য বরাদ্দ না করা হয় বা ট্রিপটি সম্পূর্ণ বা বাতিল করা হয় তবে মানটি অনির্দিষ্ট থাকে।

etaToFirstWaypoint

string ( Timestamp format)

শুধুমাত্র আউটপুট। পরবর্তী ওয়েপয়েন্টের ETA ( remainingWaypoints ফিল্ডে প্রথম এন্ট্রি)। যদি ট্রিপটি কোনও গাড়ির জন্য নির্ধারিত না হয় বা ট্রিপটি নিষ্ক্রিয় (সম্পূর্ণ বা বাতিল) হয় তবে মানটি অনির্দিষ্ট থাকে।

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"

remainingTimeToFirstWaypoint

string ( Duration format)

শুধুমাত্র আউটপুট। Trip.eta_to_first_waypoint এ ট্রিপ ডেটা ফেরত দেওয়ার সময়কাল। যদি ট্রিপটি কোনও গাড়ির জন্য নির্ধারিত না হয় বা ট্রিপটি নিষ্ক্রিয় (সম্পূর্ণ বা বাতিল) হয় তবে মানটি অনির্দিষ্ট থাকে।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

remainingWaypointsVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। remainingWaypoints পরিবর্তন করার শেষ সময় নির্দেশ করে (একটি ওয়েপয়েন্ট যোগ করা, সরানো বা পরিবর্তন করা হয়েছে)।

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"

remainingWaypointsRouteVersion

string ( Timestamp format)

শুধুমাত্র আউটপুট। remainingWaypoints.path_to_waypoint এবং remainingWaypoints.traffic_to_waypoint শেষ কবে পরিবর্তন করা হয়েছে তা নির্দেশ করে। আপনার ক্লায়েন্ট অ্যাপটিকে এই মানটি ক্যাশে করা উচিত এবং এটিকে GetTripRequest এ পাস করা উচিত যাতে আপডেট করা হলেই remainingWaypoints জন্য পাথ এবং ট্র্যাফিক ফেরত দেওয়া হয়।

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"

numberOfPassengers

integer

অপরিবর্তনীয়। এই ট্রিপে যাত্রীদের সংখ্যা নির্দেশ করে এবং ড্রাইভারকে অন্তর্ভুক্ত করে না। একটি যানবাহন একটি vehicles.search প্রতিক্রিয়ায় ফেরত দেওয়ার জন্য উপলব্ধ ক্ষমতা থাকতে হবে।

lastLocation

object ( VehicleLocation )

শুধুমাত্র আউটপুট। রুট বরাবর গাড়ির সর্বশেষ রিপোর্ট করা অবস্থান নির্দেশ করে।

lastLocationSnappable

boolean

শুধুমাত্র আউটপুট। গাড়ির lastLocation বর্তমান রুট সেগমেন্টে স্ন্যাপ করা যাবে কিনা তা নির্দেশ করে। False যদি lastLocation বা currentRouteSegment বিদ্যমান না থাকে। এটি ফ্লিট ইঞ্জিন দ্বারা গণনা করা হয়। ক্লায়েন্টদের থেকে কোন আপডেট উপেক্ষা করা হবে.

view

enum ( TripView )

ট্রিপ ফিল্ডের উপসেট যেগুলি জনবহুল এবং কীভাবে সেগুলিকে ব্যাখ্যা করা উচিত৷

ট্রিপ স্ট্যাটাস

একটি ট্রিপের অবস্থা যা এর অগ্রগতি নির্দেশ করে৷

Enums
UNKNOWN_TRIP_STATUS ডিফল্ট, অনির্দিষ্ট বা অচেনা ট্রিপ স্ট্যাটাসের জন্য ব্যবহৃত।
NEW নতুন তৈরি ট্রিপ.
ENROUTE_TO_PICKUP ড্রাইভার পিকআপ পয়েন্টের দিকে যাচ্ছে।
ARRIVED_AT_PICKUP ড্রাইভার পিকআপ পয়েন্টে এসেছে।
ARRIVED_AT_INTERMEDIATE_DESTINATION ড্রাইভার একটি মধ্যবর্তী গন্তব্যে পৌঁছেছে এবং আরোহীর জন্য অপেক্ষা করছে।
ENROUTE_TO_INTERMEDIATE_DESTINATION ড্রাইভার একটি মধ্যবর্তী গন্তব্যে যাচ্ছে (ড্রপ অফ পয়েন্ট নয়)।
ENROUTE_TO_DROPOFF ড্রাইভার রাইডারটিকে তুলে নিয়েছে এবং পরবর্তী গন্তব্যের দিকে যাচ্ছে।
COMPLETE রাইডারকে নামিয়ে দেওয়া হয়েছে এবং ট্রিপ সম্পূর্ণ হয়েছে৷
CANCELED ড্রাইভার, রাইডার বা রাইডশেয়ার প্রদানকারী দ্বারা পিকআপের আগে ট্রিপটি বাতিল করা হয়েছিল।

স্টপ লোকেশন

প্রকৃত অবস্থান যেখানে একটি স্টপ (পিকআপ/ড্রপঅফ) ঘটেছে।

JSON প্রতিনিধিত্ব 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
ক্ষেত্র
point

object ( LatLng )

প্রয়োজন। প্রকৃত অবস্থান নির্দেশ করে।

timestamp

string ( Timestamp format)

স্টপ কখন ঘটেছে তা নির্দেশ করে।

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"

stopTime
(deprecated)

string ( Timestamp format)

শুধুমাত্র ইনপুট। অবচয়। টাইমস্ট্যাম্প ক্ষেত্র ব্যবহার করুন।

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"

ট্রিপভিউ

একটি trips.get প্রতিক্রিয়াতে ট্রিপ ফিল্ডের বিভিন্ন সেটের জন্য নির্বাচক৷ প্রসঙ্গের জন্য AIP-157 দেখুন। অতিরিক্ত মতামত যোগ করা হতে পারে.

Enums
TRIP_VIEW_UNSPECIFIED ডিফল্ট মান। পিছনের-সামঞ্জস্যতার জন্য, API একটি SDK ভিউতে ডিফল্ট হবে। স্থিতিশীলতা এবং সমর্থন নিশ্চিত করতে, গ্রাহকদের SDK ছাড়া অন্য একটি TripView নির্বাচন করার পরামর্শ দেওয়া হচ্ছে।
SDK সর্বজনীনভাবে উপলব্ধ লাইব্রেরি ব্যবহার করে ব্যাখ্যাযোগ্য বা সমর্থনযোগ্য নাও হতে পারে এমন ক্ষেত্রগুলি অন্তর্ভুক্ত করে৷
JOURNEY_SHARING_V1S জার্নি শেয়ারিং ব্যবহারের ক্ষেত্রে ট্রিপ ক্ষেত্রগুলি জনবহুল। এই দৃশ্যটি সার্ভার-টু-সার্ভার যোগাযোগের উদ্দেশ্যে।

পদ্ধতি

create

 ফ্লিট ইঞ্জিনে একটি ট্রিপ তৈরি করে এবং নতুন ট্রিপ ফেরত দেয়।

delete

 একটি একক ট্রিপ মুছে দেয়।

get

 একটি একক ভ্রমণ সম্পর্কে তথ্য পান।
একটি নির্দিষ্ট গাড়ির জন্য সমস্ত ভ্রমণ পান।

update

 ট্রিপ ডেটা আপডেট করে।