REST Resource: projects.trips

উৎস: ভ্রমণ

একটি ভ্রমণ।

JSON উপস্থাপনা 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। শনাক্তকারী। ট্রিপটির রিসোর্স নাম। ফরম্যাট: projects/{project_number}/trips/{tripId}।

config

object ( TripConfig )

অপরিবর্তনীয়। ভ্রমণের জন্য নির্ধারিত বিন্যাস।

androidAppId

string

শুধুমাত্র ইনপুটযোগ্য। অপরিবর্তনীয়। যে মোবাইল অ্যাপ্লিকেশনটি ট্রিপটি ব্যবহার করবে তার অ্যান্ড্রয়েড অ্যাপ্লিকেশন আইডি। androidAppId অথবা iosAppId এর মধ্যে অন্তত একটি অবশ্যই সেট করতে হবে।

iosAppId

string

শুধুমাত্র ইনপুটযোগ্য। অপরিবর্তনীয়। যে মোবাইল অ্যাপ্লিকেশনটি ট্রিপটি ব্যবহার করবে তার iOS বান্ডেল আইডি। androidAppId অথবা iosAppId এর মধ্যে অন্তত একটি অবশ্যই সেট করতে হবে।

authToken

object ( AuthToken )

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

state

enum ( State )

শুধুমাত্র আউটপুট। ট্রিপ অবস্থা।

execution

object ( TripExecution )

শুধুমাত্র আউটপুট। ট্রিপটি সম্পাদনের সর্বশেষ তথ্য। ট্রিপটি ত্রুটিপূর্ণ অবস্থায় থাকলে এটি সেট নাও হতে পারে।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। ট্রিপটি তৈরি করার সময় সার্ভার অনুযায়ী সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

updateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে সার্ভার সর্বশেষ ট্রিপ আপডেটটি পেয়েছে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

ট্রিপকনফিগ

ভ্রমণের জন্য বিন্যাস।

JSON উপস্থাপনা 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
ক্ষেত্র
enableHighFrequencyUpdates

boolean

ঐচ্ছিক। ঘন ঘন ট্রিপ আপডেট চালু করা হবে কিনা।

দ্রষ্টব্য: এই বৈশিষ্ট্যটি সক্রিয় করলে ট্রিপটি এন্টারপ্রাইজ টিয়ার ব্যবহারের অধীনে লগ করা হবে এবং এটি এন্টারপ্রাইজ টিয়ার রেটের অধীন।

enablePubsub

boolean

ঐচ্ছিক। ভ্রমণের জন্য পাবসাব নোটিফিকেশন চালু করা হবে কিনা।

pubsubFieldMask

string ( FieldMask format)

ঐচ্ছিক। সেট করা হলে, ট্রিপ ফিল্ডগুলির শুধুমাত্র নির্দিষ্ট উপসেটটি পাবসাব নোটিফিকেশনে অন্তর্ভুক্ত করা হবে।

সেট করা না থাকলে, ট্রিপের সমস্ত ফিল্ড পাবসাব নোটিফিকেশনে অন্তর্ভুক্ত করা হবে (এটিই ডিফল্ট আচরণ)।

নিম্নলিখিত ক্ষেত্রগুলি সমর্থিত নয়:

  • androidAppId
  • iosAppId
  • authToken
  • config

দ্রষ্টব্য: enablePubsub এর মান false হলে এই ফিল্ডটি উপেক্ষা করা হয়।

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

enableRemainingRouteReporting

boolean

ঐচ্ছিক। ট্রিপটির জন্য অবশিষ্ট পথের প্রতিবেদন চালু করা হবে কিনা।

দ্রষ্টব্য: এই বৈশিষ্ট্যটি সক্রিয় করলে ট্রিপটি এন্টারপ্রাইজ টিয়ার ব্যবহারের অধীনে লগ করা হবে এবং এটি এন্টারপ্রাইজ টিয়ার রেটের অধীন।

অথটোকেন

একটি প্রমাণীকরণ টোকেন।

JSON উপস্থাপনা 
{
  "token": string,
  "expireTime": string
}
ক্ষেত্র
token

string

শুধুমাত্র আউটপুট। প্রমাণীকরণ টোকেন যা মোবাইল অ্যাপ্লিকেশনে পাঠাতে হবে।

expireTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে প্রমাণীকরণ টোকেনটির মেয়াদ শেষ হবে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

