জায়গা খোঁজা (লিগ্যাসি)

Find Place (Legacy) অনুরোধ টেক্সট ইনপুট নেয় এবং একটি জায়গা রিটার্ন করে। ইনপুট যেকোনও ধরনের Places টেক্সট ডেটা হতে পারে, যেমন নাম, ঠিকানা বা ফোন নম্বর। অনুরোধটি অবশ্যই একটি স্ট্রিং হতে হবে। Find Place (Legacy) অনুরোধে স্ট্রিং নয় এমন ডেটা ব্যবহার করলে, যেমন অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট বা Plus Code, তাহলে সমস্যা হয়।

Find Place (Legacy) সংক্রান্ত অনুরোধ

Find Place (Legacy) অনুরোধ হল নিম্নলিখিত ফর্মের একটি HTTP URL:

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

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

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

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

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

• ইনপুট

  যে টেক্সট স্ট্রিংয়ে সার্চ করতে হবে। এটি অবশ্যই কোনও জায়গার নাম, ঠিকানা বা ফোন নম্বর হতে হবে (যেমন, "১২৩ মেইন স্ট্রিট" বা "সিটি হল")।

• inputtype

  ইনপুটের ধরন। এটি textquery বা phonenumber-এর মধ্যে যেকোনও একটি হতে পারে। ফোন নম্বর আন্তর্জাতিক ফর্ম্যাটে হতে হবে (প্রথমে প্লাস চিহ্ন ("+"), তারপর দেশের কোড, তারপর ফোন নম্বর)। আরও তথ্যের জন্য E.164 ITU সাজেশন দেখুন।

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

• ফিল্ড

  সতর্কতা: জায়গা সার্চ করা (Legacy) সংক্রান্ত অনুরোধ এবং জায়গার বিবরণ (Legacy) সংক্রান্ত অনুরোধ একই ফিল্ড ফেরত দেয় না। জায়গা সার্চ করা (পুরনো) সংক্রান্ত অনুরোধে, জায়গার বিবরণ (পুরনো) সংক্রান্ত অনুরোধের মাধ্যমে ফেরত পাওয়া ফিল্ডের সাবসেট ফেরত পাওয়া যায়। আপনি যে ফিল্ডটি চান সেটি যদি Place Search (Legacy) দ্বারা ফেরত না আসে, তাহলে আপনি একটি place_id পেতে Place Search (Legacy) ব্যবহার করতে পারেন, তারপর একটি Place Details (Legacy) অনুরোধ করতে সেই Place ID ব্যবহার করুন। জায়গা সার্চ (পুরনো) অনুরোধে উপলভ্য নয় এমন ফিল্ড সম্পর্কে আরও তথ্যের জন্য, Places API ফিল্ড সংক্রান্ত সহায়তা দেখুন।

  ফেরত পাঠানোর জন্য জায়গার ডেটার ধরন কমা দিয়ে আলাদা করা তালিকা হিসেবে উল্লেখ করতে ফিল্ড প্যারামিটার ব্যবহার করুন। যেমন: fields=formatted_address,name,geometry. কম্পাউন্ড ভ্যালু উল্লেখ করার সময় ফরওয়ার্ড স্ল্যাশ ব্যবহার করুন। যেমন: opening_hours/open_now.

  ফিল্ডগুলি তিনটি বিলিং বিভাগে বিভক্ত: প্রাথমিক, যোগাযোগ এবং পরিবেশ। বেসিক ফিল্ডের জন্য বেস রেটে বিল করা হয় এবং কন্ট্যাক্ট ও অ্যাটমোস্ফিয়ার ফিল্ডের জন্য বেশি রেটে বিল করা হয়। বেসিক, পরিচিতি এবং অ্যাটমোস্ফিয়ার SKU-এর জন্য বেস SKU (Places Details, Find Place, Nearby Search, or Text Search) ছাড়াও চার্জ করা হয়, যে অনুরোধের জন্য সেগুলি ট্রিগার করা হয়েছে। আরও তথ্যের জন্য, দাম সংক্রান্ত শিট দেখুন।

  প্রাথমিক

  বেসিক বিভাগে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (বন্ধ করা হয়েছে), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  পরিচিতি

  পরিচিতি বিভাগে নিম্নলিখিত ফিল্ডগুলি অন্তর্ভুক্ত থাকে: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  পরিবেশ

  'পরিবেশ' বিভাগে নিম্নলিখিত ফিল্ড অন্তর্ভুক্ত থাকে: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  মনে রাখবেন: অ্যাট্রিবিউশন, html_attributions, সবসময় প্রতিটি কলের সাথে ফেরত দেওয়া হয়, ফিল্ডের জন্য অনুরোধ করা হয়েছে কিনা তা নির্বিশেষে।

