Geocoder

জিওকোডার ক্লাস

ক্লাস google.maps.Geocoder
লাইব্রেরি "geocoding"

একটি ঠিকানা এবং একটি LatLng-এর মধ্যে রূপান্তর করার জন্য একটি পরিষেবা।

const {Geocoder} = await google.maps.importLibrary("geocoding");
Geocoder
Geocoder()
প্যারামিটার: কিছু নেই
Geocoder-এর একটি নতুন ইনস্ট্যান্স তৈরি করে যা Google সার্ভারে জিওকোড অনুরোধ পাঠায়।
geocode
geocode(request[, callback])
প্যারামিটার:
রিটার্ন ভ্যালু: Promise<GeocoderResponse>
অনুরোধ জিওকোড করুন।

GeocoderRequest ইন্টারফেস

ইন্টারফেস google.maps.GeocoderRequest

Geocoder-এ পাঠানোর জন্য জিওকোডিং অনুরোধের স্পেসিফিকেশন।
address
ঐচ্ছিক
ধরন: string optional
জিওকোড করার ঠিকানা। address, location এবং placeId-এর মধ্যে যেকোনও একটি অবশ্যই দিতে হবে।
bounds
ঐচ্ছিক
ধরন: LatLngBounds|LatLngBoundsLiteral optional
LatLngBounds যার মধ্যে সার্চ করতে হবে। ঐচ্ছিক।
componentRestrictions
ঐচ্ছিক
ধরন: GeocoderComponentRestrictions optional
নির্দিষ্ট কোনও এলাকায় ফলাফল সীমিত করতে কম্পোনেন্ট ব্যবহার করা হয়। একটি ফিল্টারে এগুলির মধ্যে এক বা একাধিক থাকে: route, locality, administrativeArea, postalCode, country। শুধুমাত্র সেইসব ফলাফল দেখানো হবে যেগুলি সব ফিল্টারের সাথে ম্যাচ করে। ফিল্টার ভ্যালু অন্যান্য জিওকোডিং অনুরোধের মতো বানান সংশোধন এবং আংশিক মিলের একই পদ্ধতি সমর্থন করে। ঐচ্ছিক।
BetaextraComputations
ঐচ্ছিক
ধরন: Array<ExtraGeocodeComputation> optional
অনুরোধ সম্পূর্ণ করার জন্য ব্যবহার করা হতে পারে এমন অতিরিক্ত কম্পিউটেশনের তালিকা। মনে রাখবেন: এই অতিরিক্ত গণনা উত্তরের ক্ষেত্রে অতিরিক্ত ফিল্ড দেখাতে পারে।
fulfillOnZeroResults
ঐচ্ছিক
ধরন: boolean optional
উত্তরে ZERO_RESULT স্ট্যাটাস সংক্রান্ত প্রতিশ্রুতি পূরণ করুন। এটি বাঞ্ছনীয় হতে পারে কারণ শূন্য জিওকোডিং ফলাফল থাকলেও অতিরিক্ত রেসপন্স লেভেল ফিল্ড ফেরত আসতে পারে।
language
ঐচ্ছিক
ধরন: string optional
সম্ভব হলে, যে ভাষায় ফলাফল দেখানো উচিত সেই ভাষার জন্য একটি ভাষা শনাক্তকারী। অনুমোদিত ভাষার তালিকা দেখুন।
location
ঐচ্ছিক
ধরন: LatLng|LatLngLiteral optional
LatLng (বা LatLngLiteral) যার জন্য সার্চ করতে হবে। জিওকোডার একটি রিভার্স জিওকোড পারফর্ম করে। আরও তথ্যের জন্য রিভার্স জিওকোডিং দেখুন। address, location এবং placeId-এর মধ্যে যেকোনও একটি অবশ্যই দিতে হবে।
placeId
ঐচ্ছিক
ধরন: string optional
লোকেশন সম্পর্কিত প্লেস আইডি। Google Places ডেটাবেস এবং Google Maps-এ কোনও জায়গাকে অনন্যভাবে শনাক্ত করার জন্য প্লেস আইডি ব্যবহার করা হয়। Places API ডেভেলপার নির্দেশিকায় প্লেস আইডি সম্পর্কে আরও জানুন। জিওকোডার একটি রিভার্স জিওকোড পারফর্ম করে। আরও তথ্যের জন্য রিভার্স জিওকোডিং দেখুন। address, location এবং placeId-এর মধ্যে যেকোনও একটি অবশ্যই দিতে হবে।
region
ঐচ্ছিক
ধরন: string optional
সার্চের ফলাফলকে প্রভাবিত করার জন্য ব্যবহৃত দেশের কোড, যা দুই-অক্ষরের (সংখ্যাসূচক নয়) ইউনিকোড অঞ্চল সাবট্যাগ / CLDR শনাক্তকারী হিসেবে নির্দিষ্ট করা হয়েছে। ঐচ্ছিক। যেসব অঞ্চলে কাজ করে তার জন্য Google Maps Platform কভারেজের বিবরণ দেখুন।

