অক্টোবর ২০২৬ থেকে নতুন Google Cloud প্রোজেক্টের জন্য Places API (পুরনো ভার্সন) আর চালু করা যাবে না। আগে থেকে থাকা প্রোজেক্টে সম্পূর্ণ সহায়তা পাওয়া যাবে। নতুন ফিচার ও উন্নত পারফর্ম্যান্সের জন্য Places API (নতুন)-এ মাইগ্রেট করুন।
Places API (লিগ্যাসি): গুরুত্বপূর্ণ তথ্য
- প্রোডাক্ট: Places API (পুরনো)
- এছাড়াও এই নামে পরিচিত: Places API (পুরনো ওয়েব পরিষেবা), Places API ওয়েব পরিষেবা (maps/api/place)
- বিভাগ: জায়গা
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: লিগ্যাসি
- এর পরিবর্তে: Places API (নতুন)
- এক নজরে: Places API (Legacy) এক নজরে
Places API (পুরনো ভার্সন): এটি কখন ব্যবহার করবেন
Places API (Legacy) ব্যবহার করুন যখন:
- আপনি আগে থেকেই এমন একটি প্রোজেক্ট ম্যানেজ করছেন যেখানে Places API (Legacy) চালু করা আছে এবং
maps.googleapis.com/maps/api/placeএন্ডপয়েন্ট কল করে। - মাইগ্রেট করার সময় কাজ চালিয়ে যেতে, আপনার আগে থেকে থাকা জায়গা খোঁজা, নিয়ারবাই Search, টেক্সট সার্চ, বিবরণ, ফটো বা অটোমেটিক সম্পূর্ণ (লিগ্যাসি) কল প্রয়োজন।
এইসব ক্ষেত্রে Places API (Legacy) ব্যবহার করবেন না:
- আপনি একটি নতুন Google Cloud প্রোজেক্ট শুরু করছেন। অক্টোবর ২০২৬ থেকে, নতুন প্রোজেক্টের জন্য Places API (Legacy) চালু করা যাবে না। পরিবর্তে Places API (নতুন) ব্যবহার করুন।
- আপনার নতুন ফিচার, OAuth যাচাইকরণ বা নিয়ারবাই Search ও টেক্সট সার্চে ফিল্ড মাস্ক প্রয়োজন, যাতে আপনি শুধু অনুরোধ করা ফিল্ডের জন্য পেমেন্ট করেন। পরিবর্তে Places API (নতুন) ব্যবহার করুন।
- নতুন কোডে আপনার Find Place (Legacy) বা Query Autocomplete (Legacy) প্রয়োজন। টেক্সট সার্চ (নতুন) এবং অটো-কমপ্লিট (নতুন) এগুলিকে প্রতিস্থাপন করে। পরিবর্তে Places API (নতুন) ব্যবহার করুন।
Places API (Legacy): setup
- পরিষেবা চালু করতে:
places-backend.googleapis.com - যাচাইকরণ: API key
- দাম: Places API (Legacy) ব্যবহার ও বিলিং
- নীতি: Places API (Legacy) নীতি
Places API (পুরনো ভার্সন): সাধারণ ভুল
- সমস্যা: কোনও জায়গার বিবরণ (লিগ্যাসি) সংক্রান্ত অনুরোধে
fieldsপ্যারামিটার বাদ দেওয়া হলে বা কোনও ফিল্ড উল্লেখ করা না হলে, API সব ফিল্ড ফিরিয়ে দেয় এবং সবকটির জন্য আপনাকে বিল করে। সমাধান: সবসময়fieldsপ্যারামিটার সেট করুন অথবা ফিল্ড মাস্ক সহ জায়গার বিবরণ (নতুন) ফিচারে মাইগ্রেট করুন। /maps/documentation/places/web-service/legacy/details দেখুন। - সমস্যা: নিয়ারবাই Search (Legacy) এবং টেক্সট সার্চ (Legacy) কোন ফিল্ড রিটার্ন করতে হবে তা নির্দিষ্ট করা সমর্থন করে না। এগুলি সবসময় ফিল্ডের একটি নির্দিষ্ট সেট (জায়গার বিবরণ ফিল্ডের একটি সাবসেট) রিটার্ন করে এবং বেসিক ডেটা, পরিচিতি ডেটা ও অ্যাটমোস্ফিয়ার ডেটা SKU ট্রিগার করে। সমাধান: ফিল্ড মাস্ক সহ নিয়ারবাই Search (নতুন) বা টেক্সট সার্চ (নতুন) ফিচারে মাইগ্রেট করুন অথবা আপনার প্রয়োজনীয় ফিল্ডের জন্য অনুরোধ করতে ও পেমেন্ট করতে
fieldsপ্যারামিটার সহ Find Place (Legacy) ব্যবহার করুন। /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku দেখুন। - সমস্যা:
photo_referenceক্যাশে করা যায় না এবং এর মেয়াদ শেষ হয়ে যেতে পারে, তাই সেভ করা রেফারেন্স কাজ করা বন্ধ করে দেয়। সমাধান: কোনও ফটোর জন্য অনুরোধ করার আগে জায়গার বিবরণ, জায়গা খোঁজা, আশেপাশের সার্চ বা টেক্সট সার্চের উত্তর থেকে নতুনphoto_referenceপান। /maps/documentation/places/web-service/legacy/photos দেখুন। - সমস্যা: কোনও প্রোজেক্টে Places API (Legacy) চালু করা না থাকলে, সেখান থেকে API কল করলে
REQUEST_DENIEDসহ এই সমস্যার মেসেজ দেখানো হয়, "আপনি একটি লিগ্যাসি API কল করছেন, যা আপনার প্রোজেক্টের জন্য চালু করা নেই..." (LegacyApiNotActivatedMapError)। অক্টোবর ২০২৬ থেকে, নতুন প্রোজেক্টের জন্য Places API (Legacy) চালু করা যাবে না। সমাধান: নতুন প্রোজেক্টের জন্য Places API (নতুন) ব্যবহার করুন এবং আগে থেকে থাকা অ্যাপ মাইগ্রেট করুন। মাইগ্রেট করার সময়, আপনি লিগ্যাসি পৃষ্ঠায় মতামত জানানোর ফর্মের মাধ্যমে লিগ্যাসি API-এর স্বল্প-মেয়াদী অ্যাক্টিভেশনের জন্য অনুরোধ করতে পারেন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন।
Places API (লিগ্যাসি): লিগ্যাসি এবং অননুমোদিত ফিচার
permanently_closedরেসপন্স ফিল্ড: বন্ধ করে দেওয়া হয়েছে ২৬-০৫-২০২০ থেকে। পরিবর্তন:business_statusফিল্ড। মাইগ্রেশন গাইড দেখুন।referenceউত্তর দেওয়ার ফিল্ড: বন্ধ করা হয়েছে ৩ সেপ্টেম্বর, ২০১৯ থেকে। পরিবর্তন:place_idফিল্ড। মাইগ্রেশন গাইড দেখুন।- Nearby Search (Legacy)
nameঅনুরোধের প্যারামিটার: বন্ধ করা হয়েছে। পরিবর্তন:keywordপ্যারামিটার। মাইগ্রেশন গাইড দেখুন।