Geocoding API হল একটি ওয়েব পরিষেবা যা ঠিকানাকে কোঅর্ডিনেট ও স্থান আইডিতে এবং কোঅর্ডিনেট বা স্থান আইডিকে ঠিকানায় পরিবর্তন করে। এছাড়াও, এর v4 SearchDestinations পদ্ধতি বিল্ডিংয়ের প্রবেশপথ, নেভিগেশন পয়েন্ট, বিল্ডিং ও গ্রাউন্ডের আউটলাইন এবং আশেপাশের ল্যান্ডমার্কের মতো গন্তব্যের বিবরণ ফিরিয়ে দেয়।
Geocoding API: মূল তথ্য
- প্রোডাক্ট: Geocoding API
- বিভাগ: জায়গা
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Geocoding API এক নজরে
Geocoding API: কখন ব্যবহার করবেন
Geocoding API ব্যবহার করুন যখন:
- আপনাকে রাস্তার ঠিকানা অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক এবং আপনার ব্যাকএন্ড সার্ভারে একটি স্থান আইডিতে রূপান্তর করতে হবে।
- জিপিএস কোঅর্ডিনেট বা পরিচিত প্লেস আইডির জন্য আপনাকে ডিসপ্লে ঠিকানা বা প্রশাসনিক এলাকা (শহর, পিন কোড) দিতে হবে।
- ড্রাইভার বা কুরিয়ারকে গন্তব্যে পৌঁছানোর রুট দেখাতে আপনার বিল্ডিংয়ের প্রবেশপথ, রুট করা যায় এমন নেভিগেশন পয়েন্ট বা বিল্ডিং/গ্রাউন্ডের আউটলাইন প্রয়োজন।
- আপনাকে কোনও বড় কমপ্লেক্সের (এয়ারপোর্ট, মল, ক্যাম্পাস) মধ্যে কোনও গন্তব্যকে সাব-গন্তব্য বা আশেপাশের ল্যান্ডমার্কে সমাধান করতে হবে।
Geocoding API ব্যবহার করবেন না যখন:
- ক্লায়েন্ট-সাইড ব্রাউজার জাভাস্ক্রিপ্ট থেকে আপনার জিওকোডিং প্রয়োজন; এক্সপোজড API key সহ v4 কল করা একটি নিরাপত্তা ঝুঁকি। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
- আপনাকে জিওকোড করা গন্তব্যের রুট বা ETA গণনা করতে হবে। পরিবর্তে Routes API ব্যবহার করুন।
- Android অ্যাপে নেভিগেশন পয়েন্ট টোকেনের জন্য আপনার এক এক করে নির্দেশিকা প্রয়োজন। এর পরিবর্তে Android-এর জন্য Navigation SDK ব্যবহার করুন।
- iOS অ্যাপে নেভিগেশন পয়েন্ট টোকেনে এক এক করে নির্দেশিকা পেতে চান। এর পরিবর্তে iOS-এর জন্য Navigation SDK ব্যবহার করুন।
Geocoding API: সেট-আপ
- পরিষেবা চালু করতে:
geocoding-backend.googleapis.com - যাচাইকরণ: API কী, OAuth 2.0, পরিষেবা অ্যাকাউন্ট
- শুরু করা: Geocoding API সেট-আপ করুন
- রেফারেন্স: Geocoding API রেফারেন্স
- দাম: Geocoding API ব্যবহার ও বিলিং
- নীতি: Geocoding API সংক্রান্ত নীতি
- রিলিজ নোট: Geocoding API রিলিজ নোট
Geocoding API: সম্পর্কিত প্রোডাক্ট
- সাধারণত এগুলির সাথে ব্যবহার করা হয়: Routes API, Android-এর জন্য Navigation SDK, iOS-এর জন্য Navigation SDK
Geocoding API: সাধারণ ভুল
- সমস্যা: ফিল্ড মাস্ক ছাড়া
SearchDestinationsঅনুরোধে সমস্যা হয়;GeocodeAddress,GeocodeLocationওGeocodePlace-এর মতো ফিল্ড মাস্ক প্রয়োজন। সমাধান: প্রতিটিSearchDestinationsঅনুরোধেX-Goog-FieldMaskহেডার বা$fieldsপ্যারামিটার সেট করুন। /maps/documentation/geocoding/choose-fields দেখুন। - সমস্যা: v4
GeocodeAddress-এ কোনও হার্ড কম্পোনেন্ট ফিল্টার (v3components=country:US) নেই। স্ট্রাকচার্ডaddress.*প্যারামিটার একটি ঠিকানায় একত্রিত করা হয় এবং ফলাফল ফিল্টার করে না;regionCode-এরও v4-এ কোনও ডিফল্ট নেই (v3-এর ডিফল্ট হলus)। সমাধান: ক্লায়েন্ট-সাইডেresultsফিল্টার করুন: বড় হাতের অক্ষরে লেখাregionCode-এর সাথেpostalAddress.regionCodeম্যাচ করুন; বড় হাতের অক্ষরে লেখা ২-অক্ষরের অ্যাডমিন এরিয়ার সাথেpostalAddress.administrativeAreaএবংadministrative_area_level_naddressComponents(shortText) ম্যাচ করুন; ইনপুট ওpostalAddress.postalCode(স্পেস/হাইফেন বাদ দিন এবং অঞ্চল সংক্রান্ত নিয়ম প্রয়োগ করুন) দুটিই নরমালাইজ করুন। /maps/documentation/geocoding/geocoding-v4-migrate দেখুন। - সমস্যা: ব্রাউজার জাভাস্ক্রিপ্ট থেকে সরাসরি Geocoding API v4 কল করলে API কী প্রকাশ হয়ে যায়;
Refererহেডার জাল করে HTTP রেফারার সংক্রান্ত বিধিনিষেধ বাইপাস করা যেতে পারে। সমাধান: সুরক্ষিত কী ব্যবহার করে আপনার নিজস্ব ব্যাকএন্ড থেকে v4 কল করুন অথবা ক্লায়েন্ট-সাইডের প্রয়োজনের জন্য Maps JavaScript API Geocoding Service (v3 ব্যাকএন্ড) ব্যবহার করুন। /maps/documentation/geocoding/geocoding-v4-migrate দেখুন। - সমস্যা: v3 এবং অন্যান্য v4 পদ্ধতির মতো নয়,
SearchDestinationsএমন ফলাফল দেখাতে পারে যাতে সুনির্দিষ্ট প্রাথমিক ঠিকানা নেই। সমাধান: আপনার যদি শুধুমাত্র সুনির্দিষ্ট প্রাথমিক ঠিকানা সহ ফলাফল প্রয়োজন হয়, তাহলেplaceFilter.addressability-কেPRIMARY-এ সেট করুন। /maps/documentation/geocoding/geocoding-v4-migrate দেখুন। - সমস্যা: Geocoding API v3-এর জন্য লেখা কোড v4 REST রেসপন্সে কাজ করে না: v4-এ lowerCamelCase ফিল্ডের নাম (
addressComponents,address_componentsনয়) ব্যবহার করা হয়,statusওerror_messageসরিয়ে দেয় এবংresultsঅ্যারের পরিবর্তেGeocodePlaceথেকে একটি রুট অবজেক্ট রিটার্ন করে। সমাধান: v4 REST কলে HTTP স্ট্যাটাস কোড ও এরর বডি চেক করুন, lowerCamelCase ফিল্ড (addressComponents,postalAddress) পড়ুন এবং মনে রাখবেন যে gRPC রেসপন্স এখনও snake_case ব্যবহার করে। /maps/documentation/geocoding/geocoding-v4-migrate দেখুন।
Geocoding API: পুরনো এবং বন্ধ হয়ে যাওয়া ফিচার
- Geocoding API v3 হাইপারলোকাল ডেটা (
extra_computations:BUILDING_AND_ENTRANCES,NAVIGATION_POINTS,GROUNDS; রেসপন্স ফিল্ডbuildings.entrances,navigation_points,buildings.building_outlines,grounds): বন্ধ করা হয়েছে ১৩-০৮-২০২৫ থেকে। পরিবর্তন: Geocoding API v4SearchDestinationsপদ্ধতি (POST /v4/geocode/destinations)। মাইগ্রেশন গাইড দেখুন।
Geocoding API-এর সাহায্যে আপনি কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
- কোনও ঠিকানার অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক (জিওকোডিং) রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের জন্য ঠিকানা দেখান (রিভার্স জিওকোডিং)।
- নির্দিষ্ট ভিউপোর্টের মধ্যে ফলাফল দেখানোর জন্য জিওকোডিং অনুরোধ সীমাবদ্ধ করুন। মনে রাখবেন: Geocoding API v4-এ, locationBias ফলাফলকে কঠোরভাবে সীমাবদ্ধ করার পরিবর্তে নির্দিষ্ট ভিউপোর্টের দিকে পক্ষপাতিত্ব করে।
- জিওকোডিং বা রিভার্স জিওকোডিং অনুরোধকে শুধু নির্দিষ্ট অঞ্চল, দেশ বা পিন কোডের মধ্যে ফলাফল দেখানোর জন্য সীমাবদ্ধ করুন। মনে রাখবেন: Geocoding API v4-এ, regionCode ফলাফলকে কঠোরভাবে সীমাবদ্ধ করার পরিবর্তে একটি নির্দিষ্ট CLDR অঞ্চলের দিকে পক্ষপাতিত্ব করে; দেশ বা পোস্টাল কোড দ্বারা লিগ্যাসি v3 কম্পোনেন্ট ফিল্টারিংয়ের জন্য, https://developers.google.com/maps/documentation/geocoding/guides-v3/requests-geocoding#ComponentFiltering দেখুন।
- রিভার্স জিওকোডিং অনুরোধকে শুধু নির্দিষ্ট ধরনের ঠিকানার জন্য ফলাফল দেখানোর জন্য সীমাবদ্ধ করুন। মনে রাখবেন: Geocoding API v4-এ, প্রকার প্যারামিটার ফিল্টার, সার্চের পরে ঠিকানা প্রকার অনুযায়ী রিভার্স-জিওকোডিং ফলাফল ফিরিয়ে দেয়, অন্তর্নিহিত সার্চ সীমাবদ্ধ করার পরিবর্তে।
- কোনও ঠিকানার জন্য ল্যান্ডমার্ক বা এলাকার কাছাকাছি থাকা সংক্রান্ত তথ্য ফেরত দিন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের জন্য ল্যান্ডমার্ক বা এলাকার নৈকট্য সম্পর্কে তথ্য ফেরত দিন।
- Google প্লেস আইডেন্টিফায়ারের জন্য ল্যান্ডমার্ক বা এলাকার কাছাকাছি থাকা সংক্রান্ত তথ্য রিটার্ন করুন।
- Google প্লেস আইডেন্টিফায়ারের জন্য ঠিকানা রিটার্ন করুন।
- কোনও ঠিকানার জন্য বিল্ডিং আউটলাইনের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেটের জন্য বিল্ডিং আউটলাইনের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।
- Google Place শনাক্তকারীর জন্য কোনও বিল্ডিংয়ের আউটলাইনের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।
- কোনও ঠিকানার জন্য বিল্ডিংয়ের প্রবেশপথের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের একটি সেটের জন্য কোনও বিল্ডিংয়ের প্রবেশপথের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।
- Google Place শনাক্তকারীর জন্য কোনও বিল্ডিংয়ের প্রবেশপথের অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক রিটার্ন করুন।