টেক্সট সার্চ (লিগ্যাসি)

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

টেক্সট সার্চ (লিগ্যাসি) স্ট্রিংয়ের উপর ভিত্তি করে এক সেট জায়গা সম্পর্কে তথ্য প্রদান করে — যেমন "নিউ ইয়র্কে পিৎজা" বা "অটোয়ার কাছাকাছি জুতোর দোকান" বা "১২৩ মেইন স্ট্রিট"। পরিষেবাটি টেক্সট স্ট্রিং এবং সেট করা যেকোনও লোকেশন বায়াসের সাথে মেলে এমন জায়গার তালিকা সহ উত্তর দেয়।

টেক্সট সার্চ (লিগ্যাসি) অস্পষ্ট কোয়েরির জন্য নয়, যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:

কোয়েরির ধরন উদাহরণ
একটি কোয়েরিতে অনেক বেশি ধারণা বা সীমাবদ্ধতা, যেমন একাধিক জায়গা, রাস্তা বা শহরের নাম "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান জোসে বিমানবন্দর"
Google Maps-এ ডাক ঠিকানার এলিমেন্ট দেখানো হয়নি "C/O জন স্মিথ ১২৩ মেইন স্ট্রিট"
"পোস্ট বক্স ১৩ সান ফ্রান্সিসকো"
ব্যবসা, চেন বা বিভাগের নাম লোকেশনের সাথে যুক্ত করা যেখানে এইসব এন্টিটি উপলভ্য নয় "টেক্সাসের ডালাসের কাছে টেসকো"
একাধিক ব্যাখ্যা সহ অস্পষ্ট কোয়েরি "চার্জার ড্রপ-অফ"
ঐতিহাসিক নাম আর ব্যবহার করা হয় না "মিডলসেক্স যুক্তরাজ্য"
নন-জিওস্পেশিয়াল এলিমেন্ট বা উদ্দেশ্য "ভেনচুরা হারবারে কতগুলি নৌকা আছে?"
বেসরকারি বা ভ্যানিটি নাম "The Jenga"
"The Helter Skelter"
অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক "37.422131,-122.084801"

সার্চের উত্তরে জায়গার তালিকা অন্তর্ভুক্ত আছে। উত্তরে দেখানো যেকোনও জায়গা সম্পর্কে আরও তথ্য পেতে আপনি জায়গার বিবরণ সংক্রান্ত অনুরোধ পাঠাতে পারেন।

টেক্সট সার্চ (লিগ্যাসি) সংক্রান্ত অনুরোধ

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

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

