Destination বলতে একটি গুরুত্বপূর্ণ স্থান বা নির্দিষ্ট অবস্থানকে বোঝায়, যেখানে একজন ব্যবহারকারী পৌঁছাতে বা যাত্রা করতে চান। একটি Destination দিকনির্দেশক চিহ্ন, পরিচিত স্থানচিহ্ন, প্রবেশপথ এবং ভবনের রূপরেখার মতো তথ্য অন্তর্ভুক্ত থাকতে পারে।
জিওকোডিং এপিআই-এর SearchDestinations মেথডটি আপনাকে ঠিকানা, স্থানের আইডি, বা অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্কের মতো বিভিন্ন ইনপুট শর্তের উপর ভিত্তি করে নানা গন্তব্যস্থল সম্পর্কে বিস্তারিত তথ্য পেতে সাহায্য করে।
অনুসন্ধান গন্তব্য অনুরোধ
অনুসন্ধানের গন্তব্যের অনুরোধ হলো একটি URL-এ পাঠানো একটি HTTP POST অনুরোধ, যার গঠনটি নিম্নরূপ:
https://geocode.googleapis.com/v4beta/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/v4beta/geocode/destinations
আপনি ৩টি উপায়ের যেকোনো একটি ব্যবহার করে গন্তব্যস্থল খোঁজার জন্য অবস্থান নির্দিষ্ট করতে পারেন:
- ঠিকানা
- স্থান আইডি
- অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক
ঠিকানা দ্বারা গন্তব্য অনুসন্ধান করুন
আপনি ঠিকানাটি একটি অসংগঠিত স্ট্রিং হিসাবে নির্দিষ্ট করতে পারেন। অ্যাড্রেস জিওকোডিং অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক, বা অন্যান্য অসংগঠিত স্ট্রিং যা কোনো ঠিকানাকে প্রতিনিধিত্ব করে না, সেগুলোকে শনাক্ত করতে পারে না। এই ধরনের স্ট্রিং ব্যবহার করে করা অনুরোধগুলি সমর্থিত নয় এবং এর ফলে ত্রুটিপূর্ণ প্রতিক্রিয়া বা অনির্দিষ্ট আচরণ দেখা দিতে পারে। অসমর্থিত কোয়েরিগুলির উদাহরণ নিচে দেওয়া হলো:
| কোয়েরি টাইপ | উদাহরণ |
|---|---|
| অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক। এর পরিবর্তে একটি অবস্থান কোয়েরি ব্যবহার করুন। | "৩৭.৪২২১৩১,-১২২.০৮৪৮০১" |
| একটি কোয়েরিতে একাধিক স্থান, রাস্তা বা শহরের নামের মতো অনেক বেশি ধারণা বা সীমাবদ্ধতা। | "মার্কেট স্ট্রিট সান ফ্রান্সিসকো সান হোসে বিমানবন্দর" |
| গুগল ম্যাপে ডাক ঠিকানার যে উপাদানগুলো দেখানো হয় না | "জন স্মিথের তত্ত্বাবধানে, ১২৩ মেইন স্ট্রিট" পোস্ট অফিস বক্স ১৩ সান ফ্রান্সিসকো |
| ব্যবসা, চেইন বা ক্যাটাগরির নাম, সেইসাথে এমন স্থান যেখানে এই সত্তাগুলো উপলব্ধ নয়। | ডালাস, টেক্সাসের নিকটবর্তী টেসকো |
| একাধিক ব্যাখ্যা সহ দ্ব্যর্থক প্রশ্ন | চার্জার ড্রপ-অফ |
| ঐতিহাসিক নাম যা এখন আর ব্যবহৃত হয় না | "মিডলসেক্স যুক্তরাজ্য" |
| অ-ভূস্থানিক উপাদান বা উদ্দেশ্য | ভেনচুরা বন্দরে কয়টি নৌকা আছে? |
| অনানুষ্ঠানিক বা শখের নাম | "জেঙ্গা" "দ্য হেল্টার স্কেল্টার" |
| বৃহৎ রাজনৈতিক সত্তা (শহর, রাজ্য, দেশ) | "নিউ ইয়র্ক সিটি" ক্যালিফোর্নিয়া "আমেরিকা" |
| নির্দিষ্ট ঠিকানা ছাড়া রুট | ১ম অ্যাভিনিউ, এনওয়াইসি, এনওয়াই "আই-৯৫" |
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/v4beta/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/v4beta/geocode/destinations
এইচটিএমএল ফর্মে ধারণ করা ঠিকানার উপাদানগুলো প্রক্রিয়াকরণের সময় আপনি সাধারণত postalAddress ফরম্যাটটি ব্যবহার করেন।
স্থান আইডি দ্বারা গন্তব্য অনুসন্ধান করুন
আপনি একটি স্থান আইডি প্রদান করে গন্তব্য খুঁজে পেতে পারেন:
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/v4beta/geocode/destinations
সমর্থিত স্থান আইডি
সার্চ ডেস্টিনেশন পদ্ধতিটি এমন প্লেস আইডিগুলোর সাথে সবচেয়ে ভালোভাবে কাজ করে, যেগুলো সুনির্দিষ্ট ও চলাচলযোগ্য গন্তব্যস্থলকে নির্দেশ করে।
establishment , point_of_interest , premise , street_address এবং subpremise মতো প্রকারের জন্য স্থান আইডি সাধারণত সমর্থিত।
যেসব স্থান আইডি সুনির্দিষ্ট অবস্থান নির্দেশ করে না, যেমন—ঠিকানার পরিসর থেকে অনুমান করা আইডি (উদাহরণস্বরূপ, "১০-২০ মেইন স্ট্রিট"), নির্দিষ্ট নম্বরবিহীন কোনো রুটের অংশ, বা প্লাস কোড—সেগুলো সমর্থিত নয় ।
প্লেস আইডি খোঁজার জন্য প্লেস অটোকমপ্লিট ব্যবহার করার সময় সামঞ্জস্যতা নিশ্চিত করতে, টাইপ অনুযায়ী ফলাফল ফিল্টার করার কথা বিবেচনা করুন। উপরে তালিকাভুক্ত শুধুমাত্র সমর্থিত টাইপগুলো অন্তর্ভুক্ত করার জন্য আপনি আপনার অটোকমপ্লিট অনুরোধগুলিতে includedPrimaryTypes প্যারামিটারটি ব্যবহার করতে পারেন:
"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]
এটি নিশ্চিত করে যে প্লেস অটোকমপ্লিট দ্বারা ফেরত আসা প্লেস আইডিগুলো সার্চ ডেস্টিনেশনস পদ্ধতির সাথে সর্বাধিক সামঞ্জস্যপূর্ণ। মনে রাখবেন যে establishment টাইপটি ব্যাপক। অনেক ব্যবসায়িক অবস্থান অন্তর্ভুক্ত করার জন্য প্রয়োজনীয় হলেও, এই ফিল্টারটিতে natural_feature টাইপের প্লেস অটোকমপ্লিট ফলাফলও অন্তর্ভুক্ত থাকতে পারে, যেগুলোর সার্চ ডেস্টিনেশনস-এ সীমিত সমর্থন রয়েছে।
অবস্থান অনুসারে গন্তব্য অনুসন্ধান করুন
আপনি অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক প্রদান করে গন্তব্য অনুসন্ধান করতে পারেন:
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/v4beta/geocode/destinations
অনুরোধ করতে OAuth ব্যবহার করুন
জিওকোডিং এপিআই ভি৪ অথেনটিকেশনের জন্য ওঅথ ২.০ সমর্থন করে। জিওকোডিং এপিআই-এর সাথে ওঅথ ব্যবহার করতে হলে, ওঅথ টোকেনটিকে অবশ্যই সঠিক স্কোপ প্রদান করতে হবে। জিওকোডিং এপিআই ‘ডেস্টিনেশনস’ মেথডের সাথে ব্যবহারের জন্য নিম্নলিখিত স্কোপগুলো সমর্থন করে:
-
https://www.googleapis.com/auth/maps-platform.geocode— সকল জিওকোডিং এপিআই পদ্ধতির সাথে ব্যবহার করুন।
এছাড়াও, আপনি সমস্ত জিওকোডিং এপিআই মেথডের জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপটি ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় উপযোগী, কিন্তু প্রোডাকশনের জন্য নয়, কারণ এটি একটি সাধারণ স্কোপ যা সমস্ত মেথডে অ্যাক্সেস দেয়।
আরও তথ্য ও উদাহরণের জন্য, Use OAuth দেখুন।
অনুসন্ধানের গন্তব্যস্থলের প্রতিক্রিয়া
'সার্চ ডেস্টিনেশনস' প্রতিক্রিয়াটি অবস্থানটি সম্পর্কে সমৃদ্ধ ও অতি-স্থানীয় প্রেক্ষাপট প্রদান করে।
এই বিভাগে মূল প্রতিক্রিয়া ক্ষেত্রগুলি বর্ণনা করা হয়েছে। সমস্ত প্রতিক্রিয়া ক্ষেত্রের সম্পূর্ণ বিবরণের জন্য, এপিআই রেফারেন্স দেখুন।
primary
অনুরোধে থাকা কোয়েরি দ্বারা চিহ্নিত প্রধান স্থান।
containingPlaces
বৃহত্তর প্রতিষ্ঠান যার অংশ হলো মূল গন্তব্যস্থল (উদাহরণস্বরূপ, একটি শপিং মল যার মধ্যে একটি দোকান রয়েছে)।
subDestinations
মূল গন্তব্যের মধ্যে আরও সুনির্দিষ্ট স্থান (উদাহরণস্বরূপ, একটি ভবনের অ্যাপার্টমেন্ট)।
entrances
entrances[] অ্যারের অবজেক্টগুলোতে নিম্নলিখিত ফিল্ডগুলো রয়েছে:
locationএকটি একক অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক জোড়া যা কোনো স্থানে প্রবেশ এবং প্রস্থানের বিন্দুর অবস্থান নির্ধারণ করে।
entrance_tags[]প্রবেশপথের বৈশিষ্ট্য বর্ণনা করে এমন প্রবেশপথ ট্যাগগুলির একটি অ্যারে। নিম্নলিখিত মানটি সমর্থিত:
"PREFERRED"এটি নির্দেশ করে যে এই প্রবেশপথটি সম্ভবত ফেরত দেওয়া স্থানটিতে সরাসরি প্রবেশের সুযোগ করে দেয়। একটি স্থানের একাধিক পছন্দের প্রবেশপথ থাকতে পারে। যদি কোনো প্রবেশপথে এই ট্যাগটি না থাকে, তার মানে হলো প্রবেশপথটি ভৌতিকভাবে একই ভবনে অবস্থিত, কিন্তু এটি আবশ্যিকভাবে স্থানটিতে প্রবেশের সুযোগ করে দেয় না।
উদাহরণস্বরূপ, যদি ফেরত দেওয়া স্থানটি একটি স্ট্রিপ মলের কোনো রেস্তোরাঁ হয়, তাহলে
"PREFERRED"প্রবেশপথগুলো হবে সরাসরি রেস্তোরাঁটিতে প্রবেশের পথ, আর অন্য ফেরত দেওয়া প্রবেশপথগুলো হবে ভবনটির অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্য রেস্তোরাঁগুলোতে যাওয়ার প্রবেশপথ।ফেরত দেওয়া স্থানটি যদি নিজেই একটি ভবন হয়,
"PREFERRED"প্রবেশপথগুলো হবে সেগুলোই যা ভবনের "প্রধান" অংশে নিয়ে যায়। উদাহরণস্বরূপ, একটি শপিং সেন্টারে"PREFERRED"প্রবেশপথগুলো হবে সেগুলো যা প্রধান ফোয়ার এলাকায় প্রবেশের সুযোগ দেয়, কিন্তু যদি কোনো প্রবেশপথ কেবল ভবনের পাশের কোনো দোকানে প্রবেশের সুযোগ দেয়, তবে সেটি"PREFERRED"প্রবেশপথ হবে না।
structureType
এই স্থানটি যে ধরনের কাঠামোর প্রতিনিধিত্ব করে।
POINTএকটি বিন্দু অবস্থান।
SECTIONভবনের একটি উপবিভাগ।
BUILDINGএকটি ভবন।
GROUNDSএকটি বৃহৎ এলাকা যেখানে সাধারণত একাধিক ভবন থাকে, যেমন বিশ্ববিদ্যালয় ক্যাম্পাস, অ্যাপার্টমেন্ট কমপ্লেক্স বা শপিং মল।
navigationPoints
The navigationPoints field within the Geocoding response contains a list of points that are useful for navigating to the place. Specifically, they should be used either as the starting or ending points when routing on a road network from or to the place. Each navigation point contains the following values:
-
navigationPointTokenহলো একটি টোকেন, যাnavigationPointsফিল্ডে প্রাসঙ্গিক তথ্য ধারণ করে। আপনার অ্যাপে রাউটিং এবং নদী অভিজ্ঞতা উন্নত করতে আপনি এই টোকেনটি রাউটিং এবং নেভিগেশন এপিআই-তে পাঠাতে পারেন। আরও তথ্যের জন্য ‘নেভিগেশন পয়েন্ট টোকেন ব্যবহার করে রাউটিং’ দেখুন। -
locationনেভিগেশন পয়েন্টের অক্ষাংশ ও দ্রাঘিমাংশের মান থাকে। এই অবস্থানটি সর্বদা সড়ক নেটওয়ার্কের খুব কাছাকাছি থাকবে এবং কোনো স্থানে যাতায়াতের জন্য এটি একটি আদর্শ থামার বা শুরু করার স্থান। স্থানটি রাস্তার কোন পাশে অবস্থিত তা স্পষ্টভাবে চিহ্নিত করার জন্য পয়েন্টটিকে ইচ্ছাকৃতভাবে রাস্তার কেন্দ্ররেখা থেকে সামান্য সরিয়ে রাখা হয়। -
travelModesহলো ভ্রমণ মোডগুলির একটি তালিকা, যেগুলি থেকে নেভিগেশন পয়েন্টটি অ্যাক্সেস করা যায়:-
"DRIVE"হলো ভ্রমণের মোড যা গাড়ি চালানোর নির্দেশনার সাথে সঙ্গতিপূর্ণ। -
"WALK"হলো হাঁটার দিকনির্দেশনার সাথে সম্পর্কিত ভ্রমণের মাধ্যম।
-
-
usagesহলো নেভিগেশন পয়েন্ট দ্বারা সমর্থিত ব্যবহারসমূহের একটি তালিকা। ব্যবহারসমূহ হতে পারে:-
"DROPOFF" -
"PICKUP" -
"PARKING"
-
arrivalSummary
আগমনে সহায়তার জন্য এআই-চালিত তথ্য। এআই-চালিত সারাংশগুলো দেখুন।
landmarks
গন্তব্যের চারপাশ সম্পর্কে ব্যবহারকারীদের ধারণা দিতে কাছাকাছি কিছু উল্লেখযোগ্য স্থান।
প্রতিক্রিয়া বিন্যাস
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": [ { "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" ] } ] } ] }
প্রয়োজনীয় প্যারামিটার
- এপিআই অনুরোধে নিম্নলিখিত ৩টি প্যারামিটারের মধ্যে যেকোনো একটি অবশ্যই থাকতে হবে, যা কোনো গন্তব্য খোঁজার জন্য ঠিকানা, স্থান বা অবস্থান নির্দিষ্ট করে:
-
addressQuery- যে ঠিকানাটি অনুসন্ধান করতে হবে। -
place- যে স্থানটি অনুসন্ধান করতে হবে তার স্থান আইডি। -
locationQuery- যে স্থানটি অনুসন্ধান করতে হবে তার অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক।
-
ফিল্ডমাস্ক
একটি রেসপন্স ফিল্ড মাস্ক তৈরি করে রেসপন্সে ফেরত আসা ফিল্ডগুলোর তালিকা নির্দিষ্ট করুন। 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/v4beta/geocode/destinationsরেসপন্সে ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি ফিল্ড মাস্কটি বাদ দেন, তাহলে মেথডটি একটি এরর রিটার্ন করবে। সমস্ত ফিল্ড রিটার্ন করার জন্য ফিল্ড মাস্কটি
*এ সেট করুন। আরও বিস্তারিত জানতে ‘ফেরত দেওয়ার জন্য ফিল্ড নির্বাচন করুন ’ দেখুন।
ঐচ্ছিক পরামিতি
ভ্রমণ মোড
কোন ধরনের
navigationPointsফেরত দেওয়া হবে তা নির্দিষ্ট করে। অন্যান্য ভ্রমণ পদ্ধতির নেভিগেশন পয়েন্টগুলো ফিল্টার করে বাদ দেওয়া হবে। যদিtravelModesসেট করা না থাকে, তবে সব ধরনের ভ্রমণ পদ্ধতির নেভিগেশন পয়েন্ট ফেরত দেওয়া যেতে পারে।ভাষা কোড
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
-
languageCodeসরবরাহ করা না হলে, API ডিফল্টরূপেenব্যবহার করে। আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি ফেরত দেয়। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- পছন্দের ভাষাটি এপিআই দ্বারা ফেরত দেওয়া ফলাফলের সেট এবং সেগুলোর ফেরত দেওয়ার ক্রমের উপর সামান্য প্রভাব ফেলে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা এমন প্রতিশব্দ যা একটি ভাষায় বৈধ হলেও অন্য ভাষায় নয়।
অঞ্চল কোড
অঞ্চল কোডটি একটি দুই-অক্ষরের CLDR কোড মান। এর কোনো ডিফল্ট মান নেই। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।
কোনো ঠিকানা জিওকোড করার সময় (ফরওয়ার্ড জিওকোডিং) , এই প্যারামিটারটি নির্দিষ্ট অঞ্চলের জন্য পরিষেবা থেকে প্রাপ্ত ফলাফলকে প্রভাবিত করতে পারে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনো অবস্থান বা স্থান জিওকোড করার সময় (রিভার্স জিওকোডিং বা প্লেস জিওকোডিং) , এই প্যারামিটারটি ঠিকানাটিকে ফরম্যাট করার জন্য ব্যবহার করা যেতে পারে। সব ক্ষেত্রেই, এই প্যারামিটারটি প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।
স্থান ফিল্টার
এটি আপনাকে আপনার প্রয়োজন অনুযায়ী
locationQueryসার্চের ফলাফল ফিল্টার করতে দেয়, যেমন—শুধুমাত্র ভবন এমন গন্তব্য অথবা শুধুমাত্র সুস্পষ্ট ঠিকানা আছে এমন গন্তব্য ফেরত আনা।কাঠামোগত সূক্ষ্মতা অনুসারে ফিল্টার করুন
structureTypeফিল্টারটি আপনাকে কোয়েরির মাধ্যমে ফেরত আসা স্ট্রাকচারের ধরন নির্দিষ্ট করতে দেয়:- ভবন চিহ্নিতকরণ : মানচিত্রে ভবনের রূপরেখা দেখাতে বা কোনো নির্দিষ্ট কাঠামোর বিবরণ পেতে
"structureType": "BUILDING"ব্যবহার করুন। - কমপ্লেক্স বোঝা : প্রাথমিক ফলাফলটি যেন সমগ্র প্রাঙ্গণ হয়, তা নিশ্চিত করতে
"structureType": "GROUNDS"ব্যবহার করুন। বিশ্ববিদ্যালয় ক্যাম্পাস বা শপিং মলের মতো বৃহত্তর এলাকার জন্য কোয়েরি করার সময় এটি উপযোগী। - Focusing on Units/Sections : Use
"structureType": "SECTION"to identify sections within a building.
কার্যকরী ঠিকানা নিশ্চিত করুন
সব জায়গার সুস্পষ্ট রাস্তার ঠিকানা থাকে না।
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/v4beta/geocode/destinations- ভবন চিহ্নিতকরণ : মানচিত্রে ভবনের রূপরেখা দেখাতে বা কোনো নির্দিষ্ট কাঠামোর বিবরণ পেতে
প্রতিক্রিয়া
এটি জিওকোডিং এপিআই-এর একটি পরীক্ষামূলক পদ্ধতি। geocoding-feedback-channel@google.com -এ আপনার মতামত জানালে আমরা কৃতজ্ঞ থাকব।