এই প্রোডাক্ট লেগ্যাসি স্ট্যাটাসে আছে। অক্টোবর ২০২৬ থেকে, নতুন Google Cloud প্রোজেক্টের জন্য Places API (Legacy) আর চালু করা যাবে না। আগে থেকে থাকা প্রোজেক্টে সম্পূর্ণ সহায়তা প্রদান করা হবে। নতুন ফিচার ও উন্নত পারফর্ম্যান্সের জন্য, Places API (নতুন)-এ মাইগ্রেট করুন।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

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

মনে রাখবেন: সার্ভার-সাইড ও ক্লায়েন্ট-সাইড লাইব্রেরি

এছাড়াও, Places API Java ক্লায়েন্ট, Python ক্লায়েন্ট, Go ক্লায়েন্ট ও Google Maps পরিষেবার Node.js ক্লায়েন্টের সাথে উপলভ্য। Places API এবং ক্লায়েন্ট লাইব্রেরি সার্ভার অ্যাপ্লিকেশনে ব্যবহারের জন্য।

আপনি যদি ক্লায়েন্ট-সাইড অ্যাপ্লিকেশন তৈরি করেন, তাহলে Android-এর জন্য Places SDK (নতুন), iOS-এর জন্য Places SDK (নতুন) এবং Places Library, Maps JavaScript API দেখুন।

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

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

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-এর ক্ষেত্রে স্ট্যান্ডার্ড হিসেবে, সব প্যারামিটারকে অ্যামপারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়।

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

ইনপুট

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

গুরুত্বপূর্ণ: input অবশ্যই একটি স্ট্রিং হতে হবে। Find Place (Legacy) অনুরোধে অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট বা প্লাস কোডের মতো নন-স্ট্রিং ডেটা ব্যবহার করলে, সমস্যা হয়।
inputtype

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

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

ফিল্ড

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

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

ফিল্ডগুলি তিনটি বিলিং বিভাগে বিভক্ত: প্রাথমিক, যোগাযোগ এবং পরিবেশ। প্রাথমিক ফিল্ডের জন্য বেস রেট এবং পরিচিতি ও পরিবেশ ফিল্ডের জন্য বেশি রেট ধার্য করা হয়। যে অনুরোধের জন্য এগুলি ট্রিগার করা হয়েছে, তার জন্য বেস SKU (জায়গার বিবরণ, জায়গা খোঁজা, আশেপাশের সার্চ বা টেক্সট সার্চ) ছাড়াও, প্রাথমিক, পরিচিতি ও পরিবেশগত SKU-এর জন্য চার্জ করা হয়। আরও তথ্যের জন্য, দাম সংক্রান্ত শিট দেখুন।

প্রাথমিক

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

মনে রাখবেন: আপনি যদি Find Place (Legacy) অনুরোধ থেকে fields প্যারামিটার বাদ দেন, তাহলে ফলাফলের জন্য শুধুমাত্র place_id ফেরত দেওয়া হবে।

Find Place (লিগ্যাসি) সংক্রান্ত উদাহরণ

নিম্নলিখিত উদাহরণে "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'

HTTP

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'

HTTP

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'

HTTP

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) উত্তরে শুধুমাত্র সেইসব ডেটার ধরন থাকে যেগুলি fields প্যারামিটার ব্যবহার করে নির্দিষ্ট করা হয়েছে, সাথে html_attributions। নিচের উদাহরণে "মিউজিয়াম অফ কনটেম্পোরারি আর্ট অস্ট্রেলিয়া"-এর জন্য Find Place (Legacy) অনুরোধের উত্তর দেখানো হয়েছে, যার মধ্যে formatted_address, geometry, name, opening_hours, photos, rating ফিল্ড রয়েছে।

JSON

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

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

ফিল্ড	প্রয়োজনীয়	ধরন	বিবরণ
`candidates`	প্রয়োজনীয়	Array<Place>	এতে Place ক্যান্ডিডেটের একটি অ্যারে থাকে। Place Search (Legacy) অনুরোধগুলি ফিল্ডের একটি সাবসেট ফেরত দেয় যা Place Details (Legacy) অনুরোধ দ্বারা ফেরত দেওয়া হয়। আপনি যে ফিল্ডটি চান সেটি যদি Place Search (Legacy) থেকে রিটার্ন না করা হয়, তাহলে আপনি place_id পেতে Place Search (Legacy) ব্যবহার করতে পারেন, তারপর সেই Place ID ব্যবহার করে Place Details (Legacy) অনুরোধ করতে পারেন। আরও তথ্যের জন্য জায়গা দেখুন।
`status`	প্রয়োজনীয়	PlacesSearchStatus	অনুরোধের স্ট্যাটাস থাকে এবং অনুরোধ কেন ব্যর্থ হল তা ট্র্যাক করতে সাহায্য করার জন্য এতে ডিবাগিং তথ্য থাকতে পারে। আরও তথ্যের জন্য PlacesSearchStatus দেখুন।
`error_message`	ঐচ্ছিক	স্ট্রিং	পরিষেবাটি `OK<` ছাড়া অন্য কোনও স্ট্যাটাস কোড রিটার্ন করলে, রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত `error_message` ফিল্ড থাকতে পারে। এই ফিল্ডে প্রদত্ত স্ট্যাটাস কোডের পেছনের কারণ সম্পর্কে আরও বিস্তারিত তথ্য থাকে। এই ফিল্ড সবসময় রিটার্ন করা হয় না এবং এর কন্টেন্ট পরিবর্তন করা হতে পারে।
`info_messages`	ঐচ্ছিক	Array<string>	অনুরোধের স্পেসিফিকেশন সম্পর্কে পরিষেবা অতিরিক্ত তথ্য রিটার্ন করলে, রেসপন্স অবজেক্টের মধ্যে অতিরিক্ত `info_messages` ফিল্ড থাকতে পারে। এই ফিল্ড শুধুমাত্র সফল অনুরোধের ক্ষেত্রে রিটার্ন করা হয়। এটি সবসময় ফেরত নাও আসতে পারে এবং এর কন্টেন্ট পরিবর্তন করা হতে পারে।

PlacesSearchStatus

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

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