দিকনির্দেশের উত্তর

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

এই প্রোডাক্ট পুরনো স্ট্যাটাসে আছে। অক্টোবর ২০২৬ থেকে, নতুন 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 &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</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 &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</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 দেখুন।

ঐচ্ছিক স্ট্রিং

পরিষেবাটি OK ছাড়া অন্য কোনও স্ট্যাটাস কোড রিটার্ন করলে, রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত error_message ফিল্ড থাকতে পারে। এই ফিল্ডে প্রদত্ত স্ট্যাটাস কোডের কারণ সম্পর্কে আরও বিস্তারিত তথ্য থাকে। এই ফিল্ড সবসময় ফেরত দেওয়া হয় না এবং এর কন্টেন্ট পরিবর্তন করা হতে পারে।

ঐচ্ছিক Array<DirectionsGeocodedWaypoint>

এতে অরিজিন, গন্তব্য ও ওয়েপয়েন্টের জিওকোডিং সম্পর্কে বিবরণ সহ একটি অ্যারে থাকে। geocoded_waypoints অ্যারের এলিমেন্টগুলি, তাদের শূন্য-ভিত্তিক অবস্থান অনুসারে, উৎস, নির্দিষ্ট করা ক্রমে ওয়েপয়েন্ট এবং গন্তব্যের সাথে মিলে যায়।

পরিষেবা কোনও ফলাফল না দেখালে, টেক্সট হিসেবে অক্ষাংশ/দ্রাঘিমাংশ ভ্যালু হিসেবে নির্দিষ্ট করা ওয়েপয়েন্টের জন্য এইসব বিবরণ দেখানো হবে না। কারণ, কোনও রুট খুঁজে পাওয়ার পরেই এই ধরনের ওয়েপয়েন্টের প্রতিনিধিত্বমূলক ঠিকানা পেতে রিভার্স জিওকোড করা হয়। একটি খালি JSON অবজেক্ট geocoded_waypoints অ্যারেতে সংশ্লিষ্ট জায়গা দখল করবে।

আরও তথ্যের জন্য DirectionsGeocodedWaypoint দেখুন।

DirectionsRoute

রুটে নেস্ট করা legs ও steps থাকে।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় সীমা

এতে overview_polyline-এর ভিউপোর্ট বাউন্ডিং বক্স রয়েছে।

আরও তথ্যের জন্য বাউন্ড দেখুন।

প্রয়োজনীয় স্ট্রিং

এই রুটের জন্য কপিরাইট সংক্রান্ত বিজ্ঞপ্তি দেখানোর জন্য এটিতে অন্তর্ভুক্ত করা হয়েছে। আপনাকে নিজে এই তথ্য ম্যানেজ করতে ও দেখাতে হবে। এই কন্টেন্টটি যেমন আছে তেমনই পড়তে হবে। শুধুমাত্র দেখানোর জন্য এই কন্টেন্ট প্রোগ্রাম্যাটিকভাবে পার্স করবেন না।

প্রয়োজনীয় Array<DirectionsLeg>

একটি অ্যারে যাতে রুটের একটি লেগ সম্পর্কে তথ্য থাকে, প্রদত্ত রুটের মধ্যে দুটি লোকেশনের মধ্যে। প্রতিটি নির্দিষ্ট করা ওয়েপয়েন্ট বা গন্তব্যের জন্য আলাদা লেগ উপস্থিত থাকবে। (কোনও ওয়েপয়েন্ট ছাড়া রুটে, লেগ অ্যারের মধ্যে ঠিক একটি লেগ থাকবে।) প্রতিটি পর্যায়ে একাধিক ধাপ থাকে।

আরও তথ্যের জন্য DirectionsLeg দেখুন।

প্রয়োজনীয় DirectionsPolyline

এতে এমন একটি অবজেক্ট থাকে যা রুটের এনকোড করা পলিলাইন রিপ্রেজেন্টেশন ধরে রাখে। এই পলিলাইন হল ফলাফল হিসেবে পাওয়া দিকনির্দেশের আনুমানিক (স্মুথ করা) পাথ।

