Method: places.autocomplete

প্রদত্ত ইনপুটের জন্য পূর্বাভাস প্রদান করে।

HTTP অনুরোধ

POST https://places.googleapis.com/v1/places:autocomplete

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "input": string,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "includedPrimaryTypes": [
    string
  ],
  "includedRegionCodes": [
    string
  ],
  "languageCode": string,
  "regionCode": string,
  "origin": {
    object (LatLng)
  },
  "inputOffset": integer,
  "includeQueryPredictions": boolean,
  "sessionToken": string
}
ক্ষেত্র
input

string

প্রয়োজন। যে টেক্সট স্ট্রিংটিতে সার্চ করতে হবে।

locationBias

object ( LocationBias )

ঐচ্ছিক। একটি নির্দিষ্ট স্থানে পক্ষপাতের ফলাফল।

সর্বাধিক একটি locationBias বা locationRestriction সেট করা উচিত। যদি কোনটিই সেট না করা হয়, ফলাফলগুলি IP ঠিকানা দ্বারা পক্ষপাতদুষ্ট হবে, যার অর্থ IP ঠিকানাটি একটি অসম্পূর্ণ অবস্থানে ম্যাপ করা হবে এবং একটি পক্ষপাতমূলক সংকেত হিসাবে ব্যবহৃত হবে৷

locationRestriction

object ( LocationRestriction )

ঐচ্ছিক। একটি নির্দিষ্ট স্থানে ফলাফল সীমাবদ্ধ করুন।

সর্বাধিক একটি locationBias বা locationRestriction সেট করা উচিত। যদি কোনটিই সেট না করা হয়, ফলাফলগুলি IP ঠিকানা দ্বারা পক্ষপাতদুষ্ট হবে, যার অর্থ IP ঠিকানাটি একটি অসম্পূর্ণ অবস্থানে ম্যাপ করা হবে এবং একটি পক্ষপাতমূলক সংকেত হিসাবে ব্যবহৃত হবে৷

includedPrimaryTypes[]

string

ঐচ্ছিক। https://developers.google.com/maps/documentation/places/web-service/place-types থেকে প্রাথমিক স্থানের প্রকার (উদাহরণস্বরূপ, "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") অন্তর্ভুক্ত। একটি স্থান শুধুমাত্র তখনই ফেরত দেওয়া হয় যদি তার প্রাথমিক প্রকারটি এই তালিকায় অন্তর্ভুক্ত করা হয়। 5টি পর্যন্ত মান নির্দিষ্ট করা যেতে পারে। কোনো প্রকার নির্দিষ্ট না থাকলে, সমস্ত স্থানের ধরন ফেরত দেওয়া হয়।

includedRegionCodes[]

string

ঐচ্ছিক। শুধুমাত্র 15টি CLDR দুই-অক্ষরের অঞ্চল কোড হিসাবে নির্দিষ্ট করা নির্দিষ্ট অঞ্চলের ফলাফলগুলি অন্তর্ভুক্ত করুন৷ একটি খালি সেট ফলাফল সীমাবদ্ধ করবে না। locationRestriction এবং includedRegionCodes উভয়ই সেট করা থাকলে, ফলাফল ছেদ এলাকায় অবস্থিত হবে।

languageCode

string

ঐচ্ছিক। যে ভাষায় ফলাফল দিতে হবে। এন-যুক্তরাষ্ট্রে ডিফল্ট। ফলাফলগুলি মিশ্র ভাষায় হতে পারে যদি input ব্যবহৃত ভাষা languageCode থেকে আলাদা হয় বা যদি প্রত্যাবর্তিত স্থানটির স্থানীয় ভাষা থেকে languageCode অনুবাদ না থাকে।

regionCode

string

