স্বয়ংসম্পূর্ণ প্রশ্ন (উত্তরাধিকার)

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

টেক্সট-ভিত্তিক ভৌগোলিক অনুসন্ধানের জন্য কোয়েরি অটোকমপ্লিট (লেগ্যাসি) ব্যবহার করে কোয়েরি প্রেডিকশন বা পূর্বাভাস পাওয়া যায়, যা আপনার টাইপ করার সাথে সাথে সাজেস্টেড কোয়েরি প্রদর্শন করে।

কোয়েরি অটোকমপ্লিট (লেগ্যাসি) অনুরোধ

কোয়েরি অটোকমপ্লিট (লেগ্যাসি) হলো প্লেসেস এপিআই (লেগ্যাসি)-এর একটি অংশ এবং এটি প্লেসেস এপিআই (লেগ্যাসি)-এর সাথে একটি এপিআই কী ও কোটা শেয়ার করে।

কোয়েরি অটোকমপ্লিট (লেগ্যাসি) আপনাকে আপনার অ্যাপ্লিকেশনে তাৎক্ষণিক ভৌগোলিক কোয়েরি প্রেডিকশন যোগ করার সুযোগ দেয়। কোনো নির্দিষ্ট অবস্থান খোঁজার পরিবর্তে, একজন ব্যবহারকারী "পিজ্জা নিয়ার নিউ ইয়র্ক"-এর মতো একটি ক্যাটাগরিক্যাল সার্চ টাইপ করতে পারেন এবং সার্ভিসটি সেই স্ট্রিংটির সাথে মিলে যাওয়া সাজেস্ট করা কোয়েরির একটি তালিকা দিয়ে সাড়া দেয়। যেহেতু কোয়েরি অটোকমপ্লিট (লেগ্যাসি) সম্পূর্ণ শব্দ এবং সাবস্ট্রিং উভয়ের সাথেই মেলাতে পারে, তাই অ্যাপ্লিকেশনগুলো ব্যবহারকারীর টাইপ করার সাথে সাথেই কোয়েরি পাঠিয়ে তাৎক্ষণিক প্রেডিকশন প্রদান করতে পারে।

একটি কোয়েরি অটোকমপ্লিট (লেগ্যাসি) অনুরোধ হলো নিম্নলিখিত ফর্মের একটি HTTP URL:

https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters

যেখানে output json অথবা xml হতে পারে।

একটি কোয়েরি অটোকমপ্লিট (লেগ্যাসি) অনুরোধ শুরু করার জন্য নির্দিষ্ট কিছু প্যারামিটার প্রয়োজন হয়। ইউআরএল-এর প্রচলিত রীতি অনুযায়ী, সমস্ত প্যারামিটার অ্যামপারস্যান্ড ( & ) চিহ্ন দিয়ে আলাদা করা হয়। প্যারামিটার এবং তাদের সম্ভাব্য মানগুলির তালিকা নিচে দেওয়া হলো।

প্রয়োজনীয় প্যারামিটার

  • ইনপুট

    যে টেক্সট স্ট্রিংটির উপর ভিত্তি করে অনুসন্ধান করা হবে। প্লেস অটোকমপ্লিট সার্ভিসটি এই স্ট্রিংটির উপর ভিত্তি করে সম্ভাব্য ম্যাচগুলো ফেরত দেবে এবং ফলাফলগুলোকে তাদের অনুভূত প্রাসঙ্গিকতা অনুসারে সাজাবে।

