Places API (নতুন) দ্রুত রেফারেন্স

Places API (নতুন) হল একটি ওয়েব পরিষেবা যা প্রতিষ্ঠান, ভৌগোলিক লোকেশন এবং আগ্রহের জায়গা সম্পর্কে JSON লোকেশন ডেটা প্রদান করে। এটি টেক্সট সার্চ (নতুন), নিয়ারবাই সার্চ (নতুন), অটো-কমপ্লিট (নতুন), জায়গার বিবরণ (নতুন) এবং জায়গার ফটো (নতুন) ফিচারকে সাপোর্ট করে।

Places API (নতুন): গুরুত্বপূর্ণ তথ্য

  • প্রোডাক্ট: Places API (নতুন)
  • এছাড়াও এই নামে পরিচিত: Places API
  • বিভাগ: জায়গা
  • প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
  • রান করে: সার্ভার (ব্যাকএন্ড কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • এক নজরে: Places API (নতুন) এক নজরে
  • আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। EEA বিলিং অ্যাড্রেস সহ প্রোজেক্টগুলি Google Maps Platform EEA পরিষেবার শর্তাবলী (৮ জুলাই ২০২৫ থেকে কার্যকর) ব্যবহার করে, যেখানে অক্ষাংশ, দ্রাঘিমাংশ এবং স্থান আইডি ছাড়া Places API কন্টেন্ট Places UI Kit ছাড়া অন্য কোনও ম্যাপের সাথে ব্যবহার করা যাবে না। AI-পরিচালিত জায়গা, রিভিউ ও এলাকার সারসংক্ষেপ শুধুমাত্র কাজ করে এমন ভাষা ও অঞ্চলে উপলভ্য।

Places API (নতুন): এটি কখন ব্যবহার করবেন

Places API (নতুন) ব্যবহার করুন যখন:

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

Places API (নতুন) ব্যবহার করবেন না যখন:

  • আপনি একটি নেটিভ Android অ্যাপ তৈরি করছেন। এর পরিবর্তে Android-এর জন্য Places SDK ব্যবহার করুন।
  • আপনি একটি নেটিভ iOS অ্যাপ তৈরি করছেন। এর পরিবর্তে iOS-এর জন্য Places SDK ব্যবহার করুন।
  • আপনি একটি ব্রাউজার ওয়েব অ্যাপ তৈরি করছেন এবং জাভাস্ক্রিপ্টে Places লাইব্রেরি লোড করতে চান। পরিবর্তে Maps JavaScript API ব্যবহার করুন।

Places API (New): setup

অফিসিয়াল Places API (নতুন) প্যাকেজ:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • যান: cloud.google.com/go/maps

Places API (নতুন): সাধারণ ভুল

  • সমস্যা: জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) ফিল্ডে কোনও ডিফল্ট তালিকা নেই; ফিল্ড মাস্ক ছাড়া অনুরোধ করলে সমস্যা হয়। সমাধান: fields বা $fields প্যারামিটার অথবা X-Goog-FieldMask হেডারের সাথে একটি রেসপন্স ফিল্ড মাস্ক পাস করুন। /maps/documentation/places/web-service/choose-fields দেখুন।
  • সমস্যা: সেশন শেষ হওয়ার পরে Autocomplete (New) সেশন টোকেন বাদ দেওয়া বা আবার ব্যবহার করা হলে, প্রতিটি অনুরোধের জন্য SKU: Autocomplete Requests হিসেবে আলাদাভাবে বিল করা হয়। সমাধান: প্রতিটি সেশনের জন্য একটি নতুন সেশন টোকেন (UUID v4 সাজেস্ট করা হয়) তৈরি করুন এবং জায়গার বিবরণ (নতুন) বা Address Validation অনুরোধের মাধ্যমে এটি শেষ করুন। /maps/documentation/places/web-service/place-session-tokens দেখুন।
  • সমস্যা: আগে থেকে থাকা বা AI-জেনারেটেড কোড যা Places API (Legacy) বা Maps JavaScript API PlacesService-কে কল করে, সেটি কোনও প্রোজেক্টে লিগ্যাসি API চালু না থাকলে LegacyApiNotActivatedMapError-এর সাথে ব্যর্থ হয়। সমাধান: Places API (নতুন)-এ কল মাইগ্রেট করুন এবং প্রয়োজনীয় ফিল্ড মাস্ক অন্তর্ভুক্ত করুন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন।
  • সমস্যা: সেভ করা জায়গার আইডি পুরনো হয়ে যেতে পারে; সেক্ষেত্রে জায়গার বিবরণ (নতুন) NOT_FOUND (HTTP 404) দেখায় এবং ভুল বা অসম্পূর্ণ আইডি HTTP 400 INVALID_ARGUMENT দেখায়। সমাধান: ১২ মাসের বেশি পুরনো স্টোর করা জায়গার আইডি রিফ্রেশ করুন। এর জন্য জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ করুন যাতে শুধু id ফিল্ডের (কোনও চার্জ লাগবে না) ব্যাপারে জিজ্ঞাসা করা হয়। /maps/documentation/places/web-service/place-id#refresh-id দেখুন।

Places API (নতুন) ব্যবহার করে আপনি কী কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।

Places API (নতুন): জেনারেটিভ AI

Places API (নতুন): Places