ঐচ্ছিক। অঞ্চল কোড, একটি CLDR দুই-অক্ষরের অঞ্চল কোড হিসাবে নির্দিষ্ট করা হয়েছে। এটি অ্যাড্রেস ফরম্যাটিং, ফলাফলের র‌্যাঙ্কিংকে প্রভাবিত করে এবং কী ফলাফল দেওয়া হবে তা প্রভাবিত করতে পারে। এটি নির্দিষ্ট অঞ্চলে ফলাফল সীমাবদ্ধ করে না। একটি অঞ্চলে ফলাফল সীমাবদ্ধ করতে, region_code_restriction ব্যবহার করুন।

origin

object ( LatLng )

ঐচ্ছিক। মূল বিন্দু যেখান থেকে গন্তব্যের জিওডেসিক দূরত্ব গণনা করতে হবে ( distanceMeters হিসাবে ফিরে এসেছে)। যদি এই মানটি বাদ দেওয়া হয়, জিওডেসিক দূরত্ব ফেরত দেওয়া হবে না।

inputOffset

integer

ঐচ্ছিক। input একটি শূন্য-ভিত্তিক ইউনিকোড অক্ষর অফসেট input কার্সারের অবস্থান নির্দেশ করে। ভবিষ্যদ্বাণীগুলি কী ফেরত দেওয়া হবে তা কার্সারের অবস্থান প্রভাবিত করতে পারে৷

খালি থাকলে, input দৈর্ঘ্য ডিফল্ট।

includeQueryPredictions

boolean

ঐচ্ছিক। সত্য হলে, উত্তরে স্থান এবং ক্যোয়ারী উভয় ভবিষ্যদ্বাণী অন্তর্ভুক্ত থাকবে। অন্যথায় প্রতিক্রিয়া শুধুমাত্র স্থানের পূর্বাভাস প্রদান করবে।

sessionToken

string

ঐচ্ছিক। একটি স্ট্রিং যা বিলিং উদ্দেশ্যে একটি স্বয়ংসম্পূর্ণ সেশন সনাক্ত করে৷ সর্বাধিক 36টি ASCII অক্ষর সহ একটি URL এবং ফাইলের নাম নিরাপদ base64 স্ট্রিং হতে হবে৷ অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হবে৷

সেশন শুরু হয় যখন ব্যবহারকারী একটি ক্যোয়ারী টাইপ করা শুরু করে, এবং শেষ হয় যখন তারা একটি স্থান নির্বাচন করে এবং স্থানের বিবরণ বা ঠিকানা যাচাইকরণে একটি কল করা হয়। প্রতিটি সেশনে একাধিক প্রশ্ন থাকতে পারে, তার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ থাকতে পারে। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত শংসাপত্রগুলি অবশ্যই একই Google Cloud Console প্রকল্পের অন্তর্গত। একবার একটি অধিবেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে অবশ্যই প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি sessionToken প্যারামিটারটি বাদ দেওয়া হয়, বা আপনি যদি একটি সেশন টোকেন পুনরায় ব্যবহার করেন, তাহলে সেশনটি চার্জ করা হবে যেন কোনো সেশন টোকেন প্রদান করা হয়নি (প্রতিটি অনুরোধ আলাদাভাবে বিল করা হয়)।

আমরা নিম্নলিখিত নির্দেশিকা সুপারিশ:

  • সমস্ত প্লেস স্বয়ংসম্পূর্ণ কলের জন্য সেশন টোকেন ব্যবহার করুন।
  • প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করুন। একটি সংস্করণ 4 UUID ব্যবহার করার সুপারিশ করা হয়।
  • একটি সেশনের মধ্যে সমস্ত স্থান স্বয়ংসম্পূর্ণ, স্থানের বিবরণ এবং ঠিকানা যাচাইকরণের অনুরোধগুলির জন্য ব্যবহৃত শংসাপত্রগুলি একই ক্লাউড কনসোল প্রকল্পের অন্তর্গত তা নিশ্চিত করুন৷
  • প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন পাস করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করার ফলে প্রতিটি অনুরোধ পৃথকভাবে বিল করা হবে।

প্রতিক্রিয়া শরীর

place.autocomplete এর জন্য প্রতিক্রিয়া প্রোটো।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
ক্ষেত্র
suggestions[]

object ( Suggestion )