ঐচ্ছিক পরামিতি

  • ভাষা

    যে ভাষায় ফলাফল ফেরত দেওয়া হয়।

    • সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
    • যদি language সরবরাহ করা না হয়, তাহলে API-টি Accept-Language হেডারে নির্দিষ্ট করা পছন্দের ভাষাটি ব্যবহার করার চেষ্টা করে।
    • এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
    • পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
    • এপিআই যে ফলাফলগুলো ফেরত দেবে এবং সেগুলো যে ক্রমে ফেরত আসবে, তার ওপর পছন্দের ভাষার সামান্য প্রভাব রয়েছে। জিওকোডার ভাষার ওপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারভেদের সংক্ষিপ্ত রূপ, অথবা এমন সমার্থক শব্দ যা একটি ভাষায় বৈধ হলেও অন্যটিতে নয়। উদাহরণস্বরূপ, হাঙ্গেরীয় ভাষায় 'utca' এবং 'tér' হলো রাস্তার সমার্থক শব্দ।

  • অবস্থান

    latitude,longitude স্থানাঙ্ক হিসেবে একটি বিন্দু নির্ধারণ করে, যার চারপাশে অনুসন্ধান করা হবে। প্লেসেস পরিষেবাটি location এবং radius দ্বারা সংজ্ঞায়িত এলাকার মধ্যে ফলাফল দেখানোর জন্য অনুসন্ধানকে প্রভাবিত করতে অবস্থানটি ব্যবহার করে; সংজ্ঞায়িত এলাকার বাইরের ফলাফলও প্রদর্শিত হতে পারে।

    query যদি Market in Barcelona মতো কোনো সুস্পষ্ট অবস্থান থাকে, তাহলে location প্যারামিটারটি ওভাররাইড করা যেতে পারে। কোয়েরির চারপাশে উদ্ধৃতি চিহ্ন ব্যবহার করলে তা location এবং radius দেওয়া গুরুত্বকেও প্রভাবিত করতে পারে।

  • অফসেট

    ইনপুট টার্মের মধ্যে থাকা শেষ অক্ষরের অবস্থান, যা সার্ভিসটি প্রেডিকশন মেলানোর জন্য ব্যবহার করে। উদাহরণস্বরূপ, যদি ইনপুটটি Google হয় এবং অফসেট ৩ হয়, তাহলে সার্ভিসটি Goo এর সাথে মেলাবে। অফসেট দ্বারা নির্ধারিত স্ট্রিংটি শুধুমাত্র ইনপুট টার্মের প্রথম শব্দের সাথে মেলানো হয়। উদাহরণস্বরূপ, যদি ইনপুট টার্মটি Google abc হয় এবং অফসেট ৩ হয়, তাহলে সার্ভিসটি Goo abc সাথে মেলানোর চেষ্টা করবে। যদি কোনো অফসেট সরবরাহ করা না হয়, তাহলে সার্ভিসটি সম্পূর্ণ টার্মটি ব্যবহার করবে। অফসেটটি সাধারণত টেক্সট ক্যারেটের অবস্থানে সেট করা উচিত।

  • ব্যাসার্ধ

    স্থান সম্পর্কিত ফলাফল প্রদর্শনের জন্য দূরত্ব (মিটারে) নির্ধারণ করে। আপনি একটি location এবং একটি radius প্যারামিটার পাস করে ফলাফলকে একটি নির্দিষ্ট বৃত্তের মধ্যে সীমাবদ্ধ রাখতে পারেন। এটি করলে প্লেসেস সার্ভিসকে সেই বৃত্তের মধ্যে ফলাফল দেখাতে অগ্রাধিকার দেওয়ার নির্দেশ দেওয়া হয়; নির্ধারিত এলাকার বাইরের ফলাফলও প্রদর্শিত হতে পারে।

    অনুসন্ধানের ধরন এবং অন্যান্য প্যারামিটারের উপর নির্ভর করে ব্যাসার্ধটি স্বয়ংক্রিয়ভাবে একটি সর্বোচ্চ মানে সীমাবদ্ধ থাকবে।

    • স্বয়ংক্রিয় পূরণ: ৫০,০০০ মিটার
    • কাছাকাছি অনুসন্ধান:
      • keyword বা name সহ: ৫০,০০০ মিটার
      • keyword বা name ছাড়া
        • ৫০,০০০ মিটার পর্যন্ত, যা rankby প্যারামিটার নির্বিশেষে, এলাকার ঘনত্বের উপর ভিত্তি করে গতিশীলভাবে সমন্বয় করা হয়।
        • rankby=distance ব্যবহার করার সময়, radius প্যারামিটারটি গৃহীত হবে না এবং এর ফলে একটি INVALID_REQUEST দেখা দেবে।
    • কোয়েরি অটোকমপ্লিট: ৫০,০০০ মিটার
    • পাঠ্য অনুসন্ধান: ৫০,০০০ মিটার

