জিওকোডিং API v3-তে নিম্নলিখিত বৈশিষ্ট্যগুলি জিওকোডিং API v4-এর অনুসন্ধান গন্তব্যের শেষ পয়েন্ট দ্বারা প্রতিস্থাপিত হচ্ছে:
- প্রবেশদ্বার
- নেভিগেশন পয়েন্ট
- বিল্ডিং রূপরেখা
- স্থল
আপনি যদি উপরের বৈশিষ্ট্যগুলির জন্য জিওকোডিং API v3 ব্যবহার করে থাকেন তবে এই বৈশিষ্ট্যগুলি পাওয়ার পরিবর্তে অনুসন্ধান গন্তব্যের শেষ পয়েন্ট ব্যবহার করতে সাহায্য করার জন্য এই নথিটি ব্যবহার করুন৷ এই দস্তাবেজটি ব্যাখ্যা করে যে অনুসন্ধানগন্তব্য API প্রতিক্রিয়াতে এই বৈশিষ্ট্যগুলি খুঁজে পেতে কোথায় এবং এই বৈশিষ্ট্যগুলি কীভাবে জিওকোডিং API v3 এবং জিওকোডিং API v4 এর অনুসন্ধান গন্তব্যের শেষ পয়েন্টের মধ্যে API প্রতিক্রিয়াগুলিতে উপস্থাপন করা হয় তার পার্থক্য।
প্রবেশদ্বার
একটি destination সাথে যুক্ত প্রবেশদ্বার পেতে, ক্ষেত্র destination.entrances ব্যবহার করুন।
মনে রাখবেন যে একটি entrance বিন্যাস জিওকোডিং API v3-এর প্রবেশদ্বার বিন্যাস থেকে কিছুটা আলাদা। destination.entrances এর প্রতিটি প্রবেশপথে নিম্নলিখিত ক্ষেত্র রয়েছে:
-
displayName- এটি একটি নতুন ঐচ্ছিক ক্ষেত্র যাতে প্রবেশদ্বারের জন্য একটি মানুষের পাঠযোগ্য নাম থাকবে, উদাহরণস্বরূপ "গেট বি"। -
location- এটিLatLngটাইপের একটি অবস্থান, যা জিওকোডিং API v3-এ ব্যবহৃত বিন্যাস থেকে আলাদা। -
tags- এটি জিওকোডিং API v3 থেকে প্রবেশেরtagsক্ষেত্রের মতোই৷ -
place- জিওকোডিং API v3 থেকে প্রবেশদ্বারেরbuildingPlaceIdক্ষেত্রের সাথে সাদৃশ্যপূর্ণ। যাইহোক, এই ক্ষেত্রের স্থান আইডি যেকোন ধরণের স্থানের জন্য হতে পারে, অগত্যা কেবল একটি বিল্ডিং নয়।
নেভিগেশন পয়েন্ট
একটি destination সাথে যুক্ত নেভিগেশন পয়েন্ট পেতে, ক্ষেত্র destination.navigationPoints ব্যবহার করুন।
মনে রাখবেন যে একটি navigationPoint বিন্যাস জিওকোডিং API v3-এর নেভিগেশন পয়েন্ট বিন্যাস থেকে কিছুটা আলাদা। destination.navigationPoints এর প্রতিটি নেভিগেশন পয়েন্টের নিম্নলিখিত ক্ষেত্র রয়েছে:
-
displayName- এটি একটি নতুন ঐচ্ছিক ক্ষেত্র যাতে নেভিগেশন পয়েন্টের জন্য একটি মানুষের পাঠযোগ্য নাম থাকবে, উদাহরণস্বরূপ "5th Ave"৷ -
location- এটিLatLngটাইপের একটি অবস্থান, যা জিওকোডিং API v3-এ ব্যবহৃত বিন্যাস থেকে আলাদা। -
travelModes- এটি জিওকোডিং API v3 থেকে নেভিগেশন পয়েন্টেরrestrictedTravelModesক্ষেত্রের অনুরূপ। সম্ভাব্য enum মানগুলি একই, শুধুমাত্র পার্থক্য হল এই ক্ষেত্রটি এখন নেভিগেশন পয়েন্টের জন্য সীমাবদ্ধ ভ্রমণ মোডগুলির পরিবর্তে গ্রহণযোগ্য ভ্রমণ মোডগুলিকে প্রতিনিধিত্ব করে৷ -
usage- এটি একটি নতুন ক্ষেত্র যেখানে নেভিগেশন পয়েন্ট দ্বারা সমর্থিত ব্যবহারের ক্ষেত্রে রয়েছে। মনে রাখবেন যে বেশিরভাগ নেভিগেশন পয়েন্টগুলির একটিUNKNOWNব্যবহার থাকবে, তবে এর অর্থ এই নয় যে নেভিগেশন পয়েন্টের ব্যবহার কোনওভাবেই সীমাবদ্ধ।
বিল্ডিং রূপরেখা
একটি destination সাথে সম্পর্কিত বিল্ডিং রূপরেখা পেতে, আপনাকে destination placeView অবজেক্টের displayPolygon ক্ষেত্রটি ব্যবহার করা উচিত যা বিল্ডিংগুলিকে প্রতিনিধিত্ব করে। প্রতিটি placeView এর জন্য, আপনি এটি একটি বিল্ডিং কিনা তা placeView.structureType ক্ষেত্র সহ পরীক্ষা করতে পারেন। যদি কাঠামোর ধরনটি BUILDING হয়, তাহলে আপনি placeView.displayPolygon ক্ষেত্র থেকে রূপরেখা পেতে পারেন। placeView বিল্ডিংয়ের জন্য অতিরিক্ত ক্ষেত্রও থাকবে যা জিওকোডিং API v3-এ ছিল না।
একটি destination একটি placeView অবজেক্ট থাকতে পারে যা নিম্নলিখিত ক্ষেত্রগুলিতে একটি বিল্ডিংকে প্রতিনিধিত্ব করে:
-
destination.primary- এটি গন্তব্যের জন্য প্রাথমিক স্থান। -
destination.containingPlaces- এটি একটি পুনরাবৃত্ত ক্ষেত্র যা বৃহত্তর স্থান ধরে রাখতে পারে যা প্রাথমিক স্থান "ধারণ করে"। উদাহরণস্বরূপ, যদি প্রাথমিক স্থানটি একটিsubpremiseহয়,containingPlacesসাধারণত বিল্ডিংকে প্রতিনিধিত্বকারীplaceViewধরে রাখে। -
destination.subDestinations- এটি একটি পুনরাবৃত্ত ক্ষেত্র যা প্রাথমিক স্থানের উপ-গন্তব্য ধারণ করতে পারে। উদাহরণস্বরূপ, একটি বিল্ডিংয়ের পৃথক অ্যাপার্টমেন্ট ইউনিট। এই ক্ষেত্রটিতে সাধারণত একটি বিল্ডিং প্রতিনিধিত্বকারীplaceViewথাকবে না।
উল্লেখ্য যে placeView.displayPolygon এর বিন্যাস জিওকোডিং API v3-এর বিল্ডিং আউটলাইন বিন্যাসের সাথে মেলে, যেটি হল GeoJSON বিন্যাস, RFC 7946 বিন্যাস ব্যবহার করে।
স্থল
বিল্ডিং আউটলাইনের মতোই, একটি destination সাথে যুক্ত গ্রাউন্ডগুলি পেতে, আপনার destination placeView অবজেক্টের displayPolygon ক্ষেত্রটি ব্যবহার করা উচিত যা গ্রাউন্ডের প্রতিনিধিত্ব করে। প্রতিটি placeView এর জন্য, আপনি এটি placeView.structureType ক্ষেত্রের সাথে একটি ভিত্তি কিনা তা পরীক্ষা করতে পারেন। যদি কাঠামোর ধরনটি হয় GROUNDS , তাহলে আপনি placeView.displayPolygon ক্ষেত্র থেকে রূপরেখা পেতে পারেন। placeView এমন ক্ষেত্রগুলির জন্য অতিরিক্ত ক্ষেত্রও থাকবে যেগুলি জিওকোডিং API v3 তে ছিল না।
একটি destination একটি placeView অবজেক্ট থাকতে পারে যা নিম্নলিখিত ক্ষেত্রগুলিতে একটি স্থল প্রতিনিধিত্ব করে:
-
destination.primary -
destination.containingPlaces -
destination.subDestinations
উল্লেখ্য যে placeView.displayPolygon এর বিন্যাস জিওকোডিং API v3-এর গ্রাউন্ড আউটলাইন বিন্যাসের সাথে মেলে, যেটি হল GeoJSON বিন্যাস, RFC 7946 বিন্যাস ব্যবহার করে।
এই বৈশিষ্ট্যগুলির জন্য অনুরোধ করতে একটি ফিল্ড মাস্ক ব্যবহার করুন
SearchDestinations এন্ডপয়েন্টের জন্য একটি ফিল্ড মাস্ক প্রয়োজন, যেমনটি ফেরত দেওয়ার জন্য ক্ষেত্র চয়ন করুন- এ ব্যাখ্যা করা হয়েছে। সমস্ত ক্ষেত্র ফেরত দেওয়ার জন্য ফিল্ড মাস্ক * এ সেট করা যেতে পারে, অথবা আপনি যে নির্দিষ্ট ক্ষেত্রে পেতে চান সেটিতে সেট করতে পারেন। উদাহরণস্বরূপ, নিম্নলিখিত API অনুরোধটি প্রবেশদ্বার, নেভিগেশন পয়েন্ট, বিল্ডিং আউটলাইন এবং গন্তব্যের ভিত্তি পেতে প্রয়োজনীয় সমস্ত ক্ষেত্রগুলি গ্রহণ করার জন্য ফিল্ড মাস্ক সেট করে:
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,destinations.containingPlaces,destinations.subDestinations" \
https://geocode.googleapis.com/v4alpha/geocode/destinations