ভূমিকা
স্বয়ংসম্পূর্ণ (নতুন) একটি ওয়েব পরিষেবা যা একটি HTTP অনুরোধের প্রতিক্রিয়া হিসাবে স্থানের পূর্বাভাস এবং কোয়েরির পূর্বাভাস প্রদান করে। অনুরোধে, একটি পাঠ্য অনুসন্ধান স্ট্রিং এবং ভৌগলিক সীমা নির্দিষ্ট করুন যা অনুসন্ধান এলাকা নিয়ন্ত্রণ করে।
স্বয়ংসম্পূর্ণ (নতুন) ইনপুটের সম্পূর্ণ শব্দ এবং সাবস্ট্রিংগুলির সাথে মিলিত হতে পারে, স্থানের নাম, ঠিকানা এবং প্লাস কোডগুলি সমাধান করতে পারে৷ তাই অ্যাপ্লিকেশনগুলি ব্যবহারকারীর প্রকার হিসাবে প্রশ্ন পাঠাতে পারে, উড়তে থাকা স্থান এবং ক্যোয়ারী পূর্বাভাস প্রদান করতে।
স্বয়ংসম্পূর্ণ (নতুন) এর প্রতিক্রিয়াতে দুটি ধরণের ভবিষ্যদ্বাণী থাকতে পারে:
- স্থানের পূর্বাভাস : নির্দিষ্ট ইনপুট টেক্সট স্ট্রিং এবং অনুসন্ধান এলাকার উপর ভিত্তি করে স্থান, যেমন ব্যবসা, ঠিকানা এবং আগ্রহের পয়েন্ট। স্থান পূর্বাভাস ডিফল্টরূপে ফেরত দেওয়া হয়.
- ক্যোয়ারী ভবিষ্যদ্বাণী : ইনপুট টেক্সট স্ট্রিং এবং অনুসন্ধান এলাকার সাথে মেলে কোয়েরি স্ট্রিং। ক্যোয়ারী পূর্বাভাস ডিফল্টরূপে ফেরত দেওয়া হয় না. প্রতিক্রিয়াতে ক্যোয়ারী পূর্বাভাস যোগ করতে
includeQueryPredictionsঅনুরোধ প্যারামিটার ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি ইনপুট হিসাবে একটি স্ট্রিং ব্যবহার করে স্বয়ংসম্পূর্ণ (নতুন) কল করেন যাতে একটি আংশিক ব্যবহারকারী ইনপুট থাকে, "সিসিলিয়ান পিজ", অনুসন্ধান এলাকা সান ফ্রান্সিসকো, CA-তে সীমাবদ্ধ। তারপরে প্রতিক্রিয়াটিতে স্থানের পূর্বাভাসগুলির একটি তালিকা রয়েছে যা অনুসন্ধান স্ট্রিং এবং অনুসন্ধান এলাকার সাথে মেলে, যেমন "সিসিলিয়ান পিজা কিচেন" নামক রেস্তোরাঁর সাথে জায়গার বিবরণ সহ।
প্রত্যাবর্তিত স্থানের ভবিষ্যদ্বাণীগুলি ব্যবহারকারীর কাছে উপস্থাপিত করার জন্য ডিজাইন করা হয়েছে যাতে তাদের উদ্দেশ্যযুক্ত স্থান নির্বাচন করতে সহায়তা করা যায়। আপনি একটি স্থান বিবরণ (নতুন) অনুরোধ করতে পারেন প্রত্যাবর্তিত স্থান ভবিষ্যদ্বাণীগুলির যেকোনো সম্পর্কে আরও তথ্য পেতে।
প্রতিক্রিয়াটিতে অনুসন্ধান স্ট্রিং এবং অনুসন্ধান এলাকার সাথে মেলে এমন প্রশ্নের পূর্বাভাসের একটি তালিকাও থাকতে পারে, যেমন "সিসিলিয়ান পিজা এবং পাস্তা"। প্রতিক্রিয়ার প্রতিটি প্রশ্নের পূর্বাভাস একটি প্রস্তাবিত পাঠ্য অনুসন্ধান স্ট্রিং ধারণকারী text ক্ষেত্র অন্তর্ভুক্ত করে। আরও বিস্তারিত অনুসন্ধান করতে পাঠ্য অনুসন্ধানে (নতুন) ইনপুট হিসাবে সেই স্ট্রিংটি ব্যবহার করুন।
APIs এক্সপ্লোরার আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন:
স্বয়ংসম্পূর্ণ (নতুন) অনুরোধ
একটি স্বয়ংসম্পূর্ণ (নতুন) অনুরোধ হল ফর্মের একটি URL-এর জন্য একটি HTTP POST অনুরোধ:
https://places.googleapis.com/v1/places:autocomplete
JSON অনুরোধের বডিতে বা POST অনুরোধের অংশ হিসাবে হেডারে সমস্ত প্যারামিটার পাস করুন। যেমন:
curl -X POST -d '{
"input": "pizza",
"locationBias": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
সমর্থিত পরামিতি
প্যারামিটার | বর্ণনা |
|---|---|
| সার্চ করার জন্য টেক্সট স্ট্রিং (সম্পূর্ণ শব্দ, সাবস্ট্রিং, জায়গার নাম, ঠিকানা, প্লাস কোড)। |
| কমা দ্বারা বিভক্ত তালিকা যা প্রতিক্রিয়াতে ফিরে আসবে তা নির্দিষ্ট করে। |
পাঁচটি নির্দিষ্ট প্রাথমিক প্রকারের মধ্যে একটির সাথে মিলে যাওয়া স্থানগুলিতে ফলাফল সীমাবদ্ধ করে৷ | |
সত্য হলে, প্রকৃত অবস্থান ছাড়া ব্যবসা অন্তর্ভুক্ত করে (পরিষেবা এলাকা ব্যবসা)। ডিফল্ট থেকে মিথ্যা. | |
সত্য হলে, উত্তরে স্থান এবং ক্যোয়ারী উভয় পূর্বাভাস অন্তর্ভুক্ত করে। ডিফল্ট থেকে মিথ্যা. | |
ফলাফল সীমাবদ্ধ করতে 15টি পর্যন্ত দুই-অক্ষরের দেশের কোডের অ্যারে। | |
ইনপুট স্ট্রিং এর মধ্যে কার্সার অবস্থানের জিরো-ভিত্তিক ইউনিকোড চার অফসেট, পূর্বাভাসকে প্রভাবিত করে। ইনপুট দৈর্ঘ্য ডিফল্ট. | |
ফলাফলের জন্য পছন্দের ভাষা (IETF BCP-47 কোড)। Accept-Language হেডার বা 'en'-তে ডিফল্ট। | |
অনুসন্ধান ফলাফলের দিকে পক্ষপাতিত্ব করার জন্য একটি এলাকা (বৃত্ত বা আয়তক্ষেত্র) নির্দিষ্ট করে, এলাকার বাইরের ফলাফলের অনুমতি দেয়। অবস্থান সীমাবদ্ধতার সাথে ব্যবহার করা যাবে না। | |
অনুসন্ধান ফলাফলের মধ্যে সীমাবদ্ধ করার জন্য একটি এলাকা (বৃত্ত বা আয়তক্ষেত্র) নির্দিষ্ট করে। এই এলাকার বাইরের ফলাফল বাদ দেওয়া হয়. অবস্থানবিয়াসের সাথে ব্যবহার করা যাবে না। | |
উৎপত্তি বিন্দু (অক্ষাংশ, দীর্ঘ) পূর্বাভাসিত গন্তব্যে সরল-রেখা দূরত্ব (দূরত্ব মিটার) গণনা করতে ব্যবহৃত হয়। | |
রেসপন্স এবং বায়াস সাজেশন ফরম্যাট করতে ব্যবহৃত অঞ্চল কোড (যেমন, 'uk', 'fr')। | |
বিলিং উদ্দেশ্যে একটি অধিবেশনে স্বয়ংসম্পূর্ণ কলগুলিকে গোষ্ঠীভুক্ত করতে ব্যবহারকারী-উত্পাদিত স্ট্রিং৷ |
প্রতিক্রিয়া সম্পর্কে
স্বয়ংসম্পূর্ণ (নতুন) প্রতিক্রিয়া হিসাবে একটি JSON অবজেক্ট প্রদান করে। প্রতিক্রিয়ায়:
-
suggestionsঅ্যারেতে তাদের অনুভূত প্রাসঙ্গিকতার উপর ভিত্তি করে ক্রমানুসারে সমস্ত ভবিষ্যদ্বাণী করা স্থান এবং প্রশ্ন রয়েছে। প্রতিটি স্থান একটিplacePredictionক্ষেত্র দ্বারা প্রতিনিধিত্ব করা হয় এবং প্রতিটি ক্যোয়ারী একটিqueryPredictionক্ষেত্র দ্বারা প্রতিনিধিত্ব করা হয়। - একটি
placePredictionক্ষেত্রটিতে স্থানের আইডি এবং পাঠ্যের বিবরণ সহ একটি স্থানের পূর্বাভাস সম্পর্কে বিস্তারিত তথ্য রয়েছে। - একটি
queryPredictionফিল্ডে একটি একক ক্যোয়ারী পূর্বাভাস সম্পর্কে বিস্তারিত তথ্য থাকে।
সম্পূর্ণ JSON অবজেক্টটি ফর্মে রয়েছে:
{
"suggestions": [
{
"placePrediction": {
"place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
"placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
"text": {
"text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
"matches": [
{
"endOffset": 6
}]
},
...
},
{
"queryPrediction": {
"text": {
"text": "Amoeba Music",
"matches": [
{
"endOffset": 6
}]
},
...
}
...]
}প্রয়োজনীয় পরামিতি
ইনপুট
যে টেক্সট স্ট্রিংটিতে সার্চ করতে হবে। সম্পূর্ণ শব্দ এবং সাবস্ট্রিং, স্থানের নাম, ঠিকানা এবং প্লাস কোড নির্দিষ্ট করুন। স্বয়ংসম্পূর্ণ (নতুন) পরিষেবা এই স্ট্রিংয়ের উপর ভিত্তি করে প্রার্থীর মিল ফেরত দেয় এবং তাদের অনুভূত প্রাসঙ্গিকতার উপর ভিত্তি করে ফলাফল অর্ডার করে।
ঐচ্ছিক পরামিতি
ফিল্ডমাস্ক
একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক তৈরি করে প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নির্দিষ্ট করুন। HTTP হেডার
X-Goog-FieldMaskব্যবহার করে পদ্ধতিতে প্রতিক্রিয়া ক্ষেত্র মাস্ক পাস করুন।প্রত্যাবর্তনের জন্য পরামর্শ ক্ষেত্রগুলির একটি কমা দ্বারা পৃথক তালিকা নির্দিষ্ট করুন৷ উদাহরণস্বরূপ, সাজেশনের
suggestions.placePrediction.text.textএবংsuggestions.queryPrediction.text.textপুনরুদ্ধার করতে।X-Goog-FieldMask: suggestions.placePrediction.text.text,suggestions.queryPrediction.text.text
সমস্ত ক্ষেত্র পুনরুদ্ধার করতে
*ব্যবহার করুন।X-Goog-FieldMask: *
প্রাইমারি টাইপস অন্তর্ভুক্ত
সারণি A বা সারণি B- তে তালিকাভুক্ত প্রকারগুলি থেকে একটি স্থানের শুধুমাত্র একটি প্রাথমিক প্রকার থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকার হতে পারে
"mexican_restaurant"বা"steak_house"।ডিফল্টরূপে, এপিআই
inputপ্যারামিটারের উপর ভিত্তি করে সমস্ত স্থান প্রদান করে, স্থানের সাথে সম্পর্কিত প্রাথমিক প্রকারের মান নির্বিশেষে।includedPrimaryTypesটাইপস প্যারামিটার পাস করে একটি নির্দিষ্ট প্রাথমিক প্রকার বা প্রাথমিক প্রকারের ফলাফলগুলিকে সীমাবদ্ধ করুন।সারণি A বা টেবিল B থেকে পাঁচটি পর্যন্ত মান নির্দিষ্ট করতে এই প্যারামিটারটি ব্যবহার করুন। প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য নির্দিষ্ট প্রাথমিক প্রকারের মানগুলির একটির সাথে একটি স্থান অবশ্যই মিলবে৷
এই প্যারামিটারটি এর পরিবর্তে,
(regions)বা(cities)এর মধ্যে একটি অন্তর্ভুক্ত করতে পারে। এলাকা বা বিভাগের জন্য(regions)ধরনের সংগ্রহ ফিল্টার, যেমন আশেপাশের এলাকা এবং পোস্টাল কোড।(cities)টাইপ সংগ্রহের ফিল্টার জায়গাগুলির জন্য যা Google একটি শহর হিসাবে চিহ্নিত করে৷অনুরোধটি একটি
INVALID_REQUESTত্রুটির সাথে প্রত্যাখ্যান করা হয় যদি:- পাঁচটিরও বেশি প্রকার নির্দিষ্ট করা হয়েছে।
- যেকোনো প্রকার
(cities)বা(regions)ছাড়াও নির্দিষ্ট করা হয়েছে। - কোনো অচেনা ধরনের নির্দিষ্ট করা হয়.
PureServiceAreaBusinesses অন্তর্ভুক্ত
যদি
trueতে সেট করা হয়, তাহলে প্রতিক্রিয়ার মধ্যে এমন ব্যবসাগুলি অন্তর্ভুক্ত থাকে যেগুলি সরাসরি গ্রাহকদের কাছে যায় বা ডেলিভার করে, কিন্তু তাদের কোনো প্রকৃত ব্যবসার অবস্থান নেই।falseসেট করা হলে, API শুধুমাত্র একটি প্রকৃত ব্যবসার অবস্থান সহ ব্যবসা ফেরত দেয়।Query Predictions অন্তর্ভুক্ত করুন
trueহলে, উত্তরে স্থান এবং ক্যোয়ারী উভয় ভবিষ্যদ্বাণী অন্তর্ভুক্ত থাকে। ডিফল্ট মানfalse, যার অর্থ প্রতিক্রিয়া শুধুমাত্র স্থান পূর্বাভাস অন্তর্ভুক্ত.অঞ্চল কোড অন্তর্ভুক্ত
শুধুমাত্র 15 ccTLD ("শীর্ষ-স্তরের ডোমেন") দুই-অক্ষরের মানগুলির একটি অ্যারে হিসাবে নির্দিষ্ট করা নির্দিষ্ট অঞ্চলের তালিকা থেকে ফলাফলগুলি অন্তর্ভুক্ত করুন৷ যদি বাদ দেওয়া হয়, তবে প্রতিক্রিয়াতে কোনো বিধিনিষেধ প্রয়োগ করা হয় না। উদাহরণস্বরূপ, অঞ্চলগুলিকে জার্মানি এবং ফ্রান্সের মধ্যে সীমাবদ্ধ করতে:
"includedRegionCodes": ["de", "fr"]
আপনি যদি উভয়
locationRestrictionএবংincludedRegionCodesকোডগুলি নির্দিষ্ট করেন, ফলাফল দুটি সেটিংসের ছেদ এলাকায় অবস্থিত।ইনপুটঅফসেট
শূন্য-ভিত্তিক ইউনিকোড অক্ষর অফসেট
inputকার্সার অবস্থান নির্দেশ করে। ভবিষ্যদ্বাণীগুলি কী ফেরত দেওয়া হয় তা কার্সারের অবস্থান প্রভাবিত করতে পারে। খালি থাকলে, এটিinputদৈর্ঘ্যে ডিফল্ট হয়।ভাষা কোড
পছন্দের ভাষা যেটিতে ফলাফল দিতে হবে। ফলাফলগুলি মিশ্র ভাষায় হতে পারে যদি
inputব্যবহৃত ভাষাlanguageCodeদ্বারা নির্দিষ্ট করা মান থেকে আলাদা হয়, অথবা যদি প্রত্যাবর্তিত স্থানটির স্থানীয় ভাষা থেকেlanguageCodeঅনুবাদ না থাকে।- পছন্দের ভাষা নির্দিষ্ট করতে আপনাকে অবশ্যই IETF BCP-47 ভাষার কোড ব্যবহার করতে হবে।
-
languageCodeসরবরাহ করা না হলে, APIAccept-Languageশিরোনামে নির্দিষ্ট মান ব্যবহার করে। যদি কোনটিই নির্দিষ্ট করা না থাকে, ডিফল্ট হলen. আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, API একটিINVALID_ARGUMENTত্রুটি প্রদান করে৷ - পছন্দের ভাষাটির ফলাফলের সেটের উপর একটি ছোট প্রভাব রয়েছে যা API ফেরত দিতে বেছে নেয় এবং যে ক্রমে সেগুলি ফেরত দেওয়া হয়। এটি বানান ত্রুটি সংশোধন করার জন্য API এর ক্ষমতাকেও প্রভাবিত করে।
- API একটি রাস্তার ঠিকানা প্রদান করার চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় জনসংখ্যা উভয়ের জন্যই পাঠযোগ্য, একই সময়ে ব্যবহারকারীর ইনপুট প্রতিফলিত করে। প্রতিটি অনুরোধে ব্যবহারকারীর ইনপুটের উপর নির্ভর করে স্থানের পূর্বাভাসগুলি ভিন্নভাবে ফর্ম্যাট করা হয়।
-
inputপ্যারামিটারে মিলিত পদগুলি প্রথমে বেছে নেওয়া হয়, যখন উপলব্ধlanguageCodeপ্যারামিটার দ্বারা নির্দেশিত ভাষা পছন্দের সাথে সারিবদ্ধ নামগুলি ব্যবহার করে, অন্যথায় ব্যবহারকারীর ইনপুটের সাথে সবচেয়ে ভাল মেলে এমন নামগুলি ব্যবহার করে৷ - রাস্তার ঠিকানাগুলি স্থানীয় ভাষায় ফর্ম্যাট করা হয়, একটি স্ক্রিপ্টে যখন সম্ভব ব্যবহারকারী দ্বারা পাঠযোগ্য, শুধুমাত্র
inputপ্যারামিটারের শর্তাবলীর সাথে মিলিত হওয়ার জন্য বাছাই করা হয়। -
inputপ্যারামিটারে থাকা শর্তের সাথে মিলিত পদগুলি বেছে নেওয়ার পরে, অন্যান্য সমস্ত ঠিকানা পছন্দের ভাষায় ফেরত দেওয়া হয়। পছন্দের ভাষায় একটি নাম উপলব্ধ না হলে, API সবচেয়ে কাছের মিল ব্যবহার করে।
-
অবস্থানবিয়াস বা অবস্থান সীমাবদ্ধতা
অনুসন্ধান এলাকা নির্ধারণ করতে আপনি
locationBiasবাlocationRestrictionউল্লেখ করতে পারেন, কিন্তু উভয়ই নয়। ফলাফলগুলি যে অঞ্চলের মধ্যে হতে হবে সেটিকে নির্দিষ্ট করেlocationRestrictionএবংlocationBiasসেই অঞ্চলটি নির্দিষ্ট করে যে ফলাফলগুলি অবশ্যই কাছাকাছি হতে হবে তবে এলাকার বাইরে হতে পারে বলে মনে করুন৷অবস্থান পক্ষপাত
অনুসন্ধান করার জন্য একটি এলাকা নির্দিষ্ট করে। এই অবস্থানটি একটি পক্ষপাত হিসাবে কাজ করে যার অর্থ নির্দিষ্ট স্থানের আশেপাশের ফলাফলগুলি নির্দিষ্ট এলাকার বাইরের ফলাফল সহ ফেরত দেওয়া যেতে পারে৷
অবস্থান সীমাবদ্ধতা
অনুসন্ধান করার জন্য একটি এলাকা নির্দিষ্ট করে। নির্দিষ্ট এলাকার বাইরে ফলাফল ফেরত দেওয়া হয় না.
একটি আয়তক্ষেত্রাকার ভিউপোর্ট বা একটি বৃত্ত হিসাবে
locationBiasবাlocationRestrictionঅঞ্চল নির্দিষ্ট করুন।একটি বৃত্তকে কেন্দ্র বিন্দু এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়। ব্যাসার্ধ অবশ্যই 0.0 এবং 50000.0 এর মধ্যে হতে হবে। ডিফল্ট মান হল 0.0।
locationRestrictionজন্য, আপনাকে অবশ্যই ব্যাসার্ধটি 0.0-এর চেয়ে বেশি মান নির্ধারণ করতে হবে। অন্যথায়, অনুরোধ কোন ফলাফল প্রদান করে.যেমন:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
একটি আয়তক্ষেত্র হল একটি অক্ষাংশ-দ্রাঘিমাংশের ভিউপোর্ট, যা দুটি তির্যকভাবে বিপরীত
lowএবং উচ্চ বিন্দু হিসাবে উপস্থাপিত হয়। একটি ভিউপোর্ট একটি বন্ধ অঞ্চল হিসাবে বিবেচিত হয়, যার অর্থ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই -90 থেকে 90 ডিগ্রী সহ, এবং দ্রাঘিমাংশের সীমাগুলি অবশ্যই -180 থেকে 180 ডিগ্রীর মধ্যে অন্তর্ভুক্ত থাকতে হবে:-
low=highহলে, ভিউপোর্টটি সেই একক বিন্দু নিয়ে গঠিত। -
low.longitude>high.longitudeহলে, দ্রাঘিমাংশের সীমাটি উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশের রেখা অতিক্রম করে)। -
low.longitude= -180 ডিগ্রি এবংhigh.longitude= 180 ডিগ্রি হলে, ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে। -
low.longitude= 180 ডিগ্রি এবংhigh.longitude= -180 ডিগ্রি হলে, দ্রাঘিমাংশের পরিসর খালি।
lowএবংhighউভয়ই জনবসতিপূর্ণ হতে হবে এবং প্রতিনিধিত্ব করা বাক্সটি খালি হতে পারে না। একটি খালি ভিউপোর্ট একটি ত্রুটির ফলাফল.উদাহরণস্বরূপ, এই ভিউপোর্টটি সম্পূর্ণরূপে নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
-
মূল
মূল বিন্দু যেখান থেকে গন্তব্যে সরলরেখার দূরত্ব গণনা করতে হবে (
distanceMetersহিসাবে ফিরে এসেছে)। যদি এই মানটি বাদ দেওয়া হয়, সরল-রেখার দূরত্ব ফেরত দেওয়া হবে না। অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক হিসাবে নির্দিষ্ট করা আবশ্যক:"origin": { "latitude": 40.477398, "longitude": -74.259087 }
অঞ্চল কোড
প্রতিক্রিয়া ফর্ম্যাট করতে ব্যবহৃত অঞ্চল কোড, একটি ccTLD ("টপ-লেভেল ডোমেন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়েছে। কিছু উল্লেখযোগ্য ব্যতিক্রম সহ বেশিরভাগ ccTLD কোডগুলি ISO 3166-1 কোডগুলির সাথে অভিন্ন। উদাহরণস্বরূপ, ইউনাইটেড কিংডমের ccTLD হল "uk" (.co.uk) যেখানে এর ISO 3166-1 কোড হল "gb" (প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" এর সত্তার জন্য)।
অঞ্চল কোডের উপর ভিত্তি করে পরামর্শগুলিও পক্ষপাতমূলক। Google ব্যবহারকারীর আঞ্চলিক পছন্দ অনুযায়ী
regionCodeসেট করার সুপারিশ করে।আপনি যদি একটি অবৈধ অঞ্চল কোড নির্দিষ্ট করেন, API একটি
INVALID_ARGUMENTত্রুটি প্রদান করে৷ প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।সেশন টোকেন
সেশন টোকেন হল ব্যবহারকারী-উত্পাদিত স্ট্রিং যা স্বয়ংসম্পূর্ণ (নতুন) কলগুলিকে "সেশন" হিসাবে ট্র্যাক করে। স্বয়ংসম্পূর্ণ (নতুন) বিলিং উদ্দেশ্যে একটি পৃথক সেশনে ব্যবহারকারী স্বয়ংসম্পূর্ণ অনুসন্ধানের প্রশ্ন এবং নির্বাচনের পর্যায়গুলিকে গ্রুপ করতে সেশন টোকেন ব্যবহার করে। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।
পক্ষপাতিত্ব ফলাফলের পরামিতি নির্বাচন করুন
স্বয়ংসম্পূর্ণ (নতুন) পরামিতিগুলি অনুসন্ধান ফলাফলকে ভিন্নভাবে প্রভাবিত করতে পারে। নিম্নলিখিত সারণীটি উদ্দেশ্যমূলক ফলাফলের উপর ভিত্তি করে প্যারামিটার ব্যবহারের জন্য সুপারিশ প্রদান করে।| প্যারামিটার | ব্যবহারের সুপারিশ |
|---|---|
regionCode | ব্যবহারকারীর আঞ্চলিক পছন্দ অনুযায়ী সেট করুন। |
includedRegionCodes | নির্দিষ্ট অঞ্চলের তালিকায় ফলাফল সীমাবদ্ধ করতে সেট করুন। |
locationBias | কোনো অঞ্চলে বা আশেপাশে ফলাফল পছন্দের হলে ব্যবহার করুন। প্রযোজ্য হলে, ব্যবহারকারী যে মানচিত্রের ভিউপোর্ট দেখছেন সেই অঞ্চলটিকে সংজ্ঞায়িত করুন। |
locationRestriction | শুধুমাত্র তখনই ব্যবহার করুন যখন কোনো অঞ্চলের বাইরের ফলাফল ফেরত দেওয়া উচিত নয় । |
origin | প্রতিটি ভবিষ্যদ্বাণীর জন্য একটি সরল-রেখা দূরত্বের উদ্দেশ্যে ব্যবহার করুন। |
স্বয়ংসম্পূর্ণ (নতুন) উদাহরণ
অবস্থান সীমাবদ্ধতা ব্যবহার করে একটি এলাকায় অনুসন্ধান সীমাবদ্ধ করুন
locationRestriction অনুসন্ধান করার জন্য এলাকা নির্দিষ্ট করে। নির্দিষ্ট এলাকার বাইরে ফলাফল ফেরত দেওয়া হয় না. নিম্নলিখিত উদাহরণে, আপনি সান ফ্রান্সিসকোকে কেন্দ্র করে 5000 মিটার ব্যাসার্ধের একটি বৃত্তে অনুরোধ সীমাবদ্ধ করতে locationRestriction ব্যবহার করেন:
curl -X POST -d '{
"input": "Art museum",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
নির্দিষ্ট এলাকার মধ্যে থেকে সমস্ত ফলাফল suggestions অ্যারেতে রয়েছে:
{ "suggestions": [ { "placePrediction": { "place": "places/ChIJkQQVTZqAhYARHxPt2iJkm1Q", "placeId": "ChIJkQQVTZqAhYARHxPt2iJkm1Q", "text": { "text": "Asian Art Museum, Larkin Street, San Francisco, CA, USA", "matches": [ { "startOffset": 6, "endOffset": 16 } ] }, "structuredFormat": { "mainText": { "text": "Asian Art Museum", "matches": [ { "startOffset": 6, "endOffset": 16 } ] }, "secondaryText": { "text": "Larkin Street, San Francisco, CA, USA" } }, "types": [ "establishment", "museum", "point_of_interest" ] } }, { "placePrediction": { "place": "places/ChIJI7NivpmAhYARSuRPlbbn_2w", "placeId": "ChIJI7NivpmAhYARSuRPlbbn_2w", "text": { "text": "de Young Museum, Hagiwara Tea Garden Drive, San Francisco, CA, USA", "matches": [ { "endOffset": 15 } ] }, "structuredFormat": { "mainText": { "text": "de Young Museum", "matches": [ { "endOffset": 15 } ] }, "secondaryText": { "text": "Hagiwara Tea Garden Drive, San Francisco, CA, USA" } }, "types": [ "establishment", "point_of_interest", "tourist_attraction", "museum" ] } }, /.../ ] }
আপনি একটি আয়তক্ষেত্রাকার ভিউপোর্টে অনুসন্ধানগুলিকে সীমাবদ্ধ করতে locationRestriction ব্যবহার করতে পারেন। নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকো শহরের কেন্দ্রস্থলে অনুরোধ সীমিত করে:
curl -X POST -d '{
"input": "Art museum",
"locationRestriction": {
"rectangle": {
"low": {
"latitude": 37.7751,
"longitude": -122.4219
},
"high": {
"latitude": 37.7955,
"longitude": -122.3937
}
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
ফলাফলগুলি suggestions অ্যারেতে রয়েছে:
{ "suggestions": [ { "placePrediction": { "place": "places/ChIJkQQVTZqAhYARHxPt2iJkm1Q", "placeId": "ChIJkQQVTZqAhYARHxPt2iJkm1Q", "text": { "text": "Asian Art Museum, Larkin Street, San Francisco, CA, USA", "matches": [ { "startOffset": 6, "endOffset": 16 } ] }, "structuredFormat": { "mainText": { "text": "Asian Art Museum", "matches": [ { "startOffset": 6, "endOffset": 16 } ] }, "secondaryText": { "text": "Larkin Street, San Francisco, CA, USA" } }, "types": [ "point_of_interest", "museum", "establishment" ] } }, { "placePrediction": { "place": "places/ChIJyQNK-4SAhYARO2DZaJleWRc", "placeId": "ChIJyQNK-4SAhYARO2DZaJleWRc", "text": { "text": "International Art Museum of America, Market Street, San Francisco, CA, USA", "matches": [ { "startOffset": 14, "endOffset": 24 } ] }, "structuredFormat": { "mainText": { "text": "International Art Museum of America", "matches": [ { "startOffset": 14, "endOffset": 24 } ] }, "secondaryText": { "text": "Market Street, San Francisco, CA, USA" } }, "types": [ "museum", "point_of_interest", "tourist_attraction", "art_gallery", "establishment" ] } } ] }
অবস্থান বিয়াস ব্যবহার করে একটি এলাকায় বায়াস অনুসন্ধান করুন
locationBias এর সাথে, অবস্থানটি একটি পক্ষপাত হিসাবে কাজ করে যার অর্থ নির্দিষ্ট এলাকার বাইরের ফলাফল সহ নির্দিষ্ট অবস্থানের চারপাশের ফলাফলগুলি ফেরত দেওয়া যেতে পারে। নিম্নলিখিত উদাহরণে, আপনি সান ফ্রান্সিসকো শহরের কেন্দ্রস্থলে অনুরোধের পক্ষপাতিত্ব করেছেন:
curl -X POST -d '{
"input": "Amoeba",
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
ফলাফলে এখন 5000 মিটার ব্যাসার্ধের বাইরের ফলাফল সহ আরও অনেক আইটেম রয়েছে:
{ "suggestions": [ { "placePrediction": { "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko", "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko", "text": { "text": "Amoeba Music, Haight Street, San Francisco, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Haight Street, San Francisco, CA, USA" } }, "types": [ "electronics_store", "point_of_interest", "store", "establishment", "home_goods_store" ] } }, { "placePrediction": { "place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw", "placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw", "text": { "text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Telegraph Avenue, Berkeley, CA, USA" } }, "types": [ "electronics_store", "point_of_interest", "establishment", "home_goods_store", "store" ] } }, ... ] }
আপনি একটি আয়তক্ষেত্রাকার ভিউপোর্টে অনুসন্ধানগুলিকে পক্ষপাতিত্ব করতে locationBias ব্যবহার করতে পারেন। নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকো শহরের কেন্দ্রস্থলে অনুরোধ সীমিত করে:
curl -X POST -d '{
"input": "Amoeba",
"locationBias": {
"rectangle": {
"low": {
"latitude": 37.7751,
"longitude": -122.4219
},
"high": {
"latitude": 37.7955,
"longitude": -122.3937
}
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
যদিও আয়তক্ষেত্রাকার ভিউপোর্টের মধ্যে অনুসন্ধানের ফলাফলগুলি প্রতিক্রিয়াতে উপস্থিত হয়, কিছু ফলাফল বায়াসিংয়ের কারণে সংজ্ঞায়িত সীমার বাইরে। ফলাফলগুলিও suggestions অ্যারের মধ্যে রয়েছে:
{ "suggestions": [ { "placePrediction": { "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko", "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko", "text": { "text": "Amoeba Music, Haight Street, San Francisco, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Haight Street, San Francisco, CA, USA" } }, "types": [ "point_of_interest", "store", "establishment" ] } }, { "placePrediction": { "place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw", "placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw", "text": { "text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Telegraph Avenue, Berkeley, CA, USA" } }, "types": [ "point_of_interest", "store", "establishment" ] } }, { "placePrediction": { "place": "places/ChIJRdmfADq_woARYaVhnfQSUTI", "placeId": "ChIJRdmfADq_woARYaVhnfQSUTI", "text": { "text": "Amoeba Music, Hollywood Boulevard, Los Angeles, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Hollywood Boulevard, Los Angeles, CA, USA" } }, "types": [ "point_of_interest", "store", "establishment" ] } }, /.../ ] }
অন্তর্ভুক্ত প্রাইমারি টাইপ ব্যবহার করুন
সারণি A , সারণি B , অথবা শুধুমাত্র (regions) , অথবা শুধুমাত্র (cities) থেকে পাঁচটি পর্যন্ত মান নির্দিষ্ট করতে includedPrimaryTypes প্যারামিটার ব্যবহার করুন। প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য নির্দিষ্ট প্রাথমিক প্রকারের মানগুলির একটির সাথে একটি স্থান অবশ্যই মিলবে৷
নিম্নলিখিত উদাহরণে, আপনি "সকার" এর একটি input স্ট্রিং নির্দিষ্ট করুন এবং "sporting_goods_store" ধরনের প্রতিষ্ঠানের ফলাফলগুলিকে সীমাবদ্ধ করতে includedPrimaryTypes প্যারামিটার ব্যবহার করুন:
curl -X POST -d '{
"input": "Soccer",
"includedPrimaryTypes": ["sporting_goods_store"],
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
আপনি যদি includedPrimaryTypes প্যারামিটার বাদ দেন, তাহলে ফলাফলে এমন একটি ধরনের স্থাপনা অন্তর্ভুক্ত থাকতে পারে যা আপনি চান না, যেমন "athletic_field" ।
ক্যোয়ারী পূর্বাভাস অনুরোধ
ক্যোয়ারী পূর্বাভাস ডিফল্টরূপে ফেরত দেওয়া হয় না. প্রতিক্রিয়াতে ক্যোয়ারী পূর্বাভাস যোগ করতে includeQueryPredictions অনুরোধ প্যারামিটার ব্যবহার করুন। যেমন:
curl -X POST -d '{
"input": "Amoeba",
"includeQueryPredictions": true,
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
suggestions অ্যারেতে এখন জায়গার ভবিষ্যদ্বাণী এবং ক্যোয়ারী ভবিষ্যদ্বাণী উভয়ই রয়েছে যা উপরে প্রতিক্রিয়া সম্পর্কে দেখানো হয়েছে। প্রতিটি প্রশ্নের পূর্বাভাস একটি প্রস্তাবিত পাঠ্য অনুসন্ধান স্ট্রিং ধারণকারী text ক্ষেত্র অন্তর্ভুক্ত করে। প্রত্যাবর্তিত ক্যোয়ারী ভবিষ্যদ্বাণীগুলির যেকোনো একটি সম্পর্কে আরও তথ্য পেতে আপনি একটি পাঠ্য অনুসন্ধান (নতুন) অনুরোধ করতে পারেন৷
মূল ব্যবহার করুন
এই উদাহরণে, অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক হিসাবে অনুরোধে origin অন্তর্ভুক্ত করুন। আপনি যখন origin অন্তর্ভুক্ত করেন, তখন স্বয়ংসম্পূর্ণ (নতুন) প্রতিক্রিয়াতে distanceMeters ক্ষেত্রটি অন্তর্ভুক্ত করে যাতে origin থেকে গন্তব্যের সরল-রেখার দূরত্ব থাকে। এই উদাহরণটি সান ফ্রান্সিসকোর কেন্দ্রে উত্স সেট করে:
curl -X POST -d '{
"input": "Amoeba",
"origin": {
"latitude": 37.7749,
"longitude": -122.4194
},
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete
প্রতিক্রিয়া এখন distanceMeters অন্তর্ভুক্ত:
{ "suggestions": [ { "placePrediction": { "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko", "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko", "text": { "text": "Amoeba Music, Haight Street, San Francisco, CA, USA", "matches": [ { "endOffset": 6 } ] }, "structuredFormat": { "mainText": { "text": "Amoeba Music", "matches": [ { "endOffset": 6 } ] }, "secondaryText": { "text": "Haight Street, San Francisco, CA, USA" } }, "types": [ "home_goods_store", "establishment", "point_of_interest", "store", "electronics_store" ], "distanceMeters": 3012 } } ] }
প্রতিক্রিয়া থেকে দূরত্ব অনুপস্থিত
কিছু কিছু ক্ষেত্রে, রেসপন্স বডি থেকে distanceMeters অনুপস্থিত থাকে, এমনকি যখন origin অনুরোধে অন্তর্ভুক্ত থাকে। এটি নিম্নলিখিত পরিস্থিতিতে ঘটতে পারে:
-
routeপূর্বাভাসের জন্যdistanceMetersঅন্তর্ভুক্ত নয়। -
distanceMetersঅন্তর্ভুক্ত করা হয় না যখন এর মান0হয়, যা প্রদত্তoriginঅবস্থান থেকে 1 মিটারের কম দূরে থাকা ভবিষ্যদ্বাণীগুলির ক্ষেত্রে।
ক্লায়েন্ট লাইব্রেরিগুলি পার্স করা বস্তুর বাইরে distanceMeters ক্ষেত্রটি পড়ার চেষ্টা করে 0 মান সহ একটি ক্ষেত্র ফেরত দেবে। বিভ্রান্তিকর ব্যবহারকারীদের এড়াতে, ব্যবহারকারীদের কাছে শূন্য দূরত্ব প্রদর্শন করবেন না ।
এটা চেষ্টা করুন!
APIs এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে API আইকন api নির্বাচন করুন।
ঐচ্ছিকভাবে অনুরোধের পরামিতি সম্পাদনা করুন।
এক্সিকিউট বোতামটি নির্বাচন করুন। ডায়ালগে, আপনি অনুরোধ করতে যে অ্যাকাউন্টটি ব্যবহার করতে চান সেটি বেছে নিন।
APIs এক্সপ্লোরার প্যানেলে, APIs এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন পূর্ণস্ক্রীন নির্বাচন করুন।