GeocoderComponentRestrictions ইন্টারফেস

ইন্টারফেস google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions ফিল্টারের একটি সেটকে দেখায় যা নির্দিষ্ট এলাকার জন্য কাজ করে। এটি কীভাবে কাজ করে সেই সম্পর্কে বিস্তারিত জানতে, জিওকোডিং কম্পোনেন্ট ফিল্টারিং দেখুন।
administrativeArea
ঐচ্ছিক
ধরন: string optional
সব administrative_area levels-এর সাথে মিলে যায়। ঐচ্ছিক।
country
ঐচ্ছিক
ধরন: string optional
কোনও দেশের নাম বা দুই অক্ষরের ISO 3166-1 দেশের কোডের সাথে মেলে। ঐচ্ছিক।
locality
ঐচ্ছিক
ধরন: string optional
locality এবং sublocality দুই ধরনের সাথে মেলে। ঐচ্ছিক।
postalCode
ঐচ্ছিক
ধরন: string optional
postal_code এবং postal_code_prefix-এর সাথে মেলে। ঐচ্ছিক।
route
ঐচ্ছিক
ধরন: string optional
route-এর বড় বা ছোট নামের সাথে মেলে। ঐচ্ছিক।

ExtraGeocodeComputation constants

constants google.maps.ExtraGeocodeComputation
library "geocoding"

জিওকোডিং অনুরোধ সম্পূর্ণ করার সময় অতিরিক্ত গণনা করা।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল ExtraGeocodeComputationString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");
ADDRESS_DESCRIPTORS ঠিকানার বিবরণ তৈরি করুন।

GeocoderStatus কনস্ট্যান্ট

constants google.maps.GeocoderStatus
library "geocoding"

geocode()-এ কল সম্পূর্ণ হওয়ার পরে Geocoder-এর মাধ্যমে রিটার্ন করা স্ট্যাটাস। ভ্যালু বা ধ্রুবকের নাম ব্যবহার করে এগুলি উল্লেখ করুন। যেমন, 'OK' বা google.maps.GeocoderStatus.OK।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল GeocoderStatusString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");
ERROR Google সার্ভারের সাথে যোগাযোগ করার সময় সমস্যা হয়েছে।
INVALID_REQUEST এই GeocoderRequest সঠিক নয়।
OK উত্তরে সঠিক GeocoderResponse আছে।
OVER_QUERY_LIMIT খুব কম সময়ের মধ্যে ওয়েবপেজটি অনুরোধের সীমা অতিক্রম করেছে।
REQUEST_DENIED ওয়েবপেজকে জিওকোডার ব্যবহার করার অনুমতি দেওয়া হয়নি।
UNKNOWN_ERROR সার্ভারের সমস্যার কারণে জিওকোডিং সংক্রান্ত অনুরোধ প্রসেস করা যায়নি। আপনি আবার চেষ্টা করলে অনুরোধটি সফল হতে পারে।
ZERO_RESULTS এই GeocoderRequest-এর জন্য কোনও ফলাফল পাওয়া যায়নি।

GeocoderResponse ইন্টারফেস

ইন্টারফেস google.maps.GeocoderResponse

Geocoder-এর মাধ্যমে পাঠানো জিওকোডার রেসপন্স যাতে GeocoderResult-এর তালিকা থাকে।
results
ধরন: Array<GeocoderResult>
GeocoderResult-এর তালিকা।
Betaaddress_descriptor
ঐচ্ছিক
ধরন: AddressDescriptor optional
কোনও লোকেশনের সম্পর্কযুক্ত বিবরণ। এতে আশেপাশের ল্যান্ডমার্কের র‍্যাঙ্ক করা সেট এবং টার্গেট লোকেশন সহ এলাকা অন্তর্ভুক্ত থাকে। এটি শুধুমাত্র রিভার্স জিওকোডিং অনুরোধের জন্য এবং শুধুমাত্র ExtraGeocodeComputation.ADDRESS_DESCRIPTORS চালু থাকলে পপুলেট করা হয়।
plus_code
ঐচ্ছিক
ধরন: PlacePlusCode optional
লোকেশনটির সাথে যুক্ত Plus Code।

