Method: geocode.destinations.searchDestinations

এই মেথডটি গন্তব্য অনুসন্ধান করে এবং গন্তব্যস্থলগুলোর একটি তালিকা ফেরত দেয়।

HTTP অনুরোধ

POST https://geocode.googleapis.com/v4/geocode/destinations

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

অনুরোধকারী শরীর

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

JSON উপস্থাপনা 
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
ক্ষেত্র
travelModes[]

enum ( NavigationPoint.TravelMode )

ঐচ্ছিক। যে ভ্রমণ মোডগুলোর জন্য নেভিগেশন পয়েন্ট ফিল্টার করা হবে। এটি রেসপন্সে ফেরত আসা navigationPoints ফিল্ডকে প্রভাবিত করে। যদি এটি খালি থাকে, তাহলে সব ভ্রমণ মোডের নেভিগেশন পয়েন্ট ফেরত দেওয়া হবে।

languageCode

string

ঐচ্ছিক। যে ভাষায় ফলাফল ফেরত দেওয়া হবে।

regionCode

string

ঐচ্ছিক। অঞ্চল কোড। অঞ্চল কোডটি একটি ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মান হিসাবে নির্দিষ্ট করা হয়। এই প্যারামিটারটি প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করে। এই প্যারামিটারটি পরিষেবা থেকে প্রাপ্ত ফলাফলকেও প্রভাবিত করে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করে না।

ইউনিয়ন ফিল্ড primary_query । প্রাথমিক গন্তব্যের জন্য কোয়েরি করুন। এটি একটি স্থান, একটি সম্পূর্ণ নির্দিষ্ট ঠিকানা, অথবা একটি LatLng অবস্থান হতে পারে। ন্যূনতম তথ্যসহ কিছু স্থান এবং ঠিকানাকে গন্তব্যে পরিণত করা যাবে না।

গন্তব্যগুলি নির্দিষ্ট প্রাথমিক কোয়েরিকে কেন্দ্র করে তৈরি করা হয়।

দ্রষ্টব্য: শুধুমাত্র সেইসব স্থান এবং ঠিকানা সমর্থিত যেগুলোর একটি নেভিগেশনাল গন্তব্য থাকতে পারে। উদাহরণস্বরূপ, একটি বাড়ি বা অ্যাপার্টমেন্ট কমপ্লেক্সকে প্রতিনিধিত্বকারী একটি স্থান প্রাথমিক কোয়েরি হিসাবে ব্যবহার করা যেতে পারে, কিন্তু কোনো এলাকা বা প্রশাসনিক অঞ্চলকে প্রতিনিধিত্বকারী স্থানগুলো প্রাথমিক কোয়েরি হিসাবে ব্যবহার করা যাবে না। primary_query নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

place

string

কোনো স্থানের রিসোর্স নাম, places/{placeId} ফরম্যাটে।

addressQuery

object ( SearchDestinationsRequest.AddressQuery )

রাস্তার ঠিকানা।

locationQuery

object ( SearchDestinationsRequest.LocationQuery )

একটি সুনির্দিষ্ট অবস্থান।

প্রতিক্রিয়া সংস্থা

DestinationService.SearchDestinations-এর জন্য প্রতিক্রিয়া বার্তা।

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

JSON উপস্থাপনা 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
ক্ষেত্র
destinations[]

object ( Destination )

গন্তব্যস্থলগুলোর একটি তালিকা।

প্রাথমিক কোয়েরি থেকে যদি মূল গন্তব্যটি দ্ব্যর্থহীনভাবে শনাক্ত করা যায়, তাহলে পরিষেবাটি একটি ফলাফল ফেরত দেয়। অন্যথায়, দ্ব্যর্থতা নিরসনের জন্য পরিষেবাটি একাধিক ফলাফল অথবা কোনো ফলাফলই ফেরত দিতে পারে না।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.destinations

SearchDestinationsRequest.AddressQuery

যে রাস্তার ঠিকানাটি আপনি খুঁজতে চান। সংশ্লিষ্ট দেশের জাতীয় ডাক পরিষেবা কর্তৃক ব্যবহৃত বিন্যাস অনুযায়ী ঠিকানা উল্লেখ করুন।