যেখানে output নিম্নলিখিত মানগুলির মধ্যে যেকোনও একটি হতে পারে:

  • json (সাজেস্ট করা হয়েছে) জাভাস্ক্রিপ্ট অবজেক্ট নোটেশনে (JSON) আউটপুট দেখায়
  • xml XML হিসেবে আউটপুট দেখায়

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

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

  • কোয়েরি

    যে টেক্সট স্ট্রিং সার্চ করতে হবে, যেমন: "রেস্তোরাঁ" বা "১২৩ মেইন স্ট্রিট"। এটি অবশ্যই কোনও জায়গার নাম, ঠিকানা বা প্রতিষ্ঠানের বিভাগ হতে হবে। অন্য যেকোনও ধরনের ইনপুট দিলে সমস্যা হতে পারে এবং সঠিক ফলাফল পাওয়ার কোনও গ্যারেন্টি নেই। Google Places পরিষেবা এই স্ট্রিংয়ের ভিত্তিতে সম্ভাব্য ম্যাচ দেখায় এবং সেগুলির প্রাসঙ্গিকতা অনুযায়ী ফলাফল সাজায়।

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

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

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

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

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

  • ভাষা

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

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

    যে পয়েন্টের আশেপাশে জায়গার তথ্য পাওয়া যাবে। এটি অবশ্যই latitude,longitude হিসেবে উল্লেখ করতে হবে।

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

    নির্দিষ্ট রেঞ্জের মধ্যে থাকা জায়গাগুলিই শুধু ফলাফল হিসেবে দেখায়। সঠিক ভ্যালুর রেঞ্জ ০ (সবচেয়ে সস্তা) থেকে ৪ (সবচেয়ে দামি) পর্যন্ত হয়। নির্দিষ্ট ভ্যালু দ্বারা নির্দেশিত সঠিক পরিমাণ অঞ্চল থেকে অঞ্চলে পরিবর্তিত হবে।

  • minprice

    নির্দিষ্ট রেঞ্জের মধ্যে থাকা জায়গাগুলিই শুধু ফলাফল হিসেবে দেখায়। সঠিক ভ্যালুর রেঞ্জ ০ (সবচেয়ে সস্তা) থেকে ৪ (সবচেয়ে দামি) পর্যন্ত হয়। নির্দিষ্ট ভ্যালু দ্বারা নির্দেশিত সঠিক পরিমাণ অঞ্চল থেকে অঞ্চলে পরিবর্তিত হবে।

  • এখনই খুলুন

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

  • pagetoken

    আগে রান করা সার্চ থেকে ২০টি পর্যন্ত ফলাফল দেখায়। pagetoken প্যারামিটার সেট করলে, আগে ব্যবহার করা একই প্যারামিটার দিয়ে সার্চ করা হবে — pagetoken ছাড়া অন্য সব প্যারামিটার উপেক্ষা করা হবে।

  • অঞ্চল

    অঞ্চল কোড, ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের মান হিসেবে উল্লেখ করা হয়েছে। বেশিরভাগ ccTLD কোড ISO 3166-1 কোডের মতোই হয়, তবে কিছু ব্যতিক্রম আছে। যেমন, যুক্তরাজ্যের ccTLD হল "uk" (.co.uk) এবং এর ISO 3166-1 কোড হল "gb" (টেকনিক্যালি "গ্রেট ব্রিটেন ও উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এন্টিটির জন্য)।

  • ধরন

    নির্দিষ্ট ধরনের সাথে ম্যাচ করা জায়গার মধ্যে ফলাফল সীমাবদ্ধ করে। শুধুমাত্র একটি ধরন নির্দিষ্ট করা যেতে পারে। একাধিক ধরন প্রদান করা হলে, প্রথম এন্ট্রির পরে সব ধরন উপেক্ষা করা হয়।

    • type=hospital|pharmacy|doctor-এর দাম type=hospital হয়েছে
    • type=hospital,pharmacy,doctor সম্পূর্ণভাবে উপেক্ষা করা হয়েছে

    কাজ করে এমন ধরনের তালিকা দেখুন।

    মনে রাখবেন: একই ভ্যালু (keyword=cafe&type=cafe বা keyword=parking&type=parking) সহ keyword এবং type উভয় যোগ করলে ZERO_RESULTS হতে পারে।

টেক্সট সার্চ (লিগ্যাসি) সংক্রান্ত উদাহরণ

মনে রাখবেন: এইসব উদাহরণে, আপনার অ্যাপ্লিকেশনে অনুরোধ কাজ করার জন্য, আপনাকে key-এর জায়গায় নিজের API key ব্যবহার করতে হবে।

প্রাথমিক উদাহরণ

নিচের উদাহরণে সিডনির কাছাকাছি রেস্তোরাঁ সার্চ করার ব্যাপারে দেখানো হয়েছে।

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

অসম্পূর্ণ ঠিকানার উদাহরণ

নিচের উদাহরণে অসম্পূর্ণ ঠিকানা সার্চ করার বিষয়টি দেখানো হয়েছে, এই ক্ষেত্রে, রাস্তার ঠিকানায় শহর, রাজ্য বা দেশের নাম উল্লেখ করা নেই।

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

    

লোকেশন সংক্রান্ত পক্ষপাতিত্বের উদাহরণ

নিচের উদাহরণে আগের উদাহরণের মতো একই অসম্পূর্ণ ঠিকানা সার্চ করা হয়েছে এবং location ও radius প্যারামিটার অন্তর্ভুক্ত করা হয়েছে যাতে ফলাফলটি আগ্রহের অঞ্চলের দিকে পক্ষপাতদুষ্ট হয়।

কার্ল

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

    

টেক্সট সার্চ (লিগ্যাসি) সংক্রান্ত উত্তর

URL অনুরোধের পাথে output ফ্ল্যাগ দ্বারা নির্দেশিত ফর্ম্যাটে সার্চের উত্তর ফেরত দেওয়া হয়।

নিচের উদাহরণে টেক্সট সার্চ (লিগ্যাসি) সংক্রান্ত উত্তর দেখানো হয়েছে।

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

    

PlacesTextSearchResponse

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

এই তালিকায় অ্যাট্রিবিউশনের সেট থাকতে পারে যা ব্যবহারকারীকে অবশ্যই দেখাতে হবে (কিছু তালিকায় অ্যাট্রিবিউশন নাও থাকতে পারে)।

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

জায়গার অ্যারে রয়েছে।

জায়গা সার্চ করার অনুরোধ, জায়গা সংক্রান্ত বিবরণ সংক্রান্ত অনুরোধের মাধ্যমে ফেরত পাওয়া ফিল্ডের সাবসেট ফেরত দেয়। আপনি যে ফিল্ডটি চান সেটি যদি জায়গা সার্চ করার মাধ্যমে না পাওয়া যায়, তাহলে আপনি জায়গা সার্চ করার মাধ্যমে place_id পেতে পারেন, তারপর সেই প্লেস আইডি ব্যবহার করে জায়গার বিবরণ অনুরোধ করতে পারেন।

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

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

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

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

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

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

ঐচ্ছিক Array<string>

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

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

এতে একটি টোকেন আছে যা সর্বাধিক ২০টি অতিরিক্ত ফলাফল দেখাতে ব্যবহার করা যেতে পারে। দেখানোর মতো অতিরিক্ত ফলাফল না থাকলে, next_page_token ফেরত পাঠানো হবে না। সর্বাধিক ৬০টি ফলাফল ফেরত পাঠানো যেতে পারে। next_page_token ইস্যু করা এবং সেটি বৈধ হওয়ার মধ্যে সামান্য বিলম্ব হয়।

PlacesSearchStatus

পরিষেবা থেকে স্ট্যাটাস কোড পাঠানো হয়েছে।

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

জায়গা

জায়গা সার্চ করার উত্তর জায়গা ফিল্ডের নিম্নলিখিত সাবসেট ফিরিয়ে দেয়। সব ধরনের জায়গার জন্য সব অ্যাট্রিবিউট উপলভ্য নয়। জায়গা সার্চ করার মাধ্যমে পাওয়া যায় না এমন ফিল্ড, যেমন address_components, formatted_phone_number, reviews বা website, place_id-এর মাধ্যমে পাওয়া তথ্য জায়গার বিবরণ (লিগ্যাসি) অনুরোধে পাস করুন। এন্ডপয়েন্ট জুড়ে ফিল্ডের উপলভ্যতা ও দামের টিয়ার সম্পর্কে জানতে, জায়গা ডেটা ফিল্ড (পুরনো) দেখুন।

ফিল্ড ধরন বিবরণ
business_status string জায়গাটি কোনও ব্যবসা হলে, তার অপারেশনাল স্ট্যাটাস দেখায়: OPERATIONAL, CLOSED_TEMPORARILY, অথবা CLOSED_PERMANENTLY. স্ট্যাটাস ডেটা না থাকলে বাদ দেওয়া হয়।
formatted_address string এই জায়গার মানুষের-পঠনযোগ্য ঠিকানা। Text Search (Legacy) এবং Find Place (Legacy) দ্বারা রিটার্ন করা হয়। ফর্ম্যাট করা ঠিকানা প্রোগ্রাম্যাটিক্যালি পার্স করবেন না; পরিবর্তে জায়গার বিবরণ (লিগ্যাসি) থেকে address_components অনুরোধ করুন।
geometry Geometry এতে lat ও lng স্থানাঙ্ক সহ জিওকোড করা location এবং northeast ও southwest বাউন্ড সহ পছন্দের viewport আছে।
icon string ম্যাপে এই ফলাফল দেখানোর সময় আপনি যে সাজেস্ট করা আইকন দেখাতে পারেন, সেটির URL।
icon_background_color string জায়গার বিভাগের জন্য ডিফল্ট হেক্সাডেসিমেল রঙের কোড।
icon_mask_base_uri string সাজেস্ট করা আইকনের বেস URL, SVG বা PNG ফাইলের ধরনের এক্সটেনশন ছাড়া।
name string ফিরে আসা ফলাফলের জন্য মানুষের-পঠনযোগ্য নাম। establishment ফলাফলের জন্য, এই ভ্যালু সাধারণত ক্যানোনিক্যালাইজ করা ব্যবসার নাম হয়।
opening_hours PlaceOpeningHours খোলা থাকার সময় সংক্রান্ত তথ্য। 'জায়গা সার্চ' এন্ডপয়েন্ট শুধু open_now বুলিয়ান সাবফিল্ড ফিরিয়ে দেয়; periods এবং weekday_text-এর জন্য 'জায়গার বিবরণ (লিগ্যাসি)' থেকে opening_hours অনুরোধ করুন।
permanently_closed boolean বাতিল করা হয়েছে: কোনও ব্যবসার অপারেশনাল স্ট্যাটাস চেক করতে business_status ব্যবহার করুন।
photos Array<PlacePhoto> PlacePhoto অবজেক্টের একটি অ্যারে, যার প্রতিটিতে একটি করে photo_reference, height, width এবং html_attributions আছে। ব্যবহার সংক্রান্ত বিবরণের জন্য, জায়গার ফটো (লিগ্যাসি) দেখুন।
place_id string একটি টেক্সচুয়াল শনাক্তকারী যা অনন্যভাবে একটি স্থানকে শনাক্ত করে। জায়গার বিবরণ (পুরনো) অনুরোধের place_id প্যারামিটারে এই আইডি পাস করুন। প্লেস আইডি এক নজরে দেখুন।
plus_code PlusCode অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক থেকে প্রাপ্ত একটি এনকোড করা লোকেশন রেফারেন্স, যার মধ্যে একটি global_code এবং একটি ঐচ্ছিক compound_code থাকে।
price_level integer 0 থেকে 4 স্কেলে জায়গার দামের লেভেল, সবচেয়ে কম দাম থেকে সবচেয়ে বেশি দাম। price_level দেখুন।
rating number ব্যবহারকারীদের দেওয়া রিভিউয়ের ভিত্তিতে, জায়গার রেটিং 1.0 থেকে 5.0 পর্যন্ত।
reference string বন্ধ করা হয়েছে: পরিবর্তে place_id ব্যবহার করুন।
scope string ডেপ্রিকেট করা হয়েছে: place_id-এর স্কোপ নির্দেশ করে, যা সবসময় GOOGLE হয়। নিয়ারবাই Search (লিগ্যাসি) দ্বারা রিটার্ন করা হয়েছে।
types Array<string> প্রদত্ত ফলাফল বর্ণনা করে এমন ফিচার ধরনের অ্যারে। জায়গার ধরন (পুরনো) দেখুন।
user_ratings_total integer এই জায়গার জন্য রিভিউ টেক্সট সহ বা ছাড়া মোট রেটিংয়ের সংখ্যা।
vicinity string জায়গার সহজ ঠিকানা, যার মধ্যে রাস্তার নাম, রাস্তার নম্বর ও এলাকা অন্তর্ভুক্ত, তবে রাজ্য বা প্রদেশ, পিন কোড বা দেশের নাম অন্তর্ভুক্ত নয়। নিয়ারবাই Search (লিগ্যাসি) দ্বারা রিটার্ন করা হয়েছে।

অতিরিক্ত ফলাফল অ্যাক্সেস করা

ডিফল্ট হিসেবে, প্রতিটি উত্তরে কোয়েরি পিছু সর্বাধিক ২০টি establishment ফলাফল দেখানো হয়; তবে, প্রতিটি সার্চে সর্বাধিক ৬০টি ফলাফল দেখানো হতে পারে, যা তিনটি পৃষ্ঠায় ভাগ করা থাকে। আপনার সার্চের ফলাফল ২০টির বেশি হলে, সার্চের উত্তরে একটি অতিরিক্ত ভ্যালু অন্তর্ভুক্ত থাকবে — next_page_token। পরবর্তী ফলাফলের সেট দেখতে, নতুন অনুরোধের pagetoken প্যারামিটারে next_page_token-এর ভ্যালু পাস করুন।

  • next_page_token নাল হলে বা ফেরত না এলে, আর কোনও ফলাফল নেই।
  • একই next_page_token-এর সাথে অনুরোধটি আবার করলে ফলাফলের পরবর্তী পৃষ্ঠাটি দেখাবে।
  • pagetoken সেট করলে অন্য প্যারামিটার উপেক্ষা করা হবে।
  • আপনি আসল কোয়েরির পরে দুবার পর্যন্ত নতুন পৃষ্ঠার জন্য অনুরোধ করতে পারেন।
  • next_page_token ব্যবহার করে করা অনুরোধ সহ প্রতিটি অনুরোধ, আপনার ব্যবহারের সীমার বিপরীতে একটি অনুরোধ হিসেবে গণনা করা হয় এবং আলাদাভাবে চার্জ করা হয়।
  • next_page_token ইস্যু করা এবং সেটি বৈধ হওয়ার মধ্যে কয়েক সেকেন্ডের বিলম্ব হয়। পরবর্তী পৃষ্ঠা উপলভ্য হওয়ার আগে সেটির জন্য অনুরোধ করলে, INVALID_REQUEST উত্তর পাওয়া যাবে। next_page_token-এর সাথে করা অনুরোধের জন্য সবসময় চার্জ করা হয়।

যেমন, নিচের কোয়েরিতে, আমরা সিডনি, অস্ট্রেলিয়ার ডার্লিং হারবারের আশেপাশের রেস্তোরাঁ সার্চ করি এবং দূরত্ব অনুযায়ী ফলাফল র‍্যাঙ্ক করি। আপনি দেখতে পাবেন যে উত্তরে একটি next_page_token প্রপার্টি আছে।

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

পরবর্তী ফলাফলের সেট দেখতে, আপনি একটি নতুন কোয়েরি জমা দিতে পারেন, next_page_token-এর ফলাফল pagetoken প্যারামিটারে পাস করে। যেমন:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY