দিকনির্দেশের উদাহরণ

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

এই প্রোডাক্ট পুরনো স্ট্যাটাসে আছে। অক্টোবর ২০২৬ থেকে, নতুন Google Cloud প্রোজেক্টের জন্য Directions API (Legacy) আর চালু করা যাবে না। আগে থেকে থাকা প্রোজেক্ট সম্পূর্ণভাবে কাজ করবে। নতুন ফিচার ও উন্নত পারফর্ম্যান্সের জন্য, Routes API-তে মাইগ্রেট করুন।

অনুরোধের উদাহরণ

নিম্নলিখিত অনুরোধটি টরন্টো, অন্টারিও থেকে মন্ট্রিল, কুইবেক পর্যন্ত গাড়ি চালানোর দিকনির্দেশ ফেরত দেয়।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

mode এবং avoid প্যারামিটার পরিবর্তন করে, প্রাথমিক অনুরোধটি এমনভাবে পরিবর্তন করা যেতে পারে যাতে বড় বড় হাইওয়ে এড়িয়ে সাইকেলে করে মনোরম দৃশ্য দেখতে দেখতে যাওয়ার জন্য দিকনির্দেশ পাওয়া যায়।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

নিম্নলিখিত অনুরোধটি ব্রুকলিন, নিউ ইয়র্ক থেকে কুইন্স, নিউ ইয়র্ক পর্যন্ত ট্রানজিটের দিকনির্দেশ সার্চ করে। অনুরোধে কোনও departure_time উল্লেখ করা নেই, তাই ছাড়ার সময় ডিফল্ট হিসেবে বর্তমান সময়কে ধরে নেওয়া হয়েছে:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

নিম্নলিখিত ট্রানজিট অনুরোধে নির্দিষ্ট ছাড়ার সময় অন্তর্ভুক্ত আছে।

মনে রাখবেন: এই উদাহরণে ছাড়ার সময় ৩০ জুলাই, ২০১২ সকাল ৯টা ৪৫ মিনিট হিসেবে উল্লেখ করা হয়েছে। কোনও সমস্যা এড়াতে, অনুরোধ জমা দেওয়ার আগে আপনাকে প্যারামিটারটি ভবিষ্যতের কোনও সময়ে পরিবর্তন করতে হবে।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

নিম্নলিখিত অনুরোধে প্লাস কোড ব্যবহার করে ভারতের কলকাতার H8MW+WP থেকে GCG2+3M পর্যন্ত গাড়ি চালানোর দিকনির্দেশ পাওয়া যায়।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

নিম্নলিখিত অনুরোধটি প্লেস আইডি ব্যবহার করে গ্লাসগো, যুক্তরাজ্য থেকে পার্থ, যুক্তরাজ্য পর্যন্ত গাড়ি চালানোর দিকনির্দেশ প্রদান করে।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

ভ্রমণ মোড

দিকনির্দেশ গণনা করার সময়, আপনি ব্যবহার করার জন্য পরিবহন mode নির্দিষ্ট করতে পারেন। ডিফল্ট হিসেবে, driving দিকনির্দেশ হিসেবে দিকনির্দেশ গণনা করা হয়। নিম্নলিখিত ভ্রমণ মোড কাজ করে:

  • driving (ডিফল্ট) রোড নেটওয়ার্ক ব্যবহার করে স্ট্যান্ডার্ড গাড়ি চালানোর দিকনির্দেশ দেখায়।
  • walking হাঁটার দিকনির্দেশ সংক্রান্ত অনুরোধ করে পথচারীদের রাস্তা ও ফুটপাথের (যেখানে উপলভ্য) মাধ্যমে।
  • bicycling সাইকেল চালানোর দিকনির্দেশ অনুরোধ করে সাইকেল চালানোর রাস্তা ও পছন্দের রাস্তা (যেখানে উপলভ্য) ব্যবহার করে।
  • transit পাবলিক ট্রানজিট রুটের মাধ্যমে দিকনির্দেশের অনুরোধ করে (যেখানে উপলভ্য)। আপনি মোড transit-এ সেট করলে, বিকল্প হিসেবে departure_time বা arrival_time উল্লেখ করতে পারবেন। কোনও সময় উল্লেখ করা না থাকলে, departure_time ডিফল্ট হিসেবে বর্তমান সময় (অর্থাৎ, ছাড়ার সময় ডিফল্ট হিসেবে বর্তমান সময়) সেট করা হয়। এছাড়াও, আপনি ঐচ্ছিকভাবে একটি transit_mode এবং/অথবা একটি transit_routing_preference যোগ করতে পারেন।

