GeocodeAddress
এবং SearchDestinations
পদ্ধতিগুলি একটি ঐচ্ছিক effort প্যারামিটারকে সমর্থন করে যা আপনাকে
প্রতিক্রিয়া লেটেন্সি এবং ঠিকানা রেজোলিউশনের নির্ভুলতার মধ্যে ট্রেড-অফ নিয়ন্ত্রণ করতে দেয়।
স্ট্যান্ডার্ড জিওকোডিং এক সেকেন্ডের কম লেটেন্সিতে ভালভাবে ফর্ম্যাট করা পোস্টাল অ্যাড্রেস ম্যানেজ করে,
বাস্তব-জগতের ইনপুট প্রায়শই অসম্পূর্ণ, অনানুষ্ঠানিক বা জটিল হয় (যেমন,
"Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West,
Mumbai" বা "where the warriors play, sf")। আরও বেশি effort
লেভেল কনফিগার করে, আপনি Geocoding API-কে জটিল অ্যাড্রেস সমাধান করার জন্য বর্ধিত যুক্তি এবং
দ্ব্যর্থতা নিরসন প্রয়োগ করার নির্দেশ দিতে পারেন।
প্রচেষ্টার লেভেল
effort প্যারামিটারের জন্য নিম্নলিখিত ভ্যালুগুলির মধ্যে একটি উল্লেখ করুন:
| Effort level | বিবরণ | সাধারণ লেটেন্সি | সাজেস্ট করা ব্যবহারের ক্ষেত্র |
|---|---|---|---|
EFFORT_UNSPECIFIED |
ডিফল্ট ভ্যালু। LOW প্রচেষ্টার মতোই আচরণ করে। |
সাব-সেকেন্ড | ডিফল্ট স্ট্যান্ডার্ড জিওকোডিং। |
LOW |
সবচেয়ে দ্রুত উত্তর দেওয়ার জন্য অপ্টিমাইজ করে। জটিল ঠিকানার জন্য এক্সটেন্ডেড সার্চ বা দ্ব্যর্থতা নিরসন করে না। | সাব-সেকেন্ড | রিয়েল-টাইম ইন্টার্যাক্টিভ লুকআপ, হাই-ভলিউম স্ট্যান্ডার্ড ঠিকানা যাচাইকরণ। |
MEDIUM |
স্পিড ও নির্ভুলতার মধ্যে ভারসাম্য বজায় রাখে। বেশিরভাগ অনুরোধ স্ট্যান্ডার্ড কম লেটেন্সি সহ ফিরে আসে। অস্পষ্ট বা জটিল ঠিকানার ক্ষেত্রে, নির্ভুলতা উন্নত করতে পরিষেবাটি অতিরিক্ত প্রসেসিং প্রয়োগ করে, যার জন্য কয়েক সেকেন্ড পর্যন্ত সময় লাগতে পারে। | স্ট্যান্ডার্ড ঠিকানার জন্য সাব-সেকেন্ড; অস্পষ্ট ঠিকানার জন্য কয়েক সেকেন্ড পর্যন্ত (≤ ৪ সেকেন্ড) | ইন্টার্যাক্টিভ ব্যবহারকারীর ওয়ার্কফ্লো (যেমন চেক-আউটের সময় ঠিকানা কনফার্ম করা) যেখানে ব্যবহারকারী অল্প সময়ের জন্য অপেক্ষা করতে পারেন। |
HIGH |
অসম্পূর্ণ, অনানুষ্ঠানিক বা জটিল ঠিকানার জন্য ঠিকানা রেজোলিউশনের নির্ভুলতা সর্বাধিক করে। উত্তর দিতে অনেক বেশি সময় লাগতে পারে। | জটিল ঠিকানার ক্ষেত্রে ২০ সেকেন্ড পর্যন্ত সময় লাগতে পারে | ব্যাকগ্রাউন্ড প্রসেসিং, ব্যাচ জিওকোডিং, লজিস্টিক্স ডিসপ্যাচ বা অ্যাসিঙ্ক্রোনাস পোস্ট-চেকআউট ঠিকানা রিফাইনমেন্ট। |
অনুরোধের উদাহরণ
গন্তব্য সার্চ করুন (SearchDestinations)
https://geocode.googleapis.com/v4alpha/geocode/destinations-এ আপনার POST অনুরোধের JSON অনুরোধের বডিতে effort ফিল্ড অন্তর্ভুক্ত করুন। effort
প্যারামিটারটি মূলত addressQuery
রেজোলিউশনকে প্রভাবিত করে:
curl -X POST -d '{
"addressQuery": {
"addressQuery": "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai"
},
"effort": "HIGH"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations
একটি ঠিকানা জিওকোড করুন (GeocodeAddress)
/v4alpha/ এন্ডপয়েন্টে আপনার GET অনুরোধে URL কোয়েরি প্যারামিটার হিসেবে effort প্যারামিটার পাস করুন:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ "https://geocode.googleapis.com/v4alpha/geocode/address/where+the+warriors+play,+sf?effort=MEDIUM"
লেটেন্সির প্রভাব কমানো
আপনার অ্যাপ্লিকেশনে MEDIUM বা HIGH এফর্ট ব্যবহার করার সময়, সিঙ্গেল-পাস অনুরোধ পাঠানো হল সবচেয়ে সহজ ইন্টিগ্রেশন, তবে এইসব মোডে অনুরোধ করলে আরও বেশি লেটেন্সি হতে পারে, যার ফলে সিঙ্ক্রোনাস, ব্যবহারকারী নিজে ইন্টার্যাক্ট করতে পারেন এমন এবং লেটেন্সি-সেনসিটিভ ওয়ার্কফ্লোতে দেরি হতে পারে।
ইন্টার্যাক্টিভ ইউজার ফ্লোতে (যেমন চেক-আউট বা বুকিং) এই লেটেন্সির প্রভাব কমাতে, আপনি মাল্টি-পাস ওয়ার্কফ্লো ব্যবহার করতে পারেন:
- পাস ১ (ইন্ট্যার্যাক্টিভ): সাব-সেকেন্ড লেটেন্সি সহ ঠিকানা অবিলম্বে যাচাই করতে
effort=LOW(বা ডিফল্ট) সহ একটি সিঙ্ক্রোনাস অনুরোধ পাঠান। - পাস ২ (ব্যাকগ্রাউন্ড): ব্যবহারকারীকে ব্লক না করে, জটিল ঠিকানাগুলিকে উচ্চ-নির্ভুল স্থানাঙ্ক, প্রবেশদ্বার এবং নেভিগেশন পয়েন্টে সমাধান করতে
effort=MEDIUMবাeffort=HIGH(যেমন, চেকআউট-পরবর্তী বা প্রেরণের আগে) সহ একটি অ্যাসিঙ্ক্রোনাস ফলো-আপ অনুরোধ পাঠান।
ব্যবহারের সীমা
এক্সপেরিমেন্টাল (v4alpha) লঞ্চের পর্যায়ে, effort-এর সাথে MEDIUM বা HIGH-এ সেট করা অনুরোধের ক্ষেত্রে স্ট্যান্ডার্ড (LOW) অনুরোধের তুলনায় আরও কঠোর রেট সীমা প্রযোজ্য হয়। আপনার অ্যাপ্লিকেশন এই রেট সীমা অতিক্রম করলে, API একটি
RESOURCE_EXHAUSTED (HTTP 429) ত্রুটি দেখায়। আপনি যদি HTTP 429 সমস্যার সম্মুখীন হন বা
আপনার ব্যবহারের ক্ষেত্রে আরও বেশি কোটার প্রয়োজন হয়, তাহলে
মতামত চ্যানেলের মাধ্যমে আমাদের সাথে যোগাযোগ করুন।
মতামত
এটি Geocoding API-এর একটি পরীক্ষামূলক ফিচার। আমরা geocoding-feedback-channel@google.com-এ মতামত পেলে খুশি হব।