JSON উপস্থাপনা 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
ক্ষেত্র
ইউনিয়ন ফিল্ডের kind . অ্যাড্রেস কোয়েরির kind নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
address

object ( PostalAddress )

ডাক ঠিকানার বিন্যাসে একটি রাস্তার ঠিকানা।

addressQuery

string

রাস্তার ঠিকানা এক লাইনে বিন্যস্ত।

SearchDestinationsRequest.LocationQuery

নিকটবর্তী প্রধান গন্তব্যস্থল শনাক্ত করার জন্য একটি অবস্থান অনুসন্ধান।

দ্রষ্টব্য: যদি লোকেশন কোয়েরিটি এমন কোনো বিল্ডিংয়ের মধ্যে করা হয় যেখানে সাব-প্রাঙ্গণ রয়েছে, তাহলে ফেরত আসা প্রাইমারি প্লেসটি একটি সাব-প্রাঙ্গণ হওয়ার সম্ভাবনা থাকে। এইসব ক্ষেত্রে, containingPlaces ফিল্ডটিতে বিল্ডিংটি অন্তর্ভুক্ত থাকবে।

JSON উপস্থাপনা 
{
  "placeFilter": {
    object (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
ক্ষেত্র
placeFilter

object ( SearchDestinationsRequest.LocationQuery.PlaceFilter )

ঐচ্ছিক। গন্তব্যস্থলের প্রার্থীদের জন্য ফিল্টারসমূহ প্রযোজ্য।

ইউনিয়ন ফিল্ডের kind । এটি হলো লোকেশন কোয়েরি। kind নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
location

object ( LatLng )

একটি সুনির্দিষ্ট অক্ষাংশ ও দ্রাঘিমাংশের অবস্থান।

SearchDestinationsRequest.LocationQuery.PlaceFilter

গন্তব্যস্থলের প্রার্থীদের জন্য প্রযোজ্য ফিল্টারসমূহ।

JSON উপস্থাপনা 
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
ক্ষেত্র
structureType

enum ( PlaceView.StructureType )

ঐচ্ছিক। যদি এটি নির্দিষ্ট করা হয়, তবে সমস্ত গন্তব্যের জন্য এই কাঠামো প্রকারের একটি প্রাথমিক স্থান থাকা নিশ্চিত করা হয়। এর ফলে কিছু গন্তব্য বাদ পড়ে যেতে পারে, অথবা ফেরত আসা গন্তব্যগুলির গঠন স্থূল বা সূক্ষ্ম হতে পারে।

উদাহরণস্বরূপ, যদি GROUNDS নির্দিষ্ট করা থাকে, তাহলে ফেরত আসা সমস্ত গন্তব্যের প্রাথমিক স্থানটি GROUNDS কাঠামো ধরনের হবে। এর ফলে এমন কিছু গন্তব্য বাদ পড়ে যেতে পারে যা কোনো গ্রাউন্ডের অংশ নয়, অথবা ফেরত আসা গন্তব্যগুলোকে গ্রাউন্ড স্তরে সীমাবদ্ধ করে ফেলা হতে পারে।

এই ফিল্ডটির আরেকটি ব্যবহার হলো বিল্ডিং ডিসপ্লে পলিগনগুলোকে আরও সহজে এক্সট্র্যাক্ট করা। উদাহরণস্বরূপ, যদি BUILDING নির্দিষ্ট করা থাকে, তাহলে প্রাইমারি প্লেসের ডিসপ্লে পলিগনটি হবে নির্দিষ্ট লোকেশনে অবস্থিত বিল্ডিংটির জন্য।

addressability

enum ( SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability )

ঐচ্ছিক। নির্দিষ্ট করা হলে, শুধুমাত্র সেই গন্তব্যস্থলগুলোই ফেরত দেওয়া হবে যেগুলো সংশ্লিষ্ট ঠিকানাযোগ্যতার মানদণ্ড পূরণ করে।

PlaceView.StructureType

এই স্থানটি যে ধরনের কাঠামোর প্রতিনিধিত্ব করে।

এনাম
STRUCTURE_TYPE_UNSPECIFIED ব্যবহৃত হয়নি।
POINT একটি বিন্দু অবস্থান।
SECTION ভবনের একটি উপ-অংশ।
BUILDING একটি ভবন।
GROUNDS একটি বৃহৎ এলাকা যেখানে সাধারণত একাধিক ভবন থাকে, যেমন বিশ্ববিদ্যালয় ক্যাম্পাস, অ্যাপার্টমেন্ট কমপ্লেক্স বা শপিং মল।

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

ঠিকানাযোগ্যতা ফিল্টারিংয়ের জন্য বিকল্পসমূহ নির্ধারণ করে। ভবিষ্যতে নতুন মান যোগ করা হতে পারে।

এনাম
ADDRESSABILITY_UNSPECIFIED অনির্দিষ্ট থাকলে, পরিষেবাটি একটি যুক্তিসঙ্গত ডিফল্ট বেছে নেবে।
ANY ঠিকানাযোগ্যতা কোনো ফিল্টারিং মানদণ্ড নয়। গন্তব্যস্থলগুলো তাদের ঠিকানাযোগ্যতা নির্বিশেষে ফেরত দেওয়া হয়।
PRIMARY ফেরত আসা সমস্ত গন্তব্যের একটি প্রাথমিক স্থান থাকবে, যেখানে রাস্তার ঠিকানা বা নাম উল্লেখ থাকবে।
WEAK ফেরত আসা সমস্ত গন্তব্যের একটি প্রধান স্থান অথবা একটি উপ-গন্তব্য থাকবে, যার সাথে রাস্তার স্তরের ঠিকানা বা নাম সংযুক্ত থাকবে।

গন্তব্য

একটি গন্তব্যস্থল। এর মধ্যে অন্তর্ভুক্ত রয়েছে মূল স্থান, সংশ্লিষ্ট স্থানসমূহ, প্রবেশপথ এবং দিকনির্দেশক বিন্দুসমূহ।

JSON উপস্থাপনা 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ]
}
ক্ষেত্র
primary

object ( PlaceView )

অনুরোধে primary_query দ্বারা চিহ্নিত প্রাথমিক স্থান।

containingPlaces[]

object ( PlaceView )

প্রাথমিক স্থানটি যেসব অনির্দিষ্ট স্থান দ্বারা পরিবেষ্টিত থাকে। উদাহরণস্বরূপ, যে অ্যাপার্টমেন্ট কমপ্লেক্সটিতে এই ভবনটি অবস্থিত।

subDestinations[]

object ( PlaceView )

মূল স্থানের আরও সুনির্দিষ্ট উপ-গন্তব্য। উদাহরণস্বরূপ, একটি ভবনের অন্তর্ভুক্ত ইউনিটসমূহ।

দ্রষ্টব্য: Places API দ্বারা ফেরত দেওয়া SubDestination-এর তুলনায়, এই উপ-গন্তব্যগুলির তালিকাটি আরও বিশদ, এবং প্রতিটি উপ-গন্তব্যে আরও বেশি তথ্য থাকে।

landmarks[]

object ( Landmark )

এমন সব নির্দেশক চিহ্ন যা গন্তব্যস্থল জানাতে বা সেখানে পৌঁছাতে সাহায্য করে।

entrances[]

object ( Entrance )

এই গন্তব্যের প্রবেশপথসমূহ।

navigationPoints[]

object ( NavigationPoint )

এই গন্তব্যের জন্য দিকনির্দেশক চিহ্নসমূহ।

প্লেসভিউ

প্লেসেস এপিআই-তে কোনো একটি প্লেস -এর দৃশ্য উপস্থাপন করে। এটি গন্তব্যস্থল-নির্দিষ্ট অতিরিক্ত তথ্যও প্রদান করে, যেমন কাঠামোর ধরন এবং প্রদর্শিত বহুভুজ।

কিছু ক্ষেত্রে, একই প্লেস আইডি থাকা সত্ত্বেও একটি PlaceView types এবং displayName ফিল্ডগুলো Places API থেকে প্রাপ্ত ফলাফলের চেয়ে ভিন্ন হতে পারে।

JSON উপস্থাপনা 
{
  "place": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  }
}
ক্ষেত্র
place

string

এই স্থানটির রিসোর্স নাম, places/{placeId} ফরম্যাটে। স্থানটি খুঁজে বের করতে এটি ব্যবহার করা যেতে পারে।

placeId

string

কোনো স্থানের অনন্য শনাক্তকারী।

displayName

object ( LocalizedText )

মানুষের পাঠযোগ্য স্থানের বর্ণনা। যেমন, "গেট বি", "ম্যাকডোনাল্ডস"।

primaryType

string

এই স্থানের প্রাথমিক স্থানের ধরণ। সম্ভাব্য মানগুলির তালিকার জন্য https://developers.google.com/maps/documentation/places/web-service/place-types দেখুন।

দ্রষ্টব্য: এই ফিল্ডটি সবসময় পূরণ করা থাকে না। এমন পরিস্থিতিতে ' types ফিল্ডটি ব্যবহার করার জন্য প্রস্তুত থাকুন।

types[]

string

এই স্থানের সাথে সম্পর্কিত সকল স্থানের প্রকারভেদ। সম্ভাব্য মানগুলির তালিকার জন্য https://developers.google.com/maps/documentation/places/web-service/place-types দেখুন।

formattedAddress

string

এক লাইনের ঠিকানা।

postalAddress

object ( PostalAddress )

কাঠামোগত ঠিকানা।