GeocoderResult ইন্টারফেস

ইন্টারফেস google.maps.GeocoderResult

জিওকোড সার্ভার থেকে একটি জিওকোডার ফলাফল পাওয়া গেছে। জিওকোড অনুরোধ একাধিক ফলাফল অবজেক্ট দেখাতে পারে। মনে রাখবেন যে, এই ফলাফল "JSON-এর মতো" হলেও, এটি পুরোপুরি JSON নয়, কারণ এটি পরোক্ষভাবে একটি LatLng অবজেক্ট অন্তর্ভুক্ত করে।
address_components
GeocoderAddressComponent-এর একটি অ্যারে
formatted_address
ধরন: string
এই লোকেশনের মানুষের-পঠনযোগ্য ঠিকানা সহ স্ট্রিং।
geometry
ধরন: GeocoderGeometry
একটি GeocoderGeometry অবজেক্ট
place_id
ধরন: string
লোকেশন সম্পর্কিত প্লেস আইডি। Google Places ডেটাবেস এবং Google Maps-এ কোনও জায়গাকে অনন্যভাবে শনাক্ত করার জন্য প্লেস আইডি ব্যবহার করা হয়। Places API ডেভেলপার নির্দেশিকায় প্লেস আইডি সম্পর্কে আরও জানুন।
types
ধরন: Array<string>
ফেরত পাঠানো জিওকোড করা এলিমেন্টের ধরন বোঝাতে স্ট্রিংয়ের অ্যারে। সম্ভাব্য স্ট্রিংয়ের তালিকা দেখতে, ডেভেলপার গাইডের ঠিকানা কম্পোনেন্টের ধরন বিভাগ দেখুন।
Betaaddress_descriptor
ঐচ্ছিক
ধরন: AddressDescriptor optional
এই জিওকোডের সাথে যুক্ত লোকেশনের একটি রিলেশনাল বিবরণ। এতে আশেপাশের ল্যান্ডমার্কের র‍্যাঙ্ক করা সেট এবং টার্গেট লোকেশন সহ এলাকা অন্তর্ভুক্ত থাকে। এটি শুধুমাত্র ফরওয়ার্ড জিওকোডিং এবং প্লেস আইডি লুকআপ অনুরোধের জন্য পপুলেট করা হবে, শুধুমাত্র যখন ExtraGeocodeComputation.ADDRESS_DESCRIPTORS চালু থাকে এবং শুধুমাত্র নির্দিষ্ট কিছু স্থানীয় জায়গার জন্য।
partial_match
ঐচ্ছিক
ধরন: boolean optional
জিওকোডার আসল অনুরোধের জন্য সম্পূর্ণ মিল খুঁজে না পেলেও, অনুরোধ করা ঠিকানার অংশবিশেষের সাথে মিল খুঁজে পেয়েছে কিনা। সম্পূর্ণ ম্যাচ হলে, ভ্যালু হবে undefined।
plus_code
ঐচ্ছিক
ধরন: PlacePlusCode optional
লোকেশনটির সাথে যুক্ত Plus Code।
postcode_localities
ঐচ্ছিক
ধরন: Array<string> optional
একটি পিন কোডের মধ্যে থাকা সব এলাকা বোঝাতে স্ট্রিংয়ের অ্যারে। ফলাফলটি একাধিক এলাকা সহ পোস্টাল কোড হলে তবেই এটি দেখানো হয়।

AddressDescriptor ইন্টারফেস

ইন্টারফেস google.maps.AddressDescriptor