রাজ্য

ভ্রমণের সকল সম্ভাব্য অবস্থা।

এনাম
STATE_UNSPECIFIED ভ্রমণের অবস্থা অনির্দিষ্ট।
NEW ভ্রমণটি তৈরি করা হয়েছে কিন্তু এখনো শুরু হয়নি।
ENROUTE পরিবহনকারী গন্তব্যের পথে রয়েছে।
ARRIVED পরিবহনকারী গন্তব্যে পৌঁছাল।
SUSPENDED ভ্রমণটি স্থগিত করা হয়েছিল।
FAILED ভ্রমণটি সফলভাবে সম্পন্ন হতে পারেনি।
CLIENT_ERROR ক্লায়েন্টের ভুলের কারণে ট্রিপটি ব্যর্থ হয়েছে।
CANCELED ডেভেলপারের পক্ষ থেকে ভ্রমণটি স্পষ্টভাবে বাতিল করা হয়েছিল।

ট্রিপএক্সিকিউশন

ভ্রমণটি সম্পাদনের তথ্য।

JSON উপস্থাপনা 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
ক্ষেত্র
origin

object ( Location )

শুধুমাত্র আউটপুট। যাত্রার উৎস, যা সাধারণত NavConnect যাত্রা শুরুর সময় ট্রান্সপোর্টারের অবস্থান।

destination

object ( Stop )

শুধুমাত্র আউটপুট। মোবাইল অ্যাপ্লিকেশন দ্বারা জানানো ভ্রমণের গন্তব্য।

location

object ( Location )

শুধুমাত্র আউটপুট। এটি ট্রান্সপোর্টারের সর্বশেষ জ্ঞাত অবস্থান নির্দেশক লোকেশন সিগন্যাল। উপলব্ধ থাকলে, এটি হবে রোড স্ন্যাপড লোকেশন।

remainingRoute

object ( Route )

শুধুমাত্র আউটপুট। রুটের অবশিষ্ট অংশের জন্য পলিলাইনটি প্রদান করে।

traveledDuration

string ( Duration format)

শুধুমাত্র আউটপুট। এ পর্যন্ত অতিক্রান্ত সময়।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

remainingDuration

string ( Duration format)

শুধুমাত্র আউটপুট। গুগলের অনুমান অনুযায়ী এই ভ্রমণে বাকি থাকা সময়।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

traveledDistanceMeters

integer

শুধুমাত্র আউটপুট। মূলবিন্দু থেকে অতিক্রান্ত দূরত্ব মিটারে।

remainingDistanceMeters

integer

শুধুমাত্র আউটপুট। গন্তব্যে পৌঁছানোর অবশিষ্ট দূরত্ব মিটারে।

stopAddedInRoute

boolean

শুধুমাত্র আউটপুট। রুটে কোনো স্টপ যোগ করা হয়েছে কিনা তা নির্দেশ করে।

অবস্থান

মোবাইল অ্যাপ্লিকেশন দ্বারা প্রদত্ত অবস্থান।

JSON উপস্থাপনা 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
ক্ষেত্র
point

object ( LatLng )

শুধুমাত্র আউটপুট। অবস্থানটির অক্ষাংশ/দ্রাঘিমাংশ।

sourceTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। ক্লায়েন্ট কর্তৃক নির্দেশিত অবস্থানটি যে সময়ে সংগ্রহ করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

serverTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে সার্ভার এই অবস্থান আপডেটটি গ্রহণ করেছে।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

অক্ষাংশ দ্রাঘিমাংশ

একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ বোঝাতে একজোড়া ডাবল (double) হিসেবে প্রকাশ করা হয়। অন্যভাবে নির্দিষ্ট করা না থাকলে, এই অবজেক্টটিকে অবশ্যই WGS84 স্ট্যান্ডার্ড মেনে চলতে হবে। মানগুলো অবশ্যই নর্মালাইজড রেঞ্জের মধ্যে থাকতে হবে।

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

থামুন

যাত্রাপথে এমন একটি বিরতি যেখানে কোনো কাজ সম্পাদন করতে হবে।

JSON উপস্থাপনা 
{
  "point": {
    object (LatLng)
  }
}
ক্ষেত্র
point

object ( LatLng )

প্রয়োজনীয়। বিরতির স্থানের অবস্থান অক্ষাংশ/দ্রাঘিমাংশ হিসেবে।

রুট

