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
}
ক্ষেত্র
enableHighFrequencyUpdates

boolean

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

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

enablePubsub

boolean

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

pubsubFieldMask

string ( FieldMask format)

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

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

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

  • androidAppId
  • iosAppId
  • authToken
  • config

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

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

অথটোকেন

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

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 ক্লায়েন্টের ভুলের কারণে ট্রিপটি ব্যর্থ হয়েছে।

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

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

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

object ( Location )

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

destination

object ( Stop )

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

location

object ( Location )

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

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 )

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

পদ্ধতি

create

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

get

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