স্থান খুঁজুন (উত্তরাধিকার)

একটি ফাইন্ড প্লেস (লেগ্যাসি) রিকোয়েস্ট একটি টেক্সট ইনপুট গ্রহণ করে এবং একটি স্থান ফেরত দেয়। ইনপুটটি যেকোনো ধরনের প্লেসেস টেক্সট ডেটা হতে পারে, যেমন নাম, ঠিকানা বা ফোন নম্বর। রিকোয়েস্টটি অবশ্যই একটি স্ট্রিং হতে হবে। ল্যাট/লং স্থানাঙ্ক বা প্লাস কোডের মতো নন-স্ট্রিং ডেটা ব্যবহার করে করা ফাইন্ড প্লেস (লেগ্যাসি) রিকোয়েস্ট একটি এরর তৈরি করে।

ফাইন্ড প্লেস (লেগ্যাসি) অনুরোধ

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

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

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

• json (প্রস্তাবিত) জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON) ফরম্যাটে আউটপুট নির্দেশ করে।
• xml বলতে আউটপুটকে XML হিসেবে বোঝায়।

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

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

• ইনপুট

  যে টেক্সট স্ট্রিংটির উপর ভিত্তি করে অনুসন্ধান করতে হবে, যেমন: "restaurant" বা "123 Main Street"। এটি অবশ্যই কোনো স্থানের নাম, ঠিকানা বা প্রতিষ্ঠানের বিভাগ হতে হবে। অন্য কোনো ধরনের ইনপুট দিলে ত্রুটি দেখা দিতে পারে এবং সঠিক ফলাফল পাওয়ার কোনো নিশ্চয়তা নেই। প্লেসেস এপিআই (Places API) এই স্ট্রিংটির উপর ভিত্তি করে সম্ভাব্য মিলগুলো দেখাবে এবং ফলাফলগুলোকে তাদের প্রাসঙ্গিকতা অনুসারে সাজাবে।

• ইনপুট টাইপ

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

ঐচ্ছিক পরামিতি

• ক্ষেত্রগুলি

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

  ফেরত পাওয়ার জন্য স্থানের ডেটা টাইপগুলোর একটি কমা-বিভক্ত তালিকা নির্দিষ্ট করতে fields প্যারামিটারটি ব্যবহার করুন। উদাহরণস্বরূপ: 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 ( deprecated ), 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_vegetarian_food serves_lunch , serves_wine , takeout , user_ratings_total ।

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

• ভাষা

  যে ভাষায় ফলাফল ফেরত দেওয়া হয়।

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

• অবস্থানগত পক্ষপাত

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

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

স্থান (উত্তরাধিকার) উদাহরণ খুঁজুন

নিম্নলিখিত উদাহরণটি "মিউজিয়াম অফ কনটেম্পরারি আর্ট অস্ট্রেলিয়া"-এর জন্য একটি ফাইন্ড প্লেস (লেগ্যাসি) অনুরোধ দেখাচ্ছে, যেখানে 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) রেসপন্সে শুধুমাত্র 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

স্থান অনুসন্ধান স্থিতি

পরিষেবা দ্বারা ফেরত দেওয়া স্ট্যাটাস কোড।

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

স্থান

কোনো স্থানের বর্ণনাকারী বৈশিষ্ট্যসমূহ। সব ধরনের স্থানের জন্য সকল বৈশিষ্ট্য উপলব্ধ নাও হতে পারে।

স্থান সম্পাদকীয় সারসংক্ষেপ

স্থানটির একটি সারসংক্ষেপ রয়েছে। সারসংক্ষেপটি একটি লিখিত বিবরণ নিয়ে গঠিত এবং প্রযোজ্য ক্ষেত্রে এর ভাষা কোডও অন্তর্ভুক্ত থাকে। সারসংক্ষেপের লেখাটি হুবহু উপস্থাপন করতে হবে এবং এটি পরিবর্তন বা পরিমার্জন করা যাবে না।

স্থান খোলার সময়

কোনো স্থানের খোলার সময়সূচী বর্ণনা করে এমন একটি বস্তু।

স্থান খোলার সময়

স্থানবিশেষদিন

স্থান খোলার সময় সময়কাল বিবরণ

প্লেসফটো

একটি স্থানের ছবি। প্লেস ফটো এপিআই (Place Photo API) ব্যবহার করে নিম্নলিখিত প্যাটার্নের একটি ইউআরএল (url) দ্বারা ছবিটি অ্যাক্সেস করা যাবে:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

আরও তথ্যের জন্য স্থানটির ছবিগুলো দেখুন।

স্থান পর্যালোচনা

একজন ব্যবহারকারীর জমা দেওয়া স্থানটির পর্যালোচনা।