Geocoding API-এর দ্রুত রেফারেন্স

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 API: সাধারণ ভুল

  • সমস্যা: ফিল্ড মাস্ক ছাড়া SearchDestinations অনুরোধে সমস্যা হয়; GeocodeAddress, GeocodeLocation ও GeocodePlace-এর মতো ফিল্ড মাস্ক প্রয়োজন। সমাধান: প্রতিটি SearchDestinations অনুরোধে X-Goog-FieldMask হেডার বা $fields প্যারামিটার সেট করুন। /maps/documentation/geocoding/choose-fields দেখুন।
  • সমস্যা: v4 GeocodeAddress-এ কোনও হার্ড কম্পোনেন্ট ফিল্টার (v3 components=country:US) নেই। স্ট্রাকচার্ড address.* প্যারামিটার একটি ঠিকানায় একত্রিত করা হয় এবং ফলাফল ফিল্টার করে না; regionCode-এরও v4-এ কোনও ডিফল্ট নেই (v3-এর ডিফল্ট হল us)। সমাধান: ক্লায়েন্ট-সাইডে results ফিল্টার করুন: বড় হাতের অক্ষরে লেখা regionCode-এর সাথে postalAddress.regionCode ম্যাচ করুন; বড় হাতের অক্ষরে লেখা ২-অক্ষরের অ্যাডমিন এরিয়ার সাথে postalAddress.administrativeArea এবং administrative_area_level_n addressComponents (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 v4 SearchDestinations পদ্ধতি (POST /v4/geocode/destinations)। মাইগ্রেশন গাইড দেখুন।

Geocoding API-এর সাহায্যে আপনি কী করতে পারবেন

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