Route Matrix

RouteMatrix ক্লাস

google.maps.routes.RouteMatrix ক্লাস

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

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

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

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

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

RouteMatrixRow ক্লাস

google.maps.routes.RouteMatrixRow ক্লাস

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes") নম্বরে কল করে অ্যাক্সেস করুন।
Maps JavaScript API-তে লাইব্রেরি দেখুন।
items
ধরন:  Array<RouteMatrixItem>
প্রতিটি গন্তব্যের জন্য রুট সংক্রান্ত তথ্য।
toJSON
toJSON()
প্যারামিটার:  কিছু নেই
রিটার্ন ভ্যালু:  Object
অবজেক্টে কনভার্ট করে।

RouteMatrixItem ক্লাস

google.maps.routes.RouteMatrixItem ক্লাস

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

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

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

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

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 optional
ধরন:  Date optional
পৌঁছানোর সময়।

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

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

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

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

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

google.maps.routes.ComputeRouteMatrixExtraComputation কনস্ট্যান্ট

RouteMatrix.computeRouteMatrix অনুরোধের জন্য অতিরিক্ত কম্পিউটেশন করতে হবে।

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes") নম্বরে কল করে অ্যাক্সেস করুন।
Maps JavaScript API-তে লাইব্রেরি দেখুন।
TOLLS ম্যাট্রিক্স আইটেমের জন্য টোল সংক্রান্ত তথ্য।

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

google.maps.routes.RouteMatrixItemCondition কনস্ট্যান্ট

কোনও নির্দিষ্ট শুরু/গন্তব্য পেয়ারের জন্য রুটের অবস্থা।

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes") নম্বরে কল করে অ্যাক্সেস করুন।
Maps JavaScript API-তে লাইব্রেরি দেখুন।
ROUTE_EXISTS একটি রুট খুঁজে পাওয়া গেছে।
ROUTE_NOT_FOUND কোনও রুট খুঁজে পাওয়া যায়নি।

RouteMatrixItemError class

google.maps.routes.RouteMatrixItemError ক্লাস

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

এই ক্লাসটি Error-এর এক্সটেনশন।

const {RouteMatrixItemError} = await google.maps.importLibrary("routes") নম্বরে কল করে অ্যাক্সেস করুন।
Maps JavaScript API-তে লাইব্রেরি দেখুন।
toJSON
toJSON()
প্যারামিটার:  কিছু নেই
রিটার্ন ভ্যালু:  Object
অবজেক্টে কনভার্ট করে।

RouteMatrixItemLocalizedValues class

google.maps.routes.RouteMatrixItemLocalizedValues ক্লাস

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

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

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

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

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

আরও তথ্যের জন্য, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier দেখুন।
toJSON
toJSON()
প্যারামিটার:  কিছু নেই
রিটার্ন ভ্যালু:  Object
অবজেক্টে কনভার্ট করে।

RouteMatrixOrigin ইন্টারফেস

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

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