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)

একটি সুনির্দিষ্ট 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

এই জায়গাটি যে ধরনের স্ট্রাকচারকে উপস্থাপন করে।

Enums
STRUCTURE_TYPE_UNSPECIFIED ব্যবহার করা হয়নি।
POINT একটি পয়েন্ট লোকেশন।
SECTION বিল্ডিংয়ের একটি সাব-সেকশন।
BUILDING একটি বিল্ডিং।
GROUNDS একটি বড় জায়গা যেখানে সাধারণত একাধিক বিল্ডিং থাকে, যেমন কোনও বিশ্ববিদ্যালয়ের ক্যাম্পাস, অ্যাপার্টমেন্ট কমপ্লেক্স বা শপিং মল।

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

Enums
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

Places API-তে Place-এর ভিউ দেখায়। এছাড়াও, এটি গন্তব্য অনুযায়ী অতিরিক্ত তথ্য প্রদান করে, যেমন স্ট্রাকচারের ধরন এবং ডিসপ্লে পলিগন।

কিছু ক্ষেত্রে, একই জায়গা আইডির 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
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
ফিল্ড
place

string

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

string

কোনও জায়গার অনন্য শনাক্তকারী।
displayName

object (LocalizedText)

মানুষের-পঠনযোগ্য জায়গার বিবরণ। যেমন, "গেট B", "McDonalds"
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 ফর্ম্যাট MultiPolygons-কে সাপোর্ট করে, তাই একটি displayPolygon অবজেক্ট একাধিক বহুভুজকে উপস্থাপন করতে পারে।
addressComponents[]

object (PlaceView.AddressComponent)

প্রতিটি লোকালিটি লেভেলের জন্য রিপিট করা কম্পোনেন্ট।

PlaceView.AddressComponent

এই তথ্য উপলভ্য থাকলে, ফর্ম্যাট করা ঠিকানা তৈরি করে এমন স্ট্রাকচার্ড কম্পোনেন্ট।

JSON উপস্থাপনা 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
ফিল্ড
longText

string

ঠিকানার কম্পোনেন্টের সম্পূর্ণ টেক্সট বিবরণ বা নাম। যেমন, অস্ট্রেলিয়া দেশের জন্য অ্যাড্রেস কম্পোনেন্টে "অস্ট্রেলিয়া" নামের একটি বড় নাম থাকতে পারে।
shortText

string

ঠিকানার কম্পোনেন্টের জন্য সংক্ষিপ্ত টেক্সট নাম, উপলভ্য থাকলে। যেমন, অস্ট্রেলিয়া দেশের জন্য অ্যাড্রেস কম্পোনেন্টের সংক্ষিপ্ত নাম "AU" হতে পারে।
types[]

string

ঠিকানার কম্পোনেন্টের ধরন নির্দেশ করে এমন একটি অ্যারে।

আরও বিবরণের জন্য https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types দেখুন।
languageCode

string

CLDR নোটেশনে এই কম্পোনেন্ট ফর্ম্যাট করার জন্য ব্যবহৃত ভাষা।

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

গন্তব্য কোথায় অবস্থিত তা জানাতে বা গন্তব্যে পৌঁছাতে সাহায্য করার জন্য ল্যান্ডমার্ক ব্যবহার করা হয়।

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)

এই ল্যান্ডমার্কের প্রতিনিধিত্বকারী জায়গা।

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 (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string
}
ফিল্ড
location

object (LatLng)

প্রবেশপথের লোকেশন।
tags[]

enum (Entrance.Tag)

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

string

এই প্রবেশপথটি যে স্ট্রাকচারে বাস্তবে অবস্থিত, সেটি places/{placeId} ফর্ম্যাটে।

Entrance.Tag

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

Enums
TAG_UNSPECIFIED ব্যবহার করা হয়নি।
PREFERRED

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

যেমন, প্রাথমিক জায়গাটি যদি স্ট্রিপ মলের কোনও রেস্তোরাঁ হয়, তাহলে "পছন্দের" প্রবেশপথগুলি হবে সেগুলি যেগুলি সম্ভবত রেস্তোরাঁর দিকে নিয়ে যায়, অন্যদিকে অন্যান্য রিটার্ন করা প্রবেশপথগুলি হবে বিল্ডিংয়ের অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্যান্য রেস্তোরাঁর প্রবেশপথ।

প্রাথমিক জায়গাটি যদি কোনও বিল্ডিং হয়, তাহলে PREFERREDটি প্রবেশপথ বিল্ডিংয়ের "প্রধান" অংশে নিয়ে যাবে। যেমন, কোনও শপিং সেন্টারের PREFERRED প্রবেশপথ হল সেটি যেখান দিয়ে মূল লবিতে প্রবেশ করা যায়, কিন্তু কোনও প্রবেশপথ দিয়ে যদি শুধু বিল্ডিংয়ের একপাশে থাকা কোনও স্টোরে প্রবেশ করা যায়, তাহলে সেটি PREFERRED প্রবেশপথ নয়।

মনে রাখবেন: PREFERRED প্রবেশপথ দিয়ে মূল জায়গায় অ্যাক্সেস নাও পাওয়া যেতে পারে এবং PREFERRED নয় এমন প্রবেশপথ দিয়ে মূল জায়গায় অ্যাক্সেস পাওয়া যেতে পারে।