ভূমিকা
একটি ডিস্ট্যান্স ম্যাট্রিক্স এপিআই অনুরোধের রূপটি নিম্নরূপ:
https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
যেখানে outputFormat নিম্নলিখিত মানগুলির যেকোনো একটি হতে পারে:
-
json(প্রস্তাবিত) মানে হলো জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON) ফরম্যাটে আউটপুট। -
xmlবলতে আউটপুটকে XML হিসেবে বোঝায়।
কিছু প্যারামিটার আবশ্যক, আবার কিছু ঐচ্ছিক। ইউআরএল-এর প্রচলিত রীতি অনুযায়ী, সমস্ত প্যারামিটার অ্যামপারস্যান্ড ( & ) চিহ্ন দিয়ে আলাদা করা হয়। সমস্ত সংরক্ষিত অক্ষর (যেমন প্লাস চিহ্ন "+") অবশ্যই ইউআরএল-এনকোড করতে হবে। প্যারামিটার এবং তাদের সম্ভাব্য মানগুলির তালিকা নিচে দেওয়া হলো।
প্রয়োজনীয় প্যারামিটার
গন্তব্যস্থল
ভ্রমণের দূরত্ব ও সময় গণনার জন্য সমাপ্তি বিন্দু হিসেবে ব্যবহার করার জন্য এক বা একাধিক অবস্থান। গন্তব্য প্যারামিটারের বিকল্পগুলো উৎস প্যারামিটারের বিকল্পগুলোর মতোই।
উৎপত্তি
ভ্রমণের দূরত্ব ও সময় গণনা করার সূচনা বিন্দু। আপনি পাইপ চিহ্ন (|) দ্বারা পৃথক করা এক বা একাধিক অবস্থান সরবরাহ করতে পারেন, যা একটি স্থানের আইডি, একটি ঠিকানা, অথবা অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক আকারে হতে পারে:
- স্থান আইডি : আপনি যদি কোনো স্থান আইডি প্রদান করেন, তবে আপনাকে অবশ্যই এর আগে
place_id:যোগ করতে হবে। - ঠিকানা : আপনি যদি কোনো ঠিকানা দেন, তাহলে পরিষেবাটি স্ট্রিংটিকে জিওকোড করে এবং দূরত্ব গণনা করার জন্য এটিকে একটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে রূপান্তর করে। এই স্থানাঙ্কটি জিওকোডিং এপিআই দ্বারা প্রাপ্ত স্থানাঙ্ক থেকে ভিন্ন হতে পারে, উদাহরণস্বরূপ, কোনো ভবনের কেন্দ্রের পরিবর্তে তার প্রবেশদ্বার।দ্রষ্টব্য: ঠিকানা বা অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করার চেয়ে স্থান আইডি (place ID) ব্যবহার করা শ্রেয়। স্থানাঙ্ক ব্যবহার করলে পয়েন্টটি সর্বদা সেই স্থানাঙ্কের নিকটতম রাস্তায় সংযুক্ত হবে - যা সম্পত্তিতে প্রবেশের পথ নাও হতে পারে, এমনকি এমন কোনো রাস্তাও নাও হতে পারে যা দ্রুত বা নিরাপদে গন্তব্যে নিয়ে যাবে। ঠিকানা ব্যবহার করলে ভবনের প্রবেশপথের পরিবর্তে ভবনের কেন্দ্র পর্যন্ত দূরত্ব পাওয়া যাবে।
- স্থানাঙ্ক : আপনি যদি অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ক দেন, তবে সেগুলি নিকটতম রাস্তায় স্বয়ংক্রিয়ভাবে চলে যাবে। একটি স্থানের আইডি দেওয়া শ্রেয়। যদি আপনি স্থানাঙ্ক দেন, তবে নিশ্চিত করুন যেন অক্ষাংশ এবং দ্রাঘিমাংশের মানের মধ্যে কোনো ফাঁকা স্থান না থাকে।
- প্লাস কোড অবশ্যই গ্লোবাল কোড বা কম্পাউন্ড কোড হিসেবে ফরম্যাট করতে হবে। এখানে দেখানো অনুযায়ী প্লাস কোড ফরম্যাট করুন (প্লাস চিহ্নগুলোকে url-escaped করে %2B এবং স্পেসগুলোকে url-escaped করে %20 করা হয়):
- গ্লোবাল কোড হলো একটি ৪ অক্ষরের এরিয়া কোড এবং ৬ বা তার বেশি অক্ষরের লোকাল কোড (যেমন
849VCWC8+R9এনকোড হয়ে849VCWC8%2BR9হয়)। - যৌগিক কোড হলো ৬ বা ততোধিক অক্ষরের একটি স্থানীয় কোড যার সাথে একটি সুস্পষ্ট অবস্থান উল্লেখ থাকে (যেমন:
CWC8+R9 Mountain View, CA, USAকে এনকোড করা হয়CWC8%2BR9%20Mountain%20View%20CA%20USA)।
- গ্লোবাল কোড হলো একটি ৪ অক্ষরের এরিয়া কোড এবং ৬ বা তার বেশি অক্ষরের লোকাল কোড (যেমন
- বিকল্পভাবে, আপনি এনকোডেড পলিলাইন অ্যালগরিদম ব্যবহার করে স্থানাঙ্কের একটি এনকোডেড সেট সরবরাহ করতে পারেন। এটি বিশেষভাবে উপযোগী যদি আপনার প্রচুর সংখ্যক মূলবিন্দু থাকে, কারণ এনকোডেড পলিলাইন ব্যবহার করলে URL উল্লেখযোগ্যভাবে ছোট হয়।
- এনকোড করা পলিলাইনের শুরুতে অবশ্যই
enc:এবং পরে একটি কোলন:দিতে হবে। উদাহরণস্বরূপ:origins=enc:gfo}EtohhU: - আপনি পাইপ ক্যারেক্টার
|দ্বারা পৃথক করে একাধিক এনকোডেড পলিলাইনও অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ:origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
- এনকোড করা পলিলাইনের শুরুতে অবশ্যই
- স্থান আইডি : আপনি যদি কোনো স্থান আইডি প্রদান করেন, তবে আপনাকে অবশ্যই এর আগে
ঐচ্ছিক পরামিতি
আগমনের সময়
ট্রানজিট দিকনির্দেশনার জন্য পছন্দের পৌঁছানোর সময় নির্দিষ্ট করে, যা ১ জানুয়ারী, ১৯৭০ UTC-এর মধ্যরাত থেকে সেকেন্ডে পরিমাপ করা হয়। আপনি
departure_timeঅথবাarrival_timeমধ্যে যেকোনো একটি নির্দিষ্ট করতে পারেন, কিন্তু উভয়ই নয়। মনে রাখবেন যেarrival_timeঅবশ্যই একটি পূর্ণসংখ্যা হিসাবে নির্দিষ্ট করতে হবে।এড়িয়ে চলুন
নির্দিষ্ট কিছু সীমাবদ্ধতা মেনে দূরত্ব গণনা করা যেতে পারে। ‘avoid’ প্যারামিটার এবং সেই প্যারামিটারের একটি আর্গুমেন্ট ব্যবহার করে সীমাবদ্ধতাগুলো নির্দেশ করা হয়, যা পরিহারযোগ্য সীমাবদ্ধতাটি নির্দেশ করে। নিম্নলিখিত সীমাবদ্ধতাগুলো সমর্থিত:
-
tollsনির্দেশ করে যে, গণনা করা পথটিতে টোল রাস্তা/সেতু এড়িয়ে চলতে হবে। -
highwaysনির্দেশ করে যে, গণনা করা পথটি হাইওয়ে এড়িয়ে চলবে। -
ferriesনির্দেশ করে যে গণনা করা পথটিতে ফেরি এড়িয়ে চলতে হবে। -
indoorনির্দেশ করে যে, গণনা করা পথটিতে হাঁটা এবং গণপরিবহনের দিকনির্দেশনার জন্য বাড়ির ভেতরের সিঁড়ি এড়িয়ে চলতে হবে।
`avoid` প্যারামিটারে উভয় সীমাবদ্ধতা পাস করার মাধ্যমে টোল, হাইওয়ে এবং ফেরির যেকোনো সংমিশ্রণ এড়িয়ে চলে এমন একটি রুটের অনুরোধ করা সম্ভব। উদাহরণস্বরূপ,
avoid=tolls|highways|ferries।দ্রষ্টব্য: বিধিনিষেধ যোগ করার ফলে সেইসব রুট বাদ পড়ে না যেগুলিতে সীমাবদ্ধ বৈশিষ্ট্যটি অন্তর্ভুক্ত রয়েছে; বরং এটি ফলাফলকে আরও অনুকূল রুটের দিকে পক্ষপাতদুষ্ট করে তোলে।-
প্রস্থানের সময়
প্রস্থানের পছন্দের সময় নির্দিষ্ট করে। আপনি ১ জানুয়ারী, ১৯৭০ UTC মধ্যরাত থেকে সেকেন্ডে একটি পূর্ণসংখ্যা হিসাবে সময়টি নির্দিষ্ট করতে পারেন। যদি 9999-12-31T23:59:59.999999999Z-এর চেয়ে পরবর্তী কোনো
departure_timeনির্দিষ্ট করা হয়, তাহলে APIdeparture_time9999-12-31T23:59:59.999999999Z-এ ফিরিয়ে আনবে। বিকল্পভাবে, আপনি 'now' মানটি নির্দিষ্ট করতে পারেন, যা প্রস্থানের সময়কে বর্তমান সময়ে (নিকটতম সেকেন্ড পর্যন্ত সঠিক) সেট করে। প্রস্থানের সময় দুটি ক্ষেত্রে নির্দিষ্ট করা যেতে পারে:- যেসব অনুরোধের ভ্রমণ মাধ্যম গণপরিবহন, সেগুলোর ক্ষেত্রে আপনি ঐচ্ছিকভাবে
departure_time) অথবাarrival_time) এর মধ্যে যেকোনো একটি নির্দিষ্ট করতে পারেন। যদি কোনো সময়ই নির্দিষ্ট করা না হয়, তাহলেdeparture_timeডিফল্টভাবে বর্তমান সময় হবে (অর্থাৎ, যাত্রার সময় ডিফল্টভাবে বর্তমান সময় হবে)। - যেসব অনুরোধের জন্য ভ্রমণের মাধ্যম গাড়ি, সেগুলোর ক্ষেত্রে আপনি একটি রুট এবং ভ্রমণের সময়কাল (রেসপন্স ফিল্ড: duration_in_traffic) পাওয়ার জন্য
departure_timeনির্দিষ্ট করতে পারেন, যা ট্র্যাফিকের অবস্থা বিবেচনা করে।departure_timeঅবশ্যই বর্তমান সময় বা ভবিষ্যতের কোনো সময়ে সেট করতে হবে। এটি অতীতের কোনো সময় হতে পারবে না।
দ্রষ্টব্য: প্রস্থানের সময় নির্দিষ্ট করা না থাকলে, রুটের পছন্দ এবং সময়কাল সড়ক নেটওয়ার্ক এবং সময়-নিরপেক্ষ গড় ট্র্যাফিক পরিস্থিতির উপর ভিত্তি করে নির্ধারিত হয়। সড়ক নেটওয়ার্কের পরিবর্তন, হালনাগাদকৃত গড় ট্র্যাফিক পরিস্থিতি এবং পরিষেবার বিকেন্দ্রীভূত প্রকৃতির কারণে একটি নির্দিষ্ট অনুরোধের ফলাফল সময়ের সাথে সাথে পরিবর্তিত হতে পারে। যেকোনো সময়ে বা যেকোনো পুনরাবৃত্তিতে প্রায়-সমতুল্য রুটগুলোর মধ্যেও ফলাফল ভিন্ন হতে পারে।দ্রষ্টব্য:mode=drivingঅবস্থায়departure_timeউল্লেখ করে করা Distance Matrix অনুরোধগুলি প্রতি অনুরোধে সর্বোচ্চ ১০০টি উপাদানের মধ্যে সীমাবদ্ধ। উৎসের সংখ্যা এবং গন্তব্যের সংখ্যার গুণফলই উপাদানের সংখ্যা নির্ধারণ করে।- যেসব অনুরোধের ভ্রমণ মাধ্যম গণপরিবহন, সেগুলোর ক্ষেত্রে আপনি ঐচ্ছিকভাবে
ভাষা
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
- যদি
languageসরবরাহ করা না হয়, তাহলে API-টিAccept-Languageহেডারে নির্দিষ্ট করা পছন্দের ভাষাটি ব্যবহার করার চেষ্টা করে। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- এপিআই যে ফলাফলগুলো ফেরত দেবে এবং সেগুলো যে ক্রমে ফেরত আসবে, তার ওপর পছন্দের ভাষার সামান্য প্রভাব রয়েছে। জিওকোডার ভাষার ওপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারভেদের সংক্ষিপ্ত রূপ, অথবা এমন সমার্থক শব্দ যা একটি ভাষায় বৈধ হলেও অন্যটিতে নয়। উদাহরণস্বরূপ, হাঙ্গেরীয় ভাষায় 'utca' এবং 'tér' হলো রাস্তার সমার্থক শব্দ।
মোড
দূরত্ব ও দিক গণনার জন্য, আপনি কোন পরিবহন মাধ্যম ব্যবহার করবেন তা নির্দিষ্ট করে দিতে পারেন। ডিফল্টরূপে,
DRIVINGমোড ব্যবহৃত হয়। ডিফল্টরূপে, দিকনির্দেশগুলো ড্রাইভিং দিকনির্দেশ হিসেবে গণনা করা হয়। নিম্নলিখিত ভ্রমণ মাধ্যমগুলো সমর্থিত:-
driving(ডিফল্ট) সড়ক নেটওয়ার্ক ব্যবহার করে সাধারণ ড্রাইভিং দিকনির্দেশনা বা দূরত্ব নির্দেশ করে। -
walkingঅনুরোধ, পথচারী পথ ও ফুটপাত (যেখানে উপলব্ধ) ব্যবহার করে হাঁটার দিকনির্দেশনা বা দূরত্ব। -
bicyclingবাইসাইকেল পথ ও পছন্দের রাস্তা (যেখানে উপলব্ধ) ব্যবহার করে দিকনির্দেশনা বা দূরত্বের অনুরোধ। -
transitপাবলিক ট্রানজিট রুট ব্যবহার করে (যেখানে উপলব্ধ) দিকনির্দেশনা বা দূরত্বের অনুরোধ করে। আপনি যদি মোডটি ট্রানজিট হিসেবে সেট করেন, তাহলে আপনি ঐচ্ছিকভাবে একটি 'departure_time(departure_time) অথবা একটি 'arrival_time) নির্দিষ্ট করতে পারেন। যদি কোনো সময়ই নির্দিষ্ট না করা হয়, তাহলেdeparture_timeপ্রস্থানের সময়' ডিফল্ট হিসেবে বর্তমান সময় হবে। আপনি ঐচ্ছিকভাবে একটিtransit_mode) এবং/অথবা একটি 'transit_routing_preference) অন্তর্ভুক্ত করতে পারেন।
দ্রষ্টব্য: হাঁটা এবং সাইকেল চালানোর দিকনির্দেশনায় অনেক সময় পথচারী বা সাইকেল চালানোর জন্য স্পষ্ট পথ অন্তর্ভুক্ত নাও থাকতে পারে, তাই এই দিকনির্দেশনাগুলো প্রাপ্ত ফলাফলে সতর্কবার্তা দেখাবে যা আপনাকে অবশ্যই ব্যবহারকারীকে প্রদর্শন করতে হবে।দ্রষ্টব্য: ডেটা সরবরাহকারীদের দেওয়া ট্রানজিট তথ্যের প্রাপ্যতার উপর নির্ভর করে, ট্রানজিট ট্রিপের তথ্য সর্বোচ্চ বিগত ৭ দিন বা সর্বোচ্চ ভবিষ্যৎ ১০০ দিনের জন্য উপলব্ধ থাকবে। ট্রানজিটের সময়সূচী ঘন ঘন পরিবর্তিত হয়, সময়ের সাথে সাথে উপলব্ধ ট্রানজিট ট্রিপের সংখ্যাও পরিবর্তিত হতে পারে এবং অনেক আগে থেকে করা পূর্বাভাসের ক্ষেত্রে ধারাবাহিক ফলাফল প্রদানের কোনো নিশ্চয়তা নেই।-
অঞ্চল
অঞ্চল কোডটি একটি ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়। কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ ccTLD কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "দ্য ইউনাইটেড কিংডম অফ গ্রেট ব্রিটেন অ্যান্ড নর্দার্ন আয়ারল্যান্ড" সত্তাটির জন্য ব্যবহৃত হয়)।
ট্র্যাফিক_মডেল
ট্র্যাফিকের মধ্যে কাটানো সময় গণনা করার জন্য যে অনুমানগুলি ব্যবহার করা হবে, তা নির্দিষ্ট করে। এই সেটিংটি রেসপন্সের duration_in_traffic ফিল্ডে ফেরত আসা মানকে প্রভাবিত করে, যেখানে ঐতিহাসিক গড়ের উপর ভিত্তি করে ট্র্যাফিকের মধ্যে আনুমানিক সময় থাকে।
traffic_modelপ্যারামিটারটি শুধুমাত্র সেইসব ড্রাইভিং নির্দেশনার জন্য নির্দিষ্ট করা যেতে পারে, যেখানে অনুরোধে একটিdeparture_timeঅন্তর্ভুক্ত থাকে। এই প্যারামিটারের জন্য উপলব্ধ মানগুলি হলো:-
best_guess(ডিফল্ট) নির্দেশ করে যে, ঐতিহাসিক এবং চলমান ট্র্যাফিক পরিস্থিতি সম্পর্কে যা জানা আছে, তার ভিত্তিতে ফেরত আসা duration_in_traffic ভ্রমণ সময়ের সর্বোত্তম অনুমান হওয়া উচিত।departure_timeবর্তমান সময়ের যত কাছাকাছি হবে, চলমান ট্র্যাফিক তত বেশি গুরুত্বপূর্ণ হয়ে উঠবে। -
pessimisticবলতে বোঝায় যে, ফেরত আসা `duration_in_traffic` বেশিরভাগ দিনেই প্রকৃত ভ্রমণ সময়ের চেয়ে বেশি হওয়া উচিত, যদিও বিশেষ করে খারাপ ট্র্যাফিক পরিস্থিতির কারণে মাঝে মাঝে এই মান অতিক্রম করতে পারে। -
optimisticনির্দেশ করে যে, ফেরত আসা `duration_in_traffic` বেশিরভাগ দিনেই প্রকৃত ভ্রমণ সময়ের চেয়ে কম হওয়া উচিত, যদিও বিশেষ ভালো ট্র্যাফিক পরিস্থিতিযুক্ত কিছু ব্যতিক্রমী দিনে এটি এই মানের চেয়ে দ্রুত হতে পারে।
best_guessএর ডিফল্ট মানটি অধিকাংশ ব্যবহারের ক্ষেত্রেই সবচেয়ে কার্যকর পূর্বাভাস দেবে।best_guessপূর্বাভাস মডেলটি যেভাবে লাইভ ট্র্যাফিকের তথ্য অন্তর্ভুক্ত করে, তার কারণেbest_guessভ্রমণ সময়ের পূর্বাভাসটিoptimisticপূর্বাভাসের চেয়ে কম, অথবাpessimisticপূর্বাভাসের চেয়ে বেশি হতে পারে।-
ট্রানজিট_মোড
এক বা একাধিক পছন্দের পরিবহন মাধ্যম নির্দিষ্ট করে। এই প্যারামিটারটি শুধুমাত্র পরিবহনের দিকনির্দেশনার জন্য নির্দিষ্ট করা যেতে পারে। প্যারামিটারটি নিম্নলিখিত আর্গুমেন্টগুলো সমর্থন করে:
-
busনির্দেশ করে যে, গণনা করা রুটটিতে বাসে ভ্রমণকে অগ্রাধিকার দেওয়া উচিত। -
subwayনির্দেশ করে যে, গণনা করা রুটটিতে সাবওয়েতে ভ্রমণকে অগ্রাধিকার দেওয়া উচিত। -
trainনির্দেশ করে যে, গণনাকৃত রুটটিতে ট্রেনে ভ্রমণকে অগ্রাধিকার দেওয়া উচিত। -
tramনির্দেশ করে যে, গণনাকৃত রুটে ট্রাম এবং লাইট রেলে ভ্রমণকে অগ্রাধিকার দেওয়া উচিত। -
railনির্দেশ করে যে, গণনাকৃত রুটে ট্রেন, ট্রাম, লাইট রেল এবং সাবওয়েতে ভ্রমণকে অগ্রাধিকার দেওয়া উচিত। এটিtransit_mode=train|tram|subwayএর সমতুল্য।
-
ট্রানজিট_রাউটিং_পছন্দ
গণপরিবহন রুটের জন্য পছন্দ নির্দিষ্ট করে। এই প্যারামিটারটি ব্যবহার করে, আপনি এপিআই দ্বারা নির্বাচিত ডিফল্ট সেরা রুটটি গ্রহণ না করে, ফেরত আসা বিকল্পগুলোকে নিজের পছন্দ অনুযায়ী বেছে নিতে পারেন। এই প্যারামিটারটি শুধুমাত্র গণপরিবহনের দিকনির্দেশনার জন্য নির্দিষ্ট করা যেতে পারে। প্যারামিটারটি নিম্নলিখিত আর্গুমেন্টগুলো সমর্থন করে:
-
less_walkingনির্দেশ করে যে, গণনা করা পথটিতে সীমিত হাঁটাচলাকে অগ্রাধিকার দেওয়া উচিত। -
fewer_transfersনির্দেশ করে যে, গণনাকৃত রুটটি সীমিত সংখ্যক ট্রান্সফারকে অগ্রাধিকার দেবে।
-
ইউনিট
ফলাফল প্রদর্শনের জন্য ব্যবহৃত একক পদ্ধতি নির্দিষ্ট করে।
দ্রষ্টব্য: এই একক পদ্ধতি সেটিংটি শুধুমাত্র দূরত্বের ফিল্ডের মধ্যে প্রদর্শিত টেক্সটকে প্রভাবিত করে। দূরত্বের ফিল্ডগুলিতে এমন মানও থাকে যা সর্বদা মিটারে প্রকাশ করা হয়।
উদাহরণ অনুরোধ করুন
এই উদাহরণে গন্তব্যের স্থানাঙ্ক নির্দিষ্ট করতে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করা হয়েছে:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626 &origins=40.6655101%2C-73.89188969999998 &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'
এই উদাহরণে গন্তব্যের স্থানাঙ্ক নির্দিষ্ট করতে প্লাস কোড ব্যবহার করা হয়েছে:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=San%20Francisco &origins=849VCWC8%2BR9 &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'
এই উদাহরণটি একটি এনকোডেড পলিলাইন ব্যবহার করে একই অনুরোধটি দেখাচ্ছে:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A &origins=40.6655101%2C-73.89188969999998 &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'
ট্র্যাফিক তথ্য
যখন নিম্নলিখিত সবগুলি শর্ত প্রযোজ্য হয় তখন ট্র্যাফিকের তথ্য ব্যবহার করা হয় (ডিস্টেন্স ম্যাট্রিক্স রেসপন্সে duration_in_traffic ফিল্ডটি পাওয়ার জন্য এই শর্তগুলি প্রয়োজন):
- ভ্রমণ
modeপ্যারামিটারটিdriving, অথবা নির্দিষ্ট করা নেই (drivingহলো ডিফল্ট ভ্রমণ মোড)। - অনুরোধটিতে একটি বৈধ
departure_timeপ্যারামিটার অন্তর্ভুক্ত রয়েছে। 'departure_timeবর্তমান সময় বা ভবিষ্যতের কোনো সময়ে সেট করা যেতে পারে। এটি অতীতের কোনো সময় হতে পারে না।
ঐচ্ছিকভাবে, ট্র্যাফিকের সময় গণনা করার জন্য ব্যবহৃত অনুমানগুলি নির্দিষ্ট করতে আপনি আপনার অনুরোধে traffic_model প্যারামিটারটি অন্তর্ভুক্ত করতে পারেন।
নিম্নলিখিত URL-টি বস্টন, এমএ বা চার্লসটাউন, এমএ এবং লেক্সিংটন, এমএ ও কনকর্ড, এমএ-এর মধ্যে ড্রাইভিং দূরত্ব নির্ণয়ের জন্য একটি ডিস্ট্যান্স ম্যাট্রিক্স অনুরোধ শুরু করে। অনুরোধটিতে একটি প্রস্থানের সময় অন্তর্ভুক্ত থাকে, যা ডিস্ট্যান্স ম্যাট্রিক্স প্রতিক্রিয়ায় duration_in_traffic ফিল্ডটি ফেরত দেওয়ার জন্য সমস্ত প্রয়োজনীয়তা পূরণ করে।
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?departure_time=now &destinations=Lexington%2CMA%7CConcord%2CMA &origins=Boston%2CMA%7CCharlestown%2CMA &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'
JSON
{ "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"], "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"], "rows": [ { "elements": [ { "distance": { "text": "33.3 km", "value": 33253 }, "duration": { "text": "27 mins", "value": 1620 }, "duration_in_traffic": { "text": "34 mins", "value": 2019 }, "status": "OK", }, { "distance": { "text": "41.5 km", "value": 41491 }, "duration": { "text": "33 mins", "value": 1981 }, "duration_in_traffic": { "text": "39 mins", "value": 2342 }, "status": "OK", }, ], }, { "elements": [ { "distance": { "text": "31.1 km", "value": 31100 }, "duration": { "text": "26 mins", "value": 1543 }, "duration_in_traffic": { "text": "29 mins", "value": 1754 }, "status": "OK", }, { "distance": { "text": "39.3 km", "value": 39338 }, "duration": { "text": "32 mins", "value": 1904 }, "duration_in_traffic": { "text": "35 mins", "value": 2077 }, "status": "OK", }, ], }, ], "status": "OK", }
এক্সএমএল
OK Boston, MA, USA Charlestown, Boston, MA, USA Lexington, MA, USA Concord, MA, USA |
OK 1620 27 mins 33253 33.3 km 2018 34 mins OK 1981 33 mins 41491 41.5 km 2342 39 mins |
OK 1543 26 mins 31100 31.1 km 1759 29 mins OK 1904 32 mins 39338 39.3 km 2077 35 mins
অবস্থান পরিবর্তনকারী
চালকদের কোনো নির্দিষ্ট স্থানে কীভাবে পৌঁছাতে হবে, তা নির্দেশ করার জন্য আপনি লোকেশন মডিফায়ার ব্যবহার করতে পারেন। এর জন্য আপনি side_of_road মডিফায়ার ব্যবহার করে রাস্তার কোন পাশ ব্যবহার করতে হবে তা নির্দিষ্ট করতে পারেন, অথবা ভ্রমণের সঠিক দিক নির্দেশ করার জন্য একটি হেডিং উল্লেখ করতে পারেন।
নির্দিষ্ট করুন যে গণনাকৃত পথ অবশ্যই রাস্তার একটি নির্দিষ্ট পাশ দিয়ে যেতে হবে।
কোনো অবস্থান নির্দিষ্ট করার সময়, আপনি ` side_of_road: প্রিফিক্সটি ব্যবহার করে অনুরোধ করতে পারেন যেন গণনা করা রুটটি রাস্তার সেই পাশ দিয়ে যায় যেদিকে ওয়েপয়েন্টটি ঝুঁকে আছে। উদাহরণস্বরূপ, এই অনুরোধটি একটি দীর্ঘ রুটের দূরত্ব ফেরত দেবে, যাতে যানবাহনটি রাস্তার সেই পাশে গিয়ে থামে যেদিকে ওয়েপয়েন্টটি ঝুঁকে ছিল:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=side_of_road%3A37.7663444%2C-122.4412006 &origins=37.7680296%2C-122.4375126 &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=37.7680296%2C-122.4375126&destinations=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'
এনকোডেড পলিলাইনের সাথে side_of_road: ব্যবহার করার সময়, মডিফায়ারটি পলিলাইন বরাবর প্রতিটি অবস্থানে প্রয়োগ করা হয়। উদাহরণস্বরূপ, এই অনুরোধের দুটি গন্তব্যই এই প্যারামিটারটি ব্যবহার করে:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A &origins=San%20Francisco%20City%20hall &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'
` side_of_road: ` মডিফায়ারটি শুধুমাত্র এই সীমাবদ্ধতার সাথে ব্যবহার করা যেতে পারে:
- ভ্রমণ
modeপ্যারামিটারটিdriving, অথবা নির্দিষ্ট করা নেই (drivingহলো ডিফল্ট ভ্রমণ মোড)।
নির্দিষ্ট করুন যে গণনাকৃত রুটগুলির একটি নির্দিষ্ট শিরোনাম থাকবে।
কোনো অবস্থান নির্দিষ্ট করার সময়, আপনি অনুরোধ করতে পারেন যে গণনা করা রুটটি একটি নির্দিষ্ট হেডিং বরাবর সেই অবস্থানের মধ্য দিয়ে যাবে। এই হেডিংটি heading=X: প্রিফিক্স দিয়ে নির্দিষ্ট করা হয়, যেখানে X হলো ০ (অন্তর্ভুক্ত) এবং ৩৬০ (বর্জনীয়)-এর মধ্যে একটি পূর্ণসংখ্যা। হেডিং ০ উত্তর দিক নির্দেশ করে, ৯০ পূর্ব দিক নির্দেশ করে এবং এটি ঘড়ির কাঁটার দিকে চলতে থাকে। উদাহরণস্বরূপ, এই অনুরোধে গণনা করা রুটটি মূলবিন্দু থেকে পূর্ব দিকে যায়, তারপর একটি ইউ-টার্ন নেয়:
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=37.773245%2C-122.469502 &origins=heading%3D90%3A37.773279%2C-122.468780 &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=heading%3D90%3A37.773279%2C-122.468780&destinations=37.773245%2C-122.469502&key=YOUR_API_KEY'
` heading=X: ` মডিফায়ারটি শুধুমাত্র নিম্নলিখিত বিধিনিষেধ সাপেক্ষে ব্যবহার করা যাবে:
- ভ্রমণ
modeপ্যারামিটারটি হলোdriving,bicycling, অথবা এটি নির্দিষ্ট করা নেই (drivingহলো ডিফল্ট ভ্রমণ মোড)। - একই অবস্থানের জন্য
side_of_roadমডিফায়ারটি নির্দিষ্ট করা হয়নি। - অবস্থানটি অক্ষাংশ/দ্রাঘিমাংশের মান দিয়ে নির্দিষ্ট করা হয়। আপনি ঠিকানা, স্থান আইডি বা এনকোডেড পলিলাইনের সাথে
headingব্যবহার করতে পারবেন না।
দূরত্ব ম্যাট্রিক্স অনুরোধ এবং প্রতিক্রিয়া
নিচে একটি নমুনা HTTP অনুরোধ দেখানো হলো, যেখানে কানাডার ভ্যাঙ্কুভার, ব্রিটিশ কলাম্বিয়া এবং মার্কিন যুক্তরাষ্ট্রের সিয়াটল, ওয়াশিংটন থেকে মার্কিন যুক্তরাষ্ট্রের সান ফ্রান্সিসকো, ক্যালিফোর্নিয়া এবং কানাডার ভিক্টোরিয়া, ব্রিটিশ কলাম্বিয়া পর্যন্ত দূরত্ব ও সময়কাল জানতে চাওয়া হয়েছে।
ইউআরএল
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=San%20Francisco%7CVictoria%20BC &language=fr-FR &mode=bicycling &origins=Vancouver%20BC%7CSeattle &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver%20BC%7CSeattle&destinations=San%20Francisco%7CVictoria%20BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY'
এই অনুরোধটি চারটি উপাদান ফেরত দেবে - দুটি উৎস এবং দুটি গন্তব্য:
| ভ্যাঙ্কুভার থেকে সান ফ্রান্সিসকো | ভ্যাঙ্কুভার থেকে ভিক্টোরিয়া |
| সিয়াটল থেকে সান ফ্রান্সিসকো | সিয়াটল থেকে ভিক্টোরিয়া |
ফলাফলগুলো সারি আকারে ফেরত দেওয়া হয়, প্রতিটি সারিতে একটি করে উৎসের সাথে প্রতিটি গন্তব্য যুক্ত থাকে।
JSON
{ "destination_addresses": ["San Francisco, Californie, États-Unis", "Victoria, BC, Canada"], "origin_addresses": ["Vancouver, BC, Canada", "Seattle, Washington, États-Unis"], "rows": [ { "elements": [ { "distance": { "text": "1 712 km", "value": 1711765 }, "duration": { "text": "3 jours 16 heures", "value": 318119 }, "status": "OK", }, { "distance": { "text": "140 km", "value": 139695 }, "duration": { "text": "6 heures 49 minutes", "value": 24567 }, "status": "OK", }, ], }, { "elements": [ { "distance": { "text": "1 452 km", "value": 1451704 }, "duration": { "text": "3 jours 2 heures", "value": 266680 }, "status": "OK", }, { "distance": { "text": "146 km", "value": 146500 }, "duration": { "text": "2 heures 53 minutes", "value": 10374 }, "status": "OK", }, ], }, ], "status": "OK", }
এক্সএমএল
OK Vancouver, BC, Canada Seattle, Washington, États-Unis San Francisco, Californie, États-Unis Victoria, BC, Canada |
OK 318119 3 jours 16 heures 1711765 1 712 km OK 24567 6 heures 49 minutes 139695 140 km |
OK 266680 3 jours 2 heures 1451704 1 452 km OK 10374 2 heures 53 minutes 146500 146 km
দূরত্বম্যাট্রিক্স প্রতিক্রিয়া
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | অ্যারে<স্ট্রিং> | আপনার মূল অনুরোধ থেকে এপিআই দ্বারা ফেরত আসা ঠিকানাগুলির একটি অ্যারে। |
| প্রয়োজনীয় | অ্যারে<স্ট্রিং> | আপনার মূল অনুরোধ থেকে এপিআই দ্বারা ফেরত আসা ঠিকানাগুলির একটি অ্যারে। এগুলি জিওকোডার দ্বারা ফরম্যাট করা হয় এবং অনুরোধের সাথে পাঠানো ভাষা প্যারামিটার অনুযায়ী স্থানীয়করণ করা হয়। এই বিষয়বস্তুটি সরাসরি পড়ার জন্য। প্রোগ্রামগতভাবে ফরম্যাট করা ঠিকানাগুলি পার্স করবেন না। |
| প্রয়োজনীয় | অ্যারে< দূরত্বম্যাট্রিক্সসারি > | উপাদানগুলির একটি অ্যারে, যার প্রতিটিতে আবার একটি আরও তথ্যের জন্য DistanceMatrixRow দেখুন। |
| প্রয়োজনীয় | দূরত্বম্যাট্রিক্স স্থিতি | এতে অনুরোধের অবস্থা থাকে এবং অনুরোধটি কেন ব্যর্থ হয়েছে তা খুঁজে বের করতে সাহায্য করার জন্য ডিবাগিং তথ্যও থাকতে পারে। আরও তথ্যের জন্য DistanceMatrixStatus দেখুন। |
| ঐচ্ছিক | স্ট্রিং | অনুরোধটি প্রক্রিয়াকরণের সময় উদ্ভূত যেকোনো ত্রুটির পাঠযোগ্য বিবরণ সম্বলিত একটি স্ট্রিং। |
দূরত্বম্যাট্রিক্স স্থিতি
পরিষেবা দ্বারা ফেরত দেওয়া স্ট্যাটাস কোড।
-
OKনির্দেশ করে যে প্রতিক্রিয়াটিতে একটি বৈধ ফলাফল রয়েছে। -
INVALID_REQUESTনির্দেশ করে যে প্রদত্ত অনুরোধটি অবৈধ ছিল। -
MAX_ELEMENTS_EXCEEDEDনির্দেশ করে যে উৎস এবং গন্তব্যের গুণফল প্রতি-কোয়েরি সীমা অতিক্রম করেছে। -
MAX_DIMENSIONS_EXCEEDEDনির্দেশ করে যে উৎস বা গন্তব্যের সংখ্যা প্রতি-কোয়েরি সীমা অতিক্রম করেছে। -
OVER_DAILY_LIMITনিম্নলিখিত যেকোনো একটিকে নির্দেশ করে:- এপিআই কী অনুপস্থিত অথবা অবৈধ।
- আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
- স্বেচ্ছায় নির্ধারিত ব্যবহারের সীমা অতিক্রম করা হয়েছে।
- প্রদত্ত অর্থপ্রদানের পদ্ধতিটি আর বৈধ নয় (উদাহরণস্বরূপ, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
-
OVER_QUERY_LIMITনির্দেশ করে যে, পরিষেবাটি নির্ধারিত সময়সীমার মধ্যে আপনার অ্যাপ্লিকেশন থেকে প্রয়োজনের চেয়ে বেশি অনুরোধ পেয়েছে। -
REQUEST_DENIEDনির্দেশ করে যে পরিষেবাটি আপনার অ্যাপ্লিকেশনকে ডিস্টেন্স ম্যাট্রিক্স পরিষেবা ব্যবহার করতে দেয়নি। -
UNKNOWN_ERRORনির্দেশ করে যে সার্ভার ত্রুটির কারণে একটি ডিস্ট্যান্স ম্যাট্রিক্স অনুরোধ প্রক্রিয়া করা যায়নি। আপনি পুনরায় চেষ্টা করলে অনুরোধটি সফল হতে পারে।
দূরত্বম্যাট্রিক্স সারি
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | অ্যারে< দূরত্বম্যাট্রিক্সউপাদান > | যখন ডিস্ট্যান্স ম্যাট্রিক্স এপিআই ফলাফল ফেরত দেয়, তখন সেগুলোকে একটি JSON রো অ্যারের মধ্যে রাখে। এমনকি যদি কোনো ফলাফল ফেরত না আসে (যেমন যখন উৎস এবং/অথবা গন্তব্য বিদ্যমান থাকে না), তখনও এটি একটি খালি অ্যারে ফেরত দেয়। অনুরোধের 'অরিজিন' প্যারামিটারের মান অনুসারে সারিগুলো সাজানো হয়। প্রতিটি সারি একটি অরিজিনকে নির্দেশ করে, এবং সেই সারির প্রতিটি উপাদান অরিজিন ও ডেস্টিনেশন মানের একটি জোড়কে নির্দেশ করে। প্রতিটি সারি অ্যারেতে এক বা একাধিক উপাদান এন্ট্রি থাকে, যেগুলোতে আবার একটিমাত্র উৎস-গন্তব্য জোড়া সম্পর্কিত তথ্য থাকে। আরও তথ্যের জন্য DistanceMatrixElement দেখুন। |
দূরত্বম্যাট্রিক্স উপাদান
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | দূরত্বম্যাট্রিক্স উপাদান স্থিতি | উপাদানটির একটি অবস্থা। আরও তথ্যের জন্য DistanceMatrixElementStatus দেখুন। |
| ঐচ্ছিক | টেক্সটভ্যালুঅবজেক্ট | এই রুটের মোট দূরত্ব, যা মিটারে (মান) এবং পাঠ্য আকারে প্রকাশ করা হয়। পাঠ্য মানটি মূল অনুরোধের ইউনিট প্যারামিটারে নির্দিষ্ট করা ইউনিট সিস্টেম, অথবা উৎসের অঞ্চল ব্যবহার করে। আরও তথ্যের জন্য TextValueObject দেখুন। |
| ঐচ্ছিক | টেক্সটভ্যালুঅবজেক্ট | এই পথটি অতিক্রম করতে যে সময় লাগে, তা সেকেন্ডে (ভ্যালু ফিল্ড) এবং টেক্সট হিসেবে প্রকাশ করা হয়। কোয়েরির ল্যাঙ্গুয়েজ প্যারামিটার অনুযায়ী টেক্সচুয়াল উপস্থাপনাটি স্থানীয়করণ করা হয়। আরও তথ্যের জন্য TextValueObject দেখুন। |
| ঐচ্ছিক | টেক্সটভ্যালুঅবজেক্ট | বর্তমান এবং ঐতিহাসিক ট্র্যাফিকের অবস্থার উপর ভিত্তি করে এই রুটটি অতিক্রম করতে যে সময় লাগে। ফেরত আসা মানটি আশাবাদী, হতাশাবাদী, বা একটি সম্ভাব্য সেরা অনুমান হবে কিনা, তা অনুরোধ করার জন্য আপনি যে বিকল্পগুলি ব্যবহার করতে পারেন, তার জন্য
আরও তথ্যের জন্য TextValueObject দেখুন। |
| ঐচ্ছিক | ভাড়া | উপস্থিত থাকলে, এতে এই রুটের মোট ভাড়া (অর্থাৎ, টিকিটের মোট খরচ) থাকে। এই বৈশিষ্ট্যটি শুধুমাত্র ট্রানজিট অনুরোধের জন্য এবং শুধুমাত্র সেইসব ট্রানজিট প্রদানকারীদের জন্য ফেরত দেওয়া হয়, যাদের ভাড়ার তথ্য উপলব্ধ আছে। আরও তথ্যের জন্য ভাড়া দেখুন। |
ভাড়া
এই রুটের মোট ভাড়া।
{
"currency" : "USD",
"value" : 6,
"text" : "$6.00"
}
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | স্ট্রিং | একটি ISO 4217 মুদ্রা কোড যা নির্দেশ করে যে টাকার পরিমাণটি কোন মুদ্রায় প্রকাশ করা হয়েছে। |
| প্রয়োজনীয় | স্ট্রিং | অনুরোধকৃত ভাষায় মোট ভাড়ার পরিমাণ। |
| প্রয়োজনীয় | সংখ্যা | মোট ভাড়ার পরিমাণ, নির্দিষ্ট মুদ্রায়। |
দূরত্বম্যাট্রিক্স উপাদান স্থিতি
-
OKনির্দেশ করে যে প্রতিক্রিয়াটিতে একটি বৈধ ফলাফল রয়েছে। -
NOT_FOUNDনির্দেশ করে যে এই জোড়াটির উৎস এবং/অথবা গন্তব্য জিওকোড করা যায়নি। -
ZERO_RESULTSনির্দেশ করে যে উৎস এবং গন্তব্যের মধ্যে কোনো রুট খুঁজে পাওয়া যায়নি। -
MAX_ROUTE_LENGTH_EXCEEDEDনির্দেশ করে যে অনুরোধ করা রুটটি খুব দীর্ঘ এবং এটি প্রক্রিয়া করা সম্ভব নয়।
টেক্সটভ্যালুঅবজেক্ট
একটি অবজেক্ট, যাতে একটি সাংখ্যিক মান এবং তার ফরম্যাট করা পাঠ্য উপস্থাপনা থাকে।
| মাঠ | প্রয়োজনীয় | প্রকার | বর্ণনা |
|---|---|---|---|
| প্রয়োজনীয় | স্ট্রিং | স্ট্রিং মান। |
| প্রয়োজনীয় | সংখ্যা | সংখ্যাসূচক মান। |