Method: resolveNames

Google Maps-এ নির্দিষ্ট জিওস্পেশিয়াল এন্টিটির (যেমন, জায়গা) জন্য জায়গার নামের (বা ঠিকানা) তালিকা সমাধান করে।

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1:resolveNames

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
ফিল্ড
queries[]

object (LocationQuery)

প্রয়োজনীয়। লোকেশন সংক্রান্ত কোয়েরির তালিকা যা সমাধান করতে হবে। আপনি সর্বাধিক ২০টি কোয়েরি উল্লেখ করতে পারবেন।
locationBias

object (LocationBias)

ঐচ্ছিক। রেজোলিউশন ফলাফলে পক্ষপাতিত্ব করার জন্য একটি ঐচ্ছিক অঞ্চল। উল্লেখ করা থাকলে, রেজোলিউশন ফলাফল এই অঞ্চলের কাছাকাছি থাকা এন্টিটির দিকে পক্ষপাতদুষ্ট হবে। locationBias বা regionCode অন্তর্ভুক্ত করলে, সার্চের পরিধি ছোট করে আরও ভালো ফলাফল পাওয়া যায়।

locationBias এবং regionCode, দুটিই উল্লেখ করা থাকলে, regionCode-এর চেয়ে locationBias-কে বেশি অগ্রাধিকার দেওয়া হয়।
regionCode

string

ঐচ্ছিক। রেজোলিউশন ফলাফলে পক্ষপাতিত্ব করার জন্য একটি ঐচ্ছিক অঞ্চল কোড। উল্লেখ করা থাকলে, রেজোলিউশন ফলাফল নির্দিষ্ট অঞ্চলে বা তার কাছাকাছি থাকা এন্টিটির দিকে পক্ষপাতদুষ্ট হবে। এটি CLDR অঞ্চল কোড হতে হবে। যেমন, "US" বা "CA"। locationBias বা regionCode অন্তর্ভুক্ত করলে, সার্চের পরিধি ছোট করে আরও ভালো ফলাফল পাওয়া যায়।

locationBias এবং regionCode, দুটিই উল্লেখ করা থাকলে, regionCode-এর চেয়ে locationBias-কে বেশি অগ্রাধিকার দেওয়া হয়।

প্রতিক্রিয়ার বডি

v1.resolveNames-এর জন্য উত্তর মেসেজ।

সফল হলে, প্রতিক্রিয়ার বডিতে নিচে উল্লেখ করা স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
ফিল্ড
results[]

object (Result)

শুধু আউটপুট। লোকেশন কোয়েরি থেকে সমাধান করা এন্টিটির তালিকা। অনুরোধ করা queries ইন্ডেক্সের সাথে ১:১ ম্যাপ করার গ্যারান্টি দেওয়া হয়। ইনডেক্স i-এ খালি স্ট্রিং থাকলে বুঝতে হবে যে সেই কোয়েরির রেজোলিউশন করা যায়নি। রেজোলিউশন ব্যর্থ হলে, সমস্যার স্ট্যাটাস জানতে failedRequests ফিল্ড চেক করুন।
failedRequests

map (key: integer, value: object (Status))

শুধু আউটপুট। আংশিক ব্যর্থতা কমিউনিকেট করছে এমন একটি ম্যাপ। queries ফিল্ডে ব্যর্থ অনুরোধের ইন্ডেক্স হল 'কী'। এই ভ্যালু হল সমস্যার সমাধান কেন করা যায়নি সেই সংক্রান্ত বিস্তারিত তথ্য সহ সমস্যার স্ট্যাটাস।

"key": valueটি পেয়ারের তালিকা সহ অবজেক্ট। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }।
saveToMapsUrl

string

শুধু আউটপুট। Google Maps-এ সঠিকভাবে সমাধান করা সব এন্টিটি সেভ করার লিঙ্ক।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

লোকেশন কোয়েরি বলতে নির্দিষ্ট লোকেশন এন্টিটি বোঝায় যা Google Maps-এর মাধ্যমে সমাধান করা যায়। বর্তমানে, লোকেশন কোয়েরি হিসেবে শুধুমাত্র জায়গার নাম ও ঠিকানা কাজ করে।

JSON উপস্থাপনা 
{
  "text": string
}
ফিল্ড
text

string

প্রয়োজনীয়। Google Maps-এ কোনও নির্দিষ্ট জিওস্পেশিয়াল এন্টিটি, যেমন কোনও জায়গা বা ঠিকানা খুঁজে পাওয়ার জন্য টেক্সট কোয়েরি। কোয়েরি যত নির্দিষ্ট হবে, সমাধান তত সঠিক হবে। যেমন, "কলকাতা", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" অথবা "আইফেল টাওয়ার, প্যারিস"। কোয়েরিতে অবশ্যই নির্দিষ্ট ঠিকানা বা জায়গার নাম থাকতে হবে। চেন স্টোরের নাম (যেমন, Starbucks) বা "রেস্তোরাঁ"-এর মতো সার্চ কোয়েরির মতো সাধারণ লোকেশন কাজ করে না।

LocationBias

রেজোলিউশন ফলাফল যে অঞ্চলের জন্য পক্ষপাতদুষ্ট।

JSON উপস্থাপনা 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
ফিল্ড
লোকেশন বায়াসের ধরন। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
viewport

object (Viewport)

বাউন্ডিং বক্সের মাধ্যমে নির্ধারিত ভিউপোর্ট।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

ফলাফল

প্রদত্ত লোকেশন কোয়েরি থেকে একটি সমাধান করা এন্টিটি, সাথে সমাধানের কনফিডেন্স লেভেল।

JSON উপস্থাপনা 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
ফিল্ড
entity

object (Entity)

শুধু আউটপুট। লোকেশন কোয়েরি থেকে সমাধান করা এন্টিটি।
confidence

enum (Confidence)

শুধু আউটপুট। রেজোলিউশনের জন্য কনফিডেন্স লেভেল।

কনফিডেন্স

রেজোলিউশনের জন্য কনফিডেন্স লেভেল।

Enums
CONFIDENCE_UNSPECIFIED ডিফল্ট ভ্যালু। এই ভ্যালু ব্যবহার করা হয়নি।
MEDIUM মিডিয়াম কনফিডেন্স থেকে বোঝা যায় যে রেজোলিউশন সঠিক হওয়ার সম্ভাবনা আছে, তবে অন্যান্য বিকল্পও থাকতে পারে।
HIGH হাই কনফিডেন্স থেকে বোঝা যায় যে রেজোলিউশন সঠিক এবং এটি নির্দিষ্ট জিওস্পেশিয়াল এন্টিটি (যেমন, নির্দিষ্ট জায়গা) দেখায়।