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 হাই কনফিডেন্স থেকে বোঝা যায় যে রেজোলিউশন সঠিক এবং এটি একটি নির্দিষ্ট জিওস্পেশিয়াল এন্টিটিকে (যেমন, একটি নির্দিষ্ট জায়গা) উপস্থাপন করে।