এই প্রোডাক্ট পুরনো স্ট্যাটাসে আছে। অক্টোবর ২০২৬ থেকে, নতুন Google Cloud প্রোজেক্টের জন্য Directions API (Legacy) আর চালু করা যাবে না। আগে থেকে থাকা প্রোজেক্ট সম্পূর্ণভাবে কাজ করবে। নতুন ফিচার ও উন্নত পারফর্ম্যান্সের জন্য, Routes API-তে মাইগ্রেট করুন।
নমুনা উত্তর
URL অনুরোধের পাথে output ফ্ল্যাগ দ্বারা নির্দেশিত ফর্ম্যাটে
দিকনির্দেশ সংক্রান্ত উত্তর ফেরত পাঠানো হয়।
নিচে একটি HTTP অনুরোধের নমুনা দেখানো হয়েছে, যা শিকাগো, IL থেকে লস অ্যাঞ্জেলেস, CA পর্যন্ত রুট গণনা করছে, Joplin, MO এবং ওকলাহোমা সিটি, OK-তে দুটি ওয়েপয়েন্টের মাধ্যমে।
ইউআরএল
https://maps.googleapis.com/maps/api/directions/json ?destination=Los%20Angeles%2C%20CA &origin=Chicago%2C%20IL &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK &key=YOUR_API_KEY
কার্ল
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'
উপরের উদাহরণে JSON আউটপুটের অনুরোধ করা হয়েছে। XML আউটপুটের জন্য অনুরোধ করাও সম্ভব। স্যাম্পেল JSON ও XML উত্তর দেখতে নিচের ট্যাব বেছে নিন।
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 41.8781139, "lng": -87.6297872 }, "southwest": { "lat": 34.0523525, "lng": -118.2435717 }, }, "copyrights": "Map data ©2022 Google, INEGI", "legs": [ { "distance": { "text": "579 mi", "value": 932311 }, "duration": { "text": "8 hours 48 mins", "value": 31653 }, "end_address": "Joplin, MO, USA", "end_location": { "lat": 37.0842449, "lng": -94.513284 }, "start_address": "Chicago, IL, USA", "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "steps": [ { "distance": { "text": "443 ft", "value": 135 }, "duration": { "text": "1 min", "value": 24 }, "end_location": { "lat": 41.8769003, "lng": -87.6297353 }, "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>", "polyline": { "points": "eir~FdezuOdCEjBC" }, "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "travel_mode": "DRIVING", }, { "distance": { "text": "269 ft", "value": 82 }, "duration": { "text": "1 min", "value": 20 }, "end_location": { "lat": 41.8768866, "lng": -87.63073 }, "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>", "maneuver": "turn-right", "polyline": { "points": "sar~FzdzuO@fC?|@" }, "start_location": { "lat": 41.8769003, "lng": -87.6297353 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity ], "overview_polyline": { "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)", }, "summary": "I-55 S and I-44", "warnings": [], "waypoint_order": [0, 1], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>I-55 S and I-44</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </end_location> <polyline> <points>eir~FdezuOdCEjBC</points> </polyline> <duration> <value>24</value> <text>1 min</text> </duration> <html_instructions>Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b></html_instructions> <distance> <value>135</value> <text>443 ft</text> </distance> </step> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </start_location> <end_location> <lat>41.8768866</lat> <lng>-87.6307300</lng> </end_location> <polyline> <points>sar~FzdzuO@fC?|@</points> </polyline> <duration> <value>20</value> <text>1 min</text> </duration> <html_instructions>Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b></html_instructions> <distance> <value>82</value> <text>269 ft</text> </distance> <maneuver>turn-right</maneuver> </step> <!-- Additional steps omitted for brevity --> <duration> <value>31653</value> <text>8 hours 48 mins</text> </duration> <distance> <value>932311</value> <text>579 mi</text> </distance> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>37.0842449</lat> <lng>-94.5132840</lng> </end_location> <start_address>Chicago, IL, USA</start_address> <end_address>Joplin, MO, USA</end_address> </leg> <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity --> <copyrights>Map data ©2022 Google, INEGI</copyrights> <overview_polyline> <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points> </overview_polyline> <waypoint_index>0</waypoint_index> <waypoint_index>1</waypoint_index> <bounds> <southwest> <lat>34.0523525</lat> <lng>-118.2435717</lng> </southwest> <northeast> <lat>41.8781139</lat> <lng>-87.6297872</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id> </geocoded_waypoint> </DirectionsResponse>
এই ডকুমেন্টেশনের বাকি অংশে JSON সিনট্যাক্স ব্যবহার করা হবে। বেশিরভাগ ক্ষেত্রে, ডকুমেন্টেশনে ধারণা বা ফিল্ডের নাম ব্যাখ্যা করার জন্য আউটপুট ফরম্যাট গুরুত্বপূর্ণ নয়। তবে, নিম্নলিখিত সূক্ষ্ম পার্থক্যগুলি মনে রাখবেন:
- XML ফলাফল রুট
<DirectionsResponse>এলিমেন্টে র্যাপ করা থাকে। - JSON-এ একাধিক এলিমেন্ট সহ এন্ট্রিকে বহুবচন অ্যারে (যেমন
stepsএবংlegs) হিসেবে দেখানো হয়, যেখানে XML-এ এগুলি একাধিক একবচন এলিমেন্ট (যেমন<step>এবং<leg>) হিসেবে দেখানো হয়। - JSON
waypoint_orderফিল্ডের মাধ্যমে ওয়েপয়েন্টের ক্রম নির্দেশ করে, যেখানে XML এগুলি আলাদা আলাদা<waypoint_index>এলিমেন্ট ব্যবহার করে নির্দেশ করে। - JSON-এ খালি অ্যারের মাধ্যমে ফাঁকা এলিমেন্ট দেখানো হয়, কিন্তু XML-এ এই ধরনের কোনও এলিমেন্ট
না থাকার মাধ্যমে তা দেখানো হয়। উদাহরণস্বরূপ, কোনও ফলাফল জেনারেট না করা রেসপন্স JSON-এ খালি
routesঅ্যারে রিটার্ন করবে, কিন্তু XML-এ কোনও<route>এলিমেন্ট রিটার্ন করবে না।
DirectionsResponse
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | Array<DirectionsRoute> |
যেখান থেকে যাত্রা শুরু হচ্ছে, সেখান থেকে গন্তব্য পর্যন্ত, রুটের অ্যারে আছে। রুটে নেস্ট করা লেগ ও স্টেপ থাকে। আরও তথ্যের জন্য DirectionsRoute দেখুন। |
|
প্রয়োজনীয় | DirectionsStatus |
এতে অনুরোধের স্ট্যাটাস থাকে এবং আপনাকে সাহায্য করার জন্য ডিবাগিং ইনফরমেশন থাকতে পারে অনুরোধ কেন ব্যর্থ হয়েছে তা ট্র্যাক করুন। আরও তথ্যের জন্য DirectionsStatus দেখুন। |
|
ঐচ্ছিক | Array<TravelMode> |
উপলভ্য ভ্রমণ মোডের অ্যারে অন্তর্ভুক্ত করে। কোনও অনুরোধে ভ্রমণের মোড নির্দিষ্ট করা হলে এবং কোনও ফলাফল না পাওয়া গেলে এই ফিল্ডটি দেখানো হয়। অ্যারেতে প্রদত্ত ওয়েপয়েন্টের সেটের দেশগুলিতে উপলভ্য ভ্রমণের মোড রয়েছে। এক বা একাধিক ওয়েপয়েন্ট 'ভায়া ওয়েপয়েন্ট' হলে, এই ফিল্ড ফেরত দেওয়া হয় না। আরও তথ্যের জন্য TravelMode দেখুন। |
|
ঐচ্ছিক | স্ট্রিং |
পরিষেবাটি |
|
ঐচ্ছিক | Array<DirectionsGeocodedWaypoint> |
এতে অরিজিন, গন্তব্য ও ওয়েপয়েন্টের জিওকোডিং সম্পর্কে বিবরণ সহ একটি অ্যারে থাকে। geocoded_waypoints অ্যারের এলিমেন্টগুলি, তাদের শূন্য-ভিত্তিক অবস্থান অনুসারে, উৎস, নির্দিষ্ট করা ক্রমে ওয়েপয়েন্ট এবং গন্তব্যের সাথে মিলে যায়। পরিষেবা কোনও ফলাফল না দেখালে, টেক্সট হিসেবে অক্ষাংশ/দ্রাঘিমাংশ ভ্যালু হিসেবে নির্দিষ্ট করা ওয়েপয়েন্টের জন্য এইসব বিবরণ দেখানো হবে না। কারণ, কোনও রুট খুঁজে পাওয়ার পরেই এই ধরনের ওয়েপয়েন্টের প্রতিনিধিত্বমূলক ঠিকানা পেতে রিভার্স জিওকোড করা হয়। একটি খালি JSON অবজেক্ট geocoded_waypoints অ্যারেতে সংশ্লিষ্ট জায়গা দখল করবে। আরও তথ্যের জন্য DirectionsGeocodedWaypoint দেখুন। |
DirectionsRoute
রুটে নেস্ট করা legs ও steps থাকে।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | সীমা |
এতে আরও তথ্যের জন্য বাউন্ড দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
এই রুটের জন্য কপিরাইট সংক্রান্ত বিজ্ঞপ্তি দেখানোর জন্য এটিতে অন্তর্ভুক্ত করা হয়েছে। আপনাকে নিজে এই তথ্য ম্যানেজ করতে ও দেখাতে হবে। এই কন্টেন্টটি যেমন আছে তেমনই পড়তে হবে। শুধুমাত্র দেখানোর জন্য এই কন্টেন্ট প্রোগ্রাম্যাটিকভাবে পার্স করবেন না। |
|
প্রয়োজনীয় | Array<DirectionsLeg> |
একটি অ্যারে যাতে রুটের একটি লেগ সম্পর্কে তথ্য থাকে, প্রদত্ত রুটের মধ্যে দুটি লোকেশনের মধ্যে। প্রতিটি নির্দিষ্ট করা ওয়েপয়েন্ট বা গন্তব্যের জন্য আলাদা লেগ উপস্থিত থাকবে। (কোনও ওয়েপয়েন্ট ছাড়া রুটে, লেগ অ্যারের মধ্যে ঠিক একটি লেগ থাকবে।) প্রতিটি পর্যায়ে একাধিক ধাপ থাকে। আরও তথ্যের জন্য DirectionsLeg দেখুন। |
|
প্রয়োজনীয় | DirectionsPolyline |
এতে এমন একটি অবজেক্ট থাকে যা রুটের এনকোড করা পলিলাইন রিপ্রেজেন্টেশন ধরে রাখে। এই পলিলাইন হল ফলাফল হিসেবে পাওয়া দিকনির্দেশের আনুমানিক (স্মুথ করা) পাথ। আরও তথ্যের জন্য DirectionsPolyline দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
রুটের জন্য একটি সংক্ষিপ্ত টেক্সট বিবরণ রয়েছে, যা রুটের নাম এবং বিকল্প থেকে রুটকে আলাদা করার জন্য উপযুক্ত। |
|
প্রয়োজনীয় | Array<string> |
এইসব দিকনির্দেশ দেখানোর সময়, দেখানোর জন্য সতর্কতার একটি অ্যারে থাকে। আপনাকে অবশ্যই এইসব সতর্কতা ম্যানেজ করতে ও দেখাতে হবে। |
|
প্রয়োজনীয় | Array<integer> |
গণনা করা রুটে যেকোনও ওয়েপয়েন্টের ক্রম নির্দেশ করে এমন একটি অ্যারে। এই ওয়েপয়েন্ট পুনরায় সাজানো হতে পারে যদি অনুরোধটি তার ওয়েপয়েন্ট প্যারামিটারের মধ্যে optimize:true পাস করে থাকে। |
|
ঐচ্ছিক | ভাড়া |
উপলভ্য থাকলে, এই রুটের মোট ভাড়া (অর্থাৎ, টিকিটের মোট খরচ) অন্তর্ভুক্ত থাকে। এই প্রপার্টি শুধুমাত্র ট্রানজিট অনুরোধের জন্য এবং শুধুমাত্র সেইসব রুটের জন্য ফেরত দেওয়া হয় যেখানে সমস্ত ট্রানজিট লেগের জন্য ভাড়ার তথ্য উপলভ্য। আরও তথ্যের জন্য ভাড়া দেখুন। |
বাউন্ডস
দক্ষিণ-পশ্চিম এবং উত্তর-পূর্ব কোণের বিন্দু থেকে ভৌগোলিক স্থানাঙ্কে একটি আয়তক্ষেত্র।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | LatLngLiteral | আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | LatLngLiteral | আরও তথ্যের জন্য LatLngLiteral দেখুন। |
LatLngLiteral
দশমিক ডিগ্রিতে অক্ষাংশ এবং দ্রাঘিমাংশ সহ একটি নির্দিষ্ট লোকেশন বর্ণনা করে এমন একটি অবজেক্ট।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | নম্বর |
দশমিক ডিগ্রিতে অক্ষাংশ |
|
প্রয়োজনীয় | নম্বর |
দশমিক ডিগ্রিতে দ্রাঘিমাংশ |
DirectionsLeg
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
এই লেগের |
|
প্রয়োজনীয় | LatLngLiteral |
এই লেগের প্রদত্ত গন্তব্যের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক। যেহেতু
Directions API শুরু ও শেষ পয়েন্টে সবচেয়ে কাছের পরিবহনের বিকল্প (সাধারণত রাস্তা) ব্যবহার করে
লোকেশনগুলির মধ্যে দিকনির্দেশ গণনা করে,
আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
এই লেগের |
|
প্রয়োজনীয় | LatLngLiteral |
এই লেগের উৎসের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক। Directions API
শুরু ও শেষ পয়েন্টে সবচেয়ে কাছের পরিবহনের বিকল্প (সাধারণত রাস্তা) ব্যবহার করে
লোকেশনগুলির মধ্যে দিকনির্দেশ গণনা করে, তাই আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | Array<DirectionsStep> |
সফরের প্রতিটি আলাদা ধাপের তথ্য উল্লেখ করে এমন ধাপের অ্যারে। আরও তথ্যের জন্য DirectionsStep দেখুন। |
|
ঐচ্ছিক | Array<DirectionsTrafficSpeedEntry> |
লেগ বরাবর ট্রাফিক স্পিড সম্পর্কিত তথ্য। আরও তথ্যের জন্য DirectionsTrafficSpeedEntry দেখুন। |
|
প্রয়োজনীয় | Array<DirectionsViaWaypoint> |
এই লেগ বরাবর ভায়া ওয়েপয়েন্টের লোকেশন। আরও তথ্যের জন্য DirectionsViaWaypoint দেখুন। |
|
ঐচ্ছিক | TimeZoneTextValueObject |
এই ট্রানজিট লাইনের জন্য পৌঁছানোর আনুমানিক সময় অন্তর্ভুক্ত করে। এই প্রপার্টি শুধুমাত্র ট্রানজিটের দিকনির্দেশের জন্য ফেরত দেওয়া হয়। আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন। |
|
ঐচ্ছিক | TimeZoneTextValueObject |
এই লেগের জন্য আনুমানিক ছাড়ার সময় থাকে, যা টাইম অবজেক্ট হিসেবে নির্দিষ্ট করা হয়। আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন। |
|
ঐচ্ছিক | TextValueObject |
এই লেগের মাধ্যমে কভার করা মোট দূরত্ব। আরও তথ্যের জন্য TextValueObject দেখুন। |
|
ঐচ্ছিক | TextValueObject |
এই লেগের মোট সময়সীমা। আরও তথ্যের জন্য TextValueObject দেখুন। |
|
ঐচ্ছিক | TextValueObject |
এই লেগের মোট সময়সীমা দেখায়। এই মানটি বর্তমান এবং ঐতিহাসিক ট্রাফিক অবস্থার উপর ভিত্তি করে ট্রাফিকের
সময়ের একটি অনুমান। আপনি যে বিকল্পগুলি ব্যবহার করে অনুরোধ করতে পারেন তার জন্য
আরও তথ্যের জন্য TextValueObject দেখুন। |
DirectionsStep
স্টেপ অ্যারের প্রতিটি এলিমেন্ট, গণনা করা দিকের একটি ধাপকে সংজ্ঞায়িত করে। একটি ধাপ হল দিকনির্দেশের রুটের সবচেয়ে ক্ষুদ্রতম ইউনিট, যাতে একটি নির্দিষ্ট, একক নির্দেশ সহ একটি ধাপ থাকে। যেমন, "W-এ বাঁদিকে ঘুরুন। "৪র্থ স্ট্রিট" এই ধাপে শুধু নির্দেশনাই বর্ণনা করা হয় না, বরং এই ধাপটি পরবর্তী ধাপের সাথে কীভাবে সম্পর্কিত সেই বিষয়ে দূরত্ব এবং সময়কাল সম্পর্কিত তথ্যও থাকে। যেমন, "I-80 West-এ মার্জ করুন" হিসেবে উল্লেখ করা কোনও ধাপে "৩৭ মাইল" এবং "৪০ মিনিট" সময়সীমা থাকতে পারে, যা থেকে বোঝা যায় যে পরবর্তী ধাপটি এই ধাপ থেকে ৩৭ মাইল/৪০ মিনিট দূরে।
ট্রানজিটের দিকনির্দেশ সার্চ করার জন্য Directions API ব্যবহার করার সময়, ধাপের অ্যারেতে transit_details অ্যারের আকারে অতিরিক্ত ট্রানজিট বিবরণ অন্তর্ভুক্ত থাকবে। দিকনির্দেশে একাধিক পরিবহনের মোড অন্তর্ভুক্ত থাকলে, ইনার স্টেপস অ্যারেতে হাঁটা বা গাড়ি চালানোর ধাপের জন্য বিস্তারিত দিকনির্দেশ প্রদান করা হবে। যেমন, হাঁটার ধাপের মধ্যে শুরু ও শেষ লোকেশনের দিকনির্দেশ অন্তর্ভুক্ত থাকবে: "Innes Ave ও Fitch St পর্যন্ত হেঁটে যান"। সেই ধাপে ইনার স্টেপ অ্যারেতে সেই রুটের জন্য বিস্তারিত হাঁটার দিকনির্দেশ অন্তর্ভুক্ত থাকবে, যেমন: "উত্তর-পশ্চিম দিকে যান", "বাঁদিকে ঘুরে Arelious Walker-এ যান" এবং "বাঁদিকে ঘুরে Innes Ave-এ যান"।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | TextValueObject |
পরবর্তী ধাপ পর্যন্ত, ধাপটি সম্পূর্ণ করতে সাধারণত কত সময় লাগে তা উল্লেখ করা থাকে। সময়কাল অজানা থাকলে এই ফিল্ডটি অনির্দিষ্ট হতে পারে। আরও তথ্যের জন্য TextValueObject দেখুন। |
|
প্রয়োজনীয় | LatLngLiteral |
এই ধাপের শেষ পয়েন্টের লোকেশন রয়েছে। আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
এই ধাপের জন্য ফর্ম্যাট করা নির্দেশাবলী রয়েছে, যা HTML টেক্সট স্ট্রিং হিসেবে দেখানো হয়েছে। এই কন্টেন্টটি যেমন আছে তেমনই পড়তে হবে। শুধুমাত্র দেখানোর জন্য এই কন্টেন্ট প্রোগ্রাম্যাটিক্যালি পার্স করবেন না। |
|
প্রয়োজনীয় | DirectionsPolyline |
এতে একটি পয়েন্ট অবজেক্ট থাকে যা স্টেপের এনকোড করা পলিলাইন রিপ্রেজেন্টেশন ধরে রাখে। এই পলিলাইন হল ধাপের আনুমানিক (স্মুথ করা) পাথ। আরও তথ্যের জন্য DirectionsPolyline দেখুন। |
|
প্রয়োজনীয় | LatLngLiteral |
এই ধাপের শুরুর পয়েন্টের লোকেশন থাকে। আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | TravelMode |
ভ্রমণের জন্য কোন ধরনের মোড ব্যবহার করা হয়েছে তা উল্লেখ করা থাকে। আরও তথ্যের জন্য TravelMode দেখুন। |
|
ঐচ্ছিক | TextValueObject |
পরবর্তী ধাপ পর্যন্ত এই ধাপের মাধ্যমে কভার করা দূরত্ব অন্তর্ভুক্ত করে। দূরত্ব জানা না থাকলে এই ফিল্ড অনির্ধারিত থাকতে পারে। আরও তথ্যের জন্য TextValueObject দেখুন। |
|
ঐচ্ছিক | স্ট্রিং |
বর্তমান স্টেপের জন্য কী অ্যাকশন নিতে হবে তা থাকে (বাঁদিকে ঘুরুন, মার্জ করুন, সোজা যান ইত্যাদি)। মূল্য পরিবর্তন হতে পারে এবং আগে থেকে বিজ্ঞপ্তি না পাঠিয়েই নতুন মূল্য চালু করা হতে পারে।
The allowed values include:
turn-slight-left, turn-sharp-left,
turn-left, turn-slight-right, turn-sharp-right,
keep-right, keep-left, uturn-left,
uturn-right, turn-right, straight,
ramp-left, ramp-right, merge,
fork-left, fork-right, ferry,
ferry-train, roundabout-left, and
roundabout-right
|
|
ঐচ্ছিক |
ট্রানজিট দিকনির্দেশে হাঁটা বা গাড়ি চালানোর ধাপের জন্য বিস্তারিত দিকনির্দেশ থাকে। Substeps are only available when travel_mode is set to "transit". ভিতরের ধাপের অ্যারে ধাপের মতোই একই ধরনের। |
|
|
ঐচ্ছিক | DirectionsTransitDetails |
ভ্রমণের মোড আরও তথ্যের জন্য DirectionsTransitDetails দেখুন। |
TextValueObject
একটি অবজেক্ট যাতে একটি সংখ্যাসূচক মান এবং এর ফর্ম্যাট করা টেক্সট উপস্থাপনা রয়েছে।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
স্ট্রিং ভ্যালু। |
|
প্রয়োজনীয় | নম্বর |
সাংখ্যিক মান। |
DirectionsPolyline
পলিলাইন এনকোডিং হল একটি লসি কম্প্রেশন অ্যালগরিদম যা আপনাকে একটি স্ট্রিং হিসেবে একাধিক স্থানাঙ্ক স্টোর করতে দেয়। চিহ্নিত ভ্যালু ব্যবহার করে পয়েন্ট কোঅর্ডিনেট এনকোড করা হয়। আপনার কাছে মাত্র কয়েকটি স্ট্যাটিক পয়েন্ট থাকলে, আপনি ইন্টার্যাক্টিভ পলিলাইন এনকোডিং ইউটিলিটিও ব্যবহার করতে পারেন।
এনকোডিং প্রসেস পরিচিত base64 এনকোডিং স্কিম ব্যবহার করে ASCII অক্ষরের জন্য বাইনারি ভ্যালুকে অক্ষর কোডের সিরিজে কনভার্ট করে: এইসব অক্ষর যাতে সঠিকভাবে দেখানো যায় তা নিশ্চিত করতে, এনকোড করা ভ্যালু ASCII-তে কনভার্ট করার আগে ৬৩ (ASCII অক্ষর '?') যোগ করা হয়। এছাড়াও, অ্যালগরিদম প্রতিটি বাইট গ্রুপের সবচেয়ে কম গুরুত্বপূর্ণ বিট চেক করে কোনও নির্দিষ্ট পয়েন্টের জন্য অতিরিক্ত ক্যারেক্টার কোড চেক করে; এই বিট ১-এ সেট করা থাকলে, পয়েন্টটি এখনও সম্পূর্ণভাবে তৈরি হয়নি এবং অতিরিক্ত ডেটা অবশ্যই ফলো করতে হবে।
এছাড়াও, জায়গা বাঁচাতে, পয়েন্টে শুধুমাত্র আগের পয়েন্ট থেকে অফসেট অন্তর্ভুক্ত থাকে (অবশ্যই প্রথম পয়েন্ট ছাড়া)। সব পয়েন্ট Base64-এ সাইন করা পূর্ণসংখ্যা হিসেবে এনকোড করা হয়, কারণ অক্ষাংশ ও দ্রাঘিমাংশ সাইন করা ভ্যালু। একটি পলিলাইনের মধ্যে এনকোডিং ফর্ম্যাটকে দুটি স্থানাঙ্ক উপস্থাপন করতে হবে যা যুক্তিসঙ্গত নির্ভুলতার সাথে অক্ষাংশ এবং দ্রাঘিমাংশ উপস্থাপন করে। সর্বাধিক +/- ১৮০ ডিগ্রি দ্রাঘিমাংশ ৫ দশমিক স্থান (১৮০.০০০০০ থেকে -১৮০.০০০০০) পর্যন্ত নির্ভুলভাবে দেখানোর জন্য, ৩২ বিট সাইনড বাইনারি ইন্টিজার ভ্যালু প্রয়োজন।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
পলিলাইনের একটি স্ট্রিং উপস্থাপনা। |
TravelMode
DRIVING(ডিফল্ট) রোড নেটওয়ার্ক ব্যবহার করে গণনা করাকে বোঝায়।-
BICYCLINGসাইকেল চালানোর রাস্তা ও পছন্দের রাস্তা (যেখানে উপলভ্য) ব্যবহার করে সাইকেল চালানোর জন্য হিসাব করার অনুরোধ করে। TRANSITপাবলিক ট্রানজিট রুট (যেখানে উপলভ্য) ব্যবহার করে গণনা করার অনুরোধ করে।-
WALKINGপথচারীদের রাস্তা ও ফুটপাথ (যেখানে উপলভ্য) ব্যবহার করে হাঁটার জন্য হিসাব করার অনুরোধ করে।
DirectionsTransitDetails
অতিরিক্ত তথ্য যা পরিবহনের অন্যান্য মোডের জন্য প্রাসঙ্গিক নয়।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
ঐচ্ছিক | DirectionsTransitStop |
পৌঁছানোর ট্রানজিট স্টপ। আরও তথ্যের জন্য DirectionsTransitStop দেখুন। |
|
ঐচ্ছিক | TimeZoneTextValueObject | আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন। |
|
ঐচ্ছিক | DirectionsTransitStop |
ট্রানজিট স্টপ থেকে রওনা হওয়ার সময়। আরও তথ্যের জন্য DirectionsTransitStop দেখুন। |
|
ঐচ্ছিক | TimeZoneTextValueObject | আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন। |
|
ঐচ্ছিক | স্ট্রিং |
এই লাইনে কোন দিকে যেতে হবে তা উল্লেখ করে, যেমনটি গাড়িতে বা ছাড়ার স্টপে চিহ্নিত করা আছে। এটি প্রায়শই টার্মিনাস স্টেশন হবে। |
|
ঐচ্ছিক | পূর্ণসংখ্যা |
এই সময়ে একই স্টপ থেকে ছাড়ার মধ্যে প্রত্যাশিত সেকেন্ডের সংখ্যা নির্দিষ্ট করে। যেমন, |
|
ঐচ্ছিক | DirectionsTransitLine |
এই ধাপে ব্যবহার করা ট্রানজিট লাইন সম্পর্কে তথ্য থাকে। আরও তথ্যের জন্য DirectionsTransitLine দেখুন। |
|
ঐচ্ছিক | পূর্ণসংখ্যা |
ছেড়ে যাওয়ার স্টপ থেকে গন্তব্যে পৌঁছানোর স্টপের মধ্যে যতগুলি স্টপ আছে। এর মধ্যে পৌঁছানোর স্টপ অন্তর্ভুক্ত, কিন্তু প্রস্থানের স্টপ নয়। যেমন, আপনার দিকনির্দেশে যদি
স্টপ A থেকে রওনা হয়ে, স্টপ B ও C পেরিয়ে স্টপ D-তে পৌঁছানোর কথা বলা হয়,
তাহলে |
|
ঐচ্ছিক | স্ট্রিং |
যাত্রীদের ট্রানজিট ট্রিপ শনাক্ত করার জন্য শিডিউল এবং সাইনবোর্ডে যে টেক্সট দেখানো হয়। পরিষেবা প্রদানকারী দিনের মধ্যে টেক্সটটি অনন্যভাবে একটি ট্রিপ শনাক্ত করতে হবে। যেমন,
"538" হল
Amtrak ট্রেনের |
DirectionsTransitStop
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | LatLngLiteral |
স্টপের লোকেশন। আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
ট্রানজিট স্টপের নাম। |
TimeZoneTextValueObject
Unix epoch সময়, টাইম জোন ও ফর্ম্যাট করা টেক্সট উপস্থাপনা সহ অবজেক্ট।
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
টাইম জোনে স্ট্রিং হিসেবে উল্লেখ করা সময়। |
|
প্রয়োজনীয় | স্ট্রিং |
টাইম জোন অন্তর্ভুক্ত করে। ভ্যালু হল টাইম জোনের নাম, যেমন IANA টাইম জোন ডেটাবেসে উল্লেখ করা আছে, যেমন "America/New_York"। |
|
প্রয়োজনীয় | নম্বর |
Unix epoch সময় বা ১ জানুয়ারি, ১৯৭০ UTC মধ্যরাত থেকে সেকেন্ড হিসেবে সময় নির্দিষ্ট করা হয়েছে। |
DirectionsTransitLine
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | Array<DirectionsTransitAgency> |
ট্রানজিট এজেন্সি (বা এজেন্সিগুলি) যা এই ট্রানজিট লাইন পরিচালনা করে। আরও তথ্যের জন্য DirectionsTransitAgency দেখুন। |
|
প্রয়োজনীয় | স্ট্রিং |
এই ট্রানজিট লাইনের পুরো নাম, যেমন "৮ অ্যাভিনিউ লোকাল"। |
|
ঐচ্ছিক | স্ট্রিং |
এই লাইনের সাইনেজে সাধারণত ব্যবহৃত রঙ। |
|
ঐচ্ছিক | স্ট্রিং |
এই লাইনের সাথে যুক্ত আইকনের URL থাকে। |
|
ঐচ্ছিক | স্ট্রিং |
এই ট্রানজিট লাইনের সংক্ষিপ্ত নাম। এটি সাধারণত একটি লাইন নম্বর হবে, যেমন "M7" বা "355"। |
|
ঐচ্ছিক | স্ট্রিং |
এই লাইনের সাইনেজে সাধারণত ব্যবহৃত রঙ। |
|
ঐচ্ছিক | স্ট্রিং |
ট্রানজিট এজেন্সির দেওয়া এই ট্রানজিট লাইনের URL থাকে। |
|
ঐচ্ছিক | DirectionsTransitVehicle |
এই ট্রানজিট লাইনে যে ধরনের গাড়ি চলাচল করে। আরও তথ্যের জন্য DirectionsTransitVehicle দেখুন। |
DirectionsTransitAgency
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
ঐচ্ছিক | স্ট্রিং |
এই ট্রানজিট এজেন্সির নাম। |
|
ঐচ্ছিক | স্ট্রিং |
ট্রানজিট এজেন্সির ফোন নম্বর। |
|
ঐচ্ছিক | স্ট্রিং |
ট্রানজিট এজেন্সির URL। |
DirectionsTransitVehicle
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
এই গাড়ির নাম, বড় হাতের অক্ষরে। |
|
প্রয়োজনীয় | স্ট্রিং |
যে ধরনের গাড়ি ব্যবহার করা হয়েছে।
The allowed values include:
BUS, CABLE_CAR,
COMMUTER_TRAIN, FERRY, FUNICULAR,
GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN,
INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL,
MONORAIL, OTHER, RAIL, SHARE_TAXI,
SUBWAY, TRAM, and
TROLLEYBUS
|
|
ঐচ্ছিক | স্ট্রিং |
এই ধরনের গাড়ির সাথে যুক্ত আইকনের URL থাকে। |
|
ঐচ্ছিক | স্ট্রিং |
স্থানীয় ট্রান্সপোর্ট সাইনেজের উপর ভিত্তি করে, এই ধরনের গাড়ির সাথে যুক্ত আইকনের URL থাকে। |
DirectionsTrafficSpeedEntry
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | নম্বর |
এই স্পিড ক্যাটেগরি যতদূর পর্যন্ত বৈধ সেই পাথ (মিটারে) বরাবর অফসেট। |
|
প্রয়োজনীয় | স্ট্রিং |
রাস্তার এই অংশে বর্তমান ট্রাফিক/গতির অবস্থা। |
DirectionsViaWaypoint
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
ঐচ্ছিক | LatLngLiteral |
ওয়েপয়েন্টের লোকেশন। আরও তথ্যের জন্য LatLngLiteral দেখুন। |
|
ঐচ্ছিক | পূর্ণসংখ্যা |
ওয়েপয়েন্ট সহ ধাপের ইনডেক্স। |
|
ঐচ্ছিক | নম্বর |
ধাপের পলিলাইন বরাবর ওয়েপয়েন্টের অবস্থান, ০ থেকে ১ পর্যন্ত অনুপাত হিসেবে প্রকাশ করা হয়। |
ভাড়া
রুটের জন্য মোট ভাড়া।
{
"currency" : "USD",
"value" : 6,
"text" : "$6.00"
}
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
প্রয়োজনীয় | স্ট্রিং |
একটি ISO 4217 মুদ্রা কোড যা নির্দেশ করে যে পরিমাণটি কোন মুদ্রায় প্রকাশ করা হয়েছে। |
|
প্রয়োজনীয় | স্ট্রিং |
অনুরোধ করা ভাষায় ফর্ম্যাট করা মোট ভাড়ার পরিমাণ। |
|
প্রয়োজনীয় | নম্বর |
নির্দিষ্ট করা মুদ্রায় মোট ভাড়ার পরিমাণ। |
DirectionsStatus
Directions রেসপন্স অবজেক্টের মধ্যে স্ট্যাটাস ফিল্ডে অনুরোধের স্ট্যাটাস থাকে এবং এতে ডিবাগিং তথ্য থাকতে পারে যা আপনাকে Directions পরিষেবা কেন ব্যর্থ হয়েছে তা ট্র্যাক করতে সাহায্য করে। স্ট্যাটাস ফিল্ডে নিম্নলিখিত ভ্যালু থাকতে পারে:
OKনির্দেশ করে যে উত্তরে সঠিক ফলাফল রয়েছে।-
NOT_FOUNDথেকে বোঝা যায় যে অনুরোধের উৎস, গন্তব্য বা ওয়েপয়েন্টে উল্লেখ করা লোকেশনগুলির মধ্যে অন্তত একটি জিওকোড করা যায়নি। -
ZERO_RESULTS-এর অর্থ হল, যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে কোনও রুট খুঁজে পাওয়া যায়নি। -
MAX_WAYPOINTS_EXCEEDEDথেকে বোঝা যায় যে অনুরোধে অনেক বেশি ওয়েপয়েন্ট দেওয়া হয়েছে। ওয়েব পরিষেবা হিসেবে Directions API বা Maps JavaScript API-তে দিকনির্দেশ পরিষেবা ব্যবহার করা অ্যাপ্লিকেশনের ক্ষেত্রে, সর্বাধিক ২৫টি ওয়েপয়েন্ট, সাথে শুরু ও গন্তব্যস্থল যোগ করা যাবে। -
MAX_ROUTE_LENGTH_EXCEEDED-এর অর্থ হল, অনুরোধ করা রুটটি অনেক দীর্ঘ এবং এটি প্রসেস করা যাবে না। আরও জটিল দিকনির্দেশ ফেরত দেওয়া হলে এই সমস্যা হয়। ওয়েপয়েন্ট, টার্ন বা নির্দেশের সংখ্যা কমিয়ে দেখুন। -
INVALID_REQUESTথেকে বোঝা যায় যে প্রদত্ত অনুরোধটি সঠিক ছিল না। এই স্ট্যাটাসের সাধারণ কারণের মধ্যে ভুল প্যারামিটার বা প্যারামিটারের মান অন্তর্ভুক্ত। -
OVER_DAILY_LIMITনিম্নলিখিত যেকোনও একটিকে নির্দেশ করে:- API কী নেই বা ভুল।
- আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
- ব্যবহারের ক্ষেত্রে নিজের উপর আরোপ করা সীমা অতিক্রম করা হয়েছে।
- প্রদান করা পেমেন্ট পদ্ধতি আর বৈধ নয় (যেমন, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
-
OVER_QUERY_LIMIT-এর অর্থ হল, অনুমোদিত সময়সীমার মধ্যে আপনার অ্যাপ্লিকেশন থেকে পরিষেবাটি অনেক বেশি অনুরোধ পেয়েছে। -
REQUEST_DENIEDথেকে বোঝা যায় যে আপনার অ্যাপ্লিকেশনকে দিকনির্দেশ পরিষেবা ব্যবহার করার অনুমতি দেওয়া হয়নি। -
UNKNOWN_ERROR-এর অর্থ হল, সার্ভারে সমস্যার কারণে দিকনির্দেশ সংক্রান্ত অনুরোধ প্রসেস করা যায়নি। আপনি আবার চেষ্টা করলে অনুরোধটি সফল হতে পারে।
DirectionsGeocodedWaypoint
| ফিল্ড | প্রয়োজনীয় | ধরন | বিবরণ |
|---|---|---|---|
|
ঐচ্ছিক | স্ট্রিং |
জিওকোডিং অপারেশনের ফলে পাওয়া স্ট্যাটাস কোড দেখায়। এই ফিল্ডে নিম্নলিখিত ভ্যালু থাকতে পারে।
The allowed values include:
OK, and
ZERO_RESULTS
|
|
ঐচ্ছিক |
এটি দেখায় যে জিওকোডার আসল অনুরোধের জন্য সম্পূর্ণ মিল খুঁজে পায়নি, যদিও এটি অনুরোধ করা ঠিকানার অংশ মেলাতে পেরেছে। আপনি হয়ত আসল অনুরোধে কোনও বানান ভুল এবং/অথবা অসম্পূর্ণ ঠিকানা আছে কিনা তা পরীক্ষা করে দেখতে চাইবেন। অনুরোধে উল্লেখ করা এলাকায় রাস্তার ঠিকানা না থাকলে, আংশিক মিলের ঘটনা সবচেয়ে বেশি ঘটে। কোনও অনুরোধ একই এলাকার দুই বা তার বেশি লোকেশনের সাথে মিলে গেলে আংশিক মিলও দেখানো হতে পারে। যেমন, "21 Henr St, Bristol, UK" লিখলে Henry Street এবং Henrietta Street, দুটির জন্যই আংশিক মিল দেখাবে। মনে রাখবেন যে অনুরোধে ঠিকানার কোনও অংশের বানান ভুল থাকলে, জিওকোডিং পরিষেবা বিকল্প ঠিকানা সাজেস্ট করতে পারে। এইভাবে ট্রিগার করা সাজেশনও আংশিক ম্যাচ হিসেবে চিহ্নিত করা হবে। |
|
|
ঐচ্ছিক | স্ট্রিং |
একটি অনন্য শনাক্তকারী যা অন্যান্য Google API-এর সাথে ব্যবহার করা যেতে পারে। প্লেস আইডি ওভারভিউ দেখুন। |
|
ঐচ্ছিক | Array<string> |
দিকনির্দেশ গণনা করার জন্য ব্যবহৃত জিওকোডিং ফলাফলের ঠিকানা ধরন নির্দেশ করে।
কোনও ধরনের খালি তালিকা থেকে বোঝা যায় যে নির্দিষ্ট ঠিকানা কম্পোনেন্টের জন্য কোনও পরিচিত ধরন নেই, যেমন, ফ্রান্সে লিউ-ডিট। |