মনে রাখবেন: হাঁটা ও সাইকেল চালিয়ে যাওয়ার দিকনির্দেশে কখনও কখনও পথচারী বা সাইকেল চালানোর স্পষ্ট পথ নাও থাকতে পারে, তাই এইসব দিকনির্দেশ, ফলাফল হিসেবে warnings দেখাবে যা আপনাকে অবশ্যই ব্যবহারকারীকে দেখাতে হবে।

ট্রাফিক তথ্য

ট্রাফিক সংক্রান্ত তথ্য ব্যবহার করা হয় যখন নিম্নলিখিত সব শর্ত প্রযোজ্য হয় (এগুলি হল দিকনির্দেশ সংক্রান্ত উত্তরে duration_in_traffic ফিল্ড পাওয়ার জন্য প্রয়োজনীয় শর্তাবলী):

  • travel mode প্যারামিটার হল driving, অথবা উল্লেখ করা নেই (driving হল ডিফল্ট ভ্রমণ মোড)।
  • অনুরোধে একটি সঠিক departure_time প্যারামিটার অন্তর্ভুক্ত আছে। departure_time বর্তমান সময় বা ভবিষ্যতের কোনও সময়ের জন্য সেট করা যেতে পারে। এটি অতীতের কোনও তারিখ হতে পারবে না।
  • অনুরোধে স্টপওভার ওয়েপয়েন্ট অন্তর্ভুক্ত নেই। অনুরোধে ওয়েপয়েন্ট থাকলে, রুটকে প্রভাবিত করতে প্রতিটি ওয়েপয়েন্টের আগে via: যোগ করুন তবে স্টপওভার এড়িয়ে যান। যেমন, 
    &waypoints=via:San Francisco|via:Mountain View|...

বিকল্প হিসেবে, ট্রাফিকের মধ্যে সময় হিসেব করার সময় ব্যবহার করার জন্য অনুমান নির্দিষ্ট করতে, আপনার অনুরোধে traffic_model প্যারামিটার অন্তর্ভুক্ত করতে পারেন।

নিম্নলিখিত URL-এর মাধ্যমে বস্টন, ম্যাসাচুসেটস থেকে চার্লসটাউন ও লেক্সিংটন হয়ে কনকর্ড, ম্যাসাচুসেটস পর্যন্ত যাত্রার জন্য দিকনির্দেশ সংক্রান্ত অনুরোধ শুরু করা হয়। অনুরোধে রওনা দেওয়ার সময় অন্তর্ভুক্ত থাকে, যা Directions-এর উত্তরে duration_in_traffic ফিল্ড ফিরিয়ে দেওয়ার জন্য সব প্রয়োজনীয়তা পূরণ করে।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

ওয়েপয়েন্ট

Directions API (Legacy) ব্যবহার করে রুট গণনা করার সময়, আপনি ওয়েপয়েন্ট নির্দিষ্ট করতে পারেন যাতে এমন রুট দেখানো হয় যা মধ্যবর্তী লোকেশনে পাস থ্রু বা স্টপওভার অন্তর্ভুক্ত করে। আপনি গাড়ি চালানো, হাঁটা বা সাইকেল চালানোর দিকনির্দেশে ওয়েপয়েন্ট যোগ করতে পারবেন, কিন্তু ট্রানজিটের দিকনির্দেশে পারবেন না।

waypoints প্যারামিটারে লোকেশন উল্লেখ করুন।

