Geocoding API v4-এর ওভারভিউ

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

Geocoding API হল এমন একটি পরিষেবা যা ঠিকানা, অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক বা স্থান আইডি হিসেবে কোনও স্থান গ্রহণ করে। এটি ঠিকানাকে অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক এবং একটি স্থান আইডিতে রূপান্তর করে, অথবা অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক বা একটি স্থান আইডিকে একটি ঠিকানায় রূপান্তর করে।

Geocoding API v4 হাইপারলোকাল গন্তব্য ও আগমন সংক্রান্ত ইন্টেলিজেন্স এবং কোর কোঅর্ডিনেট-টু-অ্যাড্রেস রেজোলিউশন, দুটিই প্রদান করে। আপনি লাস্ট-মাইল ডেলিভারি, রাইডশেয়ার বা ধাপে ধাপে নেভিগেশন অভিজ্ঞতা তৈরি করছেন অথবা রাস্তার ঠিকানা কোঅর্ডিনেটে নরমালাইজ করছেন, v4 আপনার ব্যবহারের ক্ষেত্রে মানানসই ডেডিকেটেড এন্ডপয়েন্ট অফার করে।

আপনার অ্যাপ্লিকেশনের জন্য কোন এন্ডপয়েন্ট উপযুক্ত তা বুঝতে পারছেন না? জিওকোডিং পদ্ধতি বেছে নিন দেখুন।

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

Geocoding API v4-এ নিম্নলিখিত ক্ষমতা ও এন্ডপয়েন্ট অন্তর্ভুক্ত:

  • গন্তব্য সার্চ করা: কোনও ঠিকানা, স্থান আইডি বা কোঅর্ডিনেট থেকে গন্তব্যের জন্য হাইপারলোকাল আগমনের বিবরণ পান—যার মধ্যে বিল্ডিংয়ের প্রবেশপথ, রুট করা যায় এমন নেভিগেশন পয়েন্ট টোকেন, বিল্ডিং এবং গ্রাউন্ডের আউটলাইন, সাব-ডেস্টিনেশন এবং কাছাকাছি ল্যান্ডমার্ক অন্তর্ভুক্ত।
  • ঠিকানা জিওকোড করা: রাস্তার ঠিকানা ভৌগোলিক কোঅর্ডিনেট ও স্থান আইডিতে (ফরওয়ার্ড জিওকোডিং) পরিবর্তন করুন।
  • কোনও লোকেশন জিওকোড করা: অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ককে মানুষের-পঠনযোগ্য রাস্তার ঠিকানা বা প্রশাসনিক এলাকায় (রিভার্স জিওকোডিং) পরিবর্তন করা।
  • কোনও জায়গার জিওকোড করা: পরিচিত Google Maps Place ID-এর জন্য ফর্ম্যাট করা ঠিকানা সংক্রান্ত বিবরণ ও কোঅর্ডিনেট ফিরিয়ে আনা।

ফলাফল কোথায় দেখানো হবে তা আপনি নিয়ন্ত্রণ করতে পারবেন এবং ফলাফলকে নির্দিষ্ট অঞ্চল, দেশ বা পিন কোডে সীমাবদ্ধ করতে পারবেন।

ডেমো ব্যবহারের করে দেখুন

Geocoding API কীভাবে কাজ করে

Geocoding API v4 বেসিক জিওকোডিংয়ের পাশাপাশি গন্তব্য সার্চ করার সুবিধা প্রদান করে:

  • ডেস্টিনেশন সার্চ (SearchDestinations): ঠিকানা, স্থান আইডি বা কোঅর্ডিনেট পেয়ারকে একটি সমৃদ্ধ Destination অবজেক্টে সমাধান করে। শারীরিকভাবে পৌঁছানো গুরুত্বপূর্ণ হলে এই পদ্ধতি ব্যবহার করুন—যেমন, বিল্ডিংয়ের পছন্দের প্রবেশপথ শনাক্ত করা, নেভিগেশন পয়েন্ট টোকেন ব্যবহার করে ড্রাইভারদের নির্দিষ্ট পিকআপ বা ড্রপ-অফ পয়েন্টে নিয়ে যাওয়া, ম্যাপে বিল্ডিংয়ের ফুটপ্রিন্ট রেন্ডার করা বা একাধিক বিল্ডিংয়ের কমপ্লেক্সে নেভিগেট করা।
  • প্রাথমিক জিওকোডিং: ঠিকানা, কোঅর্ডিনেট ও স্থান আইডির মধ্যে পরিবর্তন করে:
    • জিওকোডিং: রাস্তার ঠিকানা যেমন "১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, ক্যালিফোর্নিয়া" অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক বা প্লেস আইডিতে পরিবর্তন করে যাতে ম্যাপ মার্কার প্লেস করা বা ম্যাপ ভিউ ফ্রেমকে কেন্দ্রে আনা যায়।
    • রিভার্স জিওকোডিং: ব্যবহারকারীর ড্রপ করা ম্যাপ পিন, লোকেশন পিকার বা UI ডিসপ্লের জন্য অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক বা স্থান আইডিকে মানুষের-পঠনযোগ্য রাস্তার ঠিকানায় পরিবর্তন করে।
    • জায়গার জিওকোডিং: পরিচিত Google Maps-এর জায়গা আইডির জন্য ঠিকানা সংক্রান্ত বিবরণ ও কোঅর্ডিনেট ফিরিয়ে আনে।

