ভূমিকা
একটি কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ এক বা একাধিক স্থানের ধরণ গ্রহণ করে এবং নির্দিষ্ট এলাকার মধ্যে মিলিত স্থানগুলির একটি তালিকা প্রদান করে। এক বা একাধিক ডেটা প্রকার নির্দিষ্ট করে একটি ফিল্ড মাস্ক প্রয়োজন। কাছাকাছি অনুসন্ধান (নতুন) শুধুমাত্র POST অনুরোধগুলিকে সমর্থন করে।
APIs Explorer আপনাকে লাইভ অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন:
মানচিত্রে প্রদর্শিত কাছাকাছি অনুসন্ধান (নতুন) ফলাফল দেখতে ইন্টারেক্টিভ ডেমোটি ব্যবহার করে দেখুন।
কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ
একটি কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ হল একটি 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
কাছাকাছি অনুসন্ধান (নতুন) প্রতিক্রিয়া
কাছাকাছি অনুসন্ধান (নতুন) একটি 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.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
* ঠিকানা বর্ণনাকারী সাধারণত ভারতের গ্রাহকদের জন্য উপলব্ধ এবং অন্যত্র পরীক্ষামূলকভাবে ব্যবহার করা হচ্ছে।
**places.nameফিল্ডে স্থানের রিসোর্সের নামটি এই আকারে রয়েছে:places/ PLACE_ID। স্থানের টেক্সট নাম অ্যাক্সেস করতেplaces.displayNameব্যবহার করুন।নিম্নলিখিত ক্ষেত্রগুলি 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
* শুধুমাত্র টেক্সট অনুসন্ধান এবং কাছাকাছি অনুসন্ধান
অবস্থানের সীমাবদ্ধতা
অনুসন্ধানের জন্য অঞ্চলটি একটি বৃত্ত হিসাবে নির্দিষ্ট করা হয়েছে, যা কেন্দ্রবিন্দু এবং মিটারে ব্যাসার্ধ দ্বারা সংজ্ঞায়িত করা হয়েছে। ব্যাসার্ধটি 0.0 এবং 50000.0 এর মধ্যে হতে হবে, যার মধ্যে রয়েছে। ডিফল্ট ব্যাসার্ধ হল 0.0। আপনার অনুরোধে এটি 0.0 এর চেয়ে বেশি মান নির্ধারণ করতে হবে।
উদাহরণস্বরূপ:
"locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
ঐচ্ছিক পরামিতি
অন্তর্ভুক্ত প্রকার/বহির্ভূত প্রকার, অন্তর্ভুক্ত প্রাথমিক প্রকার/বহির্ভূত প্রাথমিক প্রকার
অনুসন্ধান ফলাফল ফিল্টার করার জন্য ব্যবহৃত প্রকারের তালিকা A থেকে প্রকারের একটি তালিকা নির্দিষ্ট করতে দেয়। প্রতিটি প্রকারের সীমাবদ্ধতা বিভাগে 50 টি পর্যন্ত প্রকার নির্দিষ্ট করা যেতে পারে।
একটি জায়গার সাথে সম্পর্কিত Table A টাইপ থেকে শুধুমাত্র একটি মাত্র প্রাইমারি টাইপ থাকতে পারে। উদাহরণস্বরূপ, প্রাইমারি টাইপ
"mexican_restaurant"অথবা"steak_house"হতে পারে। জায়গার প্রাইমারি টাইপের ফলাফল ফিল্টার করতেincludedPrimaryTypesএবংexcludedPrimaryTypesব্যবহার করুন।একটি স্থানের সাথে সম্পর্কিত প্রকারের তালিকা থেকে একাধিক প্রকারের মানও থাকতে পারে। উদাহরণস্বরূপ, একটি রেস্তোরাঁর নিম্নলিখিত প্রকারগুলি থাকতে পারে:
"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ত্রুটি প্রদান করবে। - API এমন একটি রাস্তার ঠিকানা প্রদানের জন্য যথাসাধ্য চেষ্টা করে যা ব্যবহারকারী এবং স্থানীয় উভয়ের জন্যই পঠনযোগ্য। এই লক্ষ্য অর্জনের জন্য, এটি স্থানীয় ভাষায় রাস্তার ঠিকানাগুলি ফেরত দেয়, প্রয়োজনে ব্যবহারকারীর দ্বারা পঠনযোগ্য স্ক্রিপ্টে লিপ্যন্তরিত করে, পছন্দের ভাষা পর্যবেক্ষণ করে। অন্যান্য সমস্ত ঠিকানা পছন্দের ভাষায় ফেরত দেওয়া হয়। ঠিকানার উপাদানগুলি একই ভাষায় ফেরত দেওয়া হয়, যা প্রথম উপাদান থেকে নির্বাচিত হয়।
- যদি পছন্দের ভাষায় কোনও নাম পাওয়া না যায়, তাহলে API সবচেয়ে কাছের মিল ব্যবহার করে।
- API কোন ফলাফলগুলি ফেরত দিতে বেছে নেয় এবং কোন ক্রমে সেগুলি ফেরত দেওয়া হয় তার উপর পছন্দের ভাষার প্রভাব খুব কম থাকে। জিওকোডার ভাষার উপর নির্ভর করে সংক্ষিপ্ত রূপগুলিকে ভিন্নভাবে ব্যাখ্যা করে, যেমন রাস্তার ধরণের সংক্ষিপ্ত রূপ, অথবা প্রতিশব্দ যা এক ভাষায় বৈধ হতে পারে কিন্তু অন্য ভাষায় নয়।
সর্বোচ্চ ফলাফল গণনা
সর্বোচ্চ কতগুলি স্থানের ফলাফল দেখানো হবে তা নির্দিষ্ট করে। ১ থেকে ২০ (ডিফল্ট) এর মধ্যে হতে হবে।
পদমর্যাদাপ্রেফারেন্স
ব্যবহার করার জন্য র্যাঙ্কিংয়ের ধরণ। যদি এই প্যারামিটারটি বাদ দেওয়া হয়, তাহলে ফলাফলগুলি জনপ্রিয়তা অনুসারে র্যাঙ্ক করা হবে। নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
-
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" এর সত্তার জন্য)। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।
কাছাকাছি অনুসন্ধান (নতুন) উদাহরণ
এক ধরণের জায়গা খুঁজুন
নিচের উদাহরণটি ৫০০ মিটার ব্যাসার্ধের মধ্যে সমস্ত রেস্তোরাঁর প্রদর্শন নামের জন্য একটি Nearby Search (New) অনুরোধ দেখায়, যা 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 যোগ করা হয়েছে যাতে প্রতিক্রিয়াতে প্রতিটি স্থান সম্পর্কে টাইপ তথ্য অন্তর্ভুক্ত থাকে, ফলাফল থেকে উপযুক্ত স্থান নির্বাচন করা সহজ করে তোলে।অনুসন্ধান থেকে কোনও স্থানের ধরণ বাদ দিন
নিচের উদাহরণে "school" ধরণের সকল স্থানের জন্য একটি Nearby Search (New) অনুরোধ দেখানো হয়েছে, "primary_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
দূরত্ব অনুসারে র্যাঙ্কিং করে একটি এলাকার কাছাকাছি সমস্ত স্থান অনুসন্ধান করুন
নিচের উদাহরণটি সান ফ্রান্সিসকো শহরের কেন্দ্রস্থলে একটি স্থানের কাছাকাছি স্থানের জন্য একটি কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ দেখায়। এই উদাহরণে, দূরত্ব অনুসারে ফলাফলগুলিকে র্যাঙ্ক করার জন্য আপনি 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" } ] } }, /.../ }
চেষ্টা করে দেখুন!
APIs Explorer আপনাকে নমুনা অনুরোধ করতে দেয় যাতে আপনি API এবং API বিকল্পগুলির সাথে পরিচিত হতে পারেন।
পৃষ্ঠার ডান দিকে API আইকন API নির্বাচন করুন।
ঐচ্ছিকভাবে অনুরোধের প্যারামিটারগুলি সম্পাদনা করুন।
এক্সিকিউট বোতামটি নির্বাচন করুন। ডায়ালগে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা নির্বাচন করুন।
APIs Explorer প্যানেলে, APIs Explorer উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।