কোয়েরি অটোকমপ্লিট (লেগ্যাসি) উদাহরণ

ইউআরএল 

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

কার্ল 

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

"Pizza near Par" অনুরোধটির ফলাফল ফরাসি ভাষায়:

ইউআরএল 

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &language=fr
  &key=YOUR_API_KEY

কার্ল 

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'

মনে রাখবেন, এই উদাহরণগুলিতে থাকা API কী-টি আপনাকে আপনার নিজের কী দিয়ে প্রতিস্থাপন করতে হবে।

কোয়েরি অটোকমপ্লিট (লেগ্যাসি) প্রতিক্রিয়া

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

ইউআরএল 

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

কার্ল 

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

JSON 

{
  "predictions":
    [
      {
        "description": "pizza near Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris" },
            { "offset": 18, "value": "France" },
          ],
      },
      {
        "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Pari Chowk" },
            { "offset": 23, "value": "NRI City" },
            { "offset": 33, "value": "Omega II" },
            { "offset": 43, "value": "Noida" },
            { "offset": 50, "value": "Uttar Pradesh" },
            { "offset": 65, "value": "India" },
          ],
      },
      {
        "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 16 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Disneyland Park" },
            { "offset": 28, "value": "Disneyland Drive" },
            { "offset": 46, "value": "Anaheim" },
            { "offset": 55, "value": "CA" },
            { "offset": 59, "value": "USA" },
          ],
      },
      {
        "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 30 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" },
            { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" },
            { "offset": 83, "value": "Paris" },
            { "offset": 90, "value": "France" },
          ],
      },
      {
        "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris Beauvais Airport" },
            { "offset": 35, "value": "Route de l'Aéroport" },
            { "offset": 56, "value": "Tillé" },
            { "offset": 63, "value": "France" },
          ],
      },
    ],
  "status": "OK",
}

এক্সএমএল 

      
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>pizza near Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>France</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Pari Chowk</value>
   <offset>11</offset>
  </term>
  <term>
   <value>NRI City</value>
   <offset>23</offset>
  </term>
  <term>
   <value>Omega II</value>
   <offset>33</offset>
  </term>
  <term>
   <value>Noida</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Uttar Pradesh</value>
   <offset>50</offset>
  </term>
  <term>
   <value>India</value>
   <offset>65</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Disneyland Park</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Disneyland Drive</value>
   <offset>28</offset>
  </term>
  <term>
   <value>Anaheim</value>
   <offset>46</offset>
  </term>
  <term>
   <value>CA</value>
   <offset>55</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>59</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>22</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>16</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Cathédrale Notre-Dame de Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Parvis Notre-Dame - place Jean-Paul-II</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>83</offset>
  </term>
  <term>
   <value>France</value>
   <offset>90</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>36</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>30</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris Beauvais Airport</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Route de l'Aéroport</value>
   <offset>35</offset>
  </term>
  <term>
   <value>Tillé</value>
   <offset>56</offset>
  </term>
  <term>
   <value>France</value>
   <offset>63</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

প্লেসেস সার্ভিস যখন কোনো সার্চ থেকে JSON রেজাল্ট রিটার্ন করে, তখন সেগুলোকে একটি predictions অ্যারের মধ্যে রাখে। সার্ভিসটি কোনো রেজাল্ট রিটার্ন না করলেও (যেমন location প্রত্যন্ত হলে) এটি একটি খালি predictions অ্যারে রিটার্ন করে। XML রেসপন্সগুলোতে শূন্য বা তার বেশি সংখ্যক <prediction> এলিমেন্ট থাকে।

স্থান অনুসন্ধানের স্বয়ংক্রিয় প্রতিক্রিয়া

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় অ্যারে< PlaceAutocompletePrediction >

এতে একাধিক পূর্বাভাস রয়েছে।

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

প্রয়োজনীয় স্থানগুলি স্বয়ংক্রিয়ভাবে সম্পূর্ণ হওয়ার অবস্থা

