জায়গার আইডি

প্ল্যাটফর্ম বেছে নিন: Android iOS JavaScript ওয়েব পরিষেবা

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

আপনার বিলিং ঠিকানা ইউরোপীয় অর্থনৈতিক অঞ্চলে হলে, ৮ জুলাই ২০২৫ থেকে কার্যকর, Google Maps Platform EEA পরিষেবার শর্তাবলী আপনার পরিষেবা ব্যবহারের ক্ষেত্রে প্রযোজ্য হবে। অঞ্চল অনুযায়ী কার্যকারিতা আলাদা আলাদা হয়। আরও জানুন।

ভূমিকা

প্লেস আইডি, Google Places ডেটাবেস ও Google Maps-এ কোনও জায়গাকে অনন্যভাবে শনাক্ত করে। নিম্নলিখিত Maps API-তে করা অনুরোধে প্লেস আইডি গ্রহণ করা হয়:

• Geocoding API এবং Geocoding Service, Maps JavaScript API-তে কোনও Place ID-র জন্য ঠিকানা পাওয়া।
• Routes API এবং Directions API (পুরনো) এবং Directions Service, Maps JavaScript API (পুরনো)-তে শুরুর স্থান, গন্তব্য এবং মধ্যবর্তী ওয়েপয়েন্ট উল্লেখ করা।
• Routes API এবং Distance Matrix API (পুরনো) এবং Distance Matrix Service, Maps JavaScript API (পুরনো)-তে শুরু ও গন্তব্যস্থল নির্দিষ্ট করা।
• Places API (নতুন), Android-এর জন্য Places SDK (নতুন), iOS-এর জন্য Places SDK (নতুন) এবং Places লাইব্রেরিতে জায়গার বিবরণ ফিরিয়ে আনা।
• Maps Embed API-তে Place ID প্যারামিটার ব্যবহার করা।
• Maps URL-এ সার্চ কোয়েরি রিট্রিভ করা।
• Roads API-তে স্পিড লিমিট দেখানো।
• সীমানার জন্য ডেটা-ড্রিভেন স্টাইলিংয়ে সীমানা সংক্রান্ত পলিগন খুঁজে পাওয়া ও স্টাইল করা।

কোনও নির্দিষ্ট জায়গার আইডি খুঁজে পাওয়া

আপনি কি কোনও নির্দিষ্ট জায়গার প্লেস আইডি খুঁজছেন? কোনও জায়গা খুঁজতে এবং তার আইডি পেতে, নিচে দেওয়া প্লেস আইডি ফাইন্ডার ব্যবহার করুন:

অথবা, আপনি Maps JavaScript API ডকুমেন্টেশনে এর কোড সহ প্লেস আইডি ফাইন্ডার দেখতে পারেন।

এক নজরে

প্লেস আইডি হল একটি টেক্সচুয়াল শনাক্তকারী যা কোনও জায়গাকে অনন্যভাবে শনাক্ত করে। শনাক্তকারীর দৈর্ঘ্য আলাদা হতে পারে (প্লেস আইডির কোনও সর্বাধিক দৈর্ঘ্য নেই)। উদাহরণ:

• ChIJgUbEo8cfqokR5lP9_Wh_DaM
• GhIJQWDl0CIeQUARxks3icF8U8A
• EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
• EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
• IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

ব্যবসা, ল্যান্ডমার্ক, পার্ক ও ইন্টারসেকশন সহ বেশিরভাগ লোকেশনের জন্য প্লেস আইডি উপলভ্য। একই জায়গা বা লোকেশনের একাধিক আলাদা আলাদা প্লেস আইডি থাকতে পারে। সময়ের সাথে সাথে প্লেস আইডি পরিবর্তন হতে পারে।

আপনি Places API এবং একাধিক Google Maps Platform API জুড়ে একই প্লেস আইডি ব্যবহার করতে পারবেন। যেমন, আপনি একই প্লেস আইডি ব্যবহার করে Places API, Maps JavaScript API, Geocoding API, Maps Embed API এবং Roads API-তে কোনও জায়গার রেফারেন্স দিতে পারবেন।

প্লেস আইডি ব্যবহার করে জায়গার বিবরণ ফিরিয়ে আনা

Maps JavaScript API-তে Places API বা Places লাইব্রেরি ব্যবহার করে কোনও জায়গা সার্চ করা হল প্লেস আইডি ব্যবহার করার একটি সাধারণ উপায়। তারপরে, জায়গার বিবরণ পেতে, ফেরত পাওয়া জায়গার আইডি ব্যবহার করুন। আপনি প্লেস আইডি সেভ করে রাখতে পারেন এবং পরে একই জায়গার বিবরণ পেতে এটি ব্যবহার করতে পারেন। এই ডকুমেন্টের পরে প্লেস আইডি সেভ করা সম্পর্কে পড়ুন।

Maps JavaScript API-তে Places Library ব্যবহার করার উদাহরণ