আরও তথ্যের জন্য DirectionsPolyline দেখুন।

প্রয়োজনীয় স্ট্রিং

রুটের জন্য একটি সংক্ষিপ্ত টেক্সট বিবরণ রয়েছে, যা রুটের নাম এবং বিকল্প থেকে রুটকে আলাদা করার জন্য উপযুক্ত।

প্রয়োজনীয় Array<string>

এইসব দিকনির্দেশ দেখানোর সময়, দেখানোর জন্য সতর্কতার একটি অ্যারে থাকে। আপনাকে অবশ্যই এইসব সতর্কতা ম্যানেজ করতে ও দেখাতে হবে।

প্রয়োজনীয় Array<integer>

গণনা করা রুটে যেকোনও ওয়েপয়েন্টের ক্রম নির্দেশ করে এমন একটি অ্যারে। এই ওয়েপয়েন্ট পুনরায় সাজানো হতে পারে যদি অনুরোধটি তার ওয়েপয়েন্ট প্যারামিটারের মধ্যে optimize:true পাস করে থাকে।

ঐচ্ছিক ভাড়া

উপলভ্য থাকলে, এই রুটের মোট ভাড়া (অর্থাৎ, টিকিটের মোট খরচ) অন্তর্ভুক্ত থাকে। এই প্রপার্টি শুধুমাত্র ট্রানজিট অনুরোধের জন্য এবং শুধুমাত্র সেইসব রুটের জন্য ফেরত দেওয়া হয় যেখানে সমস্ত ট্রানজিট লেগের জন্য ভাড়ার তথ্য উপলভ্য।

আরও তথ্যের জন্য ভাড়া দেখুন।

বাউন্ডস

দক্ষিণ-পশ্চিম এবং উত্তর-পূর্ব কোণের বিন্দু থেকে ভৌগোলিক স্থানাঙ্কে একটি আয়তক্ষেত্র।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় LatLngLiteral আরও তথ্যের জন্য LatLngLiteral দেখুন।
প্রয়োজনীয় LatLngLiteral আরও তথ্যের জন্য LatLngLiteral দেখুন।

LatLngLiteral

দশমিক ডিগ্রিতে অক্ষাংশ এবং দ্রাঘিমাংশ সহ একটি নির্দিষ্ট লোকেশন বর্ণনা করে এমন একটি অবজেক্ট।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় নম্বর

দশমিক ডিগ্রিতে অক্ষাংশ

প্রয়োজনীয় নম্বর

দশমিক ডিগ্রিতে দ্রাঘিমাংশ

DirectionsLeg

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় স্ট্রিং

এই লেগের end_location-এর রিভার্স জিওকোডিং থেকে মানুষের-পঠনযোগ্য ঠিকানা (সাধারণত রাস্তার ঠিকানা) থাকে। এই কন্টেন্ট যেমন আছে তেমনই পড়তে হবে। ফর্ম্যাট করা ঠিকানা প্রোগ্রাম্যাটিক্যালি পার্স করবেন না।

প্রয়োজনীয় LatLngLiteral

এই লেগের প্রদত্ত গন্তব্যের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক। যেহেতু Directions API শুরু ও শেষ পয়েন্টে সবচেয়ে কাছের পরিবহনের বিকল্প (সাধারণত রাস্তা) ব্যবহার করে লোকেশনগুলির মধ্যে দিকনির্দেশ গণনা করে, end_location এই লেগের প্রদত্ত গন্তব্য থেকে আলাদা হতে পারে, যেমন, গন্তব্যের কাছাকাছি কোনও রাস্তা না থাকলে।

আরও তথ্যের জন্য LatLngLiteral দেখুন।

প্রয়োজনীয় স্ট্রিং

এই লেগের start_location-এর রিভার্স জিওকোডিং থেকে পাওয়া মানুষের-পঠনযোগ্য ঠিকানা (সাধারণত রাস্তার ঠিকানা) এতে থাকে। এই কন্টেন্ট যেমন আছে তেমনভাবেই পড়তে হবে। ফর্ম্যাট করা ঠিকানা প্রোগ্রাম্যাটিক্যালি পার্স করবেন না।