নিম্নলিখিত সারণীতে Geocoding API v4-এর মাধ্যমে উপলভ্য রিসোর্স এবং প্রতিটি পদ্ধতি থেকে পাওয়া ডেটার সারসংক্ষেপ দেওয়া হয়েছে:

ডেটা রিসোর্স ডেটা ফেরত দেওয়া হয়েছে রিটার্ন ফর্ম্যাট
গন্তব্য সার্চ করুন
(POST /v4/geocode/destinations) 		হাইপারলোকাল আগমন সংক্রান্ত ইন্টেলিজেন্স রিটার্ন করে: বিল্ডিং ও গ্রাউন্ড পলিগন (displayPolygon), ফিজিক্যাল entrances, রুটেবল navigationPoints (টোকেন সহ), হাইরারকিক্যাল containingPlaces ও subDestinations, রিলেশনাল landmarks এবং প্রাথমিক জায়গার বিবরণ। গন্তব্য সার্চ করুন বিকল্প দেখুন।
  • JSON
কোনও ঠিকানা জিওকোড করুন
(GET /v4/geocode/address) 		ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার ধরন দেখায়। জিওকোড রেসপন্স দেখুন।
কোনও লোকেশন জিওকোড করুন
(GET /v4/geocode/location) 		ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার ধরন দেখায়। রিভার্স জিওকোডিং রেসপন্স দেখুন।
কোনও জায়গার জিওকোড
(GET /v4/geocode/places) 		ঠিকানা, ঠিকানার উপাদান এবং ঠিকানার ধরন দেখায়। জায়গার জিওকোডিং সংক্রান্ত উত্তর দেখুন।

স্টেজ চ্যানেল চালু করুন

Geocoding API-এর ভার্সন ৪-এ GA, প্রিভিউ ও এক্সপেরিমেন্টাল ফিচারের জন্য আলাদা চ্যানেল আছে। আপনি প্রিভিউ বা পরীক্ষামূলক ফিচার ব্যবহার করতে চাইলে, আপনার অনুরোধে সঠিক চ্যানেল উল্লেখ করতে ভুলবেন না। যেমন, Experimental-এ Destinations এন্ডপয়েন্টের ফিচার অ্যাক্সেস করতে, এই HTTP অনুরোধ ব্যবহার করুন: https://geocode.googleapis.com/v4alpha/geocode/destinations।

লঞ্চের পর্যায় চ্যানেলের নাম
GA /v4/
প্রিভিউ /v4beta/
পরীক্ষামূলক /v4alpha/

Geocoding API v4-এর ফিচার

Geocoding API-এর ভার্সন ৪-এ এইসব নতুন ফিচার রয়েছে।

গন্তব্য সার্চ করার পদ্ধতি

v4-এ ডেস্টিনেশন সার্চ পদ্ধতি চালু করা হয়েছে, যার মাধ্যমে আপনি বিভিন্ন ইনপুট মাপকাঠির ভিত্তিতে বিভিন্ন ডেস্টিনেশন সম্পর্কে বিস্তারিত তথ্য পেতে পারবেন, যেমন ঠিকানা, স্থান আইডি বা অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক। উত্তরে AI-পরিচালিত সারসংক্ষেপ এবং নেভিগেশন পয়েন্ট টোকেন অন্তর্ভুক্ত থাকে যেখানে প্রাসঙ্গিক তথ্য থাকে যা সঠিক রুটিংয়ের জন্য Navigation SDK-তে পাস করা যেতে পারে।

Google Cloud স্ট্যান্ডার্ড প্ল্যাটফর্মে প্রয়োগ করা হয়েছে

Geocoding API v4, Google Cloud-এর পরিষেবা ইনফ্রাস্ট্রাকচার -এ প্রয়োগ করা হয়। এই প্রয়োগের ফলে আরও সুরক্ষিত ও বিশ্বস্ত প্ল্যাটফর্ম পাওয়া যায়, যেখানে OAuth-এর মতো উন্নত নিরাপত্তা বিকল্প থাকে। এই স্ট্যান্ডার্ড API ডিজাইন, API জুড়ে ধারাবাহিকতা বজায় রাখে যা Geocoding API v4-এর মাধ্যমে ডেভেলপমেন্টের দক্ষতা উন্নত করে।

OAuth সহায়তা যোগ করা হয়েছে

Geocoding API v4 যাচাইকরণের জন্য OAuth 2.0-এর ব্যবহার সমর্থন করে। Google ওয়েব সার্ভারের মতো সাধারণ OAuth 2.0 সিনারিও সমর্থন করে।

ফিল্ড মাস্ক সংক্রান্ত সহায়তা যোগ করা হয়েছে

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

API নিরাপত্তা

Geocoding API v4-কে সার্ভার-টু-সার্ভার API হিসেবে ডিজাইন করা হয়েছে। ব্রাউজার থেকে সরাসরি ক্লায়েন্ট-সাইড কল করলে API কী চুরি ও অপব্যবহারের উল্লেখযোগ্য ঝুঁকি থাকে, কারণ HTTP রেফারার সংক্রান্ত বিধিনিষেধ ওয়েব সার্ভিস এন্ডপয়েন্টের জন্য পর্যাপ্ত সুরক্ষা নয়।

আমরা আপনাকে নিজের ব্যাকএন্ড সার্ভার থেকে Geocoding API v4 কল করার জন্য বিশেষভাবে সাজেস্ট করি। নিরাপদ প্রয়োগের প্যাটার্ন এবং ক্লায়েন্ট-সাইডের প্রয়োজনীয়তার বিকল্প সম্পর্কে আরও জানতে, নিরাপত্তা সংক্রান্ত বিবেচনা দেখুন।