আপনি পাইপ ক্যারেক্টার (| বা %7C) দিয়ে আলাদা করে এক বা একাধিক লোকেশন দিতে পারেন, যা প্লেস আইডি, ঠিকানা বা অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট হিসেবে দিতে হবে। ডিফল্ট হিসেবে, Directions পরিষেবা, ওয়েপয়েন্টগুলি যে ক্রমে দেওয়া হয়েছে সেই ক্রম অনুযায়ী রুট গণনা করে। ওয়েপয়েন্টের ভ্যালু পার্স করার জন্য অগ্রাধিকার হল প্লেস আইডি, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক, তারপর ঠিকানা।

  • আপনি কোনও জায়গার আইডি পাস করলে, আপনাকে অবশ্যই সেটির আগে place_id: যোগ করতে হবে। আপনি Geocoding API এবং Places API (জায়গা অটোমেটিক সম্পূর্ণ করা সহ) থেকে জায়গার আইডি ফিরিয়ে আনতে পারবেন। উদাহরণস্বরূপ, 'প্লেস অটোকমপ্লিট' থেকে প্লেস আইডি ব্যবহার করার জন্য, প্লেস অটোকমপ্লিট ও দিকনির্দেশ দেখুন। প্লেস আইডি সম্পর্কে আরও জানতে, প্লেস আইডি ওভারভিউ দেখুন।

    দক্ষতা ও নির্ভুলতার জন্য, সম্ভব হলে জায়গার আইডি ব্যবহার করুন। এই আইডিগুলি অক্ষাংশ/দ্রাঘিমাংশ ভ্যালু পেয়ারের মতো অনন্যভাবে স্পষ্ট এবং অ্যাক্সেস পয়েন্ট ও ট্রাফিক ভেরিয়েবলের মতো রাউটিংয়ের জন্য জিওকোডিং সুবিধা প্রদান করে। ঠিকানার মতো, আইডি-র ক্ষেত্রে কোনও সার্চ বা জায়গার বিবরণের জন্য মধ্যবর্তী অনুরোধ করার প্রয়োজন হয় না; তাই, পারফর্ম্যান্স আরও ভালো হয়।

  • আপনি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক পাস করলে, জিওকোডিং ছাড়াই দিকনির্দেশ গণনা করার জন্য মানগুলি সরাসরি ফ্রন্টএন্ড সার্ভারে যায়। পয়েন্টগুলি স্ন্যাপ টু রোড এবং আপনার অ্যাপের জন্য প্রয়োজনীয় সঠিক তথ্য নাও দিতে পারে। আপনি যখন নিশ্চিত হবেন যে সম্ভাব্য অ্যাক্সেস পয়েন্ট বা অতিরিক্ত জিওকোডিংয়ের বিবরণ ছাড়াই আপনার অ্যাপের রাউটিংয়ের জন্য প্রয়োজনীয় পয়েন্টগুলি মানগুলি সঠিকভাবে নির্দিষ্ট করে, তখন কোঅর্ডিনেট ব্যবহার করুন। নিশ্চিত করুন যে অক্ষাংশ এবং দ্রাঘিমাংশের মানগুলি আলাদা করতে কমা (%2C) ব্যবহার করা হয়েছে, স্পেস (%20) নয়।
  • আপনি কোনও ঠিকানা পাস করলে, দিকনির্দেশ পরিষেবা স্ট্রিংটি জিওকোড করবে এবং দিকনির্দেশ গণনা করার জন্য এটিকে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কে রূপান্তর করবে। ঠিকানার ভ্যালু অস্পষ্ট হলে, একই ধরনের ঠিকানা থেকে অস্পষ্টতা দূর করার জন্য ভ্যালুটি সার্চ করতে পারে। যেমন, "১ম স্ট্রিট" সম্পূর্ণ ভ্যালু হতে পারে অথবা "১ম স্ট্রিট NE" বা "১ম স্ট্রিট SE"-এর আংশিক ভ্যালু হতে পারে। Geocoding API-এর মাধ্যমে পাওয়া ফলাফলের থেকে এই ফলাফল আলাদা হতে পারে। আপনি প্লেস আইডি ব্যবহার করে সম্ভাব্য ভুল ব্যাখ্যা এড়াতে পারেন। আমার রুট সংক্রান্ত অনুরোধের ফলাফল সংক্রান্ত সমস্যার সমাধান করা দেখুন।

বিকল্প হিসেবে, আপনি এনকোড করা পলিলাইন অ্যালগরিদম ব্যবহার করে পয়েন্টের এনকোড করা সেট প্রদান করতে পারেন। আপনি দেখতে পাবেন যে এনকোড করা সেট অনেক বেশি সংখ্যক ওয়েপয়েন্টের জন্য উপযোগী, কারণ URL অনেক ছোট হয়। সব ওয়েব পরিষেবার URL-এর সীমা হল ১৬৩৮৪ অক্ষর।

  • এনকোড করা পলিলাইনের শুরুতে enc: এবং তারপরে কোলন (:) থাকতে হবে। যেমন: waypoints=enc:gfo}EtohhU:।
  • এছাড়াও, আপনি পাইপ অক্ষর (|) দ্বারা আলাদা করা একাধিক এনকোড করা পলিলাইন অন্তর্ভুক্ত করতে পারেন। যেমন, waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

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

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

স্টপওভার ও পাস থ্রু পয়েন্টের মাধ্যমে রুট প্রভাবিত করুন