কোনও লোকেশনের সম্পর্কযুক্ত বিবরণ। এতে আশেপাশের ল্যান্ডমার্কের র‍্যাঙ্ক করা সেট এবং টার্গেট লোকেশন সহ এলাকা অন্তর্ভুক্ত থাকে।
areas
ধরন: Array<Area>
সংলগ্ন বা অন্তর্ভুক্ত এলাকার র‍্যাঙ্ক করা তালিকা। সবচেয়ে উপযোগী (শনাক্তযোগ্য ও সুনির্দিষ্ট) এলাকাগুলিকে প্রথমে র‍্যাঙ্ক করা হয়।
landmarks
ধরন: Array<Landmark>
আশেপাশের ল্যান্ডমার্কের র‍্যাঙ্ক করা তালিকা। সবচেয়ে উপযোগী (চেনা যায় এমন এবং কাছাকাছি) ল্যান্ডমার্কগুলি প্রথমে র‍্যাঙ্ক করা হয়।

GeocoderAddressComponent ইন্টারফেস

ইন্টারফেস google.maps.GeocoderAddressComponent

GeocoderResult-এর মধ্যে একটি ঠিকানা সংক্রান্ত কম্পোনেন্ট। একটি সম্পূর্ণ ঠিকানায় একাধিক ঠিকানার কম্পোনেন্ট থাকতে পারে।
long_name
ধরন: string
ঠিকানার উপাদানের সম্পূর্ণ টেক্সট
short_name
ধরন: string
প্রদত্ত ঠিকানা কম্পোনেন্টের সংক্ষিপ্ত টেক্সট
types
ধরন: Array<string>
এই অ্যাড্রেস কম্পোনেন্টের ধরন বোঝাতে স্ট্রিংয়ের অ্যারে। সঠিক ধরনের তালিকা এখানে দেখতে পাবেন

GeocoderGeometry ইন্টারফেস

ইন্টারফেস google.maps.GeocoderGeometry

এই GeocoderResult-এর জ্যামিতি সংক্রান্ত তথ্য
location
ধরন: LatLng
এই ফলাফলের অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট
location_type
location-এ যে ধরনের লোকেশন দেখানো হয়েছে
viewport
ধরন: LatLngBounds
এই GeocoderResult দেখানোর জন্য সাজেস্ট করা ভিউপোর্টের সীমা
bounds
ঐচ্ছিক
ধরন: LatLngBounds optional
এই GeocoderResult-এর সুনির্দিষ্ট সীমানা, প্রযোজ্য হলে

GeocoderLocationType constants

constants google.maps.GeocoderLocationType
library "geocoding"

জিওকোড থেকে পাওয়া লোকেশনের ধরন বর্ণনা করে। ভ্যালু বা ধ্রুবকের নাম ব্যবহার করে এগুলি উল্লেখ করুন। যেমন, 'ROOFTOP' বা google.maps.GeocoderLocationType.ROOFTOP।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল GeocoderLocationTypeString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");
APPROXIMATE ফিরে আসা ফলাফল আনুমানিক।
GEOMETRIC_CENTER ফলাফল হিসেবে কোনও লাইন (যেমন, রাস্তা) বা বহুভুজ (অঞ্চল)-এর মতো ফলাফলের জ্যামিতিক কেন্দ্র দেখানো হয়।
RANGE_INTERPOLATED ফিরে আসা ফলাফলটি দুটি সুনির্দিষ্ট বিন্দুর (যেমন ইন্টারসেকশন) মধ্যে ইন্টারপোলেট করা একটি আনুমানিক মান (সাধারণত একটি রাস্তায়) প্রতিফলিত করে। কোনও রাস্তার ঠিকানার জন্য রুফটপ জিওকোড উপলভ্য না থাকলে সাধারণত ইন্টারপোলেট করা ফলাফল দেখানো হয়।
ROOFTOP ফিরে আসা ফলাফল একটি সঠিক জিওকোড দেখায়।

ল্যান্ডমার্ক ইন্টারফেস

ইন্টারফেস google.maps.Landmark

