Route Matrix

RouteMatrix ক্লাস

ক্লাস google.maps.routes.RouteMatrix
লাইব্রেরি "routes"

RouteMatrix.computeRouteMatrix-এর মাধ্যমে শুরু/গন্তব্য জোড়ার সেটের জন্য গণনা করা রুটের ম্যাট্রিক্স

const {RouteMatrix} = await google.maps.importLibrary("routes");
computeRouteMatrix
computeRouteMatrix(request)
প্যারামিটার:
রিটার্ন ভ্যালু: Promise<{matrix:RouteMatrix}>
শুরু ও গন্তব্যের তালিকা নেয় এবং শুরু ও গন্তব্যের প্রতিটি কম্বিনেশনের জন্য রুট সংক্রান্ত তথ্য সহ ম্যাট্রিক্স দেখায়।

মনে রাখবেন: এই পদ্ধতিতে আপনাকে ComputeRouteMatrixRequest.fields প্রপার্টি সেট করে অনুরোধে একটি রেসপন্স ফিল্ড মাস্ক নির্দিষ্ট করতে হবে। ভ্যালু হল ফিল্ড পাথের একটি তালিকা।

যেমন:
  • উপলভ্য সব ফিল্ডের ফিল্ড মাস্ক: fields: ['*']
  • রুট-লেভেল সময়সীমা ও দূরত্বের ফিল্ড মাস্ক: fields: ['durationMillis', 'distanceMeters']

ওয়াইল্ডকার্ড রেসপন্স ফিল্ড মাস্ক fields: ['*'] ব্যবহার করতে নিরুৎসাহিত করা হয় কারণ:
  • শুধুমাত্র আপনার প্রয়োজনীয় ফিল্ড বেছে নিলে, আমাদের সার্ভার কম্পিউটেশন সাইকেল সেভ করতে পারে, যার ফলে আমরা আপনাকে কম লেটেন্সিতে ফলাফল দেখাতে পারি।
  • আপনার প্রোডাকশন জবের জন্য প্রয়োজনীয় ফিল্ড বেছে নিলে, লেটেন্সি পারফর্ম্যান্স স্থিতিশীল থাকে। আমরা ভবিষ্যতে আরও উত্তর ফিল্ড যোগ করতে পারি এবং সেই নতুন ফিল্ডের জন্য অতিরিক্ত কম্পিউটেশন সময় প্রয়োজন হতে পারে। আপনি সব ফিল্ড বেছে নিলে অথবা টপ লেভেলে সব ফিল্ড বেছে নিলে, পারফর্ম্যান্সের অবনতি হতে পারে, কারণ আমাদের যোগ করা যেকোনও নতুন ফিল্ড অটোমেটিক উত্তরে অন্তর্ভুক্ত করা হবে।
  • শুধুমাত্র আপনার প্রয়োজনীয় ফিল্ড বেছে নিলে, রেসপন্সের সাইজ ছোট হয় এবং নেটওয়ার্কে দ্রুত লোড হয়।
rows
readonly
ধরন: Array<RouteMatrixRow>
ম্যাট্রিক্সের সারি। প্রতিটি সারি একটি অরিজিনের সাথে সম্পর্কিত এবং এতে RouteMatrixItem-এর একটি অ্যারে থাকে, যার প্রতিটি গন্তব্যের একটি রুটকে উপস্থাপন করে।
ইনহেরিট করা: toJSON

RouteMatrixRow ক্লাস

ক্লাস google.maps.routes.RouteMatrixRow
লাইব্রেরি "routes"

RouteMatrix.computeRouteMatrix-এ পাস করা অরিজিনের সাথে সম্পর্কিত। RouteMatrixItem-এর তালিকা রয়েছে, প্রতিটি আইটেম গন্তব্যের রুট দেখায়।

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
প্রতিটি গন্তব্যের জন্য রুট সংক্রান্ত তথ্য।
ইনহেরিট করা: toJSON

