Package google.maps.navconnect.v1

সূচী

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

CreateTrip

rpc CreateTrip( CreateTripRequest ) returns ( Trip )

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

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

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

  • https://www.googleapis.com/auth/cloud-platform
আইএএম অনুমতি

parent রিসোর্সে নিম্নলিখিত IAM পারমিশন প্রয়োজন:

  • navigationconnect.trips.create

আরও তথ্যের জন্য, IAM ডকুমেন্টেশন দেখুন।

গেটট্রিপ

rpc GetTrip( GetTripRequest ) returns ( Trip )

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

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

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

  • https://www.googleapis.com/auth/cloud-platform
আইএএম অনুমতি

name রিসোর্সটিতে নিম্নলিখিত IAM পারমিশন প্রয়োজন:

  • navigationconnect.trips.get

আরও তথ্যের জন্য, IAM ডকুমেন্টেশন দেখুন।

অথটোকেন

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

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

route_polyline_format

RoutePolylineFormat

ঐচ্ছিক। ফেরত দেওয়া রাউট পলিলাইনের ফরম্যাট। সেট না করা হলে, SIMPLE রাউট পলিলাইন ফেরত দেওয়া হবে।

রুটপলিলাইনফরম্যাট

রুট পলিলাইনের ফরম্যাট নির্দিষ্ট করে।

এনাম
ROUTE_POLYLINE_FORMAT_UNSPECIFIED রুট পলিলাইন ফরম্যাটটি অনির্দিষ্ট।
SIMPLE রুট পলিলাইনটি google.type.LatLng হিসেবে উপস্থাপিত পয়েন্টের একটি সাধারণ অ্যারে হিসাবে ফেরত দেওয়া হয়।
ENCODED রুট পলিলাইনটি একটি এনকোডেড স্ট্রিং হিসেবে ফেরত দেওয়া হয়। দেখুন https://developers.google.com/maps/documentation/utilities/polylinealgorithm
S2ENCODED রাউট পলিলাইনটি একটি S2Polyline হিসেবে এনকোড করা হয়। দেখুন https://s2geometry.io/devguide/basic_types.html
GEO_JSON রুট পলিলাইনটি একটি GeoJSON LineString হিসেবে ফেরত দেওয়া হয়। দেখুন https://tools.ietf.org/html/rfc7946#section-3.1.4

অবস্থান

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

ক্ষেত্র
point

LatLng

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

source_time

Timestamp

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

server_time

Timestamp

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

রুট

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

ক্ষেত্র
traffic_information[]

SpeedReadingInterval

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

নোট:

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

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

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

simple_polyline

SimplePolyline

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

encoded_polyline

string

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

s2_polyline

bytes

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

geo_json

Struct

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

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

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

ক্ষেত্র
points[]

LatLng

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

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

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

ক্ষেত্র
speed

Speed

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

start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

গতি

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

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

থামুন

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

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

ট্রিপকনফিগ

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

ক্ষেত্র
enable_high_frequency_updates

bool

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

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

enable_pubsub

bool

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

pubsub_field_mask

FieldMask

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

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

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

  • android_app_id
  • ios_app_id
  • auth_token
  • config

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

enable_remaining_route_reporting

bool

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

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

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

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

ক্ষেত্র
origin

Location

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

destination

Stop

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

location

Location

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

remaining_route

Route

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

traveled_duration

Duration

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

remaining_duration

Duration

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

traveled_distance_meters

int32

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

remaining_distance_meters

int32

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

stop_added_in_route

bool

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