প্রয়োজনীয় LatLngLiteral

এই লেগের উৎসের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক। Directions API শুরু ও শেষ পয়েন্টে সবচেয়ে কাছের পরিবহনের বিকল্প (সাধারণত রাস্তা) ব্যবহার করে লোকেশনগুলির মধ্যে দিকনির্দেশ গণনা করে, তাই start_location এই লেগের প্রদত্ত উৎসের থেকে আলাদা হতে পারে, যেমন, কোনও রাস্তা যদি উৎসের কাছাকাছি না থাকে।

আরও তথ্যের জন্য LatLngLiteral দেখুন।

প্রয়োজনীয় Array<DirectionsStep>

সফরের প্রতিটি আলাদা ধাপের তথ্য উল্লেখ করে এমন ধাপের অ্যারে।

আরও তথ্যের জন্য DirectionsStep দেখুন।

traffic_speed_entry

ঐচ্ছিক Array<DirectionsTrafficSpeedEntry>

লেগ বরাবর ট্রাফিক স্পিড সম্পর্কিত তথ্য।

আরও তথ্যের জন্য DirectionsTrafficSpeedEntry দেখুন।

প্রয়োজনীয় Array<DirectionsViaWaypoint>

এই লেগ বরাবর ভায়া ওয়েপয়েন্টের লোকেশন।

আরও তথ্যের জন্য DirectionsViaWaypoint দেখুন।

ঐচ্ছিক TimeZoneTextValueObject

এই ট্রানজিট লাইনের জন্য পৌঁছানোর আনুমানিক সময় অন্তর্ভুক্ত করে। এই প্রপার্টি শুধুমাত্র ট্রানজিটের দিকনির্দেশের জন্য ফেরত দেওয়া হয়।

আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন।

ঐচ্ছিক TimeZoneTextValueObject

এই লেগের জন্য আনুমানিক ছাড়ার সময় থাকে, যা টাইম অবজেক্ট হিসেবে নির্দিষ্ট করা হয়। departure_time শুধুমাত্র ট্রানজিটের দিকনির্দেশের জন্য উপলভ্য।

আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন।

ঐচ্ছিক TextValueObject

এই লেগের মাধ্যমে কভার করা মোট দূরত্ব।

আরও তথ্যের জন্য TextValueObject দেখুন।

ঐচ্ছিক TextValueObject

এই লেগের মোট সময়সীমা।

আরও তথ্যের জন্য TextValueObject দেখুন।

ঐচ্ছিক TextValueObject

এই লেগের মোট সময়সীমা দেখায়। এই মানটি বর্তমান এবং ঐতিহাসিক ট্রাফিক অবস্থার উপর ভিত্তি করে ট্রাফিকের সময়ের একটি অনুমান। আপনি যে বিকল্পগুলি ব্যবহার করে অনুরোধ করতে পারেন তার জন্য traffic_model অনুরোধ প্যারামিটার দেখুন, যাতে ফেরত আসা মানটি আশাবাদী, হতাশাবাদী বা সেরা-অনুমান অনুমান হয়। ট্রাফিকের মধ্যে সময়কাল তখনই দেখানো হয় যখন নিম্নলিখিত সবকটি শর্ত পূরণ হয়:

  • অনুরোধে স্টপওভার ওয়েপয়েন্ট অন্তর্ভুক্ত নেই। অনুরোধে ওয়েপয়েন্ট থাকলে, স্টপওভার এড়াতে সেগুলির আগে via: থাকতে হবে।
  • অনুরোধটি বিশেষভাবে গাড়ি চালানোর দিকনির্দেশের জন্য—মোড প্যারামিটারটি driving-এ সেট করা আছে।
  • অনুরোধে departure_time প্যারামিটার অন্তর্ভুক্ত আছে।
  • অনুরোধ করা রুটের জন্য ট্রাফিক শর্তাবলী উপলভ্য।

আরও তথ্যের জন্য 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