RouteMatrixItem ক্লাস

ক্লাস google.maps.routes.RouteMatrixItem
লাইব্রেরি "routes"

RouteMatrix.computeRouteMatrix-এ পাস করা শুরু/গন্তব্য পেয়ারের জন্য গণনা করা রুট সংক্রান্ত তথ্য এতে থাকে।

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
ধরন: RouteMatrixItemCondition optional
রুট খুঁজে পাওয়া গেছে কিনা তা দেখায়।
distanceMeters
readonly
ধরন: number optional
রুটের ভ্রমণের দূরত্ব মিটারে।
durationMillis
readonly
ধরন: number optional
রুট নেভিগেট করতে কত সময় লাগবে তা মিলিসেকেন্ডে দেখানো হয়েছে। আপনি ComputeRouteMatrixRequest.routingPreference-কে TRAFFIC_UNAWARE-এ সেট করলে, এই ভ্যালু RouteMatrixItem.staticDurationMillis-এর সমান হয়। আপনি যদি ComputeRouteMatrixRequest.routingPreference-কে TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL-এর মধ্যে যেকোনও একটিতে সেট করেন, তাহলে ট্রাফিক পরিস্থিতি বিবেচনা করে এই ভ্যালু গণনা করা হয়।

মনে রাখবেন: সময়সীমা ২^৫৩ মিলিসেকেন্ডের বেশি হলে, এই ভ্যালু Number.POSITIVE_INFINITY হবে।
error
readonly
ধরন: RouteMatrixItemError optional
রুট গণনা করার সময় সমস্যা হয়েছে।
fallbackInfo
readonly
ধরন: FallbackInfo optional
কিছু ক্ষেত্রে, যখন সার্ভার এই নির্দিষ্ট উৎস/গন্তব্য জোড়ার জন্য প্রদত্ত পছন্দগুলির সাথে রুট গণনা করতে সক্ষম হয় না, তখন এটি গণনার একটি ভিন্ন মোড ব্যবহার করতে পারে। ফলব্যাক ব্যবহার করা হলে, এই ফিল্ডে ফলব্যাক উত্তর সম্পর্কে বিস্তারিত তথ্য থাকে। অন্যথায় এই ফিল্ড সেট করা হয় না।
localizedValues
readonly
ধরন: RouteMatrixItemLocalizedValues optional
RouteMatrixItem-এর প্রপার্টির টেক্সট রিপ্রেজেন্টেশন।
staticDurationMillis
readonly
ধরন: number optional
ট্রাফিক পরিস্থিতি বিবেচনা না করে রুটের মাধ্যমে ভ্রমণের সময়কাল।

মনে রাখবেন: সময়সীমা ২^৫৩ মিলিসেকেন্ডের বেশি হলে, এই ভ্যালু Number.POSITIVE_INFINITY হবে।
travelAdvisory
readonly
ধরন: RouteTravelAdvisory optional
রুট সম্পর্কে অতিরিক্ত তথ্য।

ComputeRouteMatrixRequest ইন্টারফেস

ইন্টারফেস google.maps.routes.ComputeRouteMatrixRequest

রুট ম্যাট্রিক্সের জন্য অনুরোধ করুন।
destinations
গন্তব্যের অ্যারে, যা রেসপন্স ম্যাট্রিক্সের কলাম নির্ধারণ করে। স্ট্রিং হিসেবে পাস করা কোনও ভ্যালু, ঠিকানা, Plus Code বা কোনও জায়গার রিসোর্সের নাম হতে পারে। উচ্চতার ভ্যালু বিবেচনা করা হয় না।
fields
ধরন: Iterable<string>
যেসব ফিল্ড ফেচ করতে হবে তার কালেকশন। সব ফিল্ডের জন্য ["*"] উল্লেখ করুন।
origins
উৎসগুলির অ্যারে, যা প্রতিক্রিয়া ম্যাট্রিক্সের সারিগুলি নির্ধারণ করে। স্ট্রিং হিসেবে পাস করা কোনও ভ্যালু, ঠিকানা, Plus Code বা জায়গার রিসোর্স নাম হতে পারে। উচ্চতার মান বিবেচনা করা হয় না।

