Package google.maps.navconnect.v1

সূচী

NavConnect গ্রাহকদের জন্য ট্রিপ তৈরি ও গ্রহণ করার পরিষেবা।

CreateTrip

rpc CreateTrip( CreateTripRequest ) returns ( Trip )

একটি ট্রিপ তৈরি করে। মোবাইল অ্যাপ্লিকেশনটি ট্রিপটি শুরু করার আগে অবশ্যই এটি কল করতে হবে। ফেরত আসা ট্রিপটিতে auth_token ফিল্ডটি সেট করা থাকবে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform
গেটট্রিপ

rpc GetTrip( GetTripRequest ) returns ( Trip )

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

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform

অথটোকেন

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

ক্ষেত্র
token

string

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

expire_time

Timestamp

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

ট্রিপ অনুরোধ তৈরি করুন

NavConnectService.CreateTrip-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
parent

string

আবশ্যক। মূল রিসোর্স যার অধীনে এই ট্রিপটি তৈরি করা হবে। ফরম্যাট: projects/{project_number}

trip_id

string

আবশ্যক। ট্রিপের জন্য ব্যবহৃত আইডি, যা ট্রিপের রিসোর্স নামের চূড়ান্ত অংশ হবে।

এই মানটি অবশ্যই একটি বৈধ RFC-4122 UUID হতে হবে।

trip

Trip

প্রয়োজনীয়। সৃষ্টির যাত্রা।

GetTripRequest

NavConnectService.GetTrip-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
name

string

আবশ্যক। যে ট্রিপটি পেতে চান তার রিসোর্সের নাম। ফরম্যাট: projects/{project}/trips/{trip_id}

অবস্থান

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

ক্ষেত্র
point

LatLng

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

source_time

Timestamp

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

server_time

Timestamp

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

থামুন

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

ক্ষেত্র
point

LatLng

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

ভ্রমণ

একটি ভ্রমণ।

ক্ষেত্র
name

string

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

config

TripConfig

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

android_app_id

string

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

ios_app_id

string

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

auth_token

AuthToken

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

state

State

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

execution

TripExecution

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

create_time

Timestamp

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

update_time

Timestamp

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

রাজ্য

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

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

ট্রিপকনফিগ

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

ক্ষেত্র
enable_high_frequency_updates

bool

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

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

enable_pubsub

bool

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

pubsub_field_mask

FieldMask

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

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

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

  • android_app_id
  • ios_app_id
  • auth_token
  • config

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

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

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

ক্ষেত্র
origin

Location

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

destination

Stop

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

location

Location

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

traveled_duration

Duration

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

remaining_duration

Duration

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

traveled_distance_meters

int32

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

remaining_distance_meters

int32

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

stop_added_in_route

bool

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