• ভাষা

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

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

• locationbias

  ব্যাসার্ধ এবং অক্ষাংশ/দ্রাঘিমাংশ অথবা আয়তক্ষেত্রের বিন্দুগুলি বোঝায় এমন দুটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া উল্লেখ করে, নির্দিষ্ট এলাকার ফলাফলকে অগ্রাধিকার দিন। এই প্যারামিটার নির্দিষ্ট করা না থাকলে, API ডিফল্ট হিসেবে IP অ্যাড্রেস বায়াসিং ব্যবহার করে।

  • IP বায়াস: IP অ্যাড্রেস বায়াসিং ব্যবহার করার জন্য API-কে নির্দেশ দেয়। স্ট্রিং পাস করুন ipbias (এই বিকল্পে কোনও অতিরিক্ত প্যারামিটার নেই)।
  • বৃত্তাকার: একটি স্ট্রিং যা মিটারে ব্যাসার্ধ এবং দশমিক ডিগ্রিতে অক্ষাংশ/দ্রাঘিমাংশ নির্দিষ্ট করে। নিম্নলিখিত ফর্ম্যাট ব্যবহার করুন: circle:radius@lat,lng।
  • আয়তাকার: দশমিক ডিগ্রিতে দুটি অক্ষাংশ/দ্রাঘিমাংশ জোড়া নির্দিষ্ট করে এমন স্ট্রিং, যা আয়তক্ষেত্রের দক্ষিণ/পশ্চিম এবং উত্তর/পূর্ব বিন্দুকে দেখায়। নিম্নলিখিত ফর্ম্যাট ব্যবহার করুন:rectangle:south,west|north,east। মনে রাখবেন যে পূর্ব/পশ্চিম ভ্যালু -১৮০, ১৮০ রেঞ্জে এবং উত্তর/দক্ষিণ ভ্যালু -৯০, ৯০ রেঞ্জে সীমাবদ্ধ।

Find Place (Legacy) সংক্রান্ত উদাহরণ

নিম্নলিখিত উদাহরণে "Museum of Contemporary Art Australia"-এর জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে, যার মধ্যে photos, formatted_address, name, rating, opening_hours এবং geometry ফিল্ড অন্তর্ভুক্ত:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

নিচের উদাহরণে "Mongolian Grill"-এর জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে, যেখানে locationbias প্যারামিটার ব্যবহার করে নির্দিষ্ট করা স্থানাঙ্কের ২০০০ মিটারের মধ্যে ফলাফলকে অগ্রাধিকার দেওয়া হয়েছে:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

নিম্নলিখিত উদাহরণে ফোন নম্বরের জন্য Find Place (Legacy) অনুরোধ দেখানো হয়েছে। মনে রাখবেন যে আন্তর্জাতিক কল প্রিফিক্স "+" %2B হিসেবে এনকোড করা হয়েছে যাতে এই অনুরোধটি একটি মানানসই URL হয়। আনএনকোডেড অবস্থায় রেখে দিলে, + প্রিফিক্স সার্ভারে স্পেস হিসেবে ডিকোড করা হবে, যার ফলে ফোন নম্বর লুকআপ ভুল হবে।

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Find Place (Legacy) রেসপন্স

Find Place (Legacy) রেসপন্সে শুধু সেইসব ডেটার ধরন থাকে যেগুলি fields প্যারামিটার ব্যবহার করে নির্দিষ্ট করা হয়েছে, সাথে html_attributions। নিচের উদাহরণে "Museum of Contemporary Art Australia"-এর জন্য Find Place (Legacy) অনুরোধের উত্তর দেখানো হয়েছে, যার মধ্যে formatted_address, geometry, name, opening_hours, photos, rating ফিল্ড অন্তর্ভুক্ত।

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

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-এর মাধ্যমে পাওয়া তথ্য জায়গার বিবরণ (লিগ্যাসি) অনুরোধে পাস করুন। এন্ডপয়েন্ট জুড়ে ফিল্ডের উপলভ্যতা ও দামের টিয়ার সম্পর্কে জানতে, জায়গা ডেটা ফিল্ড (পুরনো) দেখুন।