উৎস ও গন্তব্যের কার্ডিনালিটির উপর বিভিন্ন সাইজ সংক্রান্ত বিধিনিষেধ প্রযোজ্য:
  • string বা Place হিসেবে উল্লেখ করা শুরু ও গন্তব্যের মোট সংখ্যা ৫০-এর বেশি হলে চলবে না।
  • শুরুর স্থান ও গন্তব্যের সংখ্যার গুণফল ৬২৫-এর বেশি হলে চলবে না।
  • ComputeRouteMatrixRequest.routingPreference-এর মান TRAFFIC_AWARE_OPTIMAL-এ সেট করা থাকলে, উৎস ও গন্তব্যের সংখ্যার গুণফল ১০০-এর বেশি হওয়া চলবে না।
  • ComputeRouteMatrixRequest.travelMode-এর মান TRANSIT-এ সেট করা থাকলে, উৎস ও গন্তব্যের সংখ্যার গুণফল ১০০-এর বেশি হওয়া চলবে না।
arrivalTime
ঐচ্ছিক
ধরন: Date optional
পৌঁছানোর সময়।

মনে রাখবেন: ComputeRouteMatrixRequest.travelMode-এর মান TRANSIT-এ সেট করা থাকলে তবেই এটি সেট করা যাবে। আপনি ComputeRouteMatrixRequest.departureTime অথবা ComputeRouteMatrixRequest.arrivalTime উল্লেখ করতে পারেন, তবে দুটিই নয়। ট্রানজিট ট্রিপের তথ্য অতীতে সর্বাধিক ৭ দিন বা ভবিষ্যতে ১০০ দিন পর্যন্ত উপলভ্য থাকে।
departureTime
ঐচ্ছিক
ধরন: Date optional
ছাড়ার সময়। আপনি এই ভ্যালু সেট না করলে, আপনি যে সময়ে অনুরোধ করেছেন সেই সময়টি ডিফল্ট ভ্যালু হিসেবে সেট হয়ে যায়।

মনে রাখবেন: ComputeRouteMatrixRequest.travelMode-এর মান TRANSIT-এ সেট করা থাকলে, আপনি শুধুমাত্র অতীতের কোনও সময় উল্লেখ করতে পারবেন। ট্রানজিট ট্রিপের তথ্য অতীতে সর্বাধিক ৭ দিন বা ভবিষ্যতে ১০০ দিন পর্যন্ত উপলভ্য থাকে।
extraComputations
ঐচ্ছিক
অনুরোধ সম্পূর্ণ করার জন্য ব্যবহার করা হতে পারে এমন অতিরিক্ত কম্পিউটেশনের তালিকা।

মনে রাখবেন: এই অতিরিক্ত গণনা উত্তরের ক্ষেত্রে অতিরিক্ত ফিল্ড দেখাতে পারে। উত্তরে ফেরত পাওয়ার জন্য এই অতিরিক্ত ফিল্ডগুলিও ComputeRouteMatrixRequest.fields-এ নির্দিষ্ট করতে হবে।
internalUsageAttributionIds
ঐচ্ছিক
ধরন: Iterable<string> optional
নির্দিষ্ট প্যাকেজ বা OSS লাইব্রেরিতে কল অ্যাট্রিবিউট করার জন্য ব্যবহৃত শনাক্তকারী।
language
ঐচ্ছিক
ধরন: string optional
BCP-47 ভাষার কোড, যেমন "en-US" বা "sr-Latn"। আরও তথ্যের জন্য, ইউনিকোড লোকেল আইডেন্টিফায়ার দেখুন। কোন কোন ভাষায় কাজ করে তা জানতে ভাষা সংক্রান্ত সহায়তা দেখুন। আপনি এই ভ্যালু প্রদান না করলে, আপনার Google Maps JavaScript API লোকালাইজেশন সেটিংস থেকে ভাষা অনুমান করা হয়। অন্যথায়, প্রথম উৎসের লোকেশন থেকে ভাষা অনুমান করা হয়।
region
ঐচ্ছিক
ধরন: string optional
অঞ্চল কোড, ccTLD ("টপ-লেভেল ডোমেন") দুই-অক্ষরের মান হিসেবে উল্লেখ করা হয়েছে। আরও তথ্যের জন্য দেশ ভিত্তিক কোড টপ-লেভেল ডোমেন দেখুন। আপনি এই ভ্যালু না দিলে, আপনার Google Maps JavaScript API লোকালাইজেশন সেটিংস থেকে অঞ্চল অনুমান করা হয়। অন্যথায়, প্রথম উৎসের লোকেশন থেকে অঞ্চল অনুমান করা হয়।
routingPreference
ঐচ্ছিক
ধরন: RoutingPreference optional
রুট ম্যাট্রিক্স কীভাবে গণনা করতে হবে তা নির্দিষ্ট করে। সার্ভার রুট ম্যাট্রিক্স গণনা করার জন্য বেছে নেওয়া রাউটিং পছন্দ ব্যবহার করার চেষ্টা করে। রাউটিং সংক্রান্ত পছন্দ থেকে কোনও সমস্যা বা অতিরিক্ত দীর্ঘ লেটেন্সি হলে, সমস্যা পাওয়া গেছে। ComputeRouteMatrixRequest.travelMode, DRIVING বা TWO_WHEELER হলে তবেই আপনি এই বিকল্প নির্দিষ্ট করতে পারবেন, অন্যথায় অনুরোধটি ব্যর্থ হবে।
trafficModel
ঐচ্ছিক
ধরন: TrafficModel optional
ট্রাফিকে সময় হিসেব করার সময় কোন অনুমান ব্যবহার করা হবে তা নির্দিষ্ট করে। এই সেটিং RouteMatrixItem.durationMillis-এ রিটার্ন করা ভ্যালুকে প্রভাবিত করে, যার মধ্যে ঐতিহাসিক গড়ের উপর ভিত্তি করে ট্রাফিকের আনুমানিক সময় থাকে। ComputeRouteMatrixRequest.trafficModel শুধুমাত্র সেইসব অনুরোধের জন্য উপলভ্য যেগুলি ComputeRouteMatrixRequest.routingPreference থেকে TRAFFIC_AWARE_OPTIMAL এবং ComputeRouteMatrixRequest.travelMode থেকে DRIVING-এ সেট করা হয়েছে। ডিফল্ট হিসেবে BEST_GUESS সেট করা থাকে।
transitPreference
ঐচ্ছিক
ধরন: TransitPreference optional
TRANSIT রুটের জন্য দেখানো রুটের উপর প্রভাব ফেলে এমন পছন্দ নির্দিষ্ট করে।

মনে রাখবেন: ComputeRouteMatrixRequest.travelMode-এর মান TRANSIT-এ সেট করা থাকলে তবেই এটি নির্দিষ্ট করা যাবে।
travelMode
ঐচ্ছিক
ধরন: TravelMode optional
পরিবহনের মোড নির্দিষ্ট করে।
units
ঐচ্ছিক
ধরন: UnitSystem optional
ডিসপ্লে ফিল্ডের জন্য পরিমাপের একক নির্দিষ্ট করে। আপনি এই ভ্যালু না দিলে, প্রথম উৎসের লোকেশন থেকে ডিসপ্লে ইউনিট অনুমান করা হয়।

ComputeRouteMatrixExtraComputation কনস্ট্যান্ট

