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