অনুরোধে প্রতিটি ওয়েপয়েন্টের জন্য, দিকনির্দেশ সংক্রান্ত উত্তরে legs অ্যারেতে একটি এন্ট্রি যোগ করা হয় যাতে ভ্রমণের সেই অংশে স্টপওভারের বিবরণ প্রদান করা যায়।

আপনি যদি স্টপওভার যোগ না করে ওয়েপয়েন্ট ব্যবহার করে রুট প্রভাবিত করতে চান, তাহলে ওয়েপয়েন্টে via: প্রিফিক্স যোগ করুন। via: প্রিফিক্স সহ ওয়েপয়েন্ট legs অ্যারেতে কোনও এন্ট্রি যোগ করবে না, তবে ওয়েপয়েন্টের মাধ্যমে যাত্রা রুট করবে।

নিম্নলিখিত URL আগের অনুরোধকে এমনভাবে পরিবর্তন করে যাতে যাত্রাটি লেক্সিংটনের মধ্য দিয়ে না থেমে রুট করা হয়:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

ব্যবহারকারী ম্যাপে ওয়েপয়েন্ট টেনে আনার ফলে রুট তৈরি করার সময় via: প্রিফিক্স সবচেয়ে কার্যকর হয়। এটি করলে, ব্যবহারকারী দেখতে পাবেন যে রিয়েল-টাইমে চূড়ান্ত রুট কেমন দেখতে হতে পারে এবং এটি নিশ্চিত করতে সাহায্য করে যে ওয়েপয়েন্টগুলি এমন লোকেশনে রাখা হয়েছে যা Directions API (Legacy)-এর মাধ্যমে অ্যাক্সেস করা যায়।

নিম্নলিখিত URL অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট ব্যবহার করে ওয়েপয়েন্টের অনুরোধ করে:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

এনকোড করা পলিলাইন ব্যবহার করে একই অনুরোধ এখানে দেওয়া হল:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

মনে রাখবেন যে আপনি লোকেশন মডিফায়ার সহ via: স্পেসিফায়ার অবাধে ইন্টারমিক্স করতে পারবেন। যেমন:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

আপনার ওয়েপয়েন্ট অপ্টিমাইজ করুন

ডিফল্ট হিসেবে, Directions পরিষেবা প্রদত্ত ওয়েপয়েন্টের মাধ্যমে প্রদত্ত ক্রমে একটি রুট গণনা করে। বিকল্প হিসেবে, আপনি waypoints প্যারামিটারের মধ্যে প্রথম আর্গুমেন্ট হিসেবে optimize:true পাস করতে পারেন যাতে দিকনির্দেশ পরিষেবা আরও দক্ষ ক্রমে ওয়েপয়েন্টগুলি পুনর্বিন্যাস করে প্রদত্ত রুট অপ্টিমাইজ করতে পারে। (এই অপ্টিমাইজেশন হল ট্রাভেলিং সেলসপার্সন সমস্যার একটি অ্যাপ্লিকেশন।) ভ্রমণের সময় হল প্রাথমিক ফ্যাক্টর যা অপ্টিমাইজ করা হয়, তবে দূরত্ব, কতবার ঘুরতে হবে এবং আরও অনেক ফ্যাক্টর বিবেচনা করা হতে পারে যখন সিদ্ধান্ত নেওয়া হয় যে কোন রুটটি সবচেয়ে দক্ষ। Directions পরিষেবার মাধ্যমে রুট অপ্টিমাইজ করার জন্য সব ওয়েপয়েন্টকে স্টপওভার হতে হবে।

আপনি যদি Directions পরিষেবাকে এর ওয়েপয়েন্টের ক্রম অপ্টিমাইজ করার নির্দেশ দেন, তাহলে তাদের ক্রম routes অবজেক্টের মধ্যে waypoint_order ফিল্ডে ফেরত দেওয়া হবে। waypoint_order ফিল্ড এমন ভ্যালু রিটার্ন করে যা শূন্য-ভিত্তিক।

নিম্নলিখিত উদাহরণে রুট অপ্টিমাইজেশন ব্যবহার করে দক্ষিণ অস্ট্রেলিয়ার অ্যাডিলেড থেকে দক্ষিণ অস্ট্রেলিয়ার প্রতিটি প্রধান ওয়াইন অঞ্চলে সড়ক ভ্রমণের হিসেব করা হয়েছে।

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