একটি রুট পলিলাইন।

JSON উপস্থাপনা 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
ক্ষেত্র
trafficInformation[]

object ( SpeedReadingInterval )

শুধুমাত্র আউটপুট। পলিলাইনে ট্র্যাফিকের তথ্য গতি পাঠের ব্যবধান হিসাবে বর্ণনা করা হয়েছে।

নোট:

  • ব্যবধানগুলো পরস্পরকে অতিক্রম করে না।
  • ব্যবধানগুলো সংলগ্ন।
  • ব্যবধানগুলো সম্পূর্ণ পলিলাইনটিকে আবৃত করে।
  • ব্যবধানগুলো ক্রমবর্ধমান সূচক অনুসারে সাজানো হয়েছে।
  • প্রতিটি ব্যবধানের জন্য গতি নির্দিষ্ট করা আছে।

ইউনিয়ন ফিল্ড format । রুট ফরম্যাট।

ব্যবহৃত ফরম্যাটটি route_polyline_format প্যারামিটার দ্বারা নিয়ন্ত্রিত হয়। যদি এটি সেট করা না থাকে, তবে এটি ডিফল্টরূপে একটি সাধারণ পলিলাইন হয়। format নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

simplePolyline

object ( SimplePolyline )

শুধুমাত্র আউটপুট। রুটটি ল্যাটলং-এর একটি সাধারণ তালিকা হিসেবে থাকবে।

encodedPolyline

string

শুধুমাত্র আউটপুট। রুটটি একটি এনকোডেড পলিলাইন হিসেবে থাকবে। দেখুন https://developers.google.com/maps/documentation/utilities/polylinealgorithm ।

s2Polyline

string ( bytes format)

শুধুমাত্র আউটপুট। রুটটি একটি এনকোডেড S2Polyline হিসেবে থাকবে। দেখুন https://s2geometry.io/devguide/basic_types.html ।

একটি বেস৬৪-এনকোডেড স্ট্রিং।

geoJson

object ( Struct format)

শুধুমাত্র আউটপুট। রুটটি একটি GeoJSON LineString হিসেবে থাকবে। দেখুন https://tools.ietf.org/html/rfc7946#section-3.1.4 ।

সিম্পলপলিলাইন

পয়েন্টের একটি সাধারণ তালিকা ব্যবহার করে একটি পলিলাইন উপস্থাপন করা হয়।

JSON উপস্থাপনা 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
ক্ষেত্র
points[]

object ( LatLng )

শুধুমাত্র আউটপুট। পলিলাইনটির প্রতিনিধিত্বকারী পয়েন্টগুলোর ক্রমিক তালিকা।

দ্রুত পঠন ব্যবধান

একটি পথের সংলগ্ন অংশের যানচলাচলের ঘনত্বের সূচক। P_0, P_1, ... , P_N (শূন্য-ভিত্তিক সূচক) বিন্দুবিশিষ্ট একটি পথ দেওয়া থাকলে, SpeedReadingInterval একটি ব্যবধান নির্ধারণ করে এবং Speed বিভাগগুলো ব্যবহার করে এর যানচলাচল বর্ণনা করে।

JSON উপস্থাপনা 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
ক্ষেত্র
speed

enum ( Speed )

শুধুমাত্র আউটপুট। এই ব্যবধিতে ট্র্যাফিকের গতি।

startPolylinePointIndex

integer

শুধুমাত্র আউটপুট। পাথে এই ব্যবধির শুরুর সূচক।

endPolylinePointIndex

integer

শুধুমাত্র আউটপুট। পাথে এই ব্যবধানের শেষ সূচক।

গতি

ট্র্যাফিক তথ্যের উপর ভিত্তি করে পলিলাইনের গতির শ্রেণিবিন্যাস।

এনাম
SPEED_UNSPECIFIED গতিবেগ অনির্দিষ্ট।
NORMAL স্বাভাবিক গতি, যানজটের কারণে কোনো বিলম্ব নেই।
SLOW গতি হ্রাস শনাক্ত করা হয়েছে, যান চলাচল হালকা থেকে মাঝারি।
TRAFFIC_JAM যানজট, যার মধ্যে সম্পূর্ণ স্থবিরতাও অন্তর্ভুক্ত।

পদ্ধতি

create

 একটি ভ্রমণের পরিকল্পনা তৈরি করে।

get

 ভ্রমণের সুযোগ পায়।