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

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

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

Query Autocomplete (Legacy) সংক্রান্ত অনুরোধ

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

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

কোয়েরি অটো-কমপ্লিট (লিগ্যাসি) অনুরোধ হল নিম্নলিখিত ফর্মের একটি 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 পরিষেবা সেই বৃত্তের মধ্যে ফলাফল দেখানোর জন্য অগ্রাধিকার দেয়; তবে, নির্দিষ্ট করা এলাকার বাইরের ফলাফলও দেখানো হতে পারে।

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

  • অটো-কমপ্লিট: ৫০,০০০ মিটার
  • নিয়ারবাই Search:
    • 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'

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

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

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

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

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

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

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