Method: resolveNames

স্থানের নামের (বা ঠিকানার) একটি তালিকা থেকে গুগল ম্যাপসের নির্দিষ্ট ভূ-স্থানিক সত্তাকে (যেমন, স্থান) শনাক্ত করে।

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1alpha: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 অগ্রাধিকার থাকবে।

প্রতিক্রিয়া সংস্থা

v1alpha.resolveNames-এর জন্য প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
ক্ষেত্র
results[]

object ( Result )

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

failedRequests

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

শুধুমাত্র আউটপুট। আংশিক ব্যর্থতা জানানোর জন্য একটি ম্যাপ। এর কী (key) হলো queries ফিল্ডে থাকা ব্যর্থ অনুরোধটির ইন্ডেক্স। এর ভ্যালু (value) হলো ত্রুটির স্ট্যাটাস, যা সমাধান ব্যর্থ হওয়ার কারণ বিস্তারিতভাবে বর্ণনা করে।

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

অনুমোদনের পরিধি

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

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

অবস্থান অনুসন্ধান

একটি অবস্থান কোয়েরি এমন একটি নির্দিষ্ট অবস্থান সত্তাকে বোঝায়, যা গুগল ম্যাপস দ্বারা সমাধান করা যায়। বর্তমানে, অবস্থান কোয়েরি হিসেবে শুধুমাত্র স্থানের নাম এবং ঠিকানা সমর্থিত।

JSON উপস্থাপনা 
{
  "text": string
}
ক্ষেত্র
text

string

আবশ্যক। গুগল ম্যাপস-এ কোনো নির্দিষ্ট ভূ-স্থানিক সত্তা, যেমন কোনো স্থান বা ঠিকানা, খুঁজে বের করার জন্য টেক্সট কোয়েরি। কোয়েরি যত সুনির্দিষ্ট হবে, সমাধান তত নির্ভুল হবে। উদাহরণস্বরূপ, "সান ফ্রান্সিসকো", "গুগলপ্লেক্স, মাউন্টেন ভিউ, সিএ", "১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, সিএ", অথবা "আইফেল টাওয়ার, প্যারিস"। কোয়েরি অবশ্যই একটি নির্দিষ্ট ঠিকানা বা স্থানের নাম হতে হবে। কোনো চেইনের নাম (যেমন স্টারবাকস) বা "রেস্টুরেন্টস"-এর মতো সার্চ কোয়েরির মতো সাধারণ অবস্থান সমর্থিত নয়।

অবস্থানগত পক্ষপাত

রেজোলিউশনের ফলাফলকে প্রভাবিত করার অঞ্চল।

JSON উপস্থাপনা 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
ক্ষেত্র
ইউনিয়ন ফিল্ডের type । অবস্থানগত পক্ষপাতিত্বের ধরণ। type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
viewport

object ( Viewport )

একটি বাউন্ডিং বক্স দ্বারা সংজ্ঞায়িত ভিউপোর্ট।

ভিউপোর্ট

একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, যা দুটি তির্যকভাবে বিপরীত low এবং high বিন্দু দ্বারা উপস্থাপিত হয়। একটি ভিউপোর্টকে একটি বদ্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাৎ এটি তার সীমানাকে অন্তর্ভুক্ত করে। অক্ষাংশের সীমা অবশ্যই -৯০ থেকে ৯০ ডিগ্রির মধ্যে এবং দ্রাঘিমাংশের সীমা অবশ্যই -১৮০ থেকে ১৮০ ডিগ্রির মধ্যে হতে হবে। বিভিন্ন ক্ষেত্রগুলির মধ্যে রয়েছে:

  • যদি low = high , তাহলে ভিউপোর্টটি সেই একক বিন্দুটি নিয়ে গঠিত হয়।

  • যদি low.longitude > high.longitude , তাহলে দ্রাঘিমাংশের পরিসরটি উল্টে যায় (ভিউপোর্টটি ১৮০ ডিগ্রি দ্রাঘিমা রেখা অতিক্রম করে)।

  • যদি low.longitude = -180 ডিগ্রি এবং high.longitude = 180 ডিগ্রি হয়, তাহলে ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকবে।

  • যদি low.longitude = 180 ডিগ্রি এবং high.longitude = -180 ডিগ্রি হয়, তাহলে দ্রাঘিমাংশের পরিসরটি খালি থাকে।

  • যদি low.latitude > high.latitude হয়, তাহলে অক্ষাংশের পরিসরটি খালি থাকে।

low এবং high উভয়ই অবশ্যই পূরণ করতে হবে, এবং প্রদর্শিত বক্সটি খালি থাকতে পারবে না (যেমনটি উপরের সংজ্ঞাগুলিতে উল্লেখ করা হয়েছে)। একটি খালি ভিউপোর্টের ফলে একটি ত্রুটি দেখা দেবে।

উদাহরণস্বরূপ, এই ভিউপোর্টটি নিউ ইয়র্ক শহরকে সম্পূর্ণরূপে ঘিরে রেখেছে:

{ "নিম্ন": { "অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087 }, "উচ্চ": { "অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018 } }

JSON উপস্থাপনা 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ক্ষেত্র
low

object ( LatLng )

প্রয়োজনীয়। ভিউপোর্টের সর্বনিম্ন বিন্দু।

high

object ( LatLng )

প্রয়োজনীয়। ভিউপোর্টের সর্বোচ্চ বিন্দু।

অক্ষাংশ দ্রাঘিমাংশ

একটি অবজেক্ট যা একটি অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে উপস্থাপন করে। এটি ডিগ্রি অক্ষাংশ এবং ডিগ্রি দ্রাঘিমাংশ বোঝাতে একজোড়া ডাবল (double) হিসেবে প্রকাশ করা হয়। অন্যভাবে নির্দিষ্ট করা না থাকলে, এই অবজেক্টটিকে অবশ্যই WGS84 স্ট্যান্ডার্ড মেনে চলতে হবে। মানগুলো অবশ্যই নর্মালাইজড রেঞ্জের মধ্যে থাকতে হবে।

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

দ্রাঘিমাংশ ডিগ্রিতে। এটি অবশ্যই [-180.0, +180.0] সীমার মধ্যে হতে হবে।

ফলাফল

প্রদত্ত অবস্থান কোয়েরি থেকে সমাধানকৃত একটিমাত্র সত্তা, এবং সমাধানের নির্ভরযোগ্যতার স্তর।

JSON উপস্থাপনা 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
ক্ষেত্র
entity

object ( Entity )

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

confidence

enum ( Confidence )

শুধুমাত্র আউটপুট। রেজোলিউশনটির নির্ভরযোগ্যতার মাত্রা।

আত্মবিশ্বাস

প্রস্তাবটির প্রতি আস্থার মাত্রা।

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