structureType

enum ( PlaceView.StructureType )

এই স্থানের সাথে সঙ্গতিপূর্ণ কাঠামোর ধরণ।

location

object ( LatLng )

এই স্থানটির অবস্থান। যেসব স্থানে ডিসপ্লে পলিগন থাকে, সেগুলোর ক্ষেত্রে এটি মানচিত্রে একটি মার্কার বসানোর জন্য একটি ভালো জায়গা হতে পারে।

displayPolygon

object ( Struct format)

RFC 7946 ফরম্যাট ব্যবহার করে GeoJSON ফরম্যাটে স্থানটির বহুভুজ রূপরেখা: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6 ।

দ্রষ্টব্য: RFC 7946 ফরম্যাটটি মাল্টিপলিগন সমর্থন করে, তাই একটি displayPolygon অবজেক্ট একাধিক পলিগনকে উপস্থাপন করতে পারে।

ল্যান্ডমার্ক

গন্তব্যস্থল কোথায় তা জানাতে বা সেখানে পৌঁছাতে সাহায্য করার জন্য নির্দেশক চিহ্ন ব্যবহার করা হয়।

JSON উপস্থাপনা 
{
  "relationalDescription": {
    object (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
ক্ষেত্র
relationalDescription

object ( LocalizedText )

গন্তব্যস্থলটি দর্শনীয় স্থানটির সাথে কীভাবে সম্পর্কিত, তার একটি সহজবোধ্য বিবরণ। উদাহরণস্বরূপ: "এম্পায়ার স্টেট বিল্ডিং-এর কাছে" অথবা "হোয়াইট হাউসের উল্টোদিকে"।

tags[]

enum ( Landmark.Tag )

ট্যাগ যা বর্ণনা করে যে গন্তব্যের প্রেক্ষাপটে ল্যান্ডমার্কটি কীভাবে ব্যবহার করা যেতে পারে।

straightLineDistanceMeters

number

শুধুমাত্র আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্য পর্যন্ত সরলরৈখিক দূরত্ব মিটারে।

travelDistanceMeters

number

শুধুমাত্র আউটপুট। এই ল্যান্ডমার্ক থেকে গন্তব্য পর্যন্ত সড়কপথের দূরত্ব মিটারে।

ইউনিয়ন ফিল্ড landmark । landmark নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
place

object ( PlaceView )

যে স্থানটি এই নিদর্শনটির প্রতিনিধিত্ব করে।

ল্যান্ডমার্ক.ট্যাগ

একটি গন্তব্যের প্রেক্ষাপটে কোনো ল্যান্ডমার্ক কীভাবে ব্যবহার করা যেতে পারে, তা বর্ণনা করে এমন সমস্ত সম্ভাব্য ট্যাগের তালিকা।

যদি কোনো ঠিকানায় ADDRESS এবং ARRIVAL উভয় ট্যাগই থাকে, তার মানে হলো সেই স্থানটি স্থানীয়ভাবে সুপরিচিত এবং গন্তব্যস্থলেরও নিকটবর্তী।

এনাম
TAG_UNSPECIFIED ব্যবহৃত হয়নি।
ADDRESS স্থানীয়ভাবে একটি সুপরিচিত স্থান যা গন্তব্যের সাধারণ অবস্থান শনাক্ত করতে ব্যবহার করা যেতে পারে। সাধারণত এটি গন্তব্যস্থলের কয়েকশ মিটারের মধ্যে অবস্থিত। এগুলো জিওকোডিং এপিআই-এর অ্যাড্রেস ডেসক্রিপ্টরস ফিচার দ্বারা প্রাপ্ত ল্যান্ডমার্কগুলোর অনুরূপ: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors ।
ARRIVAL এমন একটি স্থান যা গন্তব্যে পৌঁছাতে সাহায্য করে। গন্তব্যের কাছাকাছি পৌঁছানোর পর দিক নির্ণয়ের জন্য এটি উপযোগী। উদাহরণস্বরূপ, এই ল্যান্ডমার্কটি হতে পারে গন্তব্যের রাস্তার ওপারে অবস্থিত কোনো স্থান। সাধারণত, ADDRESS ট্যাগযুক্ত ল্যান্ডমার্কের চেয়ে এই ট্যাগযুক্ত ল্যান্ডমার্কটি গন্তব্যের বেশি কাছে থাকে।

প্রবেশদ্বার

প্রবেশপথ হলো একটি একক অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক জোড়া, যা কোনো স্থানের প্রবেশ ও প্রস্থান বিন্দুর অবস্থান নির্ধারণ করে।

JSON উপস্থাপনা 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string
}
ক্ষেত্র
location

object ( LatLng )

প্রবেশপথের অবস্থান।

tags[]

enum ( Entrance.Tag )

প্রবেশপথটির বর্ণনা দেয় এমন ট্যাগগুলোর একটি তালিকা।

place

string

এই প্রবেশদ্বারটি যে কাঠামোর উপর ভৌতভাবে অবস্থিত, তা places/{placeId} বিন্যাসে থাকবে।

প্রবেশপথ.ট্যাগ

প্রবেশপথের বর্ণনা দেয় এমন বৈশিষ্ট্যসমূহ।

এনাম
TAG_UNSPECIFIED ব্যবহৃত হয়নি।
PREFERRED

প্রবেশপথটি সম্ভবত ফেরত দেওয়া গন্তব্যের মূল স্থানে সরাসরি প্রবেশের সুযোগ করে দেয়। একটি স্থানের একাধিক পছন্দের প্রবেশপথ থাকতে পারে। যদি কোনো প্রবেশপথে এই ট্যাগটি না থাকে, তার মানে হলো প্রবেশপথটি মূল স্থানটির মতোই একই ভবনে অবস্থিত, কিন্তু সেটি আবশ্যিকভাবে সেই স্থানে প্রবেশের সুযোগ করে দেয় না।

উদাহরণস্বরূপ, যদি প্রধান স্থানটি কোনো স্ট্রিপ মলের একটি রেস্তোরাঁ হয়, তাহলে "পছন্দের" প্রবেশপথগুলো হবে সেগুলো যা সম্ভবত সরাসরি রেস্তোরাঁটিতে নিয়ে যায়, আর অন্যান্য ফেরত আসা প্রবেশপথগুলো হবে ভবনটির অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্য রেস্তোরাঁগুলোর প্রবেশপথ।

যদি মূল স্থানটি একটি ভবন হয়, তবে PREFERRED প্রবেশপথগুলো হবে সেগুলোই যা ভবনের 'প্রধান' অংশে নিয়ে যায়। উদাহরণস্বরূপ, একটি শপিং সেন্টারে PREFERRED প্রবেশপথগুলো হবে সেগুলো যা প্রধান ফোয়ার এলাকায় প্রবেশের সুযোগ দেয়, কিন্তু যদি কোনো প্রবেশপথ কেবল ভবনের পাশের কোনো দোকানে প্রবেশের সুযোগ দেয়, তবে সেটি PREFERRED প্রবেশপথ হিসেবে গণ্য হবে না।

দ্রষ্টব্য: একটি PREFERRED প্রবেশপথ মূল স্থানে প্রবেশের সুযোগ নাও দিতে পারে, এবং একটি PREFERRED প্রবেশপথ মূল স্থানে প্রবেশের সুযোগ দিতে পারে।