Destination
বলতে কোনও নির্দিষ্ট লোকেশন বা জায়গাকে বোঝায় যেখানে ব্যবহারকারী পৌঁছাতে বা নেভিগেট করতে
চান। এছাড়াও, Destination-এ লোকেশন বা জায়গা সম্পর্কিত তথ্যের সংগ্রহ থাকে, যেমন নেভিগেশন পয়েন্ট, ল্যান্ডমার্ক, প্রবেশপথ এবং বিল্ডিংয়ের আউটলাইন।
Geocoding API-এর
SearchDestinations
পদ্ধতি আপনাকে বিভিন্ন ইনপুট মাপকাঠির উপর ভিত্তি করে বিভিন্ন গন্তব্য সম্পর্কে বিস্তারিত তথ্য পেতে দেয়, যেমন একটি ঠিকানা, স্থান আইডি, বা
অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক।
গন্তব্য সার্চ করার অনুরোধ
গন্তব্য সার্চ করার অনুরোধ হল এই ফর্ম্যাটে কোনও URL-এ HTTP POST অনুরোধ:
https://geocode.googleapis.com/v4/geocode/destinations
POST অনুরোধের অংশ হিসেবে JSON অনুরোধের বডি বা হেডারে সব প্যারামিটার পাস করুন। যেমন:
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations
আপনি ৩টি উপায়ের মধ্যে যেকোনও একটির মাধ্যমে গন্তব্য সার্চ করার জন্য লোকেশন নির্দিষ্ট করতে পারবেন:
- ঠিকানা
- জায়গার আইডি
- অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক
ঠিকানা দিয়ে গন্তব্য সার্চ করুন
আপনি ঠিকানাটি আনস্ট্রাকচার্ড স্ট্রিং হিসেবে উল্লেখ করতে পারেন। অ্যাড্রেস জিওকোডিং অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক বা অন্যান্য আনস্ট্রাকচার্ড স্ট্রিং সমাধান করে না যা কোনও ঠিকানা দেখায় না। এই ধরনের স্ট্রিং ব্যবহার করে করা অনুরোধ কাজ করে না এবং এর ফলে ভুল উত্তর বা অনির্দিষ্ট আচরণ দেখা যেতে পারে। কাজ করে না এমন কোয়েরির উদাহরণ নিচে দেওয়া হল:
| কোয়েরির ধরন | উদাহরণ |
|---|---|
| অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক। পরিবর্তে লোকেশন কোয়েরি ব্যবহার করুন। | "37.422131,-122.084801" |
| একটি কোয়েরিতে অনেক বেশি ধারণা বা সীমাবদ্ধতা, যেমন একাধিক জায়গা, রাস্তা বা শহরের নাম | "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান জোসে বিমানবন্দর" |
| Google Maps-এ ডাক ঠিকানার এলিমেন্ট দেখানো হয়নি |
"C/O জন স্মিথ ১২৩ মেইন স্ট্রিট" "পোস্ট বক্স ১৩ সান ফ্রান্সিসকো" |
| ব্যবসা, চেন বা বিভাগের নাম লোকেশনের সাথে যুক্ত করা যেখানে এইসব এন্টিটি উপলভ্য নয় | "ডালাস, টেক্সাসের কাছাকাছি Tesco" |
| একাধিক ব্যাখ্যা সহ অস্পষ্ট কোয়েরি | "চার্জার ড্রপ-অফ" |
| ঐতিহাসিক নাম আর ব্যবহার করা হয় না | "মিডলসেক্স যুক্তরাজ্য" |
| নন-জিওস্পেশিয়াল এলিমেন্ট বা উদ্দেশ্য | "ভেনচুরা হারবারে কতগুলি নৌকা আছে?" |
| বেসরকারি বা ভ্যানিটি নাম |
"The Jenga" "The Helter Skelter" |
| বড় রাজনৈতিক এন্টিটি (শহর, রাজ্য, দেশ) |
"নিউ ইয়র্ক সিটি" "ক্যালিফোর্নিয়া" "মার্কিন যুক্তরাষ্ট্র" |
| নির্দিষ্ট ঠিকানা ছাড়া রুট |
"1st Ave., NYC, NY" "I-95" |
curl -X POST -d '{
"addressQuery": {
"addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations
অথবা
postalAddress হিসেবে:
curl -X POST -d '{
"addressQuery": {
"address": {
"addressLines": ["601 S Bernardo Ave"],
"locality": "Sunnyvale",
"postalCode": "94087",
"administrativeArea": "CA",
"regionCode": "US"
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations
HTML ফর্মে ক্যাপচার করা ঠিকানার উপাদান প্রসেস করার সময় আপনি সাধারণত postalAddress ফর্ম্যাট ব্যবহার করেন।
প্লেস আইডি দিয়ে গন্তব্য সার্চ করুন
আপনি জায়গার ID প্রদান করে কোনও গন্তব্য পুনরুদ্ধার করতে পারবেন:
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations
কাজ করে এমন প্লেস আইডি
Search Destinations পদ্ধতিটি নির্দিষ্ট, নেভিগেট করা যায় এমন গন্তব্যকে উপস্থাপন করে এমন Place ID-এর সাথে সবচেয়ে ভালো কাজ করে। establishment,
point_of_interest, premise, street_address এবং subpremise-এর মতো ধরনের জন্য প্লেস আইডি সাধারণত
কাজ করে। যেসব প্লেস আইডি আলাদা লোকেশন দেখায় না, যেমন ঠিকানা রেঞ্জ থেকে অনুমান করা
লোকেশন (যেমন, "১০-২০ মেইন স্ট্রিট"), নির্দিষ্ট নম্বর ছাড়া রুটের অংশ
অথবা Plus Code কাজ করে না। যেসব ফলাফলের এলাকা অনেক বড় (যেমন, "প্রশান্ত মহাসাগর"), সেগুলির প্লেস আইডি
কাজ করে না।
Search Destinations-এর সাথে 'অটোমেটিক সম্পূর্ণ করুন (নতুন)' ফিচার ব্যবহার করা
মানানসই কিনা তা নিশ্চিত করতে, Search Destinations-এর সাথে ব্যবহার করার জন্য Place ID খুঁজতে Autocomplete (নতুন) ব্যবহার করুন। অটোকমপ্লিট (নতুন) ব্যবহার করার সময়, আপনাকে
includedPrimaryTypes
প্যারামিটার ব্যবহার করে ধরন অনুযায়ী ফলাফল ফিল্টার করতে হবে। নিম্নলিখিত সাজেস্ট করা ফিল্টার ব্যবহার করে অটো-কমপ্লিট (নতুন) ফিচারের মাধ্যমে ফেরত পাঠানো প্লেস আইডি
Search Destinations-এর সাথে কাজ করে:
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
এছাড়াও, আপনার অটোমেটিক পূরণ (নতুন) অনুরোধে include_pure_service_area_businesses
ফ্ল্যাগ true-এ সেট করা উচিত নয়।
লোকেশন অনুযায়ী গন্তব্য সার্চ করা
আপনি অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক প্রদান করে গন্তব্য সার্চ করতে পারবেন:
curl -X POST -d '{
"locationQuery": {
"location": {
"latitude": 37.37348780,
"longitude": -122.05678064
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations
অনুরোধ করতে OAuth ব্যবহার করা
Geocoding API v4 যাচাইকরণের জন্য OAuth 2.0-কে সাপোর্ট করে। Geocoding API-এর সাথে OAuth ব্যবহার করতে, OAuth টোকেনকে অবশ্যই সঠিক স্কোপে অ্যাসাইন করতে হবে। Geocoding API, Destinations পদ্ধতির সাথে ব্যবহারের জন্য নিম্নলিখিত স্কোপগুলি সমর্থন করে:
https://www.googleapis.com/auth/maps-platform.geocode— সব Geocoding API পদ্ধতির সাথে ব্যবহার করুন।
এছাড়াও, আপনি সব Geocoding API পদ্ধতির জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform
স্কোপ ব্যবহার করতে পারবেন। ডেভেলপমেন্টের সময় এই স্কোপ উপযোগী,
কিন্তু প্রোডাকশনের সময় নয়, কারণ এটি একটি সাধারণ স্কোপ যা সব
পদ্ধতিতে অ্যাক্সেস দেয়।
আরও তথ্য ও উদাহরণের জন্য, OAuth ব্যবহার করুন দেখুন।
গন্তব্য সার্চ করার উত্তর
Search Destinations-এর উত্তর লোকেশন সম্পর্কে সমৃদ্ধ, হাইপারলোকাল প্রসঙ্গ প্রদান করে।
Search Destinations-এর উত্তরে PlaceView অবজেক্ট (যেমন, primary, containingPlaces-এ থাকা আইটেম এবং landmarks) জায়গার ধরন উল্লেখ করতে ফিল্ড ব্যবহার করে:
types: জায়গার ধরন নির্দেশ করে এমন স্ট্রিংয়ের অ্যারে।primaryType: একটি স্ট্রিং যা জায়গার প্রাথমিক ধরন নির্দেশ করে।
types এবং primaryType-এর সম্ভাব্য স্ট্রিং ভ্যালু, জায়গার ধরন (নতুন) পৃষ্ঠার সারণী ক এবং সারণী খ থেকে নেওয়া হয়েছে।
এই বিভাগে মূল উত্তর ফিল্ডের বিবরণ দেওয়া হয়েছে। সব উত্তর ফিল্ডের সম্পূর্ণ বিবরণ পেতে, API রেফারেন্স দেখুন।
primary
অনুরোধে কোয়েরির মাধ্যমে শনাক্ত করা প্রধান জায়গা।
addressComponents
এই ঠিকানার ক্ষেত্রে প্রযোজ্য আলাদা আলাদা কম্পোনেন্ট সহ একটি অ্যারে।
প্রতিটি ঠিকানার কম্পোনেন্টে সাধারণত নিম্নলিখিত ফিল্ড থাকে:
types[]হল একটি অ্যারে যা অ্যাড্রেস কম্পোনেন্টের ধরন নির্দেশ করে। কাজ করে এমন ধরনের তালিকা দেখুন।longTextহল জিওকোডারের মাধ্যমে পাওয়া ঠিকানা কম্পোনেন্টের সম্পূর্ণ টেক্সট বিবরণ বা নাম।shortTextহল ঠিকানা কম্পোনেন্টের সংক্ষিপ্ত টেক্সট নাম, যদি উপলভ্য থাকে। যেমন, আলাস্কা রাজ্যের কোনও ঠিকানার উপাদানেlongText"Alaska" এবংshortText"AK" থাকতে পারে, যেখানে দুই অক্ষরের ডাকঘরের সংক্ষিপ্ত রূপ ব্যবহার করা হয়েছে।- CLDR নোটেশনে, এই কম্পোনেন্ট ফর্ম্যাট করতে
languageCodeভাষা ব্যবহার করা হয়।
containingPlaces
প্রাথমিক গন্তব্যটি যে বড় এন্টিটির অংশ (যেমন, কোনও স্টোর সহ শপিং মল)।
subDestinations
প্রাথমিক গন্তব্যের মধ্যে আরও নির্দিষ্ট লোকেশন (যেমন, কোনও বিল্ডিংয়ের মধ্যে অ্যাপার্টমেন্ট)।
entrances
entrances[] অ্যারেতে থাকা অবজেক্টে নিম্নলিখিত ফিল্ড থাকে:
displayNameএকটি
LocalizedTextঅবজেক্ট যাতে প্রবেশদ্বারের জন্য মানুষের-পঠনযোগ্য নাম থাকে (যেমন,"South Bernardo Avenue"বা"5th Avenue"), যদি উপলভ্য থাকে।locationএকটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক জোড়া যা কোনও জায়গায় প্রবেশ ও বের হওয়ার পয়েন্টের লোকেশন নির্ধারণ করে।
entrance_tags[]প্রবেশপথের ট্যাগগুলির একটি অ্যারে যা প্রবেশপথের বৈশিষ্ট্যগুলি বর্ণনা করে। নিম্নলিখিত ভ্যালু কাজ করে:
"PREFERRED"
এই প্রবেশপথটি সম্ভবত ফিরে আসা জায়গায় ফিজিক্যাল অ্যাক্সেস প্রদান করে। কোনও জায়গায় একাধিক পছন্দের প্রবেশপথ থাকতে পারে। কোনও প্রবেশপথে এই ট্যাগ না থাকলে, তার অর্থ হল প্রবেশপথটি শারীরিকভাবে একই বিল্ডিংয়ে অবস্থিত হলেও, সেটি দিয়ে ওই জায়গায় প্রবেশ করা যায় না।
যেমন, যদি ফেরত আসা জায়গাটি স্ট্রিপ মলের একটি রেস্তোরাঁ হয়, তাহলে
"PREFERRED"প্রবেশপথগুলি হবে সেগুলি যা সরাসরি রেস্তোরাঁর দিকে নিয়ে যায়, অন্যদিকে অন্যান্য ফেরত আসা প্রবেশপথগুলি হবে বিল্ডিংয়ের অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্যান্য রেস্তোরাঁর প্রবেশপথ।ফিরে আসা জায়গাটি যদি কোনও বিল্ডিং হয়, তাহলে
"PREFERRED"প্রবেশপথগুলি বিল্ডিংয়ের "প্রধান" অংশে নিয়ে যাবে। যেমন, কোনও শপিং সেন্টারে"PREFERRED"প্রবেশপথগুলি হল সেগুলি যেগুলি প্রধান ফোয়ার এলাকায় অ্যাক্সেস দেয়, কিন্তু যদি কোনও প্রবেশপথ শুধুমাত্র বিল্ডিংয়ের পাশে একটি স্টোরে অ্যাক্সেস দেয়, তবে এটি একটি"PREFERRED"প্রবেশপথ হবে না।streetViewThumbnailওstreetViewAnnotationStreet View Static API-এর প্যারামিটার, যা আপনাকে এইসব লোকেশনের জন্য প্রাসঙ্গিক ছবি দেখানোর অনুমতি দেয়। এইসব ফিল্ড সম্পর্কে আরও জানুন।
structureType
এই জায়গাটি যে ধরনের স্ট্রাকচারকে উপস্থাপন করে।
POINTএকটি পয়েন্ট লোকেশন।
SECTIONবিল্ডিংয়ের একটি উপবিভাগ।
BUILDINGএকটি বিল্ডিং।
GROUNDSএকটি বড় এলাকা যেখানে সাধারণত একাধিক বিল্ডিং থাকে, যেমন একটি বিশ্ববিদ্যালয় ক্যাম্পাস, একটি অ্যাপার্টমেন্ট কমপ্লেক্স বা একটি শপিং মল।
navigationPoints
জিওকোডিং রেসপন্সের মধ্যে navigationPoints ফিল্ডে পয়েন্টের একটি তালিকা থাকে যা
জায়গায় নেভিগেট করার জন্য উপযোগী। বিশেষ করে, কোনও জায়গা থেকে বা কোনও জায়গায় রোড নেটওয়ার্কে রুট করার সময় এগুলি শুরু বা শেষ পয়েন্ট হিসেবে ব্যবহার করা উচিত।
প্রতিটি নেভিগেশন পয়েন্টে নিম্নলিখিত ভ্যালু থাকে:
navigationPointTokenহল একটি টোকেন যাতেnavigationPointsফিল্ডে প্রাসঙ্গিক তথ্য থাকে। আপনার অ্যাপে রাউটিং ও নদী সংক্রান্ত অভিজ্ঞতা উন্নত করতে, আপনি এই টোকেন রাউটিং ও নেভিগেশন API-তে পাঠাতে পারেন। আরও তথ্যের জন্য নেভিগেশন পয়েন্ট টোকেন ব্যবহার করে রুট করুন দেখুন।location-এ নেভিগেশন পয়েন্টের অক্ষাংশ, দ্রাঘিমাংশের মান থাকে। এই লোকেশনটি সবসময় রোড নেটওয়ার্কের খুব কাছাকাছি হবে এবং কোনও জায়গায় যাওয়া বা সেখান থেকে আসার জন্য নেভিগেট করার আদর্শ স্টপিং বা স্টার্টিং পয়েন্ট হিসেবে কাজ করবে। রাস্তার যে পাশে জায়গাটি অবস্থিত সেটি স্পষ্টভাবে চিহ্নিত করার জন্য পয়েন্টটি ইচ্ছাকৃতভাবে রাস্তার কেন্দ্ররেখা থেকে সামান্য অফসেট করা হয়েছে।travelModesহল ভ্রমণ মোডের একটি তালিকা যেখান থেকে নেভিগেশন পয়েন্ট অ্যাক্সেস করা যায়:"DRIVE"হল গাড়ি চালানোর দিকনির্দেশ অনুযায়ী ভ্রমণ মোড।"WALK"হল হাঁটার দিকনির্দেশ অনুযায়ী ভ্রমণের মোড।
usagesহল নেভিগেশন পয়েন্টের মাধ্যমে কাজ করে এমন ব্যবহারের তালিকা। ব্যবহারের ধরন হতে পারে:"DROPOFF""PICKUP""PARKING"
পিক-আপ ও ড্রপ-অফের জন্য, সেই নেভিগেশন পয়েন্ট ব্যবহার করুন যেখানে ভ্রমণ মোড হল DRIVE
এবং ব্যবহার হল PICKUP বা DROPOFF। পিক-আপ বা ড্রপ-অফ পয়েন্ট উপলভ্য না থাকলে, ড্রাইভিং নেভিগেশনের সবচেয়ে উপরের পয়েন্ট ব্যবহার করুন।
streetViewThumbnailএবংentranceAnnotationStreet View Static API-এর জন্য প্যারামিটার প্রদান করে, যা আপনাকে এইসব লোকেশনের জন্য প্রাসঙ্গিক ছবি দেখানোর অনুমতি দেয়। এইসব ফিল্ড সম্পর্কে আরও জানুন।
altitude_meters-এ WGS-84 উপবৃত্তাকার-এর সাপেক্ষে নেভিগেশন পয়েন্টের উচ্চতা মিটারে দেওয়া আছে। যেসব ক্ষেত্রে উল্লম্বভাবে স্ট্যাক করা রাস্তার অংশ আছে, সেখানে আপনার সিস্টেমের নেভিগেট করার জন্য সেরা রাস্তার অংশ বেছে নিতেaltitude_metersফিল্ড ব্যবহার করুন।
landmarks
ব্যবহারকারীদের গন্তব্যের আশেপাশের পরিবেশ বুঝতে সাহায্য করার জন্য কাছাকাছি উল্লেখযোগ্য স্থান।
প্রতিটি ল্যান্ডমার্কে নিম্নলিখিত ফিল্ড থাকে:
placeহলPlaceViewঅবজেক্ট যা এই ল্যান্ডমার্ককে দেখায়।relationalDescriptionহল গন্তব্যটি ল্যান্ডমার্কের সাথে কীভাবে সম্পর্কিত তার একটি মানুষের-পঠনযোগ্য বিবরণ, যেমন "এম্পায়ার স্টেট বিল্ডিংয়ের কাছে" বা "হোয়াইট হাউসের বিপরীতে"।tags[]হল ট্যাগের একটি অ্যারে যা বর্ণনা করে যে কীভাবে ল্যান্ডমার্কটি গন্তব্যের প্রসঙ্গে ব্যবহার করা যেতে পারে:"ADDRESS": স্থানীয়ভাবে পরিচিত জায়গা যা গন্তব্যের সাধারণ লোকেশন শনাক্ত করতে ব্যবহার করা যেতে পারে।"ARRIVAL": এমন একটি জায়গা যা গন্তব্যে পৌঁছাতে সাহায্য করার জন্য ব্যবহার করা যেতে পারে, গন্তব্যের কাছাকাছি পৌঁছানোর পরে নেভিগেশনের জন্য উপযোগী।
straightLineDistanceMetersহল এই ল্যান্ডমার্ক থেকে গন্তব্যের সরলরৈখিক দূরত্ব, মিটারে।- এই ল্যান্ডমার্ক থেকে গন্তব্যের দূরত্ব
travelDistanceMetersমিটার, যা হেঁটে যাওয়া যায়।
arrivalSummary
পৌঁছানোর ব্যাপারে সাহায্য করার জন্য AI-পরিচালিত ইনসাইট। AI-এর মাধ্যমে তৈরি সারসংক্ষেপ দেখুন।
parkingOptions
পার্কিং সংক্রান্ত বিস্তারিত তথ্য।
উত্তর দেওয়ার ফর্ম্যাট
SearchDestinations নিম্নলিখিত JSON ফর্মের
SearchDestinationsResponse
রিটার্ন করে:
{ "destinations": [ { "primary": { "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w", "displayName": { "text": "Arby's", "languageCode": "en" }, "primaryType": "fast_food_restaurant", "types": [ "fast_food_restaurant", "sandwich_shop", "deli", "meal_takeaway", "food_delivery", "american_restaurant", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "601 S Bernardo Ave" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3734545, "longitude": -122.05693269999998 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.056930138027, 37.3735253692531 ], [ -122.056960139391, 37.3735372663597 ], [ -122.056994129366, 37.3734828786847 ], [ -122.056969677395, 37.3734731161089 ], [ -122.057061762447, 37.3733261309656 ], [ -122.056979388817, 37.3732935577128 ], [ -122.056798860285, 37.3735818838642 ], [ -122.056875858081, 37.3736121235316 ], [ -122.056930138027, 37.3735253692531 ] ] ] } }, "containingPlaces": [ { "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw", "displayName": { "text": "Cherry Chase Shopping Center", "languageCode": "en" }, "primaryType": "shopping_mall", "types": [ "shopping_mall", "point_of_interest", "establishment" ], "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1020", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "663 S Bernardo Ave" ] }, "structureType": "GROUNDS", "location": { "latitude": 37.3731231, "longitude": -122.0578211 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [ -122.057112227103, 37.3714618008523 ], [ -122.057076849821, 37.3715743611411 ], [ -122.056963607756, 37.3719081793948 ], [ -122.056865279559, 37.3722026053835 ], [ -122.056687872374, 37.3727258358476 ], [ -122.056580005889, 37.3730511370747 ], [ -122.056498845827, 37.3732994782583 ], [ -122.056338259713, 37.3737878663325 ], [ -122.056618678291, 37.373887693582 ], [ -122.056912102521, 37.3740010327191 ], [ -122.057532418159, 37.3742476426462 ], [ -122.057673926626, 37.3742441740031 ], [ -122.057735663106, 37.3742328516943 ], [ -122.057766531332, 37.3742220604378 ], [ -122.057797572967, 37.37420520725 ], [ -122.057828267759, 37.3741852342085 ], [ -122.058060299297, 37.3740060842535 ], [ -122.058199726081, 37.3737861673422 ], [ -122.05836707267, 37.373524542556 ], [ -122.058569622393, 37.3732018598683 ], [ -122.0587638478, 37.3728890198039 ], [ -122.058934661823, 37.3726036257774 ], [ -122.059164956851, 37.3722498383629 ], [ -122.058997784906, 37.3721804442035 ], [ -122.057936479838, 37.3717605636234 ], [ -122.057495827092, 37.3715860151634 ], [ -122.057112227103, 37.3714618008523 ] ] ] } } ], "landmarks": [ { "place": { "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg", "displayName": { "text": "Chase Bank", "languageCode": "en" }, "primaryType": "bank", "types": [ "bank", "atm", "finance", "point_of_interest", "establishment" ], "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1234 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.373579, "longitude": -122.05752700000001 } }, "relationalDescription": { "text": "Near Chase Bank", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 61.182193756103516, "travelDistanceMeters": 63.075645446777344 }, { "place": { "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14", "displayName": { "text": "Safeway", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "butcher_shop", "florist", "deli", "supermarket", "bakery", "food_delivery", "market", "manufacturer", "food_store", "store", "food", "service", "point_of_interest", "establishment" ], "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "639 S Bernardo Ave" ] }, "structureType": "POINT", "location": { "latitude": 37.3727912, "longitude": -122.0581172 } }, "relationalDescription": { "text": "Around the corner from Safeway", "languageCode": "en" }, "tags": [ "ARRIVAL", "ADDRESS" ], "straightLineDistanceMeters": 158.65606689453125, "travelDistanceMeters": 131.1669921875 }, { "place": { "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk", "displayName": { "text": "Oil Changers", "languageCode": "en" }, "types": [ "car_repair", "service", "point_of_interest", "establishment" ], "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1240 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3743054, "longitude": -122.0584272 } }, "relationalDescription": { "text": "Down the road from Oil Changers", "languageCode": "en" }, "tags": [ "ARRIVAL" ], "straightLineDistanceMeters": 140.52459716796875, "travelDistanceMeters": 143.24220275878906 }, { "place": { "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0", "displayName": { "text": "Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "primaryType": "grocery_store", "types": [ "grocery_store", "cake_shop", "supermarket", "asian_grocery_store", "indian_restaurant", "meal_takeaway", "bakery", "manufacturer", "wholesaler", "restaurant", "food_store", "store", "food", "point_of_interest", "establishment" ], "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1056", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1111 W El Camino Real" ] }, "structureType": "POINT", "location": { "latitude": 37.3737199, "longitude": -122.0522958 } }, "relationalDescription": { "text": "Near Apni Mandi Farmers Market Sunnyvale", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 410.37435913085938, "travelDistanceMeters": 479.49893188476562 }, { "place": { "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs", "displayName": { "text": "Starbird Chicken", "languageCode": "en" }, "primaryType": "chicken_restaurant", "types": [ "chicken_restaurant", "fast_food_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94087-1028", "administrativeArea": "CA", "locality": "Sunnyvale", "addressLines": [ "1241 W El Camino Real" ] }, "structureType": "BUILDING", "location": { "latitude": 37.3746764, "longitude": -122.05708860000001 }, "displayPolygon": { "coordinates": [ [ [ -122.057003840785, 37.3747648209809 ], [ -122.057136852459, 37.3747919153144 ], [ -122.057205005705, 37.3745815131859 ], [ -122.057071994114, 37.3745544186944 ], [ -122.057003840785, 37.3747648209809 ] ] ], "type": "Polygon" } }, "relationalDescription": { "text": "Near Starbird Chicken", "languageCode": "en" }, "tags": [ "ADDRESS" ], "straightLineDistanceMeters": 87.348007202148438, "travelDistanceMeters": 214.08084106445312 } ], "entrances": [ { "displayName": { "text": "South Bernardo Avenue", "languageCode": "en" }, "location": { "latitude": 37.3735328, "longitude": -122.05694879999999 }, "tags": [ "PREFERRED" ], "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w" } ], "navigationPoints": [ { "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4", "location": { "latitude": 37.3738659, "longitude": -122.05693620000001 }, "travelModes": [ "DRIVE", "WALK" ], "usages": [ "PARKING" ] } ] } ] }
প্রয়োজনীয় প্যারামিটার
- API অনুরোধে নিম্নলিখিত ৩টি প্যারামিটারের মধ্যে একটি অবশ্যই থাকতে হবে, যা
গন্তব্য সার্চ করার জন্য ঠিকানা, জায়গা বা লোকেশন নির্দিষ্ট করে:
addressQuery- যে ঠিকানা সার্চ করতে হবে।place- যে জায়গা সার্চ করতে হবে সেটির প্লেস আইডি।locationQuery- যে লোকেশন সার্চ করতে চান, তার অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক।
FieldMask
রেসপন্স ফিল্ড মাস্ক তৈরি করে রেসপন্সে ফেরত পাঠানোর জন্য ফিল্ডের তালিকা নির্দিষ্ট করুন। URL প্যারামিটার
$fieldsবাfieldsঅথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে পদ্ধতিতে রেসপন্স ফিল্ড মাস্ক পাস করুন। যেমন, নিচের অনুরোধটি শুধুমাত্র প্রাথমিক গন্তব্যের প্রবেশপথ, নেভিগেশন পয়েন্ট এবং স্থান আইডি দেখাবে।curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \ -H "X-Goog-Api-Key: API_KEY" \ -H "Content-Type: application/json" \ -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \ https://geocode.googleapis.com/v4/geocode/destinationsউত্তরে ফেরত আসা ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি ফিল্ড মাস্ক বাদ দিলে, পদ্ধতিটি একটি ত্রুটি দেখায়। সব ফিল্ড ফিরিয়ে আনতে ফিল্ড মাস্ক
*-এ সেট করুন। আরও বিবরণের জন্য ফেরত পাওয়ার জন্য ফিল্ড বেছে নিন দেখুন।
ঐচ্ছিক প্যারামিটার
-
travelModes
কোন ধরনের
navigationPointsফেরত দিতে হবে তা নির্দিষ্ট করে। অন্যান্য ট্রাভেল মোডের জন্য নেভিগেশন পয়েন্ট ফিল্টার করা হবে। যদিtravelModesসেট না করা থাকে, তাহলে সব ভ্রমণ মোডের নেভিগেশন পয়েন্ট ফেরত দেওয়া যেতে পারে। languageCode
যে ভাষায় ফলাফল দেখানো হবে।
- অনুমোদিত ভাষার তালিকা দেখুন। Google প্রায়ই কাজ করে এমন ভাষার তালিকা আপডেট করে, তাই এই তালিকা সম্পূর্ণ নাও হতে পারে।
-
languageCodeপ্রদান করা না হলে, API ডিফল্ট হিসেবে লোকেশনের স্থানীয় ভাষা ও স্ক্রিপ্ট ব্যবহার করে। আপনি যদি কোনও ভুল ভাষার কোড উল্লেখ করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি দেখায়। - API এমন রাস্তার ঠিকানা প্রদান করার যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী ও স্থানীয় লোকজন উভয়ের জন্যই বোধগম্য হয়। এই লক্ষ্য পূরণ করতে, এটি স্থানীয় ভাষায় রাস্তার ঠিকানা ফেরত পাঠায়, যা ব্যবহারকারীর পছন্দের ভাষা অনুযায়ী, প্রয়োজনে ব্যবহারকারীর পড়ার উপযোগী স্ক্রিপ্টে লিপ্যন্তর করা হয়। অন্যান্য সব ঠিকানা পছন্দের ভাষায় দেখানো হয়। ঠিকানার সব কম্পোনেন্ট একই ভাষায় দেখানো হয়, যা প্রথম কম্পোনেন্ট থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনও নাম উপলভ্য না থাকলে, API সবচেয়ে কাছাকাছি ম্যাচ ব্যবহার করে।
- API যে ফলাফল দেখায় এবং যে ক্রমে দেখায়, তার উপর পছন্দের ভাষার সামান্য প্রভাব থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা সমার্থক শব্দ যা একটি ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
regionCode
অঞ্চল কোড দুই-অক্ষরের CLDR কোড ভ্যালু হিসেবে। কোনও ডিফল্ট ভ্যালু নেই। অধিকাংশ CLDR কোড ISO 3166-1 কোডের মতোই।
কোনও ঠিকানা জিওকোড করার সময়, ফরওয়ার্ড জিওকোডিং, এই প্যারামিটার নির্দিষ্ট অঞ্চলের জন্য পরিষেবা থেকে প্রাপ্ত ফলাফলকে প্রভাবিত করতে পারে, তবে সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনও লোকেশন বা জায়গার জিওকোডিং করার সময়, রিভার্স জিওকোডিং বা জায়গার জিওকোডিং, এই প্যারামিটারটি ঠিকানা ফর্ম্যাট করতে ব্যবহার করা যেতে পারে। সব ক্ষেত্রেই, এই প্যারামিটার প্রযোজ্য আইনের ভিত্তিতে ফলাফলকে প্রভাবিত করতে পারে।
-
placeFilter
আপনার প্রয়োজনীয়তা অনুযায়ী
locationQueryসার্চের ফলাফল ফিল্টার করতে দেয়, যেমন শুধু বিল্ডিং বা স্পষ্ট ঠিকানা আছে এমন গন্তব্য দেখানো।স্ট্রাকচারাল গ্র্যানুলারিটি অনুযায়ী ফিল্টার করুন
structureTypeফিল্টার আপনাকে কোয়েরির মাধ্যমে ফেরত আসা স্ট্রাকচারের ধরন নির্দিষ্ট করতে দেয়:- বিল্ডিং আলাদা করা: ম্যাপে বিল্ডিংয়ের আউটলাইন দেখাতে বা নির্দিষ্ট কোনও স্ট্রাকচারের বিবরণ পেতে
"structureType": "BUILDING"ব্যবহার করুন। - কমপ্লেক্স বোঝা: প্রাথমিক ফলাফল যাতে সামগ্রিক গ্রাউন্ড হয় তা নিশ্চিত করতে
"structureType": "GROUNDS"ব্যবহার করুন। বিশ্ববিদ্যালয় ক্যাম্পাস বা শপিং মলের মতো বড় এলাকার জন্য কোয়েরি করার সময় এটি কাজে লাগে। - ইউনিট/সেকশনের উপর ফোকাস করা: কোনও বিল্ডিংয়ের মধ্যে
সেকশন শনাক্ত করতে
"structureType": "SECTION"ব্যবহার করুন।
প্রয়োজনীয় ঠিকানা নিশ্চিত করা
সব জায়গার রাস্তার লেভেলে স্পষ্ট ঠিকানা থাকে না।
addressabilityফিল্টার আপনাকে ফলাফলে দেখানো ঠিকানার কোয়ালিটি নিয়ন্ত্রণ করতে সাহায্য করে:- স্পষ্ট প্রাথমিক ঠিকানা প্রয়োজন: প্রধান গন্তব্যের ফলাফলে যাতে সবসময়
রাস্তার লেভেলে ঠিকানা বা নাম থাকে তা নিশ্চিত করতে,
"addressability": "PRIMARY"ব্যবহার করুন। এটি নেভিগেশন বা ডিসপ্লে করার উদ্দেশ্যে উপযোগী যেখানে একটি স্পষ্ট ঠিকানা অত্যন্ত গুরুত্বপূর্ণ। - সাব-ডেস্টিনেশনে ঠিকানা দেখানোর অনুমতি দিন: যেসব ক্ষেত্রে মূল জায়গার
কোনও ঠিকানা নাও থাকতে পারে, কিন্তু তার মধ্যে থাকা ইউনিটের (যেমন, কোনও বিল্ডিংয়ের অ্যাপার্টমেন্ট) ঠিকানা থাকে,
সেক্ষেত্রে
"addressability": "WEAK"নিশ্চিত করে যে অন্তত মূল জায়গা বা তার কোনও একটি সাব-ডেস্টিনেশনের ঠিকানা যেন থাকে। - যেকোনও ফলাফল: আপনার ব্যবহারের ক্ষেত্রে ঠিকানা থাকা প্রাসঙ্গিক না হলে,
"addressability": "ANY"ব্যবহার করুন। আপনার যদি শুধুমাত্র বিল্ডিংয়ের আউটলাইন এবং নেভিগেশন পয়েন্টের মতো জ্যামিতিক অ্যাট্রিবিউট প্রয়োজন হয়, তাহলে এটি করার জন্য বিশেষভাবে সাজেস্ট করা হয়, কারণ এটি এইসব ফলাফলের নির্ভুলতা উন্নত করে।
উদাহরণ: অ্যাড্রেসেবল বিল্ডিংয়ের জন্য ফিল্টার করা
curl -X POST -d '{ "locationQuery": { "location": { "latitude": 37.37348780, "longitude": -122.05678064 }, "placeFilter": { "structureType": "BUILDING", "addressability": "PRIMARY" } }, "languageCode": "en" }' \\ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\ -H "X-Goog-FieldMask: place" \\ https://geocode.googleapis.com/v4/geocode/destinations - বিল্ডিং আলাদা করা: ম্যাপে বিল্ডিংয়ের আউটলাইন দেখাতে বা নির্দিষ্ট কোনও স্ট্রাকচারের বিবরণ পেতে