ভূমিকা
একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ এক বা একাধিক স্থানের ধরন গ্রহণ করে এবং নির্দিষ্ট এলাকার মধ্যে মিলে যাওয়া স্থানগুলির একটি তালিকা ফেরত দেয়। এক বা একাধিক ডেটা টাইপ নির্দিষ্ট করে একটি ফিল্ড মাস্ক প্রয়োজন। নিকটবর্তী অনুসন্ধান (নতুন) শুধুমাত্র POST অনুরোধ সমর্থন করে।
এপিআই এক্সপ্লোরার আপনাকে সরাসরি অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন:
মানচিত্রে নিকটবর্তী অনুসন্ধানের (নতুন) ফলাফল দেখতে ইন্টারেক্টিভ ডেমোটি ব্যবহার করে দেখুন।
কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ
একটি Nearby Search (New) অনুরোধ হলো একটি URL-এ পাঠানো একটি HTTP POST অনুরোধ, যার গঠনটি নিম্নরূপ:
https://places.googleapis.com/v1/places:searchNearby
POST অনুরোধের অংশ হিসেবে সমস্ত প্যারামিটার JSON অনুরোধের বডিতে অথবা হেডারে পাঠান। উদাহরণস্বরূপ:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
Nearby Search (New) responses
নিকটবর্তী অনুসন্ধান (নতুন) প্রতিক্রিয়া হিসাবে একটি JSON অবজেক্ট ফেরত দেয়। প্রতিক্রিয়ায়:
-
placesঅ্যারেটিতে সমস্ত মিলে যাওয়া স্থানগুলো রয়েছে। - অ্যারের প্রতিটি স্থান একটি
Placeঅবজেক্ট দ্বারা উপস্থাপিত হয়।Placeঅবজেক্টটিতে একটি নির্দিষ্ট স্থান সম্পর্কে বিস্তারিত তথ্য থাকে। - অনুরোধে প্রদত্ত FieldMask,
Placeঅবজেক্টে ফেরত আসা ফিল্ডগুলোর তালিকা নির্দিষ্ট করে।
সম্পূর্ণ JSON অবজেক্টটি নিম্নলিখিত আকারে থাকে:
{
"places": [
{
object (Place)
}
]
}প্রয়োজনীয় প্যারামিটার
ফিল্ডমাস্ক
একটি রেসপন্স ফিল্ড মাস্ক তৈরি করে রেসপন্সে ফেরত আসা ফিল্ডগুলোর তালিকা নির্দিষ্ট করুন। URL প্যারামিটার
$fieldsবাfieldsব্যবহার করে, অথবা HTTP হেডারX-Goog-FieldMaskব্যবহার করে রেসপন্স ফিল্ড মাস্কটি মেথডে পাস করুন। রেসপন্সে ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি ফিল্ড মাস্কটি বাদ দেন, তাহলে মেথডটি একটি এরর ফেরত দেবে।ফিল্ড মাস্কিং একটি ভালো ডিজাইন পদ্ধতি, যা অপ্রয়োজনীয় ডেটা অনুরোধ করা থেকে বিরত রাখে এবং এর ফলে অপ্রয়োজনীয় প্রসেসিং সময় ও বিলিং চার্জ এড়ানো যায়।
ফেরত পাওয়ার জন্য স্থানের ডেটা টাইপগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা নির্দিষ্ট করুন। উদাহরণস্বরূপ, স্থানটির প্রদর্শিত নাম এবং ঠিকানা পুনরুদ্ধার করতে।
X-Goog-FieldMask: places.displayName,places.formattedAddress
সমস্ত ফিল্ড পুনরুদ্ধার করতে
*ব্যবহার করুন।X-Goog-FieldMask: *
নিম্নলিখিত ক্ষেত্রগুলির মধ্যে এক বা একাধিক নির্দিষ্ট করুন:
নিম্নলিখিত ফিল্ডগুলি Nearby Search Pro SKU সক্রিয় করে:
places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.movedPlace
places.movedPlaceId
places.openingDate
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.timeZone
places.types
places.utcOffsetMinutes
places.viewport
ঠিকানা বর্ণনাকারী সাধারণত ভারতের গ্রাহকদের জন্য উপলব্ধ এবং অন্যত্র পরীক্ষামূলক পর্যায়ে রয়েছে।
places.name ফিল্ডটিতে স্থান রিসোর্সের নামটিplaces/ PLACE_IDআকারে থাকে। স্থানটির টেক্সট নামটি অ্যাক্সেস করতেplaces.displayNameব্যবহার করুনplaces.nameনিম্নলিখিত ক্ষেত্রগুলি Nearby Search Enterprise SKU সক্রিয় করে:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUriনিম্নলিখিত ফিল্ডগুলি Nearby Search Enterprise + Atmosphere SKU সক্রিয় করে:
places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
শুধুমাত্র টেক্সট সার্চ এবং কাছাকাছি সার্চ
অবস্থান সীমাবদ্ধতা
অনুসন্ধানের জন্য অঞ্চলটিকে একটি বৃত্ত হিসাবে নির্দিষ্ট করা হয়, যা একটি কেন্দ্রবিন্দু এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত। ব্যাসার্ধটি অবশ্যই ০.০ থেকে ৫০০০০.০-এর মধ্যে হতে হবে। ডিফল্ট ব্যাসার্ধ হলো ০.০। আপনাকে আপনার অনুরোধে এর মান ০.০-এর চেয়ে বেশি সেট করতে হবে।
উদাহরণস্বরূপ:
"locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
ঐচ্ছিক পরামিতি
ভবিষ্যতে চালু হতে যাওয়া ব্যবসা অন্তর্ভুক্ত করুন
যদি
true, তাহলে ভবিষ্যতে চালু হতে পারে এমন ব্যবসা প্রতিষ্ঠানগুলো ফেরত দেবে। ডিফল্ট মান 'false।
ব্যবসার স্ট্যাটাস জানতে, আপনার রিকোয়েস্ট ফিল্ড মাস্কেplaces.businessStatusঅন্তর্ভুক্ত করুন। ব্যবসার প্রত্যাশিত উদ্বোধনের তারিখ জানতে, আপনার রিকোয়েস্ট ফিল্ড মাস্কেplaces.openingDateঅন্তর্ভুক্ত করুন।অন্তর্ভুক্ত প্রকার/বর্জিত প্রকার, অন্তর্ভুক্ত প্রাথমিক প্রকার/বর্জিত প্রাথমিক প্রকার
এটি আপনাকে সার্চের ফলাফল ফিল্টার করতে ব্যবহৃত টাইপ টেবিল A থেকে টাইপের একটি তালিকা নির্দিষ্ট করার সুযোগ দেয়। প্রতিটি টাইপ সীমাবদ্ধতা ক্যাটাগরিতে সর্বোচ্চ ৫০টি টাইপ নির্দিষ্ট করা যেতে পারে।
একটি স্থানের সাথে টাইপস টেবিল A থেকে শুধুমাত্র একটি প্রাথমিক প্রকার যুক্ত থাকতে পারে। উদাহরণস্বরূপ, প্রাথমিক প্রকারটি হতে পারে
"mexican_restaurant"বা"steak_house"। কোনো স্থানের প্রাথমিক প্রকারের উপর ভিত্তি করে ফলাফল ফিল্টার করতেincludedPrimaryTypesএবংexcludedPrimaryTypesব্যবহার করুন।একটি স্থানের সাথে টাইপস টেবিল A থেকে একাধিক টাইপ ভ্যালুও যুক্ত থাকতে পারে। উদাহরণস্বরূপ, একটি রেস্তোরাঁর নিম্নলিখিত টাইপগুলো থাকতে পারে:
"seafood_restaurant","restaurant","food","point_of_interest","establishment"। একটি স্থানের সাথে যুক্ত টাইপগুলোর তালিকা থেকে ফলাফল ফিল্টার করতেincludedTypesএবংexcludedTypesব্যবহার করুন।যখন আপনি
"restaurant"বা"hotel"এর মতো একটি সাধারণ প্রাথমিক ধরন নির্দিষ্ট করেন, তখন প্রাপ্ত উত্তরে নির্দিষ্ট করা ধরনের চেয়ে আরও সুনির্দিষ্ট প্রাথমিক ধরনের স্থানও থাকতে পারে। উদাহরণস্বরূপ, আপনি"restaurant"প্রাথমিক ধরনটি অন্তর্ভুক্ত করতে নির্দিষ্ট করলেন। সেক্ষেত্রে প্রাপ্ত উত্তরে"restaurant"প্রাথমিক ধরনের স্থান থাকতে পারে, কিন্তু এর পাশাপাশি"chinese_restaurant"বা"seafood_restaurant"এর মতো আরও সুনির্দিষ্ট প্রাথমিক ধরনের স্থানও থাকতে পারে।যদি কোনো অনুসন্ধানে একাধিক প্রকারের সীমাবদ্ধতা নির্দিষ্ট করা থাকে, তবে শুধুমাত্র সেই স্থানগুলিই ফেরত দেওয়া হবে যেগুলি সমস্ত সীমাবদ্ধতা পূরণ করে। উদাহরণস্বরূপ, যদি আপনি
{"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}নির্দিষ্ট করেন, তাহলে ফেরত আসা স্থানগুলি"restaurant"সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে"steak_house"হিসাবে পরিচালিত হয় না।অন্তর্ভুক্ত প্রকার
সারণি A থেকে অনুসন্ধানের জন্য স্থানের প্রকারগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা। এই প্যারামিটারটি বাদ দেওয়া হলে, সব ধরনের স্থান ফেরত দেওয়া হবে।
বাদ দেওয়া প্রকারগুলি
অনুসন্ধান থেকে বাদ দেওয়ার জন্য সারণি A থেকে স্থানের প্রকারগুলির একটি কমা দ্বারা পৃথক করা তালিকা।
যদি আপনি অনুরোধে
includedTypes(যেমন"school") এবংexcludedTypes(যেমন"primary_school") উভয়ই উল্লেখ করেন, তাহলে প্রতিক্রিয়ায় এমন স্থানগুলি অন্তর্ভুক্ত হবে যেগুলি"school"হিসাবে শ্রেণীবদ্ধ কিন্তু"primary_school"হিসাবে নয়। প্রতিক্রিয়ায় এমন স্থানগুলি অন্তর্ভুক্ত থাকে যেগুলিincludedTypesঅন্তত একটির সাথে মেলে এবংexcludedTypesকোনোটির সাথেই মেলে না ।যদি কোনো টাইপের মধ্যে অমিল থাকে, যেমন কোনো টাইপ
includedTypesএবংexcludedTypesউভয় তালিকাতেই থাকে, তাহলে একটিINVALID_REQUESTত্রুটি ফেরত দেওয়া হয়।অন্তর্ভুক্ত প্রাথমিক প্রকার
অনুসন্ধানে অন্তর্ভুক্ত করার জন্য সারণি A থেকে প্রাথমিক স্থানের প্রকারগুলির একটি কমা দ্বারা পৃথক করা তালিকা।
বাদ দেওয়া প্রাথমিক প্রকার
অনুসন্ধান থেকে বাদ দেওয়ার জন্য সারণি A থেকে প্রাথমিক স্থানের প্রকারগুলির একটি কমা-দ্বারা-বিভক্ত তালিকা।
যদি কোনো পরস্পরবিরোধী প্রাইমারি টাইপ থাকে, যেমন কোনো টাইপ
includedPrimaryTypesএবংexcludedPrimaryTypesউভয় তালিকাতেই উপস্থিত থাকে, তাহলে একটিINVALID_ARGUMENTত্রুটি ফেরত দেওয়া হয়।ভাষা কোড
যে ভাষায় ফলাফল ফেরত দেওয়া হয়।
- সমর্থিত ভাষাগুলোর তালিকা দেখুন। গুগল প্রায়শই সমর্থিত ভাষাগুলো হালনাগাদ করে, তাই এই তালিকাটি সম্পূর্ণ নাও হতে পারে।
-
languageCodeসরবরাহ করা না হলে, API ডিফল্টরূপেenব্যবহার করে। আপনি যদি একটি অবৈধ ভাষা কোড নির্দিষ্ট করেন, তাহলে API একটিINVALID_ARGUMENTত্রুটি ফেরত দেয়। - এপিআইটি ব্যবহারকারী এবং স্থানীয় বাসিন্দা উভয়ের জন্য পাঠযোগ্য একটি রাস্তার ঠিকানা প্রদান করার জন্য যথাসাধ্য চেষ্টা করে। সেই লক্ষ্য অর্জনের জন্য, এটি পছন্দের ভাষাটি অনুসরণ করে রাস্তার ঠিকানাগুলো স্থানীয় ভাষায় ফেরত দেয় এবং প্রয়োজনে ব্যবহারকারীর পাঠযোগ্য লিপিতে তা প্রতিবর্ণীকরণ করে। অন্য সব ঠিকানা পছন্দের ভাষাতেই ফেরত দেওয়া হয়। ঠিকানার সমস্ত উপাদান একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদানটি থেকে বেছে নেওয়া হয়।
- পছন্দের ভাষায় কোনো নাম উপলব্ধ না থাকলে, এপিআই সবচেয়ে কাছাকাছি মিল থাকা নামটি ব্যবহার করে।
- পছন্দের ভাষাটি এপিআই দ্বারা ফেরত দেওয়া ফলাফলের সেট এবং সেগুলোর ফেরত দেওয়ার ক্রমের উপর সামান্য প্রভাব ফেলে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলোকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার প্রকারের সংক্ষিপ্ত রূপ, বা এমন প্রতিশব্দ যা একটি ভাষায় বৈধ হলেও অন্য ভাষায় নয়।
সর্বোচ্চ ফলাফল সংখ্যা
ফেরত দেওয়া স্থানের ফলাফলের সর্বোচ্চ সংখ্যা নির্দিষ্ট করে। সংখ্যাটি অবশ্যই ১ থেকে ২০ (ডিফল্ট) এর মধ্যে হতে হবে।
র্যাঙ্কপ্রেফারেন্স
ব্যবহৃত র্যাঙ্কিংয়ের ধরন। এই প্যারামিটারটি বাদ দিলে, ফলাফলগুলো জনপ্রিয়তা অনুসারে র্যাঙ্ক করা হবে। এটি নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
-
POPULARITY(ডিফল্ট) ফলাফলকে তাদের জনপ্রিয়তার ভিত্তিতে সাজায়। -
DISTANCEনির্দিষ্ট অবস্থান থেকে দূরত্বের ভিত্তিতে ফলাফলগুলিকে আরোহী ক্রমে সাজায়।
-
অঞ্চল কোড
প্রতিক্রিয়া বিন্যাস করার জন্য ব্যবহৃত অঞ্চল কোডটি একটি দুই-অক্ষরের CLDR কোড মান হিসাবে নির্দিষ্ট করা হয়। এর কোনো ডিফল্ট মান নেই।
রেসপন্সের
formattedAddressফিল্ডের দেশের নাম যদিregionCodeএর সাথে মিলে যায়, তাহলেformattedAddressথেকে কান্ট্রি কোডটি বাদ দেওয়া হয়। এই প্যারামিটারটিরadrFormatAddressএর উপর কোনো প্রভাব নেই, কারণ এতে সবসময় দেশের নাম অন্তর্ভুক্ত থাকে; কিংবাshortFormattedAddressউপরও কোনো প্রভাব নেই, কারণ এতে কখনোই দেশের নাম অন্তর্ভুক্ত থাকে না।কিছু উল্লেখযোগ্য ব্যতিক্রম ছাড়া, বেশিরভাগ CLDR কোড ISO 3166-1 কোডের অনুরূপ। উদাহরণস্বরূপ, যুক্তরাজ্যের ccTLD হলো "uk" (.co.uk), যেখানে এর ISO 3166-1 কোড হলো "gb" (যা প্রযুক্তিগতভাবে "The United Kingdom of Great Britain and Northern Ireland" সত্তাটিকে বোঝায়)। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
কাছাকাছি অনুসন্ধান (নতুন) উদাহরণ
একই ধরণের জায়গা খুঁজুন
নিম্নলিখিত উদাহরণটি একটি circle দ্বারা সংজ্ঞায়িত ৫০০-মিটার ব্যাসার্ধের মধ্যে থাকা সমস্ত রেস্তোরাঁর প্রদর্শিত নামগুলির জন্য একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ দেখাচ্ছে:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
উল্লেখ্য যে, X-Goog-FieldMask হেডারটি নির্দিষ্ট করে যে রেসপন্সটিতে places.displayName নামক ডেটা ফিল্ডগুলো রয়েছে। এরপর রেসপন্সটি নিম্নলিখিত ফর্মে থাকে:
{ "places": [ { "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, { "displayName": { "text": "Harborview Restaurant & Bar", "languageCode": "en" } }, ... }
অতিরিক্ত তথ্য ফেরত পেতে ফিল্ড মাস্কে আরও ডেটা টাইপ যোগ করুন। উদাহরণস্বরূপ, রেসপন্সে রেস্তোরাঁর ঠিকানা, ধরন এবং ওয়েব অ্যাড্রেস অন্তর্ভুক্ত করতে places.formattedAddress,places.types,places.websiteUri যোগ করুন:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri" \
https://places.googleapis.com/v1/places:searchNearby
প্রতিক্রিয়াটি এখন নিম্নরূপ:
{ "places": [ { "types": [ "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "PIER 1 1/2 The Embarcadero N, San Francisco, CA 94105, USA", "websiteUri": "http://lamarsf.com/", "displayName": { "text": "La Mar Cocina Peruana", "languageCode": "en" } }, { "types": [ "greek_restaurant", "meal_takeaway", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "200 Jackson St, San Francisco, CA 94111, USA", "websiteUri": "https://kokkari.com/", "displayName": { "text": "Kokkari Estiatorio", "languageCode": "en" } }, ... }
বিভিন্ন ধরণের স্থান খুঁজুন
নিম্নলিখিত উদাহরণটি নির্দিষ্ট circle ১০০০-মিটার ব্যাসার্ধের মধ্যে অবস্থিত সমস্ত কনভেনিয়েন্স স্টোর এবং লিকার স্টোরের প্রদর্শিত নামগুলির জন্য একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ দেখাচ্ছে:
curl -X POST -d '{
"includedTypes": ["liquor_store", "convenience_store"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.primaryType,places.types" \
https://places.googleapis.com/v1/places:searchNearby
places.primaryType এবং places.types যোগ করে, যাতে রেসপন্সে প্রতিটি স্থানের প্রকারের তথ্য অন্তর্ভুক্ত থাকে এবং ফলাফল থেকে উপযুক্ত স্থান নির্বাচন করা সহজ হয়।অনুসন্ধান থেকে স্থানের ধরণ বাদ দিন
নিম্নলিখিত উদাহরণটি " "primary_school" "school" " প্রকারের সমস্ত স্থানের জন্য একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ দেখায়, যেখানে ফলাফলগুলিকে দূরত্ব অনুসারে সাজানো হয়েছে:
curl -X POST -d '{
"includedTypes": ["school"],
"excludedTypes": ["primary_school"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
},
"rankPreference": "DISTANCE"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
একটি এলাকার কাছাকাছি সমস্ত স্থান দূরত্ব অনুসারে অনুসন্ধান করুন।
নিম্নলিখিত উদাহরণটি সান ফ্রান্সিসকোর ডাউনটাউনের একটি নির্দিষ্ট বিন্দুর নিকটবর্তী স্থানগুলির জন্য একটি ‘Nearby Search (New)’ অনুরোধ দেখাচ্ছে। এই উদাহরণে, দূরত্ব অনুসারে ফলাফলগুলিকে র্যাঙ্ক করার জন্য আপনি rankPreference প্যারামিটারটি অন্তর্ভুক্ত করেছেন:
curl -X POST -d '{
"maxResultCount": 10,
"rankPreference": "DISTANCE",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965
},
"radius": 1000.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby
ঠিকানা বর্ণনাকারী পান
ঠিকানার বর্ণনাকারী কোনো স্থানের অবস্থান সম্পর্কে সম্পর্কীয় তথ্য প্রদান করে, যার মধ্যে নিকটবর্তী দর্শনীয় স্থান এবং অন্তর্ভুক্ত এলাকাগুলো রয়েছে।
নিম্নলিখিত উদাহরণটি সান হোসে-র একটি মলের কাছাকাছি স্থানগুলির জন্য একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ দেখাচ্ছে। এই উদাহরণে, আপনি ফিল্ড মাস্কে addressDescriptors অন্তর্ভুক্ত করবেন:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.321328,
"longitude": -121.946275
},"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchNearby
উত্তরে অনুরোধে উল্লেখিত স্থান, নিকটবর্তী গুরুত্বপূর্ণ স্থানসমূহের তালিকা ও স্থানটি থেকে সেগুলোর দূরত্ব, এবং এলাকাগুলোর তালিকা ও স্থানটির সাথে সেগুলোর অন্তর্ভুক্তিমূলক সম্পর্ক অন্তর্ভুক্ত থাকে:
{ "places": [ { "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 114.76984, "travelDistanceMeters": 114.261856 }, { "name": "places/ChIJgexMlR_Lj4ARiKCKuhNnjn0", "placeId": "ChIJgexMlR_Lj4ARiKCKuhNnjn0", "displayName": { "text": "Valley Fair Mall Eyexam of CA", "languageCode": "en" }, "types": [ "establishment", "health", "point_of_interest" ], "straightLineDistanceMeters": 131.62566, "travelDistanceMeters": 237.33253 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 110.0775, "travelDistanceMeters": 171.41951 }, { "name": "places/ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "placeId": "ChIJwyfPQx7Lj4AR7bYI2A2Yc54", "displayName": { "text": "Abercrombie & Fitch", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 53.620117, "travelDistanceMeters": 2.4578214 }, { "name": "places/ChIJpycNQx7Lj4ARjhXw3PrM_kU", "placeId": "ChIJpycNQx7Lj4ARjhXw3PrM_kU", "displayName": { "text": "Hollister Co.", "languageCode": "en" }, "types": [ "clothing_store", "establishment", "point_of_interest", "shoe_store", "store" ], "spatialRelationship": "DOWN_THE_ROAD", "straightLineDistanceMeters": 56.53726, "travelDistanceMeters": 15.418246 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "OUTSKIRTS" } ] } }, /.../ }
ভবিষ্যতে চালু হতে যাওয়া ব্যবসাগুলো খুঁজুন।
নিম্নলিখিত উদাহরণটি আইডাহোর নিউ মেডোজে ভবিষ্যতে চালু হতে যাওয়া ব্যবসা প্রতিষ্ঠানগুলোর জন্য একটি নিকটবর্তী অনুসন্ধান (নতুন) অনুরোধ দেখাচ্ছে:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
"includeFutureOpeningBusinesses": true,
"maxResultCount": 20,
"locationRestriction": {
"circle": {
"center": {"latitude": 44.9755100, "longitude": -116.2842180},
"radius": 20
}
},
"rankPreference": "DISTANCE"
}' \
"https://places.googleapis.com/v1/places:searchNearby"
এই উত্তরে ভবিষ্যতে চালু হতে যাওয়া ব্যবসা প্রতিষ্ঠানগুলোর নাম, তাদের ব্যবসার অবস্থা এবং প্রত্যাশিত উদ্বোধনের তারিখ অন্তর্ভুক্ত রয়েছে:
{ "places": [ { "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "displayName": { "text": "Roberts Greenhouse and Tree Farm", "languageCode": "en" }, "openingDate": { "year": 2026, "month": 4, "day": 15 } } ] }
চেষ্টা করে দেখুন!
এপিআই এক্সপ্লোরার আপনাকে নমুনা অনুরোধ করার সুযোগ দেয়, যাতে আপনি এপিআই এবং এর অপশনগুলোর সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডানদিকে থাকা API আইকনটি (api) নির্বাচন করুন।
ইচ্ছা হলে অনুরোধের প্যারামিটারগুলো সম্পাদনা করুন।
Execute বাটনটি নির্বাচন করুন। প্রদর্শিত ডায়ালগ বক্সে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান, সেটি বেছে নিন।
এপিআই এক্সপ্লোরার প্যানেলে, এপিআই এক্সপ্লোরার উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকনটি নির্বাচন করুন।