গণনা করা রুটটি পরীক্ষা করলে দেখা যাবে যে গণনাটি নিম্নলিখিত উপায়ে ওয়েপয়েন্ট ব্যবহার করে ওয়েপয়েন্ট অর্ডার:

"waypoint_order": [ 3, 2, 0, 1 ]

বিধিনিষেধ

নির্দিষ্ট কিছু বিধিনিষেধ মেনে দিকনির্দেশ গণনা করা হতে পারে। avoid প্যারামিটার ব্যবহার করে বিধিনিষেধ উল্লেখ করা হয় এবং সেই প্যারামিটারের একটি আর্গুমেন্ট বিধিনিষেধ এড়ানোর বিষয়টি উল্লেখ করে। নিম্নলিখিত বিধিনিষেধ কাজ করে:

  • avoid=tolls
  • avoid=highways
  • avoid=ferries

এড়ানোর প্যারামিটারে দুটি বিধিনিষেধই পাস করে টোল, হাইওয়ে এবং ফেরির যেকোনও কম্বিনেশন এড়িয়ে যায় এমন রুটের জন্য অনুরোধ করা সম্ভব। যেমন: avoid=tolls|highways|ferries.

মনে রাখবেন: বিধিনিষেধ যোগ করার অর্থ এই নয় যে বিধিনিষেধযুক্ত ফিচার আছে এমন রুট বাদ দেওয়া হবে; এটি আরও সুবিধাজনক রুটের ফলাফল দেখায়।

ইউনিট সিস্টেম

দিকনির্দেশ সংক্রান্ত ফলাফলে distance-এর মধ্যে text ফিল্ড থাকে যা ব্যবহারকারীকে রুটের নির্দিষ্ট "ধাপ"-এর দূরত্ব দেখানোর জন্য ব্যবহার করা হতে পারে। ডিফল্ট হিসেবে, এই টেক্সট উৎস দেশ বা অঞ্চলের ইউনিট সিস্টেম ব্যবহার করে।

যেমন, "শিকাগো, ইলিনয়" থেকে "টরন্টো, অন্টারিও" পর্যন্ত রুটের ফলাফল মাইলে দেখানো হবে, কিন্তু উল্টো রুটের ফলাফল কিলোমিটারে দেখানো হবে। আপনি অনুরোধের units প্যারামিটারের মধ্যে স্পষ্টভাবে একটি সেট করে এই ইউনিট সিস্টেমকে ওভাররাইড করতে পারেন, নিম্নলিখিত মানগুলির মধ্যে একটি পাস করে:

  • metric মেট্রিক সিস্টেমের ব্যবহার নির্দিষ্ট করে। কিলোমিটার ও মিটার ব্যবহার করে টেক্সচুয়াল দূরত্ব দেখানো হয়।
  • imperial ইম্পেরিয়াল (ইংরেজি) সিস্টেমের ব্যবহার নির্দিষ্ট করে। টেক্সট হিসেবে দূরত্ব মাইল ও ফুট হিসেবে দেখানো হয়।

মনে রাখবেন: এই ইউনিট সিস্টেম সেটিং শুধুমাত্র distance ফিল্ডের মধ্যে দেখানো text-কে প্রভাবিত করে। distance ফিল্ডে values-ও আছে যা সবসময় মিটারে প্রকাশ করা হয়।

অঞ্চল বায়াসিং

region প্যারামিটার ব্যবহার করে আপনি নির্দিষ্ট অঞ্চল থেকে ফলাফল দেখানোর জন্য দিকনির্দেশ পরিষেবা সেট করতে পারবেন। এই প্যারামিটার দুটি অক্ষর বিশিষ্ট ccTLD (দেশ ভিত্তিক কোড টপ-লেভেল ডোমেন) আর্গুমেন্ট গ্রহণ করে যা অঞ্চল ভিত্তিক পক্ষপাতিত্ব নির্দিষ্ট করে। বেশিরভাগ ccTLD কোড ISO 3166-1 alpha-2 কোডের মতো, তবে কিছু ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (টেকনিক্যালি "The United Kingdom of Great Britain and Northern Ireland" এন্টিটির জন্য)। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজের বিবরণ দেখুন।

আপনি এমন যেকোনও ডোমেন ব্যবহার করতে পারেন যেখানে মূল Google Maps অ্যাপ্লিকেশন গাড়ি চালানোর দিকনির্দেশ চালু করেছে।

যেমন, "টলেডো" থেকে "মাদ্রিদ" যাওয়ার দিকনির্দেশ সংক্রান্ত অনুরোধের ক্ষেত্রে region-কে es-এ সেট করা হলে সঠিক ফলাফল পাওয়া যায় এবং "টলেডো"-কে স্পেনের শহর হিসেবে ব্যাখ্যা করা হয়:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

