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

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

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

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

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

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

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

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

যেখানে output হল json অথবা xml।

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

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

  • ইনপুট

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

ঐচ্ছিক প্যারামিটার

  • ভাষা

    ফলাফল যে ভাষায় দেখানো হবে।

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

  • লোকেশন

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

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

  • অফসেট

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

  • যতটা অঞ্চল জুড়ে টার্গেট করা যাবে

    দূরত্ব (মিটারে) নির্ধারণ করে যার মধ্যে জায়গার ফলাফল দেখাতে হবে। আপনি location ও radius প্যারামিটার পাস করে কোনও নির্দিষ্ট বৃত্তের ফলাফলকে পক্ষপাতদুষ্ট করতে পারেন। এটি করলে, Places পরিষেবা সেই বৃত্তের মধ্যে ফলাফল দেখাতে পছন্দ করে ; তবে, সংজ্ঞায়িত এলাকার বাইরে থাকা ফলাফল এখনও দেখানো হতে পারে।

    সার্চের ধরন ও অন্যান্য প্যারামিটারের উপর নির্ভর করে ব্যাসার্ধ অটোমেটিক সর্বাধিক মানে ক্ল্যাম্প করা হবে।

    • অটো-কমপ্লিট: ৫০,০০০ মিটার
    • নিয়ারবাই সার্চ:
      • keyword বা name-এর সাথে: ৫০,০০০ মিটার
      • keyword বা name ছাড়া
        • ৫০,০০০ মিটার পর্যন্ত, এলাকার ঘনত্বের উপর ভিত্তি করে ডায়নামিকভাবে অ্যাডজাস্ট করা হয়, rankby প্যারামিটার থেকে স্বাধীন।
        • rankby=distance ব্যবহার করার সময়, ব্যাসার্ধ প্যারামিটার গ্রহণ করা হবে না এবং এর ফলে 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'

"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 key আপনার নিজস্ব 'কী' দিয়ে পরিবর্তন করতে হবে।

কোয়েরি অটোমেটিক সম্পূর্ণ করা (Legacy) সংক্রান্ত উত্তর

URL অনুরোধের পাথের মধ্যে থাকা 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",
}

XML

      
<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>

Places পরিষেবা কোনও সার্চ থেকে JSON ফলাফল রিটার্ন করলে, এটি সেগুলিকে predictions অ্যারের মধ্যে রাখে। এমনকি পরিষেবা কোনও ফলাফল না দিলেও (যেমন, location রিমোট হলে) এটি তবুও একটি ফাঁকা predictions অ্যারে দেয়। XML উত্তরে শূন্য বা তার বেশি <prediction> এলিমেন্ট থাকে।

PlacesQueryAutocompleteResponse

ফিল্ড প্রয়োজনীয় ধরন বিবরণ
প্রয়োজনীয় Array<PlaceAutocompletePrediction>

এতে পূর্বাভাসের একটি অ্যারে থাকে।

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

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

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

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

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

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

ঐচ্ছিক Array<string>

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

PlacesAutocompleteStatus

পরিষেবা থেকে ফেরত আসা স্ট্যাটাস কোড।

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

Places পরিষেবা কোনও সার্চ থেকে JSON ফলাফল রিটার্ন করলে, সেটি predictions অ্যারের মধ্যে প্লেস করে। পরিষেবা কোনও ফলাফল না দেখালেও (যেমন, location রিমোট হলে) এটি এখনও খালি predictions অ্যারে দেখায়। XML উত্তরে শূন্য বা তার বেশি <prediction> এলিমেন্ট থাকে।

PlaceAutocompletePrediction

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

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

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

সাবস্ট্রিংয়ের একটি তালিকা যা পূর্বাভাসের ফলাফল টেক্সটে লেখা শব্দের লোকেশন বর্ণনা করে, যাতে প্রয়োজন হলে শব্দটি হাইলাইট করা যায়।

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

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

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

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

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

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

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

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

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

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

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

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

place_id দেখুন।
ঐচ্ছিক Array<string>

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

PlaceAutocompleteMatchedSubstring

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

পূর্বানুমান ফলাফল টেক্সটে ম্যাচ করা সাবস্ট্রিংয়ের দৈর্ঘ্য।
প্রয়োজনীয় নম্বর

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

PlaceAutocompleteStructuredFormat

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

main_text

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

পূর্বাভাসের মূল টেক্সট থাকে, সাধারণত জায়গার নাম থাকে।

main_text_matched_substrings

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

offset ভ্যালু ও length সহ অ্যারে আছে। এগুলি হল সাজেশন ফলাফল টেক্সটে প্রবেশ করানো শব্দের লোকেশন, যাতে চাইলে শব্দটি হাইলাইট করা যায়।

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

secondary_text

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

পূর্বানুমানের সেকেন্ডারি টেক্সট থাকে, সাধারণত জায়গার লোকেশন।

secondary_text_matched_substrings

ঐচ্ছিক Array<PlaceAutocompleteMatchedSubstring>

offset ভ্যালু ও length সহ অ্যারে আছে। এগুলি হল সাজেশন ফলাফল টেক্সটে প্রবেশ করানো শব্দের লোকেশন, যাতে চাইলে শব্দটি হাইলাইট করা যায়।

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

PlaceAutocompleteTerm

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

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

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

শর্তাবলীর টেক্সট।