constants google.maps.routes.ComputeRouteMatrixExtraComputation
library "routes"

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

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল ComputeRouteMatrixExtraComputationString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS ম্যাট্রিক্স এলিমেন্টের জন্য টোল সংক্রান্ত তথ্য। আরও তথ্যের জন্য ওয়েব পরিষেবা ডকুমেন্টেশন দেখুন।

RouteMatrixItemCondition কনস্ট্যান্ট

constants google.maps.routes.RouteMatrixItemCondition
library "routes"

যে রুটের অবস্থা দেখানো হচ্ছে। আরও তথ্যের জন্য ওয়েব পরিষেবা ডকুমেন্টেশন দেখুন।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল RouteMatrixItemConditionString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS একটি রুট খুঁজে পাওয়া গেছে এবং এলিমেন্টের জন্য সংশ্লিষ্ট তথ্য পূরণ করা হয়েছে। আরও তথ্যের জন্য ওয়েব পরিষেবা ডকুমেন্টেশন দেখুন।
ROUTE_NOT_FOUND কোনও রুট খুঁজে পাওয়া যায়নি। আরও তথ্যের জন্য ওয়েব পরিষেবা ডকুমেন্টেশন দেখুন।

RouteMatrixItemError class

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

নির্দিষ্ট উৎস/গন্তব্য পেয়ারের জন্য RouteMatrix.computeRouteMatrix-এর সময় হওয়া কোনও সমস্যা।

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
ইনহেরিট করা: toJSON

RouteMatrixItemLocalizedValues class

ক্লাস google.maps.routes.RouteMatrixItemLocalizedValues
লাইব্রেরি "routes"

RouteMatrixItem-এর টেক্সট রিপ্রেজেন্টেশন।

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
ধরন: string optional
টেক্সট ফর্মে রুট ম্যাট্রিক্স আইটেমের ভ্রমণের দূরত্ব।
distanceLanguage
readonly
ধরন: string optional
দূরত্ব সংক্রান্ত টেক্সটের BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"।

আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন।
duration
readonly
ধরন: string optional
সময়সীমা, টেক্সট হিসেবে দেখানো হয় এবং কোয়েরির অঞ্চলের জন্য স্থানীয়করণ করা হয়। ট্রাফিক পরিস্থিতি বিবেচনা করে।

মনে রাখবেন: আপনি ট্রাফিক সংক্রান্ত তথ্য না চাইলে, এই ভ্যালু RouteMatrixItemLocalizedValues.staticDuration-এর ভ্যালুর সমান হবে।
durationLanguage
readonly
ধরন: string optional
সময়সীমা সংক্রান্ত টেক্সটের BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"।

আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন।
staticDuration
readonly
ধরন: string optional
ট্রাফিক পরিস্থিতি বিবেচনা না করে সময়কাল, টেক্সট ফর্ম্যাটে দেখানো হয়েছে।
staticDurationLanguage
readonly
ধরন: string optional
স্ট্যাটিক ডিউরেশন টেক্সটের BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"।
transitFare
readonly
ধরন: string optional
ট্রানজিট ভাড়া, টেক্সট ফর্মে দেখানো হয়েছে।
transitFareLanguage
readonly
ধরন: string optional
ট্রানজিট ভাড়ার টেক্সটের BCP-47 ভাষা কোড, যেমন "en-US" বা "sr-Latn"।

আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন।
ইনহেরিট করা: toJSON

RouteMatrixOrigin ইন্টারফেস

ইন্টারফেস google.maps.routes.RouteMatrixOrigin

ComputeRouteMatrixRequest-এর জন্য একটিই অরিজিন।
waypoint
উৎপত্তির লোকেশন। স্ট্রিং হিসেবে পাস করা ভ্যালু কোনও ঠিকানা বা Plus Code হতে পারে। এর জন্য উচ্চতার মান বিবেচনা করা হয় না।
routeModifiers
ঐচ্ছিক
ধরন: RouteModifiers optional
প্রতিটি রুটের জন্য মডিফায়ার যা এটিকে উৎস হিসেবে গ্রহণ করে।