এতে অনুরোধের অবস্থা থাকে এবং অনুরোধটি কেন ব্যর্থ হয়েছে তা খুঁজে বের করতে সাহায্য করার জন্য ডিবাগিং তথ্যও থাকতে পারে।

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

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

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

ঐচ্ছিক অ্যারে<স্ট্রিং>

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

স্থানগুলি স্বয়ংক্রিয়ভাবে সম্পূর্ণ হওয়ার অবস্থা

পরিষেবা দ্বারা ফেরত দেওয়া স্ট্যাটাস কোড।

  • OK নির্দেশ করে যে এপিআই অনুরোধটি সফল হয়েছে।
  • ZERO_RESULTS নির্দেশ করে যে অনুসন্ধান সফল হয়েছে কিন্তু কোনো ফলাফল পাওয়া যায়নি। এটি ঘটতে পারে যদি অনুসন্ধানের জন্য কোনো দূরবর্তী স্থানের সীমানা নির্ধারণ করে দেওয়া হয়।
  • INVALID_REQUEST নির্দেশ করে যে এপিআই অনুরোধটি ত্রুটিপূর্ণ ছিল, যা সাধারণত input প্যারামিটার অনুপস্থিত থাকার কারণে ঘটে থাকে।
  • OVER_QUERY_LIMIT নিম্নলিখিত যেকোনো একটি নির্দেশ করে:
    • আপনি QPS সীমা অতিক্রম করেছেন।
    • আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
    • মাসিক ২০০ ডলারের ক্রেডিট, বা স্বেচ্ছায় নির্ধারিত ব্যবহারের সীমা, অতিক্রম করা হয়েছে।
    • প্রদত্ত অর্থপ্রদানের পদ্ধতিটি আর বৈধ নয় (উদাহরণস্বরূপ, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
    এই ত্রুটিটি কীভাবে সমাধান করা যায় সে সম্পর্কে আরও তথ্যের জন্য মানচিত্রের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQ) দেখুন।
  • REQUEST_DENIED নির্দেশ করে যে আপনার অনুরোধটি প্রত্যাখ্যান করা হয়েছে, সাধারণত নিম্নলিখিত কারণে:
    • অনুরোধটিতে একটি এপিআই কী নেই।
    • key প্যারামিটারটি অবৈধ।
  • UNKNOWN_ERROR একটি অজানা ত্রুটি নির্দেশ করে।

প্লেসেস সার্ভিস যখন কোনো সার্চ থেকে JSON রেজাল্ট রিটার্ন করে, তখন সেগুলোকে একটি predictions অ্যারের মধ্যে রাখে। সার্ভিসটি কোনো রেজাল্ট রিটার্ন না করলেও (যেমন location প্রত্যন্ত হলে) এটি একটি খালি predictions অ্যারে রিটার্ন করে। XML রেসপন্সগুলোতে শূন্য বা তার বেশি সংখ্যক <prediction> এলিমেন্ট থাকে।

PlaceAutocompletePrediction

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় স্ট্রিং

ফেরত আসা ফলাফলের পাঠযোগ্য নাম এতে থাকে। establishment ফলাফলের ক্ষেত্রে, এটি সাধারণত ব্যবসার নাম হয়ে থাকে। এই বিষয়বস্তুটি হুবহু পড়ার জন্য। প্রোগ্রামগতভাবে এই ফরম্যাট করা ঠিকানাটি পার্স করবেন না।

প্রয়োজনীয় অ্যারে< PlaceAutocompleteMatchedSubstring >

সাবস্ট্রিংগুলির একটি তালিকা যা ভবিষ্যদ্বাণীর ফলাফলের টেক্সটে প্রবেশ করানো টার্মটির অবস্থান বর্ণনা করে, যাতে প্রয়োজন অনুযায়ী টার্মটিকে হাইলাইট করা যায়।

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

প্রয়োজনীয় PlaceAutocompleteStructured Format

পূর্ব-ফরম্যাট করা টেক্সট প্রদান করে যা আপনার অটোকমপ্লিট ফলাফলে দেখানো যেতে পারে। এই কন্টেন্টটি হুবহু পড়ার জন্য। প্রোগ্রামগতভাবে ফরম্যাট করা ঠিকানাটি পার্স করবেন না।

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