ভ্রমণের মোড transit হলে, এই ধাপ সম্পর্কিত বিবরণ।

আরও তথ্যের জন্য DirectionsTransitDetails দেখুন।

TextValueObject

একটি অবজেক্ট যাতে একটি সংখ্যাসূচক মান এবং এর ফর্ম্যাট করা টেক্সট উপস্থাপনা রয়েছে।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় স্ট্রিং

স্ট্রিং ভ্যালু।

প্রয়োজনীয় নম্বর

সাংখ্যিক মান।

DirectionsPolyline

পলিলাইন এনকোডিং হল একটি লসি কম্প্রেশন অ্যালগরিদম যা আপনাকে একটি স্ট্রিং হিসেবে একাধিক স্থানাঙ্ক স্টোর করতে দেয়। চিহ্নিত ভ্যালু ব্যবহার করে পয়েন্ট কোঅর্ডিনেট এনকোড করা হয়। আপনার কাছে মাত্র কয়েকটি স্ট্যাটিক পয়েন্ট থাকলে, আপনি ইন্টার‍্যাক্টিভ পলিলাইন এনকোডিং ইউটিলিটিও ব্যবহার করতে পারেন।

এনকোডিং প্রসেস পরিচিত base64 এনকোডিং স্কিম ব্যবহার করে ASCII অক্ষরের জন্য বাইনারি ভ্যালুকে অক্ষর কোডের সিরিজে কনভার্ট করে: এইসব অক্ষর যাতে সঠিকভাবে দেখানো যায় তা নিশ্চিত করতে, এনকোড করা ভ্যালু ASCII-তে কনভার্ট করার আগে ৬৩ (ASCII অক্ষর '?') যোগ করা হয়। এছাড়াও, অ্যালগরিদম প্রতিটি বাইট গ্রুপের সবচেয়ে কম গুরুত্বপূর্ণ বিট চেক করে কোনও নির্দিষ্ট পয়েন্টের জন্য অতিরিক্ত ক্যারেক্টার কোড চেক করে; এই বিট ১-এ সেট করা থাকলে, পয়েন্টটি এখনও সম্পূর্ণভাবে তৈরি হয়নি এবং অতিরিক্ত ডেটা অবশ্যই ফলো করতে হবে।

এছাড়াও, জায়গা বাঁচাতে, পয়েন্টে শুধুমাত্র আগের পয়েন্ট থেকে অফসেট অন্তর্ভুক্ত থাকে (অবশ্যই প্রথম পয়েন্ট ছাড়া)। সব পয়েন্ট Base64-এ সাইন করা পূর্ণসংখ্যা হিসেবে এনকোড করা হয়, কারণ অক্ষাংশ ও দ্রাঘিমাংশ সাইন করা ভ্যালু। একটি পলিলাইনের মধ্যে এনকোডিং ফর্ম্যাটকে দুটি স্থানাঙ্ক উপস্থাপন করতে হবে যা যুক্তিসঙ্গত নির্ভুলতার সাথে অক্ষাংশ এবং দ্রাঘিমাংশ উপস্থাপন করে। সর্বাধিক +/- ১৮০ ডিগ্রি দ্রাঘিমাংশ ৫ দশমিক স্থান (১৮০.০০০০০ থেকে -১৮০.০০০০০) পর্যন্ত নির্ভুলভাবে দেখানোর জন্য, ৩২ বিট সাইনড বাইনারি ইন্টিজার ভ্যালু প্রয়োজন।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় স্ট্রিং

পলিলাইনের একটি স্ট্রিং উপস্থাপনা।

TravelMode

  • DRIVING (ডিফল্ট) রোড নেটওয়ার্ক ব্যবহার করে গণনা করাকে বোঝায়।
  • BICYCLING সাইকেল চালানোর রাস্তা ও পছন্দের রাস্তা (যেখানে উপলভ্য) ব্যবহার করে সাইকেল চালানোর জন্য হিসাব করার অনুরোধ করে।
  • TRANSIT পাবলিক ট্রানজিট রুট (যেখানে উপলভ্য) ব্যবহার করে গণনা করার অনুরোধ করে।
  • WALKING পথচারীদের রাস্তা ও ফুটপাথ (যেখানে উপলভ্য) ব্যবহার করে হাঁটার জন্য হিসাব করার অনুরোধ করে।

