Method: geocode.destinations.searchDestinations

এই পদ্ধতিটি একটি গন্তব্য সন্ধান করে এবং গন্তব্যগুলির একটি তালিকা প্রদান করে।

HTTP অনুরোধ

POST https://geocode.googleapis.com/v4alpha/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.Search Destinations-এর জন্য প্রতিক্রিয়া বার্তা।

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

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

object ( Destination )

গন্তব্যের একটি তালিকা।

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

অনুমোদনের সুযোগ

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

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

অনুসন্ধান গন্তব্যের অনুরোধ। ঠিকানা কোয়েরি

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

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

একটি রাস্তার ঠিকানা একটি একক লাইন হিসাবে ফর্ম্যাট করা হয়েছে৷

অনুসন্ধান গন্তব্যের অনুরোধ। অবস্থান কোয়েরি

একটি কাছাকাছি প্রাথমিক গন্তব্য শনাক্ত করার জন্য একটি অবস্থান ক্যোয়ারী৷

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

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

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

object ( LatLng )

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

গন্তব্য

একটি গন্তব্য। এর মধ্যে রয়েছে প্রাথমিক স্থান, সম্পর্কিত স্থান, প্রবেশপথ এবং নেভিগেশন পয়েন্ট।

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 দ্বারা প্রত্যাবর্তিত সাব-গন্তব্যের তুলনায়, উপ-গন্তব্যের এই তালিকাটি আরও সম্পূর্ণ, এবং প্রতিটি উপ-গন্তব্যে আরও তথ্য রয়েছে।

landmarks[]

object ( Landmark )

ল্যান্ডমার্ক যা গন্তব্য কোথায় যোগাযোগ করতে বা আগমনে সাহায্য করতে ব্যবহার করা যেতে পারে।

entrances[]

object ( Entrance )

এই গন্তব্যের জন্য প্রবেশ পথ।

navigationPoints[]

object ( NavigationPoint )

এই গন্তব্যের জন্য নেভিগেশন পয়েন্ট.

প্লেসভিউ

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

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

JSON প্রতিনিধিত্ব 
{
  "place": 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} ফর্ম্যাটে এই জায়গার সংস্থানের নাম।

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 ফর্ম্যাট ব্যবহার করে জিওজেএসএন ফর্ম্যাটে জায়গাটির বহুভুজ রূপরেখা: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6 ।

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

PlaceView.StructureType

এই জায়গাটি যে ধরনের কাঠামোর প্রতিনিধিত্ব করে।

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

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

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

JSON প্রতিনিধিত্ব 
{
  "tags": [
    enum (Landmark.Tag)
  ],

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

enum ( Landmark.Tag )

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

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

object ( PlaceView )

এই ল্যান্ডমার্কের প্রতিনিধিত্বকারী স্থান।

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

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

যদি একটি ঠিকানায় ADDRESS এবং ARRIVAL ট্যাগ উভয়ই থাকে, তাহলে এর অর্থ হল ল্যান্ডমার্কটি স্থানীয়ভাবে বিশিষ্ট এবং গন্তব্যের কাছাকাছি।

Enums
TAG_UNSPECIFIED ব্যবহার করা হয়নি।
ADDRESS একটি স্থানীয়ভাবে বিশিষ্ট স্থান যা গন্তব্যের সাধারণ অবস্থান সনাক্ত করতে ব্যবহার করা যেতে পারে। সাধারণত গন্তব্যের কয়েকশ মিটারের মধ্যে। এগুলি জিওকোডিং 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} বিন্যাসে এই প্রবেশদ্বারটি শারীরিকভাবে অবস্থিত।

প্রবেশ। ট্যাগ

বৈশিষ্ট্য যা একটি প্রবেশদ্বার বর্ণনা করে।

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

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

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

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

দ্রষ্টব্য: একটি PREFERRED প্রবেশদ্বার প্রাথমিক স্থানে প্রবেশাধিকার নাও দিতে পারে এবং একটি অ- PREFERRED প্রবেশদ্বার প্রাথমিক স্থানে প্রবেশাধিকার প্রদান করতে পারে।