আপনার JavaScript অ্যাপে কোনও প্লেস আইডি ব্যবহার করতে, আপনাকে প্রথমে আইডিটি খুঁজে নিতে হবে, যা PlaceResult থেকে পাওয়া যায় প্লেস সার্চ অথবা getPlace() থেকে পাওয়া যায় প্লেস অটোকমপ্লিট (Legacy) পরিষেবা। তারপরে, আপনি জায়গার বিবরণ দেখতে প্লেস আইডি ব্যবহার করতে পারবেন।

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

পরে ব্যবহারের জন্য প্লেস আইডি সেভ করা

Google Maps Platform পরিষেবার শর্তাবলীর ধারা ৩.২.৩(খ) -এ উল্লিখিত ক্যাশিং সংক্রান্ত বিধিনিষেধ থেকে প্লেস আইডি মুক্ত। তাই, আপনি পরে ব্যবহার করার জন্য প্লেস আইডি ভ্যালু সেভ করে রাখতে পারেন।

সেভ করা জায়গার আইডি রিফ্রেশ করা

Google Maps ডেটাবেসে আপডেট হওয়ার কারণে প্লেস আইডি পরিবর্তন হতে পারে, তাই Google ১২ মাসের বেশি পুরনো প্লেস আইডি রিফ্রেশ করার সাজেশন দেয়। আপনি কোনও চার্জ ছাড়াই প্লেস আইডি রিফ্রেশ করতে পারবেন, এর জন্য প্লেস বিবরণের অনুরোধ করতে হবে, fields প্যারামিটারে শুধুমাত্র place_id ফিল্ড উল্লেখ করতে হবে।

এই কলটি Places Details - ID Refresh SKU ট্রিগার করে।

প্লেস আইডি ব্যবহার করার সময় হওয়া সমস্যা কোড

INVALID_REQUEST

INVALID_REQUEST স্ট্যাটাস কোড থেকে বোঝা যায় যে নির্দিষ্ট করা প্লেস আইডি সঠিক নয়। প্লেস আইডি ট্রাঙ্কেট করা বা অন্য কোনওভাবে পরিবর্তন করা হলে এবং সেটি আর সঠিক না থাকলে, INVALID_REQUEST রিটার্ন করা হতে পারে।

NOT_FOUND

NOT_FOUND স্ট্যাটাস কোড থেকে বোঝা যায় যে নির্দিষ্ট জায়গার আইডি পুরনো হয়ে গেছে। কোনও ব্যবসা বন্ধ হয়ে গেলে বা নতুন লোকেশনে চলে গেলে প্লেস আইডি অপ্রচলিত হয়ে যেতে পারে। Google Maps ডেটাবেসে আপডেট হওয়ার কারণেও প্লেস আইডি পরিবর্তন হতে পারে। এইসব ক্ষেত্রে, কোনও জায়গা নতুন প্লেস আইডি পেতে পারে এবং পুরনো আইডি NOT_FOUND উত্তর দেয়।

মনে রাখবেন: Google Maps ডেটাবেস থেকে কোনও প্লেস আইডি সরিয়ে দেওয়ার পরেও কয়েকদিন পর্যন্ত জায়গা অটোমেটিক সম্পূর্ণ করা (লিগ্যাসি), কোয়েরি অটোমেটিক সম্পূর্ণ করা (লিগ্যাসি) বা অটোমেটিক সম্পূর্ণ করা (নতুন) রেসপন্সে পুরনো প্লেস আইডি দেখানো হতে পারে।

কোনও জায়গার আইডি পুরনো হয়ে গেলে ফলাফল রিফ্রেশ করতে, আসল অনুরোধটি সেভ করুন যা প্রতিটি জায়গার আইডি ফিরিয়ে দেয় এবং প্রয়োজন অনুযায়ী অনুরোধটি আবার ইস্যু করুন। মনে রাখবেন, আবার ইস্যু করা অনুরোধের জন্য সঠিক SKU-তে বিল করা হয়।

কিছু ধরনের প্লেস আইডি কখনও কখনও NOT_FOUND উত্তর দিতে পারে অথবা API উত্তরে একটি আলাদা প্লেস আইডি ফেরাতে পারে। এইসব জায়গার আইডি ধরনের মধ্যে অন্তর্ভুক্ত হল:

• Google Maps-এ সুনির্দিষ্ট ঠিকানা হিসেবে নেই, কিন্তু একাধিক ঠিকানা থেকে অনুমান করা হয়েছে এমন রাস্তার ঠিকানা।
• দীর্ঘ রুটের সেগমেন্ট, যেখানে অনুরোধে কোনও শহর বা স্থানীয় এলাকাও উল্লেখ করা হয়েছে।
• ইন্টারসেকশন।
• subpremise ধরনের ঠিকানা কম্পোনেন্ট সহ জায়গা।

এইসব আইডি প্রায়ই একটি বড় স্ট্রিংয়ের মতো হয় (প্লেস আইডির কোনও সর্বাধিক দৈর্ঘ্য নেই)। যেমন:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4