- HTTP অনুরোধ
- অনুরোধের বডি
- প্রতিক্রিয়ার বডি ফর্ম্যাট
- অনুমোদনের স্কোপ
- SearchDestinationsRequest.AddressQuery
- SearchDestinationsRequest.LocationQuery
- SearchDestinationsRequest.LocationQuery.PlaceFilter
- PlaceView.StructureType
- SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
- NavigationPoint.TravelMode
- গন্তব্য
- PlaceView
- PlaceView.AddressComponent
- ল্যান্ডমার্ক
- Landmark.Tag
- প্রবেশপথ
- Entrance.Tag
- NavigationPoint
- NavigationPoint.Usage
এই পদ্ধতি গন্তব্য খোঁজে এবং গন্তব্যের তালিকা দেখায়।
HTTP অনুরোধ
POST https://geocode.googleapis.com/v4beta/geocode/destinations
URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।
অনুরোধের বডি
অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "travelModes": [ enum ( |
| ফিল্ড | |
|---|---|
travelModes[] |
ঐচ্ছিক। নেভিগেশন পয়েন্ট ফিল্টার করার জন্য ট্রাভেল মোড। এটি উত্তরে ফেরত আসা |
languageCode |
ঐচ্ছিক। যে ভাষায় ফলাফল দেখানো হবে। |
regionCode |
ঐচ্ছিক। অঞ্চলের কোড। অঞ্চল কোড, ccTLD ("টপ-লেভেল ডোমেন") দুই-অক্ষরের মান হিসেবে নির্দিষ্ট করা হয়েছে। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলে। এই প্যারামিটারও পরিষেবা থেকে পাওয়া ফলাফলকে প্রভাবিত করে, তবে সম্পূর্ণভাবে সীমাবদ্ধ করে না। |
ইউনিয়ন ফিল্ড নির্দিষ্ট প্রাথমিক কোয়েরি অনুযায়ী গন্তব্য তৈরি করা হয়। মনে রাখবেন: শুধুমাত্র সেইসব জায়গা ও ঠিকানা কাজ করবে যেগুলির নেভিগেশনাল ডেস্টিনেশন আছে। যেমন, কোনও বাড়ি বা অ্যাপার্টমেন্ট কমপ্লেক্সকে প্রাথমিক কোয়েরি হিসেবে ব্যবহার করা যেতে পারে, কিন্তু কোনও এলাকা বা প্রশাসনিক অঞ্চলকে প্রাথমিক কোয়েরি হিসেবে ব্যবহার করা যাবে না। |
|
place |
|
addressQuery |
রাস্তার ঠিকানা। |
locationQuery |
সুনির্দিষ্ট লোকেশন। |
প্রতিক্রিয়ার বডি
DestinationService.SearchDestinations-এর জন্য উত্তর মেসেজ।
সফল হলে, প্রতিক্রিয়ার বডিতে নিচে উল্লেখ করা স্ট্রাকচার সহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{
"destinations": [
{
object ( |
| ফিল্ড | |
|---|---|
destinations[] |
গন্তব্যের তালিকা। প্রাথমিক কোয়েরি থেকে প্রাথমিক গন্তব্য স্পষ্টভাবে শনাক্ত করা গেলে, পরিষেবাটি একটি ফলাফল দেখায়। অন্যথায়, পরিষেবাটি অস্পষ্টতা দূর করার জন্য একাধিক ফলাফল বা কোনও ফলাফল নাও দেখাতে পারে। |
অনুমোদনের স্কোপ
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/maps-platform.geocodehttps://www.googleapis.com/auth/maps-platform.destinations
SearchDestinationsRequest.AddressQuery
আপনি যে রাস্তার ঠিকানা সার্চ করতে চান। সংশ্লিষ্ট দেশের জাতীয় পোস্টাল পরিষেবা যে ফর্ম্যাট ব্যবহার করে সেই অনুযায়ী ঠিকানা উল্লেখ করুন।
| JSON উপস্থাপনা |
|---|
{ // Union field |
| ফিল্ড | |
|---|---|
ইউনিয়ন ফিল্ড kind। ঠিকানা সংক্রান্ত কোয়েরি। kind শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: |
|
address |
পোস্টাল অ্যাড্রেস ফর্ম্যাটে রাস্তার ঠিকানা। |
addressQuery |
রাস্তার ঠিকানা একটি লাইনে ফর্ম্যাট করা হয়েছে। |
SearchDestinationsRequest.LocationQuery
আশেপাশের প্রাথমিক গন্তব্য শনাক্ত করার জন্য লোকেশন কোয়েরি।
মনে রাখবেন: লোকেশন কোয়েরি যদি এমন কোনও বিল্ডিংয়ের মধ্যে হয় যেখানে সাব-প্রিমিস আছে, তাহলে হতে পারে যে রিটার্ন করা প্রাথমিক জায়গাটি একটি সাব-প্রিমিস। এইসব ক্ষেত্রে, containingPlaces ফিল্ডে বিল্ডিং অন্তর্ভুক্ত থাকবে।
| JSON উপস্থাপনা |
|---|
{ "placeFilter": { object ( |
| ফিল্ড | |
|---|---|
placeFilter |
ঐচ্ছিক। ডেস্টিনেশন ক্যান্ডিডেটে প্রয়োগ করার জন্য ফিল্টার। |
ইউনিয়ন ফিল্ড kind। লোকেশন কোয়েরি। kind শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: |
|
location |
সুনির্দিষ্ট LatLng লোকেশন। |
SearchDestinationsRequest.LocationQuery.PlaceFilter
গন্তব্য ক্যান্ডিডেটে প্রয়োগ করার জন্য ফিল্টার।
| JSON উপস্থাপনা |
|---|
{ "structureType": enum ( |
| ফিল্ড | |
|---|---|
structureType |
ঐচ্ছিক। উল্লেখ করা হলে, সব গন্তব্যে এই স্ট্রাকচার টাইপের একটি প্রাথমিক স্থান থাকবে। এর ফলে কিছু গন্তব্য ফিল্টার করে বাদ দেওয়া হতে পারে অথবা রিটার্ন করা গন্তব্য আরও বেশি বা কম হতে পারে। যেমন, এই ফিল্ডের আরেকটি ব্যবহার হল আরও সহজে বিল্ডিং ডিসপ্লে পলিগন এক্সট্র্যাক্ট করা। যেমন, |
addressability |
ঐচ্ছিক। উল্লেখ করা থাকলে, শুধুমাত্র সেইসব গন্তব্য দেখায় যা সংশ্লিষ্ট অ্যাড্রেসেবিলিটি সংক্রান্ত মাপকাঠি পূরণ করে। |
PlaceView.StructureType
এই জায়গাটি যে ধরনের স্ট্রাকচারকে উপস্থাপন করে।
| Enums | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
ব্যবহার করা হয়নি। |
POINT |
একটি পয়েন্ট লোকেশন। |
SECTION |
বিল্ডিংয়ের একটি সাব-সেকশন। |
BUILDING |
একটি বিল্ডিং। |
GROUNDS |
একটি বড় এলাকা যেখানে সাধারণত একাধিক বিল্ডিং থাকে, যেমন একটি বিশ্ববিদ্যালয় ক্যাম্পাস, একটি অ্যাপার্টমেন্ট কমপ্লেক্স বা একটি শপিং মল। |
SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
অ্যাড্রেসেবিলিটি ফিল্টারিংয়ের জন্য বিকল্প নির্ধারণ করে। ভবিষ্যতে নতুন ভ্যালু যোগ করা হতে পারে।
| Enums | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
নির্দিষ্ট করা না থাকলে, পরিষেবাটি একটি সংবেদনশীল ডিফল্ট বেছে নেবে। |
ANY |
অ্যাড্রেসেবিলিটি কোনও ফিল্টারিং মাপকাঠি নয়। ঠিকানা অ্যাক্সেস করা যায় কিনা তা নির্বিশেষে গন্তব্য ফেরত দেওয়া হয়। |
PRIMARY |
ফিরে আসা সব ডেস্টিনেশনে স্ট্রিট লেভেল ঠিকানা বা নাম সহ একটি প্রাথমিক জায়গা থাকবে। |
WEAK |
ফিরে আসা সব ডেস্টিনেশনে হয় কোনও প্রাথমিক জায়গা থাকবে অথবা স্ট্রিট লেভেল ঠিকানা বা নাম সহ কোনও সাবডেস্টিনেশন থাকবে। |
গন্তব্য
একটি গন্তব্য। এর মধ্যে প্রাথমিক জায়গা, সম্পর্কিত জায়গা, প্রবেশপথ ও নেভিগেশন পয়েন্ট অন্তর্ভুক্ত।
| JSON উপস্থাপনা |
|---|
{ "primary": { object ( |
| ফিল্ড | |
|---|---|
primary |
অনুরোধে |
containingPlaces[] |
প্রাথমিক জায়গাটি যে কম সুনির্দিষ্ট জায়গার মধ্যে রয়েছে। যেমন, এই বিল্ডিং যে অ্যাপার্টমেন্ট কমপ্লেক্সে রয়েছে। |
subDestinations[] |
প্রাথমিক জায়গার আরও সুনির্দিষ্ট সাব-ডেস্টিনেশন। যেমন, কোনও বিল্ডিংয়ে থাকা ইউনিট। মনে রাখবেন: Places API-এর মাধ্যমে রিটার্ন করা SubDestination-এর তুলনায়, সাব-ডেস্টিনেশনের এই তালিকাটি আরও বিস্তারিত এবং প্রতিটি সাব-ডেস্টিনেশনে আরও তথ্য রয়েছে। |
landmarks[] |
গন্তব্য কোথায় তা জানাতে বা সেখানে পৌঁছাতে সাহায্য করার জন্য ল্যান্ডমার্ক ব্যবহার করা যেতে পারে। |
entrances[] |
এই গন্তব্যের প্রবেশপথ। |
navigationPoints[] |
এই গন্তব্যের জন্য নেভিগেশন পয়েন্ট। |
PlaceView
Places API-তে Place-এর ভিউ দেখায়। এছাড়াও, এটি গন্তব্য-নির্দিষ্ট অতিরিক্ত তথ্য প্রদান করে, যেমন স্ট্রাকচারের ধরন এবং ডিসপ্লে পলিগন।
কিছু ক্ষেত্রে, একই জায়গা আইডির PlaceView, types এবং displayName ফিল্ডের জন্য Places API-এর মাধ্যমে যা রিটার্ন করা হচ্ছে তার থেকে আলাদা হতে পারে।
| JSON উপস্থাপনা |
|---|
{ "place": string, "placeId": string, "displayName": { object ( |
| ফিল্ড | |
|---|---|
place |
|
placeId |
কোনও জায়গার অনন্য শনাক্তকারী। |
displayName |
মানুষের-পঠনযোগ্য জায়গার বিবরণ। যেমন, "গেট B", "McDonalds" |
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 ফর্ম্যাট MultiPolygons-কে সাপোর্ট করে, তাই একটি |
addressComponents[] |
প্রতিটি লোকালিটি লেভেলের জন্য রিপিট করা কম্পোনেন্ট। |
PlaceView.AddressComponent
এই তথ্য উপলভ্য থাকলে, ফর্ম্যাট করা ঠিকানা তৈরি করে এমন স্ট্রাকচার্ড কম্পোনেন্ট।
| JSON উপস্থাপনা |
|---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
| ফিল্ড | |
|---|---|
longText |
ঠিকানার কম্পোনেন্টের সম্পূর্ণ টেক্সট বিবরণ বা নাম। যেমন, অস্ট্রেলিয়া দেশের জন্য কোনও অ্যাড্রেস কম্পোনেন্টের বড় নাম "অস্ট্রেলিয়া" হতে পারে। |
shortText |
ঠিকানার কম্পোনেন্টের জন্য সংক্ষিপ্ত টেক্সচুয়াল নাম, উপলভ্য থাকলে। যেমন, অস্ট্রেলিয়া দেশের জন্য কোনও অ্যাড্রেস কম্পোনেন্টের সংক্ষিপ্ত নাম "AU" হতে পারে। |
types[] |
অ্যারে যা ঠিকানা কম্পোনেন্টের ধরন নির্দেশ করে। আরও বিবরণের জন্য https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types দেখুন। |
languageCode |
CLDR নোটেশনে এই কম্পোনেন্ট ফর্ম্যাট করতে ব্যবহৃত ভাষা। |
ল্যান্ডমার্ক
গন্তব্য কোথায় অবস্থিত তা জানাতে বা গন্তব্যে পৌঁছাতে সাহায্য করার জন্য ল্যান্ডমার্ক ব্যবহার করা হয়।
| JSON উপস্থাপনা |
|---|
{ "relationalDescription": { object ( |
| ফিল্ড | |
|---|---|
relationalDescription |
গন্তব্যটি ল্যান্ডমার্কের সাথে কীভাবে সম্পর্কিত তার একটি মানুষের-পঠনযোগ্য বিবরণ। যেমন: "এম্পায়ার স্টেট বিল্ডিংয়ের কাছে" বা "হোয়াইট হাউসের ঠিক উল্টোদিকে"। |
tags[] |
গন্তব্যের প্রসঙ্গে ল্যান্ডমার্ক কীভাবে ব্যবহার করা যেতে পারে তা বর্ণনা করে এমন ট্যাগ। |
straightLineDistanceMeters |
শুধু আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্যের সরলরৈখিক দূরত্ব মিটারে। |
travelDistanceMeters |
শুধু আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্যের দূরত্ব, মিটারে। |
ইউনিয়ন ফিল্ড landmark। ল্যান্ডমার্ক। landmark শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: |
|
place |
এই ল্যান্ডমার্ককে উপস্থাপন করে এমন জায়গা। |
Landmark.Tag
সব সম্ভাব্য ট্যাগের তালিকা যা বর্ণনা করে যে কোনও গন্তব্যের প্রসঙ্গে ল্যান্ডমার্ক কীভাবে ব্যবহার করা যেতে পারে।
কোনও ঠিকানায় ADDRESS এবং ARRIVAL দুটি ট্যাগই থাকলে, এর অর্থ হল ল্যান্ডমার্কটি স্থানীয়ভাবে বিশিষ্ট এবং গন্তব্যের কাছাকাছি।
| Enums | |
|---|---|
TAG_UNSPECIFIED |
ব্যবহার করা হয়নি। |
ADDRESS |
গন্তব্যের সাধারণ লোকেশন শনাক্ত করার জন্য ব্যবহার করা যেতে পারে এমন স্থানীয়ভাবে বিখ্যাত জায়গা। সাধারণত গন্তব্যের কয়েকশো মিটারের মধ্যে। এগুলি Geocoding API-এর অ্যাড্রেস ডেসক্রিপ্টর ফিচারের মাধ্যমে রিটার্ন করা ল্যান্ডমার্কের মতো: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors. |
ARRIVAL |
গন্তব্যে পৌঁছাতে সাহায্য করার জন্য ব্যবহার করা যেতে পারে এমন একটি জায়গা। গন্তব্যের কাছাকাছি পৌঁছে গেলে নেভিগেশনের জন্য উপযোগী। যেমন, এই ল্যান্ডমার্কটি এমন একটি জায়গা হতে পারে যা গন্তব্যের ঠিক উল্টো দিকে অবস্থিত। এই ট্যাগ সহ ল্যান্ডমার্ক সাধারণত ADDRESS ট্যাগ সহ ল্যান্ডমার্কের চেয়ে গন্তব্যের কাছাকাছি থাকে। |
প্রবেশপথ
প্রবেশপথ হল একটি অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট পেয়ার যা কোনও জায়গার প্রবেশ ও প্রস্থান পয়েন্টের লোকেশনকে নির্ধারণ করে।
| JSON উপস্থাপনা |
|---|
{ "location": { object ( |
| ফিল্ড | |
|---|---|
location |
প্রবেশপথের লোকেশন। |
tags[] |
প্রবেশপথের বিবরণ দেয় এমন ট্যাগের তালিকা। |
place |
এই প্রবেশপথটি যে স্ট্রাকচারে বাস্তবে অবস্থিত, সেটি |
Entrance.Tag
প্রবেশপথের বিবরণ দেয় এমন বৈশিষ্ট্য।
| Enums | |
|---|---|
TAG_UNSPECIFIED |
ব্যবহার করা হয়নি। |
PREFERRED |
প্রবেশপথটি সম্ভবত ফিরে আসা গন্তব্যের প্রাথমিক স্থানে ফিজিক্যাল অ্যাক্সেস প্রদান করে। কোনও জায়গার একাধিক পছন্দের প্রবেশপথ থাকতে পারে। কোনও প্রবেশপথে এই ট্যাগ না থাকলে, এর অর্থ হল প্রবেশপথটি প্রাথমিক স্থানের মতো একই বিল্ডিংয়ে শারীরিকভাবে অবস্থিত, তবে এটি সেই স্থানে অ্যাক্সেস নাও দিতে পারে। যেমন, প্রাইমারি জায়গাটি যদি কোনও স্ট্রিপ মলের রেস্তোরাঁ হয়, তাহলে "পছন্দের" প্রবেশপথগুলি হবে সেগুলি যেগুলি সম্ভবত সরাসরি রেস্তোরাঁর দিকে নিয়ে যায়, অন্যদিকে ফেরত আসা অন্যান্য প্রবেশপথগুলি হবে বিল্ডিংয়ের অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্যান্য রেস্তোরাঁর প্রবেশপথ। প্রাথমিক স্থানটি যদি কোনও বিল্ডিং হয়, তাহলে মনে রাখবেন: |