DirectionsTransitDetails

অতিরিক্ত তথ্য যা পরিবহনের অন্যান্য মোডের জন্য প্রাসঙ্গিক নয়।

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
ঐচ্ছিক DirectionsTransitStop

পৌঁছানোর ট্রানজিট স্টপ।

আরও তথ্যের জন্য DirectionsTransitStop দেখুন।

ঐচ্ছিক TimeZoneTextValueObject আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন।
ঐচ্ছিক DirectionsTransitStop

ট্রানজিট স্টপ থেকে রওনা হওয়ার সময়।

আরও তথ্যের জন্য DirectionsTransitStop দেখুন।

ঐচ্ছিক TimeZoneTextValueObject আরও তথ্যের জন্য TimeZoneTextValueObject দেখুন।
ঐচ্ছিক স্ট্রিং

এই লাইনে কোন দিকে যেতে হবে তা উল্লেখ করে, যেমনটি গাড়িতে বা ছাড়ার স্টপে চিহ্নিত করা আছে। এটি প্রায়শই টার্মিনাস স্টেশন হবে।

ঐচ্ছিক পূর্ণসংখ্যা

এই সময়ে একই স্টপ থেকে ছাড়ার মধ্যে প্রত্যাশিত সেকেন্ডের সংখ্যা নির্দিষ্ট করে। যেমন, headway-এর ভ্যালু ৬০০ হলে, বাস মিস করলে আপনাকে দশ মিনিট অপেক্ষা করতে হবে।

ঐচ্ছিক DirectionsTransitLine

এই ধাপে ব্যবহার করা ট্রানজিট লাইন সম্পর্কে তথ্য থাকে।

আরও তথ্যের জন্য DirectionsTransitLine দেখুন।

ঐচ্ছিক পূর্ণসংখ্যা

ছেড়ে যাওয়ার স্টপ থেকে গন্তব্যে পৌঁছানোর স্টপের মধ্যে যতগুলি স্টপ আছে। এর মধ্যে পৌঁছানোর স্টপ অন্তর্ভুক্ত, কিন্তু প্রস্থানের স্টপ নয়। যেমন, আপনার দিকনির্দেশে যদি স্টপ A থেকে রওনা হয়ে, স্টপ B ও C পেরিয়ে স্টপ D-তে পৌঁছানোর কথা বলা হয়, তাহলে num_stops-এর মান হবে ৩।

ঐচ্ছিক স্ট্রিং

যাত্রীদের ট্রানজিট ট্রিপ শনাক্ত করার জন্য শিডিউল এবং সাইনবোর্ডে যে টেক্সট দেখানো হয়। পরিষেবা প্রদানকারী দিনের মধ্যে টেক্সটটি অনন্যভাবে একটি ট্রিপ শনাক্ত করতে হবে। যেমন, "538" হল Amtrak ট্রেনের trip_short_name যা সপ্তাহের কাজের দিনে ১৫:১০-এ ক্যালিফোর্নিয়ার সান জোসে থেকে ক্যালিফোর্নিয়ার স্যাক্রামেন্টোর উদ্দেশ্যে রওনা দেয়।

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

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় স্ট্রিং

এই গাড়ির নাম, বড় হাতের অক্ষরে।

প্রয়োজনীয় স্ট্রিং