সাজেশনের একটি তালিকা রয়েছে, প্রাসঙ্গিকতার ক্রমানুসারে সাজানো।

অবস্থান বিয়াস

অঞ্চল অনুসন্ধান. ফলাফলগুলি নির্দিষ্ট অঞ্চলের চারপাশে পক্ষপাতদুষ্ট হতে পারে।

JSON প্রতিনিধিত্ব
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের type ।

type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

rectangle

object ( Viewport )

উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি ভিউপোর্ট।

circle

object ( Circle )

একটি কেন্দ্র বিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত।

অবস্থান সীমাবদ্ধতা

অঞ্চল অনুসন্ধান. ফলাফল নির্দিষ্ট অঞ্চলে সীমাবদ্ধ থাকবে।

JSON প্রতিনিধিত্ব
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের type ।

type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

rectangle

object ( Viewport )

উত্তর-পূর্ব এবং দক্ষিণ-পশ্চিম কোণ দ্বারা সংজ্ঞায়িত একটি ভিউপোর্ট।

circle

object ( Circle )

একটি কেন্দ্র বিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত।

সাজেশন

একটি স্বয়ংসম্পূর্ণ প্রস্তাবনা ফলাফল।

JSON প্রতিনিধিত্ব
{

  // Union field kind can be only one of the following:
  "placePrediction": {
    object (PlacePrediction)
  },
  "queryPrediction": {
    object (QueryPrediction)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্র kind .

kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

placePrediction

object ( PlacePrediction )

একটি স্থান জন্য একটি ভবিষ্যদ্বাণী.

queryPrediction

object ( QueryPrediction )

একটি প্রশ্নের জন্য একটি পূর্বাভাস.

স্থানের পূর্বাভাস

একটি স্থান স্বয়ংসম্পূর্ণ পূর্বাভাসের জন্য ভবিষ্যদ্বাণী ফলাফল।

JSON প্রতিনিধিত্ব
{
  "place": string,
  "placeId": string,
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  },
  "types": [
    string
  ],
  "distanceMeters": integer
}
ক্ষেত্র
place

string

প্রস্তাবিত স্থানের সম্পদের নাম। এই নামটি অন্যান্য API-এ ব্যবহার করা যেতে পারে যা স্থানের নাম গ্রহণ করে।

placeId

string

প্রস্তাবিত স্থানের অনন্য শনাক্তকারী। এই শনাক্তকারী অন্যান্য API-এ ব্যবহার করা যেতে পারে যেগুলি প্লেস আইডি গ্রহণ করে।

text

object ( FormattableText )

ফিরে আসা ফলাফলের জন্য মানব-পঠনযোগ্য নাম রয়েছে। প্রতিষ্ঠার ফলাফলের জন্য, এটি সাধারণত ব্যবসার নাম এবং ঠিকানা।

text বিকাশকারীদের জন্য সুপারিশ করা হয় যারা একটি একক UI উপাদান দেখাতে চান৷ যে বিকাশকারীরা দুটি আলাদা, কিন্তু সম্পর্কিত, UI উপাদানগুলি দেখাতে চান তারা পরিবর্তে structuredFormat ব্যবহার করতে চাইতে পারেন। তারা একটি স্থান ভবিষ্যদ্বাণী প্রতিনিধিত্ব করার দুটি ভিন্ন উপায়। ব্যবহারকারীদের structuredFormat text বা তদ্বিপরীতভাবে পার্স করার চেষ্টা করা উচিত নয়।

এই পাঠ্যটি places.get দ্বারা প্রত্যাবর্তিত displayName থেকে ভিন্ন হতে পারে।

মিশ্র ভাষায় হতে পারে যদি অনুরোধ input এবং languageCode ভিন্ন ভাষায় হয় অথবা যদি স্থানটির স্থানীয় ভাষা থেকে languageCode অনুবাদ না থাকে।

structuredFormat

object ( StructuredFormat )

স্থানের ভবিষ্যদ্বাণীর একটি ভাঙ্গন প্রধান পাঠ্যের মধ্যে যেখানে স্থানের নাম এবং সেকেন্ডারি পাঠ্য যেখানে অতিরিক্ত দ্ব্যর্থহীন বৈশিষ্ট্য রয়েছে (যেমন একটি শহর বা অঞ্চল)।

structuredFormat এমন ডেভেলপারদের জন্য সুপারিশ করা হয় যারা দুটি আলাদা, কিন্তু সম্পর্কিত, UI উপাদান দেখাতে চান। বিকাশকারীরা যারা একটি একক UI উপাদান দেখাতে চান তারা পরিবর্তে text ব্যবহার করতে চাইতে পারেন। তারা একটি স্থান ভবিষ্যদ্বাণী প্রতিনিধিত্ব করার দুটি ভিন্ন উপায়। ব্যবহারকারীদের structuredFormat text বা তদ্বিপরীতভাবে পার্স করার চেষ্টা করা উচিত নয়।

types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types- এ টেবিল A ​​বা টেবিল B থেকে এই স্থানে প্রযোজ্য প্রকারের তালিকা।

একটি টাইপ হল একটি স্থানের শ্রেণীকরণ। ভাগ করা প্রকারের স্থানগুলি একই বৈশিষ্ট্যগুলি ভাগ করবে৷

distanceMeters

integer

origin থেকে মিটারে জিওডেসিকের দৈর্ঘ্য যদি origin নির্দিষ্ট করা হয়। কিছু ভবিষ্যদ্বাণী যেমন রুট এই ক্ষেত্রটি পূরণ করতে পারে না।

ফরম্যাটেবল টেক্সট

একটি স্থান বা ক্যোয়ারী পূর্বাভাস প্রতিনিধিত্বকারী পাঠ্য। টেক্সট যেমন আছে বা ফরম্যাটে ব্যবহার করা যেতে পারে।

JSON প্রতিনিধিত্ব
{
  "text": string,
  "matches": [
    {
      object (StringRange)
    }
  ]
}
ক্ষেত্র
text

string

টেক্সট যা আছে হিসাবে ব্যবহার করা যেতে পারে বা matches সাথে ফর্ম্যাট করা যেতে পারে।

matches[]

object ( StringRange )

স্ট্রিং রেঞ্জের একটি তালিকা যা text সাথে ইনপুট অনুরোধটি কোথায় মিলেছে তা চিহ্নিত করে। রেঞ্জগুলি text নির্দিষ্ট অংশ বিন্যাস করতে ব্যবহার করা যেতে পারে। সাবস্ট্রিংগুলি input সঠিক মিল নাও হতে পারে যদি ম্যাচিং স্ট্রিং ম্যাচিং (উদাহরণস্বরূপ, বানান সংশোধন বা প্রতিবর্ণীকরণ) ব্যতীত অন্যান্য মানদণ্ড দ্বারা নির্ধারিত হয়।

এই মানগুলি text ইউনিকোড অক্ষর অফসেট। অফসেট মান বাড়ানোর জন্য ব্যাপ্তিগুলি অর্ডার করার নিশ্চয়তা রয়েছে৷

স্ট্রিংরেঞ্জ

একটি প্রদত্ত পাঠ্যের মধ্যে একটি সাবস্ট্রিং সনাক্ত করে।

JSON প্রতিনিধিত্ব
{
  "startOffset": integer,
  "endOffset": integer
}
ক্ষেত্র
startOffset

integer

স্ট্রিং এর প্রথম ইউনিকোড অক্ষরের শূন্য-ভিত্তিক অফসেট (অন্তর্ভুক্ত)।

endOffset

integer

শেষ ইউনিকোড অক্ষরের জিরো-ভিত্তিক অফসেট (এক্সক্লুসিভ)।

স্ট্রাকচার্ড ফরম্যাট

মূল টেক্সট এবং সেকেন্ডারি টেক্সটে একটি স্থান বা কোয়েরির পূর্বাভাসের একটি ভাঙ্গন রয়েছে।

স্থানের পূর্বাভাসের জন্য, মূল পাঠ্যটিতে স্থানটির নির্দিষ্ট নাম রয়েছে। ক্যোয়ারী ভবিষ্যদ্বাণীর জন্য, মূল পাঠ্যে ক্যোয়ারী থাকে।

গৌণ পাঠ্যটিতে স্থানটিকে আরও শনাক্ত করতে বা ক্যোয়ারীটি পরিমার্জিত করার জন্য অতিরিক্ত দ্ব্যর্থতামূলক বৈশিষ্ট্য (যেমন একটি শহর বা অঞ্চল) রয়েছে।

JSON প্রতিনিধিত্ব
{
  "mainText": {
    object (FormattableText)
  },
  "secondaryText": {
    object (FormattableText)
  }
}
ক্ষেত্র
mainText

object ( FormattableText )

স্থান বা প্রশ্নের নাম প্রতিনিধিত্ব করে।

secondaryText

object ( FormattableText )

স্থানটিকে আরও শনাক্ত করতে বা ক্যোয়ারী পরিমার্জন করতে অতিরিক্ত দ্ব্যর্থতামূলক বৈশিষ্ট্য (যেমন একটি শহর বা অঞ্চল) উপস্থাপন করে।

কোয়েরি পূর্বাভাস

একটি ক্যোয়ারী স্বয়ংসম্পূর্ণ পূর্বাভাস জন্য পূর্বাভাস ফলাফল.

JSON প্রতিনিধিত্ব
{
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  }
}
ক্ষেত্র
text

