Package google.maps.geocode.v4alpha

সূচক

গন্তব্য পরিষেবা

গন্তব্য পুনরুদ্ধারের জন্য একটি পরিষেবা।

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

গন্তব্য অনুসন্ধান করুন

rpc SearchDestinations( SearchDestinationsRequest ) returns ( SearchDestinationsResponse )

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

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

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

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

গন্তব্য

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

ক্ষেত্র
primary

PlaceView

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

containing_places[]

PlaceView

কম সুনির্দিষ্ট স্থান যে প্রাথমিক স্থান দ্বারা ধারণ করা হয়. উদাহরণস্বরূপ, অ্যাপার্টমেন্ট কমপ্লেক্স যেটিতে এই বিল্ডিং রয়েছে।

sub_destinations[]

PlaceView

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

দ্রষ্টব্য: Places API দ্বারা প্রত্যাবর্তিত সাব-গন্তব্যের তুলনায়, উপ-গন্তব্যের এই তালিকাটি আরও সম্পূর্ণ, এবং প্রতিটি উপ-গন্তব্যে আরও তথ্য রয়েছে।

landmarks[]

Landmark

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

entrances[]

Entrance

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

navigation_points[]

NavigationPoint

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

প্রবেশদ্বার

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

ক্ষেত্র
location

LatLng

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

tags[]

Entrance.Tag

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

place

string

places/{place_id} বিন্যাসে এই প্রবেশদ্বারটি শারীরিকভাবে অবস্থিত।

ট্যাগ

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

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

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

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

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

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

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

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

ক্ষেত্র
tags[]

Landmark.Tag

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

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

PlaceView

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

ট্যাগ

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

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

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

একটি নেভিগেশন পয়েন্ট হল একটি রাস্তার পাশের একটি অবস্থান যেখানে নেভিগেশন শেষ হতে পারে।

ক্ষেত্র
display_name

LocalizedText

এই নেভিগেশন পয়েন্ট প্রদর্শনের নাম. উদাহরণস্বরূপ, "5th Ave" বা "গেট B"।

location

LatLng

রাস্তার অংশের পাশে একটি বিন্দু যেখানে নেভিগেশন শেষ হওয়া উচিত। বিন্দুটি ইচ্ছাকৃতভাবে রাস্তার কেন্দ্ররেখা থেকে সামান্য অফসেট করা হয়েছে যাতে জায়গাটি অবস্থিত রাস্তার পাশে স্পষ্টভাবে চিহ্নিত করা যায়।

travel_modes[]

NavigationPoint.TravelMode

এই নেভিগেশন পয়েন্টের জন্য উপযুক্ত ভ্রমণ মোড।

usages[]

NavigationPoint.Usage

এই নেভিগেশন পয়েন্ট দ্বারা সমর্থিত ব্যবহার.

ট্রাভেলমোড

এই নেভিগেশন পয়েন্টের জন্য উপযুক্ত ভ্রমণ মোড।

Enums
TRAVEL_MODE_UNSPECIFIED ব্যবহার করা হয়নি।
DRIVE গাড়ি চালানোর জন্য উপযুক্ত।
WALK হাঁটার জন্য উপযুক্ত।

ব্যবহার

এই নেভিগেশন পয়েন্ট দ্বারা সমর্থিত ব্যবহার.

Enums
USAGE_UNSPECIFIED ব্যবহার করা হয়নি।
UNKNOWN অজানা ব্যবহারের ধরন। বেশিরভাগ নেভিগেশন পয়েন্ট UNKNOWN থাকবে এবং এর মানে এই নয় যে তাদের ব্যবহার কোনোভাবেই সীমাবদ্ধ। এই নেভিগেশন এখনও পিকআপ এবং/অথবা ড্রপঅফের জন্য উপযুক্ত হতে পারে।
DROPOFF যাত্রী নামানোর জন্য উপযুক্ত। উদাহরণস্বরূপ, একটি রাইডশেয়ার ড্রপ অফ অবস্থান।
PICKUP যাত্রী তোলার জন্য উপযুক্ত। উদাহরণস্বরূপ, একটি রাইডশেয়ার পিক আপ অবস্থান।

প্লেসভিউ

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

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

ক্ষেত্র
place

string

places/{placeId} ফর্ম্যাটে এই জায়গার সংস্থানের নাম।

display_name

LocalizedText

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

primary_type

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 দেখুন।

formatted_address

string

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

postal_address

PostalAddress

কাঠামোবদ্ধ ঠিকানা।

structure_type

PlaceView.StructureType

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

location

LatLng

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

display_polygon

Struct

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

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

স্ট্রাকচার টাইপ

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

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

অনুসন্ধান গন্তব্য অনুরোধ

DestinationService.SearchDestinations-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
travel_modes[]

NavigationPoint.TravelMode

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

language_code

string

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

region_code

string

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

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

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

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

place

string

places/{place_id} ফর্ম্যাটে একটি স্থানের সম্পদের নাম।

address_query

SearchDestinationsRequest.AddressQuery

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

location_query

SearchDestinationsRequest.LocationQuery

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

AddressQuery

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

ক্ষেত্র
ইউনিয়ন ক্ষেত্র kind . ঠিকানা প্রশ্ন. kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
address

PostalAddress

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

address_query

string

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

LocationQuery

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

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

ক্ষেত্র
ইউনিয়ন ক্ষেত্র kind . অবস্থান প্রশ্ন. kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
location

LatLng

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

অনুসন্ধান গন্তব্য প্রতিক্রিয়া

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

ক্ষেত্র
destinations[]

Destination

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

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