"Toledo" থেকে "Madrid" যাওয়ার দিকনির্দেশ সংক্রান্ত অনুরোধ region প্যারামিটার ছাড়া পাঠানো হলে কোনও ফলাফল পাওয়া যায় না, কারণ "Toledo" বলতে স্পেনের শহর নয়, ওহাইও-র শহরকে বোঝায়:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

লোকেশন মডিফায়ার

ড্রাইভার কীভাবে কোনও নির্দিষ্ট লোকেশনে পৌঁছাবেন তা নির্দেশ করতে আপনি লোকেশন মডিফায়ার ব্যবহার করতে পারেন। এর জন্য রাস্তার কোন দিক ব্যবহার করতে হবে তা নির্দিষ্ট করতে side_of_road প্যারামিটার ব্যবহার করতে পারেন অথবা ভ্রমণের সঠিক দিক নির্দেশ করতে হেডিং নির্দিষ্ট করতে পারেন। এইসব মডিফায়ার, ইন্টারমিডিয়েট ওয়েপয়েন্টের জন্য via: মডিফায়ারের সাথে অবাধে মিক্স করা যেতে পারে।

রাস্তার একটি নির্দিষ্ট দিক দিয়ে রুট যেতে হবে তা উল্লেখ করুন

কোনও ওয়েপয়েন্ট নির্দিষ্ট করার সময়, আপনি অনুরোধ করতে পারেন যে রুটটি রাস্তার যে দিকে ওয়েপয়েন্টটি রয়েছে সেই দিকেই যাবে। এর জন্য side_of_road: প্রিফিক্স ব্যবহার করুন। যেমন, এই দিকনির্দেশের অনুরোধে একটি দীর্ঘ রুট দেখানো হবে যাতে গাড়িটি রাস্তার সেই দিকেই থামে যেদিকে ওয়েপয়েন্টটি বায়াস করা হয়েছে:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

এনকোড করা পলিলাইনের সাথে side_of_road: ব্যবহার করার সময়, পলিলাইন বরাবর প্রতিটি লোকেশনে প্যারামিটার প্রয়োগ করা হয়।

side_of_road: মডিফায়ার শুধুমাত্র নিম্নলিখিত বিধিনিষেধের সাথে ব্যবহার করা যেতে পারে:

  • travel mode প্যারামিটার হল driving, অথবা উল্লেখ করা নেই (driving হল ডিফল্ট ভ্রমণ মোড)।

রুটগুলিতে একটি নির্দিষ্ট শিরোনাম থাকতে হবে তা উল্লেখ করুন

কোনও ওয়েপয়েন্ট নির্দিষ্ট করার সময়, আপনি অনুরোধ করতে পারেন যে রুটটি যেন কোনও নির্দিষ্ট হেডিংয়ে ওয়েপয়েন্টের মধ্যে দিয়ে যায়। এই হেডিং heading=X: প্রিফিক্স দিয়ে নির্দিষ্ট করা হয়, যেখানে X হল ০ (অন্তর্ভুক্ত) থেকে ৩৬০ (বাদ দিয়ে)-এর মধ্যে একটি পূর্ণসংখ্যা ডিগ্রি মান। ০ হেডিং উত্তর দিক, ৯০ হেডিং পূর্ব দিক নির্দেশ করে, ঘড়ির কাঁটার দিকে চলতে থাকে। যেমন, এই দিকনির্দেশের অনুরোধে রুটটি শুরু থেকে পূর্ব দিকে যায়, তারপর একটি ইউ-টার্ন নেয়:

ইউআরএল

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

heading=X: মডিফায়ার শুধুমাত্র নিম্নলিখিত বিধিনিষেধের সাথে ব্যবহার করা যেতে পারে:

  • travel mode প্যারামিটার হল driving, bicycling, অথবা নির্দিষ্ট করা নেই (driving হল ডিফল্ট ট্রাভেল মোড)।
  • একই লোকেশনের জন্য side_of_road মডিফায়ার নির্দিষ্ট করা নেই।
  • লোকেশনটি অক্ষাংশ/দ্রাঘিমাংশের মান দিয়ে নির্দিষ্ট করা হয়েছে। আপনি ঠিকানা, স্থান আইডি বা এনকোড করা পলিলাইনের সাথে heading ব্যবহার করতে পারবেন না।