কাছাকাছি অনুসন্ধান (নতুন)

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস জাভাস্ক্রিপ্ট ওয়েব পরিষেবা
ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

ভূমিকা

একটি কাছাকাছি অনুসন্ধান (নতুন) অনুরোধ এক বা একাধিক স্থানের ধরণ গ্রহণ করে এবং নির্দিষ্ট এলাকার মধ্যে মিলিত স্থানগুলির একটি তালিকা প্রদান করে। এক বা একাধিক ডেটা প্রকার নির্দিষ্ট করে একটি ফিল্ড মাস্ক প্রয়োজন। কাছাকাছি অনুসন্ধান (নতুন) শুধুমাত্র 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 বিকল্পগুলির সাথে পরিচিত হতে পারেন।

  1. পৃষ্ঠার ডান দিকে API আইকন API নির্বাচন করুন।

  2. ঐচ্ছিকভাবে অনুরোধের প্যারামিটারগুলি সম্পাদনা করুন।

  3. এক্সিকিউট বোতামটি নির্বাচন করুন। ডায়ালগে, অনুরোধটি করার জন্য আপনি যে অ্যাকাউন্টটি ব্যবহার করতে চান তা নির্বাচন করুন।

  4. APIs Explorer প্যানেলে, APIs Explorer উইন্ডোটি প্রসারিত করতে ফুলস্ক্রিন আইকন ফুলস্ক্রিন নির্বাচন করুন।