- HTTP অনুরোধ
- অনুরোধের মূল অংশ
- প্রতিক্রিয়া মূল অংশ
- অনুমোদনের সুযোগ
- অনুসন্ধানগন্তব্য অনুরোধ.ঠিকানা প্রশ্ন
- অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন
- অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন.স্থান ফিল্টার
- প্লেসভিউ.স্ট্রাকচারটাইপ
- অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন.স্থান ফিল্টার.ঠিকানাযোগ্যতা
- নেভিগেশনপয়েন্ট.ট্রাভেলমোড
- গন্তব্য
- প্লেসভিউ
- ল্যান্ডমার্ক
- ল্যান্ডমার্ক.ট্যাগ
- প্রবেশদ্বার
- প্রবেশ.ট্যাগ
- নেভিগেশনপয়েন্ট
- নেভিগেশনপয়েন্ট.ব্যবহার
- গন্তব্য।আগমনসারাংশ
এই পদ্ধতিটি একটি গন্তব্য অনুসন্ধান সম্পাদন করে এবং গন্তব্যস্থলের একটি তালিকা প্রদান করে।
HTTP অনুরোধ
POST https://geocode.googleapis.com/v4alpha/geocode/destinations
URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
অনুরোধের মূল অংশ
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON উপস্থাপনা |
|---|
{ "travelModes": [ enum ( |
| ক্ষেত্র | |
|---|---|
travelModes[] | ঐচ্ছিক। যেসব ভ্রমণ মোডের জন্য নেভিগেশন পয়েন্ট ফিল্টার করতে হবে। এটি প্রতিক্রিয়ায় ফিরে আসা |
languageCode | ঐচ্ছিক। যে ভাষায় ফলাফল দেখানো হবে। |
regionCode | ঐচ্ছিক। অঞ্চল কোড। অঞ্চল কোড, যা ccTLD ("শীর্ষ-স্তরের ডোমেন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়েছে। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করে। এই প্যারামিটারটি পরিষেবা থেকে ফলাফলকেও প্রভাবিত করে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করে না। |
Union ফিল্ড গন্তব্যগুলি নির্দিষ্ট প্রাথমিক প্রশ্নের চারপাশে তৈরি করা হয়েছে। দ্রষ্টব্য: শুধুমাত্র সেইসব স্থান এবং ঠিকানা সমর্থিত যেখানে নেভিগেশনাল গন্তব্য থাকতে পারে। উদাহরণস্বরূপ, একটি বাড়ি বা অ্যাপার্টমেন্ট কমপ্লেক্সের প্রতিনিধিত্বকারী স্থান প্রাথমিক কোয়েরি হিসেবে ব্যবহার করা যেতে পারে, কিন্তু যে স্থানগুলি একটি এলাকা বা প্রশাসনিক অঞ্চলের প্রতিনিধিত্ব করে সেগুলি প্রাথমিক কোয়েরি হিসেবে ব্যবহার করা যাবে না। | |
place | |
addressQuery | রাস্তার ঠিকানা। |
locationQuery | একটি সুনির্দিষ্ট অবস্থান। |
প্রতিক্রিয়া মূল অংশ
DestinationService.SearchDestinations-এর জন্য প্রতিক্রিয়া বার্তা।
যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:
| JSON উপস্থাপনা |
|---|
{
"destinations": [
{
object ( |
| ক্ষেত্র | |
|---|---|
destinations[] | গন্তব্যস্থলের তালিকা। যদি প্রাথমিক কোয়েরি থেকে কোনও প্রাথমিক গন্তব্য দ্ব্যর্থহীনভাবে চিহ্নিত করা যায়, তাহলে পরিষেবাটি একটি ফলাফল প্রদান করে। অন্যথায়, পরিষেবাটি দ্ব্যর্থতা নিরসনের জন্য একাধিক ফলাফল প্রদান করতে পারে অথবা কোনও ফলাফল প্রদান করতে পারে না। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/maps-platform.geocode
অনুসন্ধানগন্তব্য অনুরোধ.ঠিকানা প্রশ্ন
আপনি যে রাস্তার ঠিকানাটি অনুসন্ধান করতে চান। সংশ্লিষ্ট দেশের জাতীয় ডাক পরিষেবা দ্বারা ব্যবহৃত ফর্ম্যাট অনুসারে ঠিকানাগুলি উল্লেখ করুন।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ক্ষেত্র | |
|---|---|
Union ক্ষেত্রের kind । ঠিকানা অনুসন্ধানের kind নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
address | ডাক ঠিকানা বিন্যাসে একটি রাস্তার ঠিকানা। |
addressQuery | একটি রাস্তার ঠিকানা একটি একক লাইনে ফর্ম্যাট করা হয়েছে। |
অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন
কাছাকাছি একটি প্রাথমিক গন্তব্য সনাক্ত করার জন্য একটি অবস্থান অনুসন্ধান।
দ্রষ্টব্য: যদি অবস্থানের প্রশ্নটি এমন একটি ভবনের মধ্যে থাকে যেখানে উপ-প্রাঙ্গণ রয়েছে, তাহলে এটি সম্ভব যে ফিরে আসা প্রাথমিক স্থানটি একটি উপ-প্রাঙ্গণ। এই ক্ষেত্রে, containingPlaces ক্ষেত্রটি ভবনটিকে অন্তর্ভুক্ত করবে।
| JSON উপস্থাপনা |
|---|
{ "placeFilter": { object ( |
| ক্ষেত্র | |
|---|---|
placeFilter | ঐচ্ছিক। গন্তব্য প্রার্থীদের ক্ষেত্রে প্রয়োগ করার জন্য ফিল্টার। |
Union ফিল্ড kind । লোকেশন কোয়েরি kind নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
location | একটি সুনির্দিষ্ট অক্ষাংশ অবস্থান। |
অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন.স্থান ফিল্টার
গন্তব্য প্রার্থীদের ক্ষেত্রে প্রয়োগ করার জন্য ফিল্টার।
| JSON উপস্থাপনা |
|---|
{ "structureType": enum ( |
| ক্ষেত্র | |
|---|---|
structureType | ঐচ্ছিক। যদি নির্দিষ্ট করা থাকে, তাহলে এই ধরণের কাঠামোর সাথে সমস্ত গন্তব্যস্থলের একটি প্রাথমিক স্থান নিশ্চিত করা হবে। এর ফলে কিছু গন্তব্য ফিল্টার করা হতে পারে, অথবা ফিরে আসা গন্তব্যগুলিকে মোটা/পরিমার্জিত করা হতে পারে। উদাহরণস্বরূপ, যদি এই ক্ষেত্রের আরেকটি ব্যবহার হল বিল্ডিং ডিসপ্লে বহুভুজগুলি আরও সহজে বের করা। উদাহরণস্বরূপ, যদি |
addressability | ঐচ্ছিক। যদি নির্দিষ্ট করা থাকে, তবে কেবলমাত্র সেই গন্তব্যগুলি ফেরত পাঠাবে যা সংশ্লিষ্ট ঠিকানাযোগ্যতার মানদণ্ড পূরণ করে। |
প্লেসভিউ.স্ট্রাকচারটাইপ
এই স্থানটি যে ধরণের কাঠামোর প্রতিনিধিত্ব করে।
| এনামস | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED | ব্যবহৃত হয়নি। |
POINT | একটি বিন্দু অবস্থান। |
SECTION | একটি ভবনের একটি উপ-বিভাগ। |
BUILDING | একটি ভবন। |
GROUNDS | একটি বৃহৎ এলাকা যেখানে সাধারণত একাধিক ভবন থাকে, যেমন একটি বিশ্ববিদ্যালয় ক্যাম্পাস, একটি অ্যাপার্টমেন্ট কমপ্লেক্স, অথবা একটি শপিং মল। |
অনুসন্ধানগন্তব্য অনুরোধ.অবস্থান প্রশ্ন.স্থান ফিল্টার.ঠিকানাযোগ্যতা
ঠিকানাযোগ্যতা ফিল্টারিংয়ের বিকল্পগুলি সংজ্ঞায়িত করে। ভবিষ্যতে নতুন মান যুক্ত হতে পারে।
| এনামস | |
|---|---|
ADDRESSABILITY_UNSPECIFIED | নির্দিষ্ট না থাকলে, পরিষেবাটি একটি যুক্তিসঙ্গত ডিফল্ট নির্বাচন করবে। |
ANY | ঠিকানাযোগ্যতা কোনও ফিল্টারিং মানদণ্ড নয়। ঠিকানাযোগ্যতা নির্বিশেষে গন্তব্যগুলি ফেরত দেওয়া হয়। |
PRIMARY | ফিরে আসা সমস্ত গন্তব্যস্থলের একটি প্রাথমিক স্থান থাকবে যার একটি রাস্তার স্তরের ঠিকানা বা নাম থাকবে। |
WEAK | ফিরে আসা সমস্ত গন্তব্যস্থলের হয় একটি প্রাথমিক স্থান অথবা একটি উপ-গন্তব্য থাকবে যার একটি রাস্তার স্তরের ঠিকানা বা নাম থাকবে। |
গন্তব্য
একটি গন্তব্য। এর মধ্যে রয়েছে প্রাথমিক স্থান, সম্পর্কিত স্থান, প্রবেশপথ এবং নেভিগেশন পয়েন্ট।
| JSON উপস্থাপনা |
|---|
{ "primary": { object ( |
| ক্ষেত্র | |
|---|---|
primary | অনুরোধে |
containingPlaces[] | প্রাথমিক স্থানটি যে জায়গাগুলিতে অবস্থিত তার সুনির্দিষ্টতা কম। উদাহরণস্বরূপ, এই ভবনটি যে অ্যাপার্টমেন্ট কমপ্লেক্সে রয়েছে। |
subDestinations[] | প্রাথমিক স্থানের আরও সুনির্দিষ্ট উপ-গন্তব্য। উদাহরণস্বরূপ, একটি ভবনের মধ্যে থাকা ইউনিট। দ্রষ্টব্য: Places API দ্বারা প্রদত্ত সাবডেস্টিনেশনের তুলনায়, সাব-ডেস্টিনেশনের এই তালিকাটি আরও বিস্তৃত, এবং প্রতিটি সাব-ডেস্টিনেশনে আরও তথ্য রয়েছে। |
landmarks[] | গন্তব্যস্থল কোথায় তা জানাতে বা আগমনে সাহায্য করতে ল্যান্ডমার্ক ব্যবহার করা যেতে পারে। |
entrances[] | এই গন্তব্যের প্রবেশপথ। |
navigationPoints[] | এই গন্তব্যের জন্য নেভিগেশন পয়েন্ট। |
arrivalSummary | গন্তব্যে আগমনের অভিজ্ঞতার কৃত্রিম বুদ্ধিমত্তা (AI) দ্বারা তৈরি সারাংশ। |
প্লেসভিউ
Places API-তে একটি স্থানের দৃশ্য উপস্থাপন করে। এটি গন্তব্যস্থলের জন্য নির্দিষ্ট অতিরিক্ত তথ্যও প্রদান করে, যেমন কাঠামোর ধরণ এবং প্রদর্শন বহুভুজ।
কিছু ক্ষেত্রে, একই স্থান আইডি সহ একটি PlaceView types এবং displayName ক্ষেত্রের জন্য Places API দ্বারা ফেরত দেওয়া থেকে ভিন্ন হতে পারে।
| JSON উপস্থাপনা |
|---|
{ "place": string, "displayName": { object ( |
| ক্ষেত্র | |
|---|---|
place | এই স্থানের রিসোর্সের নাম, |
displayName | মানুষের পঠনযোগ্য স্থানের বর্ণনা। উদাহরণস্বরূপ, "গেট বি", "ম্যাকডোনাল্ডস" |
primaryType | এই জায়গার প্রাথমিক জায়গা। সম্ভাব্য মানগুলির তালিকার জন্য https://developers.google.com/maps/documentation/places/web-service/place-types দেখুন। দ্রষ্টব্য: এই ক্ষেত্রটি সবসময় পূর্ণ থাকে না। এই ধরনের পরিস্থিতিতে |
types[] | এই স্থানের সাথে সম্পর্কিত সকল ধরণের স্থান। সম্ভাব্য মানগুলির তালিকার জন্য https://developers.google.com/maps/documentation/places/web-service/place-types দেখুন। |
formattedAddress | এক লাইনের ঠিকানা। |
postalAddress | কাঠামোগত ঠিকানা। |
structureType | এই স্থানের সাথে সম্পর্কিত কাঠামোর ধরণ। |
location | এই স্থানের অবস্থান। যেসব স্থানে বহুভুজ প্রদর্শিত হয়, তাদের জন্য মানচিত্রে একটি মার্কার লাগানোর জন্য এটি একটি ভালো স্থান হতে পারে। |
displayPolygon | RFC 7946 ফর্ম্যাট ব্যবহার করে GeoJSON ফর্ম্যাটে স্থানটির বহুভুজের রূপরেখা: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6 । দ্রষ্টব্য: RFC 7946 ফর্ম্যাটটি মাল্টিপলিগন সমর্থন করে, তাই একটি |
ল্যান্ডমার্ক
গন্তব্যস্থল কোথায় তা জানাতে বা গন্তব্যে পৌঁছাতে সাহায্য করার জন্য ল্যান্ডমার্ক ব্যবহার করা হয়।
| JSON উপস্থাপনা |
|---|
{ "relationalDescription": { object ( |
| ক্ষেত্র | |
|---|---|
relationalDescription | গন্তব্যস্থলটি ল্যান্ডমার্কের সাথে কীভাবে সম্পর্কিত তার একটি মানুষের পঠনযোগ্য বর্ণনা। উদাহরণস্বরূপ: "এম্পায়ার স্টেট বিল্ডিংয়ের কাছে" অথবা "হোয়াইট হাউসের ওপারে"। |
tags[] | গন্তব্যস্থলের প্রেক্ষাপটে ল্যান্ডমার্কটি কীভাবে ব্যবহার করা যেতে পারে তা বর্ণনা করে এমন ট্যাগ। |
straightLineDistanceMeters | শুধুমাত্র আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্যস্থলের সরলরেখার দূরত্ব মিটারে। |
travelDistanceMeters | শুধুমাত্র আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্যস্থলের রাস্তা-নেটওয়ার্ক দূরত্ব মিটারে। |
ইউনিয়ন ফিল্ড landmark । ল্যান্ডমার্ক। landmark নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে: | |
place | এই ল্যান্ডমার্কের প্রতিনিধিত্বকারী স্থান। |
ল্যান্ডমার্ক.ট্যাগ
একটি গন্তব্যস্থলের প্রেক্ষাপটে একটি ল্যান্ডমার্ক কীভাবে ব্যবহার করা যেতে পারে তা বর্ণনা করে এমন সমস্ত সম্ভাব্য ট্যাগের তালিকা।
যদি কোনও ঠিকানায় ADDRESS এবং ARRIVAL উভয় ট্যাগ থাকে, তাহলে এর অর্থ হল ল্যান্ডমার্কটি স্থানীয়ভাবে বিশিষ্ট এবং গন্তব্যের কাছাকাছি।
| এনামস | |
|---|---|
TAG_UNSPECIFIED | ব্যবহৃত হয়নি। |
ADDRESS | স্থানীয়ভাবে বিশিষ্ট একটি স্থান যা গন্তব্যস্থলের সাধারণ অবস্থান সনাক্ত করতে ব্যবহার করা যেতে পারে। সাধারণত গন্তব্যস্থল থেকে কয়েকশ মিটারের মধ্যে। এগুলি জিওকোডিং API-এর ঠিকানা বর্ণনাকারী বৈশিষ্ট্য দ্বারা প্রদত্ত ল্যান্ডমার্কগুলির অনুরূপ: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors । |
ARRIVAL | এমন একটি জায়গা যা গন্তব্যে পৌঁছাতে সাহায্য করতে পারে। গন্তব্যের কাছাকাছি পৌঁছানোর পর নেভিগেশনের জন্য উপযোগী। উদাহরণস্বরূপ, এই ল্যান্ডমার্কটি গন্তব্যের রাস্তার বিপরীতে অবস্থিত এমন একটি জায়গা হতে পারে। এই ট্যাগযুক্ত ল্যান্ডমার্ক সাধারণত ADDRESS ট্যাগযুক্ত ল্যান্ডমার্কের তুলনায় গন্তব্যের কাছাকাছি থাকে। |
প্রবেশদ্বার
একটি প্রবেশপথ হল একটি একক অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক জোড়া যা একটি স্থানের প্রবেশ এবং প্রস্থান বিন্দুর অবস্থান নির্ধারণ করে।
| JSON উপস্থাপনা |
|---|
{ "location": { object ( |
| ক্ষেত্র | |
|---|---|
location | প্রবেশদ্বারের অবস্থান। |
tags[] | প্রবেশপথ বর্ণনা করে এমন ট্যাগের একটি তালিকা। |
place | এই প্রবেশদ্বারটি যে কাঠামোতে অবস্থিত, তা |
প্রবেশ.ট্যাগ
একটি প্রবেশপথ বর্ণনা করে এমন বৈশিষ্ট্য।
| এনামস | |
|---|---|
TAG_UNSPECIFIED | ব্যবহৃত হয়নি। |
PREFERRED | প্রবেশদ্বারটি সম্ভবত প্রত্যাবর্তিত গন্তব্যস্থলের প্রাথমিক স্থানে প্রবেশের সুযোগ করে দেয়। একটি স্থানে একাধিক পছন্দের প্রবেশপথ থাকতে পারে। যদি একটি প্রবেশপথে এই ট্যাগ না থাকে, তাহলে এর অর্থ হল প্রবেশদ্বারটি মূল স্থানের মতো একই ভবনে অবস্থিত, তবে অগত্যা এটি স্থানটিতে প্রবেশের সুযোগ দেয় না। উদাহরণস্বরূপ, যদি প্রাথমিক স্থানটি একটি স্ট্রিপ মলের একটি রেস্তোরাঁ হয়, তাহলে "পছন্দের" প্রবেশপথগুলি সম্ভবত রেস্তোরাঁটিতেই যাবে, যখন অন্যান্য ফিরে আসা প্রবেশপথগুলি ভবনের অন্যান্য প্রবেশপথ হবে, যেমন স্ট্রিপ মলের অন্যান্য রেস্তোরাঁগুলিতে প্রবেশপথ। যদি প্রধান স্থানটি একটি ভবন হয়, তাহলে দ্রষ্টব্য: একটি |
গন্তব্য।আগমনসারাংশ
গন্তব্যে আগমনের অভিজ্ঞতার কৃত্রিম বুদ্ধিমত্তা (AI) দ্বারা তৈরি সারাংশ।
| JSON উপস্থাপনা |
|---|
{ "text": { object ( |
| ক্ষেত্র | |
|---|---|
text | গন্তব্যে পৌঁছানোর অভিজ্ঞতার সারসংক্ষেপ। |
flagContentUrl | একটি লিঙ্ক যেখানে ব্যবহারকারীরা সারাংশের সাথে সমস্যা চিহ্নিত করতে পারেন। |
disclosureText | শুধুমাত্র আউটপুট। আগমনের সারাংশের জন্য প্রকাশের পাঠ্য রয়েছে। |