এমন একটি জায়গা যা ঠিকানার জন্য রেফারেন্স পয়েন্ট হিসেবে কাজ করে।
display_name
ধরন: string
ল্যান্ডমার্কের নাম।
display_name_language_code
ধরন: string
ল্যান্ডমার্কের নামের ভাষা।
place_id
ধরন: string
ল্যান্ডমার্ক হিসেবে কাজ করা অন্তর্নিহিত প্রতিষ্ঠানের প্লেস আইডি। 'জায়গার বিবরণ' বা 'জায়গার আইডি লুক-আপ' ফিচারের মাধ্যমে ল্যান্ডমার্ক সম্পর্কে আরও তথ্য পেতে ব্যবহার করা যেতে পারে।
spatial_relationship
টার্গেট লোকেশন ও ল্যান্ডমার্কের মধ্যে স্থানিক সম্পর্ক নির্ধারণ করে।
straight_line_distance_meters
ধরন: number
টার্গেট লোকেশন ও ল্যান্ডমার্কের মধ্যে সরলরৈখিক দূরত্ব।
types
ধরন: Array<string>
ফেরত আসা ফলাফলের ধরন নির্দেশ করে এমন এক বা একাধিক ভ্যালু। আরও তথ্যের জন্য ধরন দেখুন।
travel_distance_meters
ঐচ্ছিক
ধরন: number optional
টার্গেট লোকেশন ও ল্যান্ডমার্কের মধ্যে রোড নেটওয়ার্ক অনুযায়ী ভ্রমণের দূরত্ব। টার্গেট লোকেশনটি যদি রোড নেটওয়ার্কের অংশ থেকে বিচ্ছিন্ন থাকে অথবা টার্গেট লোকেশনটি যদি রোড নেটওয়ার্কের অংশ হিসেবে বিবেচনা না করা হয়, তাহলে এই ফিল্ডটি খালি থাকতে পারে।

এলাকা ইন্টারফেস

ইন্টারফেস google.maps.Area

এমন একটি জায়গা যা ছোট অঞ্চল, যেমন আশেপাশের এলাকা, সাব-লোকালিটি বা বড় কমপ্লেক্স যার মধ্যে টার্গেট লোকেশন রয়েছে।
containment
ধরন: Containment
টার্গেট লোকেশন ও এলাকার মধ্যে স্থানিক সম্পর্ক নির্ধারণ করে।
display_name
ধরন: string
এলাকার নাম।
display_name_language_code
ধরন: string
এলাকার নামের ভাষা।
place_id
ধরন: string
অন্তর্নিহিত এলাকার স্থান আইডি। জায়গার বিবরণ বা জায়গা আইডি লুকআপের মাধ্যমে এলাকা সম্পর্কে আরও তথ্য পেতে ব্যবহার করা যেতে পারে।

কন্টেনমেন্ট কনস্ট্যান্ট

constants google.maps.Containment
library "geocoding"

একটি enum যা এলাকা এবং টার্গেট লোকেশনের মধ্যে স্থানিক সম্পর্ককে উপস্থাপন করে।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল ContainmentString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {Containment} = await google.maps.importLibrary("geocoding");
NEAR টার্গেট লোকেশনটি এলাকার বাইরে, তবে কাছাকাছি।
OUTSKIRTS টার্গেট লোকেশনটি এলাকার মধ্যে, সীমানার কাছাকাছি অবস্থিত।
WITHIN টার্গেট লোকেশনটি এলাকার মধ্যে, কেন্দ্রের কাছাকাছি।

SpatialRelationship কনস্ট্যান্ট

constants google.maps.SpatialRelationship
library "geocoding"

একটি enum যা ল্যান্ডমার্ক এবং টার্গেটের মধ্যে স্পেসে সম্পর্ককে প্রতিনিধিত্ব করে।

এইসব কনস্ট্যান্ট স্ট্রিং হিসেবেও ব্যবহার করা যায়। TypeScript-এ, স্ট্রিং লিটারেল SpatialRelationshipString টাইপ দ্বারা সংজ্ঞায়িত করা হয়।

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");
ACROSS_THE_ROAD টার্গেটটি রাস্তার অন্য পাশে ল্যান্ডমার্কের ঠিক বিপরীতে অবস্থিত।
AROUND_THE_CORNER ল্যান্ডমার্কের মতো একই রুটে নয়, তবে একবার বাঁক নিলেই পৌঁছে যাওয়া যায়।
BEHIND ল্যান্ডমার্কের কাঠামোর কাছাকাছি কিন্তু এর অ্যাক্সেস পয়েন্ট থেকে দূরে।
BESIDE টার্গেটটি ল্যান্ডমার্কের ঠিক পাশেই অবস্থিত।
DOWN_THE_ROAD ল্যান্ডমার্কের একই রুটে কিন্তু পাশে বা উল্টোদিকে নয়।
NEAR নিচে আরও নির্দিষ্ট কিছু প্রযোজ্য না হলে এটি ডিফল্ট সম্পর্ক।
WITHIN ল্যান্ডমার্কের স্পেশিয়াল জিওমেট্রি আছে এবং টার্গেটটি এর সীমানার মধ্যে আছে।