একটি 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
HTML ফর্ম্যাটে ক্যাপচার করা ঠিকানা উপাদানগুলি প্রক্রিয়া করার সময় আপনি সাধারণত 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" ]
এটি নিশ্চিত করে যে Place Autocomplete দ্বারা প্রদত্ত Place ID গুলি Search Destinations পদ্ধতির সাথে সবচেয়ে সামঞ্জস্যপূর্ণ। মনে রাখবেন যে establishment ধরণটি বিস্তৃত। অনেক ব্যবসার অবস্থান ক্যাপচার করার জন্য প্রয়োজনীয় হলেও, এই ফিল্টারটিতে natural_feature ধরণের জন্য Place Autocomplete ফলাফলও অন্তর্ভুক্ত থাকতে পারে, যেগুলির Search Destinations-এ সীমিত সমর্থন রয়েছে।
অবস্থান অনুসারে একটি গন্তব্য অনুসন্ধান করুন
অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক প্রদান করে আপনি একটি গন্তব্য অনুসন্ধান করতে পারেন:
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 ব্যবহার করুন
Geocoding API v4 প্রমাণীকরণের জন্য OAuth 2.0 সমর্থন করে। Geocoding API-এর সাথে OAuth ব্যবহার করার জন্য, OAuth টোকেনটিকে সঠিক স্কোপ বরাদ্দ করতে হবে। Geocoding API Destinations পদ্ধতির সাথে ব্যবহারের জন্য নিম্নলিখিত স্কোপগুলিকে সমর্থন করে:
-
https://www.googleapis.com/auth/maps-platform.geocode— সকল জিওকোডিং API পদ্ধতির সাথে ব্যবহার করুন।
এছাড়াও, আপনি সমস্ত জিওকোডিং API পদ্ধতির জন্য সাধারণ https://www.googleapis.com/auth/cloud-platform স্কোপ ব্যবহার করতে পারেন। এই স্কোপটি ডেভেলপমেন্টের সময় কার্যকর, কিন্তু উৎপাদনের সময় নয়, কারণ এটি একটি সাধারণ স্কোপ যা সমস্ত পদ্ধতিতে অ্যাক্সেসের অনুমতি দেয়।
আরও তথ্য এবং উদাহরণের জন্য, OAuth ব্যবহার দেখুন।
গন্তব্যস্থল অনুসন্ধানের প্রতিক্রিয়া
অনুসন্ধান গন্তব্যস্থলের প্রতিক্রিয়া অবস্থান সম্পর্কে সমৃদ্ধ, হাইপারলোকাল প্রেক্ষাপট প্রদান করে।
এই অংশে মূল প্রতিক্রিয়া ক্ষেত্রগুলি বর্ণনা করা হয়েছে। সমস্ত প্রতিক্রিয়া ক্ষেত্র সম্পর্কে সম্পূর্ণ বিবরণের জন্য, API রেফারেন্স দেখুন।
primary
অনুরোধে কোয়েরি দ্বারা চিহ্নিত প্রধান স্থান।
containingPlaces
বৃহত্তর সত্তা যার প্রাথমিক গন্তব্যস্থল অংশ (উদাহরণস্বরূপ, একটি দোকান সহ একটি মল)।
subDestinations
প্রাথমিক গন্তব্যের মধ্যে আরও নির্দিষ্ট অবস্থান (উদাহরণস্বরূপ, কোনও ভবনের অ্যাপার্টমেন্ট)।
entrances
entrances[] অ্যারের বস্তুগুলিতে নিম্নলিখিত ক্ষেত্রগুলি রয়েছে:
locationএকটি একক অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক জোড়া যা কোনও স্থানে প্রবেশ এবং প্রস্থান বিন্দুর অবস্থান নির্ধারণ করে।
entrance_tags[]প্রবেশপথের বৈশিষ্ট্য বর্ণনা করে এমন প্রবেশপথ ট্যাগের একটি অ্যারে। নিম্নলিখিত মানটি সমর্থিত:
"PREFERRED"ইঙ্গিত দেয় যে এই প্রবেশদ্বারটি সম্ভবত ফেরত দেওয়া জায়গায় ভৌত প্রবেশাধিকার প্রদান করে। একটি জায়গায় একাধিক পছন্দের প্রবেশপথ থাকতে পারে। যদি একটি প্রবেশপথে এই ট্যাগ না থাকে, তাহলে এর অর্থ হল প্রবেশদ্বারটি ভৌতভাবে একই ভবনে অবস্থিত, কিন্তু অগত্যা স্থানটিতে প্রবেশাধিকার প্রদান করে না।
উদাহরণস্বরূপ, যদি ফেরত দেওয়া জায়গাটি স্ট্রিপ মলের একটি রেস্তোরাঁ হয়, তাহলে
"PREFERRED"প্রবেশপথগুলিই হবে রেস্তোরাঁটিতে যাওয়ার জন্য, অন্যদিকে ফেরত দেওয়া অন্যান্য প্রবেশপথগুলি হবে ভবনের অন্যান্য প্রবেশপথ, যেমন স্ট্রিপ মলের অন্যান্য রেস্তোরাঁগুলিতে প্রবেশপথ।যদি ফেরত দেওয়া জায়গাটি নিজেই একটি ভবন হয়,
"PREFERRED"প্রবেশপথগুলিই ভবনের "প্রধান" অংশে প্রবেশ করবে। উদাহরণস্বরূপ, একটি শপিং সেন্টারে"PREFERRED"প্রবেশপথগুলিই হবে প্রধান প্রবেশপথে প্রবেশের অনুমতি দেয়, কিন্তু যদি একটি প্রবেশপথ কেবল ভবনের পাশের একটি দোকানে প্রবেশের অনুমতি দেয়, তাহলে এটি"PREFERRED"প্রবেশপথ হবে না।
structureType
এই স্থানটি যে ধরণের কাঠামোর প্রতিনিধিত্ব করে।
POINTএকটি বিন্দু অবস্থান।
SECTIONএকটি ভবনের একটি উপধারা।
BUILDINGএকটি ভবন।
GROUNDSএকটি বৃহৎ এলাকা যেখানে সাধারণত একাধিক ভবন থাকে, যেমন একটি বিশ্ববিদ্যালয় ক্যাম্পাস, একটি অ্যাপার্টমেন্ট কমপ্লেক্স, অথবা একটি শপিং মল।
navigationPoints
জিওকোডিং রেসপন্সের মধ্যে থাকা navigationPoints ফিল্ডে এমন পয়েন্টগুলির একটি তালিকা রয়েছে যা স্থানটিতে নেভিগেট করার জন্য কার্যকর। বিশেষ করে, স্থান থেকে বা স্থানটিতে কোনও রোড নেটওয়ার্কে রাউটিং করার সময় এগুলিকে শুরু বা শেষ পয়েন্ট হিসাবে ব্যবহার করা উচিত। প্রতিটি নেভিগেশন পয়েন্টে নিম্নলিখিত মানগুলি থাকে:
-
navigationPointTokenহল একটি টোকেন যাতেnavigationPointsক্ষেত্রের প্রাসঙ্গিক তথ্য থাকে। আপনার অ্যাপে রাউটিং এবং নদীর অভিজ্ঞতা উন্নত করতে আপনি এই টোকেনটি রাউটিং এবং নেভিগেশন API-তে পাঠাতে পারেন। আরও তথ্যের জন্য নেভিগেশন পয়েন্ট টোকেন ব্যবহার করে রুট দেখুন। -
locationনেভিগেশন পয়েন্টের অক্ষাংশ, দ্রাঘিমাংশের মান থাকে। এই অবস্থানটি সর্বদা সড়ক নেটওয়ার্কের খুব কাছাকাছি থাকবে এবং কোনও স্থানে যাতায়াতের জন্য এবং সেখান থেকে নেভিগেট করার জন্য একটি আদর্শ স্টপিং বা স্টার্টিং পয়েন্ট উপস্থাপন করে। স্থানটি যেখানে অবস্থিত সেখানে রাস্তার পাশে স্পষ্টভাবে চিহ্নিত করার জন্য বিন্দুটি ইচ্ছাকৃতভাবে রাস্তার কেন্দ্ররেখা থেকে সামান্য দূরে রাখা হয়েছে। -
travelModesহল ভ্রমণ মোডগুলির একটি তালিকা যেখান থেকে নেভিগেশন পয়েন্ট অ্যাক্সেসযোগ্য:-
"DRIVE"হল ড্রাইভিং দিকনির্দেশের সাথে সম্পর্কিত ভ্রমণ মোড। -
"WALK"হল হাঁটার দিকনির্দেশের সাথে সম্পর্কিত ভ্রমণের ধরণ।
-
-
usagesহল নেভিগেশন পয়েন্ট দ্বারা সমর্থিত ব্যবহারের একটি তালিকা। ব্যবহারগুলি হতে পারে:-
"DROPOFF" -
"PICKUP" -
"PARKING"
-
arrivalSummary
আগমনে সহায়তা করার জন্য AI-চালিত অন্তর্দৃষ্টি। AI-চালিত সারাংশ দেখুন।
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" ] } ] } ] }
প্রয়োজনীয় পরামিতি
- নিম্নলিখিত ৩টি প্যারামিটারের মধ্যে একটি API অনুরোধে থাকা আবশ্যক, যা একটি গন্তব্য অনুসন্ধানের জন্য ঠিকানা, স্থান বা অবস্থান নির্দিষ্ট করে:
-
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ত্রুটি প্রদান করবে। - API এমন একটি রাস্তার ঠিকানা প্রদানের জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয়ের জন্যই পঠনযোগ্য। এই লক্ষ্য অর্জনের জন্য, এটি স্থানীয় ভাষায় রাস্তার ঠিকানাগুলি ফেরত দেয়, প্রয়োজনে ব্যবহারকারীর দ্বারা পঠনযোগ্য স্ক্রিপ্টে লিপ্যন্তরিত করে, পছন্দের ভাষা পর্যবেক্ষণ করে। অন্যান্য সমস্ত ঠিকানা পছন্দের ভাষায় ফেরত দেওয়া হয়। ঠিকানার উপাদানগুলি একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদান থেকে নির্বাচিত হয়।
- যদি পছন্দের ভাষায় কোনও নাম পাওয়া না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে।
- API কোন ফলাফলগুলি ফেরত দিতে বেছে নেয় এবং কোন ক্রমে সেগুলি ফেরত দেওয়া হয় তার উপর পছন্দের ভাষার প্রভাব খুব কম থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলিকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার ধরণের সংক্ষিপ্ত রূপ, অথবা প্রতিশব্দ যা এক ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
অঞ্চল কোড
অঞ্চল কোডটি দুই-অক্ষরের CLDR কোড মান। কোনও ডিফল্ট মান নেই। বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ।
কোনও ঠিকানা জিওকোডিং করার সময়, জিওডকোডিং ফরোয়ার্ড করার সময়, এই প্যারামিটারটি নির্দিষ্ট অঞ্চলে পরিষেবা থেকে ফলাফলকে প্রভাবিত করতে পারে, কিন্তু সম্পূর্ণরূপে সীমাবদ্ধ করতে পারে না। কোনও অবস্থান বা স্থানের জিওকোডিং করার সময়, জিওকোডিং বিপরীত করার সময় বা স্থান জিওকোডিং করার সময় , এই প্যারামিটারটি ঠিকানাটি ফর্ম্যাট করতে ব্যবহার করা যেতে পারে। সমস্ত ক্ষেত্রে, এই প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।
স্থান ফিল্টার
আপনার প্রয়োজনীয়তা পূরণের জন্য
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/v4beta/geocode/destinations- বিচ্ছিন্ন ভবন : মানচিত্রে ভবনের রূপরেখা দেখাতে বা নির্দিষ্ট কাঠামোর বিবরণ পেতে
প্রতিক্রিয়া
এটি জিওকোডিং API-এর একটি পরীক্ষামূলক পদ্ধতি। geocoding-feedback-channel@google.com ঠিকানায় প্রতিক্রিয়া জানালে আমরা কৃতজ্ঞ থাকব।