স্বয়ংসম্পূর্ণ (নতুন) একটি ওয়েব পরিষেবা যা একটি 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
ত্রুটি প্রদান করে৷ প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।সেশন টোকেন
সেশন টোকেন হল ব্যবহারকারী-উত্পাদিত স্ট্রিং যা স্বয়ংসম্পূর্ণ (নতুন) কলগুলিকে "সেশন" হিসাবে ট্র্যাক করে। স্বয়ংসম্পূর্ণ (নতুন) বিলিং উদ্দেশ্যে একটি পৃথক সেশনে ব্যবহারকারী স্বয়ংসম্পূর্ণ অনুসন্ধানের প্রশ্ন এবং নির্বাচনের পর্যায়গুলিকে গ্রুপ করতে সেশন টোকেন ব্যবহার করে। আরও তথ্যের জন্য, সেশন টোকেন দেখুন।
পক্ষপাতিত্ব ফলাফলের পরামিতি নির্বাচন করুন
স্বয়ংসম্পূর্ণ (নতুন) পরামিতিগুলি অনুসন্ধান ফলাফলকে ভিন্নভাবে প্রভাবিত করতে পারে। নিম্নলিখিত সারণীটি উদ্দেশ্যমূলক ফলাফলের উপর ভিত্তি করে প্যারামিটার ব্যবহারের জন্য সুপারিশ প্রদান করে।প্যারামিটার | ব্যবহারের সুপারিশ |
---|---|
regionBias | ব্যবহারকারীর আঞ্চলিক পছন্দ অনুযায়ী সেট করুন। |
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 এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন পূর্ণস্ক্রীন নির্বাচন করুন।
স্বয়ংসম্পূর্ণ (নতুন) একটি ওয়েব পরিষেবা যা একটি 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
ত্রুটি প্রদান করে৷ প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।সেশন টোকেন
সেশন টোকেন হল ব্যবহারকারী-উত্পাদিত স্ট্রিং যা স্বয়ংসম্পূর্ণ (নতুন) কলগুলিকে "সেশন" হিসাবে ট্র্যাক করে। অটো কমপ্লিট (নতুন) বিলিংয়ের উদ্দেশ্যে একটি পৃথক সেশনে কোনও ব্যবহারকারীর ক্যোয়ারী এবং নির্বাচন পর্যায়গুলি গোষ্ঠীভুক্ত করতে সেশন টোকেন ব্যবহার করে। আরও তথ্যের জন্য, সেশন টোকেনগুলি দেখুন।
পক্ষপাত ফলাফলের জন্য পরামিতি চয়ন করুন
অটোকম্পলিট (নতুন) পরামিতিগুলি অনুসন্ধানের ফলাফলগুলিকে আলাদাভাবে প্রভাবিত করতে পারে। নিম্নলিখিত টেবিলটি উদ্দেশ্যযুক্ত ফলাফলের ভিত্তিতে প্যারামিটার ব্যবহারের জন্য সুপারিশ সরবরাহ করে।প্যারামিটার | ব্যবহারের সুপারিশ |
---|---|
regionBias | ব্যবহারকারীর আঞ্চলিক পছন্দ অনুযায়ী সেট করুন। |
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" ] } }, /.../ ] }
অন্তর্ভুক্ত প্রাইমারি টাইপস ব্যবহার করুন
টেবিল এ , টেবিল বি , বা কেবলমাত্র (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 } } ] }
প্রতিক্রিয়া থেকে দূরত্ব অনুপস্থিত
কিছু ক্ষেত্রে, origin
অন্তর্ভুক্ত থাকা অবস্থায়ও distanceMeters
প্রতিক্রিয়া বডি থেকে অনুপস্থিত। এটি নিম্নলিখিত পরিস্থিতিতে ঘটতে পারে:
-
route
পূর্বাভাসের জন্যdistanceMeters
অন্তর্ভুক্ত নয়। - যখন এর মান
0
হয় তখনdistanceMeters
অন্তর্ভুক্ত করা হয় না, যা প্রদত্তorigin
অবস্থান থেকে 1 মিটারেরও কম দূরে এমন ভবিষ্যদ্বাণীগুলির ক্ষেত্রে।
পার্সড অবজেক্টের বাইরে distanceMeters
ক্ষেত্রটি পড়ার চেষ্টা করা ক্লায়েন্ট লাইব্রেরিগুলি 0
মান সহ একটি ক্ষেত্র ফিরিয়ে দেবে। বিভ্রান্তিকর ব্যবহারকারীদের এড়াতে, ব্যবহারকারীদের শূন্য দূরত্ব প্রদর্শন করবেন না ।
এটা চেষ্টা করুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি এপিআই এবং এপিআই বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে এপিআই আইকন এপিআই নির্বাচন করুন।
বিকল্পভাবে অনুরোধের পরামিতিগুলি সম্পাদনা করুন।
এক্সিকিউট বোতামটি নির্বাচন করুন। কথোপকথনে, অনুরোধটি করতে আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা চয়ন করুন।
এপিআইএস এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।
অটোকপ্লিট (নতুন) একটি ওয়েব পরিষেবা যা এইচটিটিপি অনুরোধের প্রতিক্রিয়া হিসাবে স্থানের পূর্বাভাস এবং ক্যোয়ারির পূর্বাভাস দেয়। অনুরোধে, একটি পাঠ্য অনুসন্ধান স্ট্রিং এবং ভৌগলিক সীমানা নির্দিষ্ট করুন যা অনুসন্ধানের ক্ষেত্রটি নিয়ন্ত্রণ করে।
অটোকম্পলিট (নতুন) ইনপুটটির সম্পূর্ণ শব্দ এবং সাবস্ট্রিংগুলিতে মেলে, জায়গার নাম, ঠিকানা এবং প্লাস কোডগুলি সমাধান করে। অ্যাপ্লিকেশনগুলি তাই ফ্লাই প্লেস এবং ক্যোয়ারির পূর্বাভাস সরবরাহ করতে ব্যবহারকারীর ধরণ হিসাবে প্রশ্নগুলি প্রেরণ করতে পারে।
অটো কমপ্লিট (নতুন) এর প্রতিক্রিয়াটিতে দুটি ধরণের পূর্বাভাস থাকতে পারে:
- পূর্বাভাস স্থান : নির্দিষ্ট ইনপুট পাঠ্য স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের উপর ভিত্তি করে ব্যবসা, ঠিকানা এবং আগ্রহের পয়েন্টগুলির মতো স্থানগুলি। স্থান পূর্বাভাসগুলি ডিফল্টরূপে ফিরে আসে।
- ক্যোয়ারির পূর্বাভাস : ইনপুট পাঠ্য স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে ক্যোয়ারী স্ট্রিংগুলি। ক্যোয়ারির পূর্বাভাসগুলি ডিফল্টরূপে ফিরে আসে না। প্রতিক্রিয়াতে ক্যোয়ারির পূর্বাভাস যুক্ত করতে
includeQueryPredictions
অনুরোধ প্যারামিটারটি ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি ইনপুট এ স্ট্রিং হিসাবে ব্যবহার করে অটো কমপ্লিট (নতুন) কল করেন যাতে সান ফ্রান্সিসকো, সিএতে সীমাবদ্ধ অনুসন্ধানের অঞ্চল সহ একটি আংশিক ব্যবহারকারী ইনপুট "সিসিলিয়ান পিআইজেড" থাকে। প্রতিক্রিয়াটিতে স্থানের পূর্বাভাসের একটি তালিকা রয়েছে যা অনুসন্ধানের স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে যেমন "সিসিলিয়ান পিজ্জা কিচেন" নামের রেস্তোঁরা, পাশাপাশি জায়গা সম্পর্কে বিশদ সহ।
প্রত্যাবর্তিত স্থানের পূর্বাভাসগুলি ব্যবহারকারীকে উদ্দেশ্যে স্থানটি নির্বাচন করতে তাদের সহায়তা করার জন্য উপস্থাপন করার জন্য ডিজাইন করা হয়েছে। আপনি ফিরে আসা যে কোনও স্থানের পূর্বাভাস সম্পর্কে আরও তথ্য পেতে একটি স্থানের বিশদ (নতুন) অনুরোধ করতে পারেন।
প্রতিক্রিয়াটিতে অনুসন্ধানের স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে যেমন "সিসিলিয়ান পিজ্জা এবং পাস্তা" এর সাথে মেলে ক্যোয়ারী পূর্বাভাসের একটি তালিকাও থাকতে পারে। প্রতিক্রিয়াতে প্রতিটি ক্যোয়ারির পূর্বাভাসে একটি প্রস্তাবিত পাঠ্য অনুসন্ধান স্ট্রিংযুক্ত text
ক্ষেত্র অন্তর্ভুক্ত রয়েছে। আরও বিশদ অনুসন্ধান সম্পাদন করতে পাঠ্য অনুসন্ধানের (নতুন) ইনপুট হিসাবে সেই স্ট্রিংটি ব্যবহার করুন।
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করতে দেয় যাতে আপনি এপিআই এবং এপিআই বিকল্পগুলির সাথে পরিচিত হতে পারেন:
স্বতঃপ্রবাহ (নতুন) অনুরোধ
একটি অটো কমপ্লিট (নতুন) অনুরোধ হ'ল ফর্মের একটি URL- এর জন্য একটি HTTP পোস্টের অনুরোধ:
https://places.googleapis.com/v1/places:autocomplete
পোস্ট অনুরোধের অংশ হিসাবে জেএসএন অনুরোধ বডি বা শিরোনামে সমস্ত পরামিতি পাস করুন। যেমন:
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 টি-চরিত্রের দেশ কোডের অ্যারে। | |
ভবিষ্যদ্বাণীগুলিকে প্রভাবিত করে ইনপুট স্ট্রিংয়ের মধ্যে কার্সার অবস্থানের জিরো-ভিত্তিক ইউনিকোড চর অফসেট। ইনপুট দৈর্ঘ্যে ডিফল্ট। | |
ফলাফলের জন্য পছন্দসই ভাষা (আইইটিএফ বিসিপি -47 কোড)। ভাষার শিরোনাম বা 'এন' গ্রহণের ক্ষেত্রে ডিফল্ট। | |
কোনও অঞ্চল (বৃত্ত বা আয়তক্ষেত্র) এর দিকে পক্ষপাতদুষ্ট ফলাফলের দিকে নির্দিষ্ট করে, ক্ষেত্রের বাইরে ফলাফলের অনুমতি দেয়। লোকেশন রেস্ট্রিকেশন সহ ব্যবহার করা যাবে না। | |
এর মধ্যে অনুসন্ধানের ফলাফলগুলি সীমাবদ্ধ করতে কোনও অঞ্চল (বৃত্ত বা আয়তক্ষেত্র) নির্দিষ্ট করে। এই অঞ্চলের বাইরের ফলাফলগুলি বাদ দেওয়া হয়। লোকেশনবিয়াস দিয়ে ব্যবহার করা যাবে না। | |
অরিজিন পয়েন্ট (ল্যাট, দীর্ঘ) পূর্বাভাস গন্তব্যগুলিতে সোজা-লাইন দূরত্ব (দূরত্ব) গণনা করতে ব্যবহৃত হয়। | |
অঞ্চল কোড প্রতিক্রিয়া এবং পক্ষপাত পরামর্শগুলি ফর্ম্যাট করতে ব্যবহৃত হয় (যেমন, 'ইউকে', 'এফআর')। | |
ব্যবহারকারী-উত্পাদিত স্ট্রিংটি বিলিংয়ের উদ্দেশ্যে একটি সেশনে অটো কমপ্লিট কলগুলি গ্রুপে। |
প্রতিক্রিয়া সম্পর্কে
অটোকপ্লিট (নতুন) প্রতিক্রিয়া হিসাবে একটি 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: *
অন্তর্ভুক্ত প্রাইমারি টাইপস
কোনও জায়গাতে কেবল টেবিল এ বা টেবিল বিতে তালিকাভুক্ত প্রকারগুলি থেকে একক প্রাথমিক প্রকার থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকারটি
"mexican_restaurant"
বা"steak_house"
হতে পারে।ডিফল্টরূপে, এপিআই স্থানের সাথে সম্পর্কিত প্রাথমিক ধরণের মান নির্বিশেষে
input
প্যারামিটারের উপর ভিত্তি করে সমস্ত স্থান ফেরত দেয়।includedPrimaryTypes
প্যারামিটারটি পাস করে নির্দিষ্ট প্রাথমিক ধরণের বা প্রাথমিক ধরণের হতে ফলাফলকে সীমাবদ্ধ করুন।টেবিল এ বা টেবিল বি থেকে পাঁচ ধরণের মান নির্দিষ্ট করতে এই প্যারামিটারটি ব্যবহার করুন। প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য একটি স্থানের অবশ্যই নির্দিষ্ট প্রাথমিক ধরণের মানগুলির একটির সাথে মেলে।
এই প্যারামিটারে পরিবর্তে
(regions)
বা(cities)
এর পরিবর্তে অন্তর্ভুক্ত থাকতে পারে। অঞ্চল বা বিভাগগুলির জন্য যেমন(regions)
সংগ্রহের ফিল্টারগুলি, যেমন পাড়া এবং ডাক কোড। গুগল একটি শহর হিসাবে চিহ্নিত স্থানগুলির জন্য(cities)
টাইপ সংগ্রহের ফিল্টারগুলি।অনুরোধটি একটি
INVALID_REQUEST
ত্রুটি দিয়ে প্রত্যাখ্যান করা হয় যদি:- পাঁচটিরও বেশি ধরণের নির্দিষ্ট করা হয়।
- যে কোনও প্রকার
(cities)
বা(regions)
ছাড়াও নির্দিষ্ট করা আছে। - যে কোনও অচেনা প্রকার নির্দিষ্ট করা আছে।
অন্তর্ভুক্তিপার সার্ভিসারএবসিনেসগুলি
যদি
true
সেট করা হয় তবে প্রতিক্রিয়াটিতে এমন ব্যবসায়গুলি অন্তর্ভুক্ত রয়েছে যা গ্রাহকদের সরাসরি পরিদর্শন করে বা বিতরণ করে তবে শারীরিক ব্যবসায়ের অবস্থান নেই। যদিfalse
সেট করা হয় তবে এপিআই কেবল শারীরিক ব্যবসায়ের অবস্থান সহ কেবল ব্যবসা ফিরিয়ে দেয়।অন্তর্ভুক্ত
যদি
true
তবে প্রতিক্রিয়াটিতে স্থান এবং ক্যোয়ারির পূর্বাভাস উভয়ই অন্তর্ভুক্ত রয়েছে। ডিফল্ট মানটিfalse
, যার অর্থ প্রতিক্রিয়াটি কেবল স্থানের পূর্বাভাস অন্তর্ভুক্ত করে।অন্তর্ভুক্ত লিজিওনকোডস
কেবলমাত্র নির্দিষ্ট অঞ্চলগুলির তালিকা থেকে ফলাফলগুলি অন্তর্ভুক্ত করুন, 15 সিসিটিএলডি ("শীর্ষ-স্তরের ডোমেন") দ্বি-চরিত্রের মানগুলির অ্যারে হিসাবে নির্দিষ্ট। যদি বাদ দেওয়া হয় তবে প্রতিক্রিয়াতে কোনও বিধিনিষেধ প্রয়োগ করা হয় না। উদাহরণস্বরূপ, অঞ্চলগুলি জার্মানি এবং ফ্রান্সে সীমাবদ্ধ করার জন্য:
"includedRegionCodes": ["de", "fr"]
যদি আপনি উভয়
locationRestriction
এবংincludedRegionCodes
নির্দিষ্ট করে থাকেন তবে ফলাফলগুলি দুটি সেটিংসের ছেদ করার ক্ষেত্রে অবস্থিত।ইনপুট অফসেট
শূন্য-ভিত্তিক ইউনিকোড চরিত্র অফসেট অফসেট যা
input
কার্সার অবস্থান নির্দেশ করে। কার্সার অবস্থানটি ভবিষ্যদ্বাণীগুলি কী ফিরে আসে তা প্রভাবিত করতে পারে। যদি খালি হয় তবে এটিinput
দৈর্ঘ্যে ডিফল্ট হয়।ল্যাঙ্গুয়েজকোড
পছন্দসই ভাষা যেখানে ফলাফলগুলি ফিরিয়ে দিতে হবে।
input
ব্যবহৃত ভাষাটিlanguageCode
দ্বারা নির্দিষ্ট মান থেকে পৃথক হলে বা যদি ফিরে আসা জায়গাটির স্থানীয় ভাষা থেকেlanguageCode
অনুবাদ না থাকে তবে ফলাফলগুলি মিশ্র ভাষায় হতে পারে।- পছন্দসই ভাষা নির্দিষ্ট করতে আপনাকে অবশ্যই আইইটিএফ বিসিপি -47 ভাষা কোড ব্যবহার করতে হবে।
- যদি
languageCode
সরবরাহ না করা হয়, তবে এপিআইAccept-Language
শিরোনামে নির্দিষ্ট মান ব্যবহার করে। যদি উভয়ই নির্দিষ্ট না করা হয় তবে ডিফল্টটিen
। আপনি যদি কোনও অবৈধ ভাষার কোড নির্দিষ্ট করে থাকেন তবে এপিআই একটিINVALID_ARGUMENT
ত্রুটি প্রদান করে। - পছন্দসই ভাষার ফলাফলগুলির সেটগুলিতে একটি ছোট প্রভাব রয়েছে যা এপিআই ফিরে আসতে পছন্দ করে এবং যে ক্রমগুলিতে তারা ফিরে আসে। এটি বানান ত্রুটিগুলি সংশোধন করার এপিআইয়ের ক্ষমতাকেও প্রভাবিত করে।
- এপিআই একটি রাস্তার ঠিকানা সরবরাহ করার চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয় জনগোষ্ঠীর জন্য পঠনযোগ্য, একই সাথে ব্যবহারকারীর ইনপুট প্রতিফলিত করে। প্রতিটি অনুরোধে ব্যবহারকারী ইনপুটটির উপর নির্ভর করে স্থান পূর্বাভাসগুলি আলাদাভাবে ফর্ম্যাট করা হয়।
-
input
প্যারামিটারে ম্যাচিং শর্তাদি প্রথমে বেছে নেওয়া হয়,languageCode
প্যারামিটার দ্বারা নির্দেশিত ভাষার পছন্দগুলির সাথে সংযুক্ত নামগুলি ব্যবহার করে উপলভ্য হয়, অন্যথায় ব্যবহারকারী ইনপুটটির সাথে সবচেয়ে ভাল মেলে এমন নামগুলি ব্যবহার করে। - স্ট্রিটের ঠিকানাগুলি স্থানীয় ভাষায় ফর্ম্যাট করা হয়, যখন সম্ভব ব্যবহারকারীর দ্বারা পাঠযোগ্য একটি স্ক্রিপ্টে, কেবল
input
প্যারামিটারের শর্তাদি মেলে ম্যাচিং শর্তাদি বাছাইয়ের পরে। -
input
প্যারামিটারে শর্তাদি মেলে ম্যাচিং শর্তাদি বেছে নেওয়ার পরে অন্যান্য সমস্ত ঠিকানা পছন্দসই ভাষায় ফিরে আসে। যদি পছন্দসই ভাষায় কোনও নাম পাওয়া না যায় তবে এপিআই নিকটতম ম্যাচটি ব্যবহার করে।
-
লোকেশনবিয়াস বা লোকেশন রেস্ট্রিকশন
আপনি অনুসন্ধানের ক্ষেত্রটি সংজ্ঞায়িত করতে
locationBias
বাlocationRestriction
নির্দিষ্ট করতে পারেন, তবে উভয়ই নয়। ফলাফলগুলি অবশ্যই সেই অঞ্চলটি নির্দিষ্ট করে এবংlocationBias
এমন অঞ্চলটি উল্লেখ করে যে ফলাফলগুলি অবশ্যই কাছাকাছি থাকতে হবে তবে এলাকার বাইরে থাকতে পারে তা উল্লেখ করেlocationRestriction
ভাবুন।লোকেশনবিয়াস
অনুসন্ধানের জন্য একটি অঞ্চল নির্দিষ্ট করে। এই অবস্থানটি পক্ষপাত হিসাবে কাজ করে যার অর্থ নির্দিষ্ট স্থানের আশেপাশের ফলাফলগুলি নির্দিষ্ট অঞ্চলের বাইরে ফলাফল সহ ফিরে আসতে পারে।
লোকেশন রেস্ট্রিকেশন
অনুসন্ধানের জন্য একটি অঞ্চল নির্দিষ্ট করে। নির্দিষ্ট অঞ্চলের বাইরের ফলাফলগুলি ফেরত দেওয়া হয় না।
আয়তক্ষেত্রাকার ভিউপোর্ট হিসাবে বা একটি বৃত্ত হিসাবে
locationBias
বাlocationRestriction
অঞ্চলটি নির্দিষ্ট করুন।একটি বৃত্ত কেন্দ্র পয়েন্ট এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়। ব্যাসার্ধটি অবশ্যই 0.0 এবং 50000.0 এর মধ্যে থাকতে হবে। ডিফল্ট মান হল 0.0।
locationRestriction
জন্য, আপনাকে অবশ্যই ব্যাসার্ধটি 0.0 এর চেয়ে বেশি মানের দিকে সেট করতে হবে। অন্যথায়, অনুরোধটি কোনও ফলাফল দেয় না।যেমন:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
একটি আয়তক্ষেত্র হ'ল একটি অক্ষাংশ-দৃ und ়তা ভিউপোর্ট, যা দুটি তির্যকভাবে
low
এবং উচ্চ পয়েন্টের বিপরীতে প্রতিনিধিত্ব করে। একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, যার অর্থ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই অন্তর্ভুক্ত থাকতে হবে -90 থেকে 90 ডিগ্রি অন্তর্ভুক্ত, এবং দ্রাঘিমাংশের সীমা অবশ্যই -180 থেকে 180 ডিগ্রি অন্তর্ভুক্ত রয়েছে:- যদি
low
=high
তবে ভিউপোর্টটি সেই একক পয়েন্ট নিয়ে গঠিত। - যদি
low.longitude
>high.longitude
, দ্রাঘিমাংশের পরিসীমা উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশ লাইনটি অতিক্রম করে)। -
high.longitude
low.longitude
-
high.longitude
low.longitude
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 }
অঞ্চলকোড
অঞ্চল কোডটি প্রতিক্রিয়া ফর্ম্যাট করতে ব্যবহৃত হয়, একটি সিসিটিএলডি ("শীর্ষ-স্তরের ডোমেন") দ্বি-চরিত্রের মান হিসাবে নির্দিষ্ট করা হয়। বেশিরভাগ সিসিটিএলডি কোডগুলি কিছু উল্লেখযোগ্য ব্যতিক্রম সহ আইএসও 3166-1 কোডগুলির সাথে সমান। উদাহরণস্বরূপ, যুক্তরাজ্যের সিসিটিএলডি হ'ল "ইউকে" (.co.uk) যখন এর আইএসও 3166-1 কোডটি "জিবি" (প্রযুক্তিগতভাবে "গ্রেট ব্রিটেন এবং উত্তর আয়ারল্যান্ডের যুক্তরাজ্য" এর সত্তার জন্য)।
অঞ্চল কোডগুলির উপর ভিত্তি করে পরামর্শগুলিও পক্ষপাতদুষ্ট। গুগল ব্যবহারকারীর আঞ্চলিক পছন্দ অনুসারে
regionCode
সেট করার পরামর্শ দেয়।আপনি যদি কোনও অবৈধ অঞ্চল কোড নির্দিষ্ট করেন তবে এপিআই একটি
INVALID_ARGUMENT
ত্রুটি দেয়। প্যারামিটার প্রযোজ্য আইনের ভিত্তিতে ফলাফলগুলিকে প্রভাবিত করতে পারে।সেশন টোকেন
সেশন টোকেনগুলি ব্যবহারকারী-উত্পাদিত স্ট্রিং যা "সেশনস" হিসাবে অটো কমপ্লিট (নতুন) কলগুলি ট্র্যাক করে। অটো কমপ্লিট (নতুন) বিলিংয়ের উদ্দেশ্যে একটি পৃথক সেশনে কোনও ব্যবহারকারীর ক্যোয়ারী এবং নির্বাচন পর্যায়গুলি গোষ্ঠীভুক্ত করতে সেশন টোকেন ব্যবহার করে। আরও তথ্যের জন্য, সেশন টোকেনগুলি দেখুন।
পক্ষপাত ফলাফলের জন্য পরামিতি চয়ন করুন
অটোকম্পলিট (নতুন) পরামিতিগুলি অনুসন্ধানের ফলাফলগুলিকে আলাদাভাবে প্রভাবিত করতে পারে। নিম্নলিখিত টেবিলটি উদ্দেশ্যযুক্ত ফলাফলের ভিত্তিতে প্যারামিটার ব্যবহারের জন্য সুপারিশ সরবরাহ করে।প্যারামিটার | ব্যবহারের সুপারিশ |
---|---|
regionBias | ব্যবহারকারীর আঞ্চলিক পছন্দ অনুযায়ী সেট করুন। |
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" ] } }, /.../ ] }
অন্তর্ভুক্ত প্রাইমারি টাইপস ব্যবহার করুন
টেবিল এ , টেবিল বি , বা কেবলমাত্র (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 } } ] }
প্রতিক্রিয়া থেকে দূরত্ব অনুপস্থিত
কিছু ক্ষেত্রে, origin
অন্তর্ভুক্ত থাকা অবস্থায়ও distanceMeters
প্রতিক্রিয়া বডি থেকে অনুপস্থিত। এটি নিম্নলিখিত পরিস্থিতিতে ঘটতে পারে:
-
route
পূর্বাভাসের জন্যdistanceMeters
অন্তর্ভুক্ত নয়। - যখন এর মান
0
হয় তখনdistanceMeters
অন্তর্ভুক্ত করা হয় না, যা প্রদত্তorigin
অবস্থান থেকে 1 মিটারেরও কম দূরে এমন ভবিষ্যদ্বাণীগুলির ক্ষেত্রে।
পার্সড অবজেক্টের বাইরে distanceMeters
ক্ষেত্রটি পড়ার চেষ্টা করা ক্লায়েন্ট লাইব্রেরিগুলি 0
মান সহ একটি ক্ষেত্র ফিরিয়ে দেবে। বিভ্রান্তিকর ব্যবহারকারীদের এড়াতে, ব্যবহারকারীদের শূন্য দূরত্ব প্রদর্শন করবেন না ।
এটা চেষ্টা করুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি এপিআই এবং এপিআই বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে এপিআই আইকন এপিআই নির্বাচন করুন।
বিকল্পভাবে অনুরোধের পরামিতিগুলি সম্পাদনা করুন।
এক্সিকিউট বোতামটি নির্বাচন করুন। কথোপকথনে, অনুরোধটি করতে আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা চয়ন করুন।
এপিআইএস এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।
অটোকপ্লিট (নতুন) একটি ওয়েব পরিষেবা যা এইচটিটিপি অনুরোধের প্রতিক্রিয়া হিসাবে স্থানের পূর্বাভাস এবং ক্যোয়ারির পূর্বাভাস দেয়। অনুরোধে, একটি পাঠ্য অনুসন্ধান স্ট্রিং এবং ভৌগলিক সীমানা নির্দিষ্ট করুন যা অনুসন্ধানের ক্ষেত্রটি নিয়ন্ত্রণ করে।
অটোকম্পলিট (নতুন) ইনপুটটির সম্পূর্ণ শব্দ এবং সাবস্ট্রিংগুলিতে মেলে, জায়গার নাম, ঠিকানা এবং প্লাস কোডগুলি সমাধান করে। অ্যাপ্লিকেশনগুলি তাই ফ্লাই প্লেস এবং ক্যোয়ারির পূর্বাভাস সরবরাহ করতে ব্যবহারকারীর ধরণ হিসাবে প্রশ্নগুলি প্রেরণ করতে পারে।
অটো কমপ্লিট (নতুন) এর প্রতিক্রিয়াটিতে দুটি ধরণের পূর্বাভাস থাকতে পারে:
- পূর্বাভাস স্থান : নির্দিষ্ট ইনপুট পাঠ্য স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের উপর ভিত্তি করে ব্যবসা, ঠিকানা এবং আগ্রহের পয়েন্টগুলির মতো স্থানগুলি। স্থান পূর্বাভাসগুলি ডিফল্টরূপে ফিরে আসে।
- ক্যোয়ারির পূর্বাভাস : ইনপুট পাঠ্য স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে ক্যোয়ারী স্ট্রিংগুলি। ক্যোয়ারির পূর্বাভাসগুলি ডিফল্টরূপে ফিরে আসে না। প্রতিক্রিয়াতে ক্যোয়ারির পূর্বাভাস যুক্ত করতে
includeQueryPredictions
অনুরোধ প্যারামিটারটি ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি ইনপুট এ স্ট্রিং হিসাবে ব্যবহার করে অটো কমপ্লিট (নতুন) কল করেন যাতে সান ফ্রান্সিসকো, সিএতে সীমাবদ্ধ অনুসন্ধানের অঞ্চল সহ একটি আংশিক ব্যবহারকারী ইনপুট "সিসিলিয়ান পিআইজেড" থাকে। প্রতিক্রিয়াটিতে স্থানের পূর্বাভাসের একটি তালিকা রয়েছে যা অনুসন্ধানের স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে যেমন "সিসিলিয়ান পিজ্জা কিচেন" নামের রেস্তোঁরা, পাশাপাশি জায়গা সম্পর্কে বিশদ সহ।
প্রত্যাবর্তিত স্থানের পূর্বাভাসগুলি ব্যবহারকারীকে উদ্দেশ্যে স্থানটি নির্বাচন করতে তাদের সহায়তা করার জন্য উপস্থাপন করার জন্য ডিজাইন করা হয়েছে। আপনি ফিরে আসা যে কোনও স্থানের পূর্বাভাস সম্পর্কে আরও তথ্য পেতে একটি স্থানের বিশদ (নতুন) অনুরোধ করতে পারেন।
প্রতিক্রিয়াটিতে অনুসন্ধানের স্ট্রিং এবং অনুসন্ধানের ক্ষেত্রের সাথে মেলে যেমন "সিসিলিয়ান পিজ্জা এবং পাস্তা" এর সাথে মেলে ক্যোয়ারী পূর্বাভাসের একটি তালিকাও থাকতে পারে। প্রতিক্রিয়াতে প্রতিটি ক্যোয়ারির পূর্বাভাসে একটি প্রস্তাবিত পাঠ্য অনুসন্ধান স্ট্রিংযুক্ত text
ক্ষেত্র অন্তর্ভুক্ত রয়েছে। আরও বিশদ অনুসন্ধান সম্পাদন করতে পাঠ্য অনুসন্ধানের (নতুন) ইনপুট হিসাবে সেই স্ট্রিংটি ব্যবহার করুন।
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করতে দেয় যাতে আপনি এপিআই এবং এপিআই বিকল্পগুলির সাথে পরিচিত হতে পারেন:
স্বতঃপ্রবাহ (নতুন) অনুরোধ
একটি অটো কমপ্লিট (নতুন) অনুরোধ হ'ল ফর্মের একটি URL- এর জন্য একটি HTTP পোস্টের অনুরোধ:
https://places.googleapis.com/v1/places:autocomplete
পোস্ট অনুরোধের অংশ হিসাবে জেএসএন অনুরোধ বডি বা শিরোনামে সমস্ত পরামিতি পাস করুন। যেমন:
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 টি-চরিত্রের দেশ কোডের অ্যারে। | |
ভবিষ্যদ্বাণীগুলিকে প্রভাবিত করে ইনপুট স্ট্রিংয়ের মধ্যে কার্সার অবস্থানের জিরো-ভিত্তিক ইউনিকোড চর অফসেট। ইনপুট দৈর্ঘ্যে ডিফল্ট। | |
ফলাফলের জন্য পছন্দসই ভাষা (আইইটিএফ বিসিপি -47 কোড)। ভাষার শিরোনাম বা 'এন' গ্রহণের ক্ষেত্রে ডিফল্ট। | |
কোনও অঞ্চল (বৃত্ত বা আয়তক্ষেত্র) এর দিকে পক্ষপাতদুষ্ট ফলাফলের দিকে নির্দিষ্ট করে, ক্ষেত্রের বাইরে ফলাফলের অনুমতি দেয়। লোকেশন রেস্ট্রিকেশন সহ ব্যবহার করা যাবে না। | |
এর মধ্যে অনুসন্ধানের ফলাফলগুলি সীমাবদ্ধ করতে কোনও অঞ্চল (বৃত্ত বা আয়তক্ষেত্র) নির্দিষ্ট করে। এই অঞ্চলের বাইরের ফলাফলগুলি বাদ দেওয়া হয়। লোকেশনবিয়াস দিয়ে ব্যবহার করা যাবে না। | |
অরিজিন পয়েন্ট (ল্যাট, দীর্ঘ) পূর্বাভাস গন্তব্যগুলিতে সোজা-লাইন দূরত্ব (দূরত্ব) গণনা করতে ব্যবহৃত হয়। | |
অঞ্চল কোড প্রতিক্রিয়া এবং পক্ষপাত পরামর্শগুলি ফর্ম্যাট করতে ব্যবহৃত হয় (যেমন, 'ইউকে', 'এফআর')। | |
ব্যবহারকারী-উত্পাদিত স্ট্রিংটি বিলিংয়ের উদ্দেশ্যে একটি সেশনে অটো কমপ্লিট কলগুলি গ্রুপে। |
প্রতিক্রিয়া সম্পর্কে
অটোকপ্লিট (নতুন) প্রতিক্রিয়া হিসাবে একটি 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: *
অন্তর্ভুক্ত প্রাইমারি টাইপস
কোনও জায়গাতে কেবল টেবিল এ বা টেবিল বিতে তালিকাভুক্ত প্রকারগুলি থেকে একক প্রাথমিক প্রকার থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকারটি
"mexican_restaurant"
বা"steak_house"
হতে পারে।ডিফল্টরূপে, এপিআই স্থানের সাথে সম্পর্কিত প্রাথমিক ধরণের মান নির্বিশেষে
input
প্যারামিটারের উপর ভিত্তি করে সমস্ত স্থান ফেরত দেয়।includedPrimaryTypes
প্যারামিটারটি পাস করে নির্দিষ্ট প্রাথমিক ধরণের বা প্রাথমিক ধরণের হতে ফলাফলকে সীমাবদ্ধ করুন।টেবিল এ বা টেবিল বি থেকে পাঁচ ধরণের মান নির্দিষ্ট করতে এই প্যারামিটারটি ব্যবহার করুন। প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য একটি স্থানের অবশ্যই নির্দিষ্ট প্রাথমিক ধরণের মানগুলির একটির সাথে মেলে।
এই প্যারামিটারে পরিবর্তে
(regions)
বা(cities)
এর পরিবর্তে অন্তর্ভুক্ত থাকতে পারে। অঞ্চল বা বিভাগগুলির জন্য যেমন(regions)
সংগ্রহের ফিল্টারগুলি, যেমন পাড়া এবং ডাক কোড। গুগল একটি শহর হিসাবে চিহ্নিত স্থানগুলির জন্য(cities)
টাইপ সংগ্রহের ফিল্টারগুলি।অনুরোধটি একটি
INVALID_REQUEST
ত্রুটি দিয়ে প্রত্যাখ্যান করা হয় যদি:- পাঁচটিরও বেশি ধরণের নির্দিষ্ট করা হয়।
- যে কোনও প্রকার
(cities)
বা(regions)
ছাড়াও নির্দিষ্ট করা আছে। - যে কোনও অচেনা প্রকার নির্দিষ্ট করা আছে।
অন্তর্ভুক্তিপার সার্ভিসারএবসিনেসগুলি
যদি
true
সেট করা হয় তবে প্রতিক্রিয়াটিতে এমন ব্যবসায়গুলি অন্তর্ভুক্ত রয়েছে যা গ্রাহকদের সরাসরি পরিদর্শন করে বা বিতরণ করে তবে শারীরিক ব্যবসায়ের অবস্থান নেই। যদিfalse
সেট করা হয় তবে এপিআই কেবল শারীরিক ব্যবসায়ের অবস্থান সহ কেবল ব্যবসা ফিরিয়ে দেয়।অন্তর্ভুক্ত
যদি
true
তবে প্রতিক্রিয়াটিতে স্থান এবং ক্যোয়ারির পূর্বাভাস উভয়ই অন্তর্ভুক্ত রয়েছে। ডিফল্ট মানটিfalse
, যার অর্থ প্রতিক্রিয়াটি কেবল স্থানের পূর্বাভাস অন্তর্ভুক্ত করে।অন্তর্ভুক্ত লিজিওনকোডস
কেবলমাত্র নির্দিষ্ট অঞ্চলগুলির তালিকা থেকে ফলাফলগুলি অন্তর্ভুক্ত করুন, 15 সিসিটিএলডি ("শীর্ষ-স্তরের ডোমেন") দ্বি-চরিত্রের মানগুলির অ্যারে হিসাবে নির্দিষ্ট। যদি বাদ দেওয়া হয় তবে প্রতিক্রিয়াতে কোনও বিধিনিষেধ প্রয়োগ করা হয় না। উদাহরণস্বরূপ, অঞ্চলগুলি জার্মানি এবং ফ্রান্সে সীমাবদ্ধ করার জন্য:
"includedRegionCodes": ["de", "fr"]
যদি আপনি উভয়
locationRestriction
এবংincludedRegionCodes
নির্দিষ্ট করে থাকেন তবে ফলাফলগুলি দুটি সেটিংসের ছেদ করার ক্ষেত্রে অবস্থিত।ইনপুট অফসেট
শূন্য-ভিত্তিক ইউনিকোড চরিত্র অফসেট অফসেট যা
input
কার্সার অবস্থান নির্দেশ করে। The cursor position can influence what predictions are returned. If empty, it defaults to the length ofinput
.languageCode
The preferred language in which to return results. The results might be in mixed languages if the language used in
input
is different from the value specified bylanguageCode
, or if the returned place does not have a translation from the local language tolanguageCode
.- You must use IETF BCP-47 language codes to specify the preferred language.
- If
languageCode
is not supplied, the API uses the value specified in theAccept-Language
header. If neither is specified, the default isen
. If you specify an invalid language code, the API returns anINVALID_ARGUMENT
error. - The preferred language has a small influence on the set of results that the API chooses to return, and the order in which they are returned. This also affects the API's ability to correct spelling errors.
- The API attempts to provide a street address that is readable for both the user and local population, while at the same time reflecting the user input. Place predictions are formatted differently depending on the user input in each request.
- Matching terms in the
input
parameter are chosen first, using names aligned with the language preference indicated by thelanguageCode
parameter when available, while otherwise using names that best match the user input. - Street addresses are formatted in the local language, in a script readable by the user when possible, only after matching terms have been picked to match the terms in the
input
parameter. - All other addresses are returned in the preferred language, after matching terms have been chosen to match the terms in the
input
parameter. If a name is not available in the preferred language, the API uses the closest match.
- Matching terms in the
locationBias or locationRestriction
You can specify
locationBias
orlocationRestriction
, but not both, to define the search area. Think oflocationRestriction
as specifying the region which the results must be within, andlocationBias
as specifying the region that the results must be near but can be outside of the area.locationBias
Specifies an area to search. This location serves as a bias which means results around the specified location can be returned, including results outside the specified area.
locationRestriction
Specifies an area to search. Results outside the specified area are not returned.
Specify the
locationBias
orlocationRestriction
region as a rectangular Viewport or as a circle .A circle is defined by center point and radius in meters. The radius must be between 0.0 and 50000.0, inclusive. ডিফল্ট মান হল 0.0। For
locationRestriction
, you must set the radius to a value greater than 0.0. Otherwise, the request returns no results.যেমন:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
A rectangle is a latitude-longitude viewport, represented as two diagonally opposite
low
and high points. A viewport is considered a closed region, meaning it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive:- If
low
=high
, the viewport consists of that single point. - If
low.longitude
>high.longitude
, the longitude range is inverted (the viewport crosses the 180 degree longitude line). - If
low.longitude
= -180 degrees andhigh.longitude
= 180 degrees, the viewport includes all longitudes. - If
low.longitude
= 180 degrees andhigh.longitude
= -180 degrees, the longitude range is empty.
Both
low
andhigh
must be populated, and the represented box cannot be empty. An empty viewport results in an error.For example, this viewport fully encloses New York City:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- If
মূল
The origin point from which to calculate straight-line distance to the destination (returned as
distanceMeters
). If this value is omitted, straight-line distance will not be returned. Must be specified as latitude and longitude coordinates:"origin": { "latitude": 40.477398, "longitude": -74.259087 }
regionCode
The region code used to format the response, specified as a ccTLD ("top-level domain") two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" (.co.uk) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland").
Suggestions are also biased based on region codes. Google recommends setting the
regionCode
according to the user's regional preference.If you specify an invalid region code, the API returns an
INVALID_ARGUMENT
error. The parameter can affect results based on applicable law.sessionToken
Session tokens are user-generated strings that track Autocomplete (New) calls as "sessions." Autocomplete (New) uses session tokens to group the query and selection phases of a user autocomplete search into a discrete session for billing purposes. For more information, see Session tokens .
Choose parameters to bias results
Autocomplete (New) parameters can influence search results differently. The following table provides recommendations for parameter usage based on the intended outcome.প্যারামিটার | Usage recommendation |
---|---|
regionBias | Set according to user's regional preference. |
includedRegionCodes | Set to limit results to the list of specified regions. |
locationBias | Use when results are preferred in or around a region . If applicable, define the region as the viewport of the map the user is looking at. |
locationRestriction | Use only when results outside of a region shouldn't be returned. |
origin | Use when a straight-line distance to each prediction is intended. |
Autocomplete (New) examples
Restrict search to an area using locationRestriction
locationRestriction
specifies the area to search. Results outside the specified area are not returned. In the following example, you use locationRestriction
to limit the request to a circle 5000 meters in radius centered on San Francisco:
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
All results from within the specified areas are contained in the suggestions
array:
{ "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" ] } }, /.../ ] }
You can also use locationRestriction
to restrict searches to a rectangular Viewport . The following example limits the request to downtown San Francisco:
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
Results are contained in the suggestions
array:
{ "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" ] } } ] }
Bias search to an area using locationBias
With locationBias
, the location serves as a bias which means results around the specified location can be returned, including results outside the specified area. In the following example, you bias the request to downtown San Francisco:
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
The results now contain many more items, including results outside of the 5000 meter radius:
{ "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" ] } }, ... ] }
You can also use locationBias
to restrict searches to a rectangular Viewport . The following example limits the request to downtown San Francisco:
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
Although search results within the rectangular viewport appear in the response, some results are outside of the defined boundaries, due to biasing. Results are also contained within the suggestions
array:
{ "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" ] } }, /.../ ] }
Use includedPrimaryTypes
Use the includedPrimaryTypes
parameter to specify up to five type values from Table A , Table B , or only (regions)
, or only (cities)
. A place must match one of the specified primary type values to be included in the response.
In the following example, you specify an input
string of "Soccer" and use the includedPrimaryTypes
parameter to restrict results to establishments of type "sporting_goods_store"
:
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
If you omit the includedPrimaryTypes
parameter, then the results can include establishments of a type that you do not want, such as "athletic_field"
.
Request query predictions
Query predictions are not returned by default. Use the includeQueryPredictions
request parameter to add query predictions to the response. যেমন:
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
The suggestions
array now contains both place predictions and query predictions as shown above in About the response . Each query prediction includes the text
field containing a recommended text search string. You can make a Text Search (New) request to get more information about any of the returned query predictions.
Use origin
In this example, include origin
in the request as latitude and longitude coordinates. When you include origin
, Autocomplete (New) includes the distanceMeters
field in the response which contains the straight-line distance from the origin
to the destination. This example sets the origin to the center of San Francisco:
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
The response now includes 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 } } ] }
Distance missing from response
In certain cases, distanceMeters
is missing from the response body, even when origin
is included in the request. This may happen in the following scenarios:
-
distanceMeters
is not included forroute
predictions. -
distanceMeters
is not included when its value is0
, which is the case for predictions that are less than 1 meter away from the providedorigin
location.
Client libraries attempting to read the distanceMeters
field out of a parsed object will return a field with value 0
. To avoid misleading users, don't display a zero distance to users.
এটা চেষ্টা করুন!
The APIs Explorer lets you make sample requests so that you can get familiar with the API and the API options.
Select the API icon api on the right side of the page.
Optionally edit the request parameters.
Select the Execute button. In the dialog, choose the account that you want to use to make the request.
In the APIs Explorer panel, select the fullscreen icon fullscreen to expand the APIs Explorer window.