object ( FormattableText )

ভবিষ্যদ্বাণী করা পাঠ্য। এই পাঠ্যটি একটি স্থানের প্রতিনিধিত্ব করে না, বরং একটি পাঠ্য ক্যোয়ারী যা একটি অনুসন্ধানের শেষ পয়েন্টে ব্যবহার করা যেতে পারে (উদাহরণস্বরূপ, পাঠ্য অনুসন্ধান)।

text বিকাশকারীদের জন্য সুপারিশ করা হয় যারা একটি একক UI উপাদান দেখাতে চান৷ যে বিকাশকারীরা দুটি আলাদা, কিন্তু সম্পর্কিত, UI উপাদানগুলি দেখাতে চান তারা পরিবর্তে structuredFormat ব্যবহার করতে চাইতে পারেন। তারা একটি ক্যোয়ারী ভবিষ্যদ্বাণী প্রতিনিধিত্ব করার দুটি ভিন্ন উপায়. ব্যবহারকারীদের structuredFormat text বা তদ্বিপরীতভাবে পার্স করার চেষ্টা করা উচিত নয়।

মিশ্র ভাষায় হতে পারে যদি অনুরোধের input এবং languageCode ভিন্ন ভাষায় হয় অথবা যদি কোয়েরির অংশ স্থানীয় ভাষা থেকে languageCode অনুবাদ না থাকে।

structuredFormat

object ( StructuredFormat )

ক্যোয়ারী ভবিষ্যদ্বাণীর একটি বিভাজন প্রধান পাঠ্যের মধ্যে ক্যোয়ারী এবং সেকেন্ডারি পাঠ্য যেখানে অতিরিক্ত দ্ব্যর্থতামূলক বৈশিষ্ট্য রয়েছে (যেমন একটি শহর বা অঞ্চল)।

structuredFormat এমন ডেভেলপারদের জন্য সুপারিশ করা হয় যারা দুটি আলাদা, কিন্তু সম্পর্কিত, UI উপাদান দেখাতে চান। বিকাশকারীরা যারা একটি একক UI উপাদান দেখাতে চান তারা পরিবর্তে text ব্যবহার করতে চাইতে পারেন। তারা একটি ক্যোয়ারী ভবিষ্যদ্বাণী প্রতিনিধিত্ব করার দুটি ভিন্ন উপায়. ব্যবহারকারীদের structuredFormat text বা তদ্বিপরীতভাবে পার্স করার চেষ্টা করা উচিত নয়।