প্রয়োজনীয় অ্যারে< PlaceAutocompleteTerm >

ফেরত আসা বিবরণের প্রতিটি অংশকে শনাক্তকারী পদগুলোর একটি অ্যারে এতে থাকে (বিবরণের একটি অংশ সাধারণত একটি কমা দিয়ে শেষ হয়)। অ্যারের প্রতিটি এন্ট্রিতে একটি value ফিল্ড থাকে, যেখানে পদটির টেক্সট থাকে, এবং একটি offset ফিল্ড থাকে, যা ইউনিকোড ক্যারেক্টারে পরিমাপ করা বিবরণে এই পদটির শুরুর অবস্থান নির্ধারণ করে।

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

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

মূলবিন্দু থেকে সরলরৈখিক দূরত্ব মিটারে। এই ক্ষেত্রটি শুধুমাত্র origin সহ করা অনুরোধের জন্য ফেরত দেওয়া হয়।

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

একটি পাঠ্য শনাক্তকারী যা একটি স্থানকে অনন্যভাবে চিহ্নিত করে। স্থানটি সম্পর্কে তথ্য পেতে, একটি প্লেসেস এপিআই (Places API) অনুরোধের placeId ফিল্ডে এই শনাক্তকারীটি পাস করুন। প্লেস আইডি সম্পর্কে আরও তথ্যের জন্য, প্লেস আইডি ওভারভিউ দেখুন।

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

স্থান_আইডি দেখুন।

ঐচ্ছিক অ্যারে<স্ট্রিং>

এই স্থানের জন্য প্রযোজ্য প্রকারগুলির একটি অ্যারে এতে রয়েছে। উদাহরণস্বরূপ: [ "political", "locality" ] অথবা [ "establishment", "geocode", "beauty_salon" ] । অ্যারেটিতে একাধিক মান থাকতে পারে। স্থানের প্রকারভেদ সম্পর্কে আরও জানুন।

PlaceAutocompleteMatchedSubstring

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় সংখ্যা

পূর্বাভাসের ফলাফলের টেক্সটে মিলে যাওয়া সাবস্ট্রিংটির দৈর্ঘ্য।

প্রয়োজনীয় সংখ্যা

পূর্বাভাসের ফলাফলের টেক্সটে মিলে যাওয়া সাবস্ট্রিংটির শুরুর অবস্থান।

PlaceAutocompleteStructured Format

মাঠ প্রয়োজনীয় প্রকার বর্ণনা

main_text

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

এতে ভবিষ্যদ্বাণীর মূল অংশটি থাকে, সাধারণত স্থানটির নাম।

main_text_matched_substrings

 প্রয়োজনীয় অ্যারে< PlaceAutocompleteMatchedSubstring >

এতে offset মান এবং length সহ একটি অ্যারে থাকে। এগুলো ভবিষ্যদ্বাণীর ফলাফলের টেক্সটে প্রবেশ করানো টার্মটির অবস্থান বর্ণনা করে, যাতে প্রয়োজন অনুযায়ী টার্মটিকে হাইলাইট করা যায়।

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

secondary_text

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

এতে কোনো ভবিষ্যদ্বাণীর সহায়ক পাঠ্য থাকে, সাধারণত স্থানটির অবস্থান।

secondary_text_matched_substrings

 ঐচ্ছিক অ্যারে< PlaceAutocompleteMatchedSubstring >

এতে offset মান এবং length সহ একটি অ্যারে থাকে। এগুলো ভবিষ্যদ্বাণীর ফলাফলের টেক্সটে প্রবেশ করানো টার্মটির অবস্থান বর্ণনা করে, যাতে প্রয়োজন অনুযায়ী টার্মটিকে হাইলাইট করা যায়।

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

PlaceAutocompleteTerm

মাঠ প্রয়োজনীয় প্রকার বর্ণনা
প্রয়োজনীয় সংখ্যা

বর্ণনায় এই পদটির শুরুর অবস্থান নির্ধারণ করে, যা ইউনিকোড অক্ষরে পরিমাপ করা হয়।

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

পরিভাষাটির পাঠ্য।