যে ধরনের গাড়ি ব্যবহার করা হয়েছে।

  • BUS - বাস।
  • CABLE_CAR - কেবেলের সাহায্যে চলে এমন গাড়ি, সাধারণত মাটিতে চলে। আকাশপথে চলাচলকারী কেবেল কার GONDOLA_LIFT ধরনের হতে পারে।
  • COMMUTER_TRAIN - কমিউটার রেল।
  • FERRY - ফেরি।
  • FUNICULAR - একটি গাড়ি যা কেবেলের মাধ্যমে খাড়া ঢাল বেয়ে উপরে তোলা হয়। একটি ফিউনিকুলারে সাধারণত দুটি গাড়ি থাকে, যার প্রতিটি গাড়ি অন্যটির জন্য কাউন্টারওয়েট হিসেবে কাজ করে।
  • GONDOLA_LIFT - একটি এরিয়াল কেবেল কার।
  • HEAVY_RAIL - হেভি রেল।
  • HIGH_SPEED_TRAIN - হাই স্পিড ট্রেন।
  • INTERCITY_BUS - ইন্টারসিটি বাস।
  • LONG_DISTANCE_TRAIN - দূরপাল্লার ট্রেন।
  • METRO_RAIL - লাইট রেল ট্রানজিট।
  • MONORAIL - Monorail.
  • OTHER - অন্য সব গাড়ি এই ধরনের রিটার্ন করবে।
  • RAIL - রেল।
  • SHARE_TAXI - শেয়ার ট্যাক্সি হল এক ধরনের বাস যা রুটের যেকোনও জায়গায় যাত্রী তুলতে ও নামাতে পারে।
  • SUBWAY - আন্ডারগ্রাউন্ড লাইট রেল।
  • TRAM - মাটির উপরে লাইট রেল।
  • TROLLEYBUS - ট্রলিবাস।
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 কী নেই বা ভুল।
    • আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
    • ব্যবহারের ক্ষেত্রে নিজের উপর আরোপ করা সীমা অতিক্রম করা হয়েছে।
    • প্রদান করা পেমেন্ট পদ্ধতি আর বৈধ নয় (যেমন, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
    এটি কীভাবে ঠিক করবেন তা জানতে Maps-এর প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।
  • 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>

দিকনির্দেশ গণনা করার জন্য ব্যবহৃত জিওকোডিং ফলাফলের ঠিকানা ধরন নির্দেশ করে।

  • administrative_area_level_1 দেশের নিচে প্রথম-ক্রমের সিভিল এন্টিটি নির্দেশ করে। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক লেভেলগুলি হল রাজ্য। সব দেশে এই প্রশাসনিক লেভেল থাকে না। বেশিরভাগ ক্ষেত্রে, administrative_area_level_1-এর ছোট নাম ISO 3166-2 সাবডিভিশন এবং অন্যান্য ব্যাপকভাবে প্রচারিত তালিকার সাথে ঘনিষ্ঠভাবে মিলবে; তবে এর কোনও গ্যারেন্টি নেই কারণ আমাদের জিওকোডিং ফলাফল বিভিন্ন ধরনের সিগন্যাল এবং লোকেশন ডেটার উপর ভিত্তি করে তৈরি।
  • administrative_area_level_2 দেশের লেভেলের নিচে দ্বিতীয়-ক্রমের সিভিল এন্টিটি নির্দেশ করে। মার্কিন যুক্তরাষ্ট্রের মধ্যে, এই প্রশাসনিক লেভেলগুলি হল কাউন্টি। সব দেশে এই প্রশাসনিক স্তর থাকে না।
  • administrative_area_level_3 দেশের লেভেলের নিচে তৃতীয়-ক্রমের সিভিল এন্টিটি নির্দেশ করে। এই ধরনটি একটি ছোট সিভিল ডিভিশন নির্দেশ করে। সব দেশে এই ধরনের প্রশাসনিক লেভেল থাকে না।
  • administrative_area_level_4 দেশের লেভেলের নিচে চতুর্থ-ক্রমের সিভিল এন্টিটি নির্দেশ করে। এই ধরনটি একটি ছোট সিভিল ডিভিশনকে নির্দেশ করে। সব দেশে এই ধরনের প্রশাসনিক লেভেল থাকে না।
  • administrative_area_level_5 দেশের লেভেলের নিচে পঞ্চম-অর্ডার সিভিল এন্টিটি নির্দেশ করে। এই ধরনটি একটি ছোট সিভিল ডিভিশন নির্দেশ করে। সব দেশে এই ধরনের প্রশাসনিক লেভেল থাকে না।
  • airport বিমানবন্দরকে নির্দেশ করে।
  • colloquial_area এন্টিটির জন্য সাধারণত ব্যবহৃত বিকল্প নাম নির্দেশ করে।
  • country জাতীয় রাজনৈতিক এন্টিটি নির্দেশ করে এবং সাধারণত এটি জিওকোডারের মাধ্যমে রিটার্ন করা সর্বোচ্চ অর্ডার টাইপ।
  • intersection একটি প্রধান ইন্টারসেকশনকে নির্দেশ করে, সাধারণত দুটি প্রধান রাস্তার।
  • locality একটি অন্তর্ভুক্ত শহর বা টাউন রাজনৈতিক এন্টিটি নির্দেশ করে।
  • natural_feature একটি বিশিষ্ট প্রাকৃতিক বৈশিষ্ট্য নির্দেশ করে।
  • neighborhood একটি নামযুক্ত প্রতিবেশী নির্দেশ করে
  • park নাম সহ পার্ক নির্দেশ করে।
  • plus_code অক্ষাংশ ও দ্রাঘিমাংশ থেকে পাওয়া এনকোড করা লোকেশন রেফারেন্স নির্দেশ করে। যেসব জায়গায় রাস্তার ঠিকানা নেই (যেখানে বিল্ডিংয়ের নম্বর বা রাস্তার নাম নেই), সেখানে রাস্তার ঠিকানার পরিবর্তে Plus Code ব্যবহার করা যেতে পারে। আরও তথ্যের জন্য https://plus.codes দেখুন।
  • point_of_interest কোনও উল্লেখযোগ্য স্থানের নাম নির্দেশ করে। সাধারণত, এই "POI" হল বিশিষ্ট স্থানীয় এন্টিটি যা অন্য কোনও বিভাগে সহজে ফিট করে না, যেমন "এম্পায়ার স্টেট বিল্ডিং" বা "আইফেল টাওয়ার"।
  • political রাজনৈতিক এন্টিটি নির্দেশ করে। সাধারণত, এই ধরনের জায়গা কোনও সিভিল অ্যাডমিনিস্ট্রেশনের পলিগনকে বোঝায়।
  • postal_code দেশের মধ্যে ডাকযোগে চিঠি পাঠানোর জন্য ব্যবহৃত পোস্টাল কোডকে চিহ্নিত করে।
  • premise কোনও নামযুক্ত লোকেশনকে নির্দেশ করে, সাধারণত কোনও বিল্ডিং বা একই নামে পরিচিত বিল্ডিংয়ের সমষ্টি
  • route কোনও নামযুক্ত রুট (যেমন, "US 101") নির্দেশ করে।
  • street_address রাস্তার সুনির্দিষ্ট ঠিকানা নির্দেশ করে।
  • sublocality কোনও লোকালিটির নিচে প্রথম-অর্ডার সিভিল এন্টিটি নির্দেশ করে। কিছু লোকেশন অতিরিক্ত ধরনের একটি পেতে পারে: sublocality_level_1 থেকে sublocality_level_5। প্রতিটি সাব-লোকালিটি লেভেল হল একটি সিভিল এন্টিটি। বড় সংখ্যা ছোট ভৌগোলিক অঞ্চল নির্দেশ করে।
  • subpremise কোনও নামযুক্ত লোকেশনের নিচে ফার্স্ট-অর্ডার এন্টিটি নির্দেশ করে, সাধারণত সাধারণ নাম সহ বিল্ডিংয়ের সংগ্রহের মধ্যে একটি একক বিল্ডিং
  • tourist_attraction পর্যটকদের জন্য আকর্ষণীয় স্থান নির্দেশ করে।
  • train_station দিয়ে ট্রেন স্টেশন বোঝানো হয়।
  • transit_station ট্রানজিট স্টেশনকে নির্দেশ করে।

কোনও ধরনের খালি তালিকা থেকে বোঝা যায় যে নির্দিষ্ট ঠিকানা কম্পোনেন্টের জন্য কোনও পরিচিত ধরন নেই, যেমন, ফ্রান্সে লিউ-ডিট।