MCP Tools Reference: mapstools.googleapis.com

টুল: resolve_names

নির্দিষ্ট অবস্থান অনুসন্ধানের (ল্যান্ডমার্কের নাম বা সঠিক ঠিকানা) একটি ব্যাচ তালিকাকে প্রামাণ্য গুগল ম্যাপস প্লেস আইডিতে রূপান্তর করে।

ইনপুট প্রয়োজনীয়তা (অত্যাবশ্যক):

  1. queries (অবজেক্টের অ্যারে - আবশ্যিক): সমাধান করার জন্য অবস্থান কোয়েরিগুলির একটি তালিকা। আপনি সর্বোচ্চ ২০টি কোয়েরি নির্দিষ্ট করতে পারেন।

    • প্রতিটি কোয়েরি অবজেক্টে অবশ্যই থাকতে হবে:
      • text (স্ট্রিং - আবশ্যিক): সমাধান করার জন্য একটি নির্দিষ্ট স্থানের নাম বা ঠিকানা প্রতিনিধিত্বকারী টেক্সট কোয়েরি।
        • উদাহরণ: 'Googleplex, Mountain View, CA' , '1600 Amphitheatre Pkwy, Mountain View, CA' , 'Eiffel Tower, Paris' ।

  2. location_bias (অবজেক্ট - ঐচ্ছিক): একটি নির্দিষ্ট ভৌগোলিক এলাকার কাছাকাছি ফলাফলকে অগ্রাধিকার দিতে এটি ব্যবহার করুন।

    • ফর্ম্যাট: {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}

  3. region_code (স্ট্রিং - ঐচ্ছিক): ফলাফলকে প্রভাবিত করার জন্য ব্যবহারকারীর ইউনিকোড CLDR অঞ্চল কোড (দুই-অক্ষরের দেশের কোড, যেমন, US , CA )।

টুল কলের জন্য নির্দেশাবলী:

  • সুনির্দিষ্টতা (অত্যন্ত জরুরি): অনুসন্ধানে অবশ্যই একটি নির্দিষ্ট স্থানের নাম বা ঠিকানা উল্লেখ করতে হবে। 'restaurants' মতো সাধারণ অনুসন্ধান অথবা 'Starbucks' মতো চেইন প্রতিষ্ঠানের নাম সমর্থিত নয়।
  • আপনি যে পরবর্তী টুলগুলো ব্যবহার করতে চান, সেগুলো যদি আগে থেকেই সরাসরি ঠিকানা বা স্থানের নামের স্ট্রিং গ্রহণ করে থাকে, তাহলে এই টুলটি ব্যবহার করবেন না।

ত্রুটি পরিচালনা (গুরুত্বপূর্ণ):

  • এটি একটি ব্যাচ প্রসেসিং টুল। একটি অনুরোধ 'মিশ্র ফলাফল' দিতে পারে (যেমন, কিছু কোয়েরি সফলভাবে সম্পন্ন হলেও অন্যগুলো ব্যর্থ হয়)।
  • results আউটপুট তালিকাটি ইনপুট queries ইনডেক্সগুলোর সাথে ১:১ মিলবে, এটি নিশ্চিত। একটি ব্যর্থ কোয়েরির ফলে results তালিকার সংশ্লিষ্ট ইনডেক্সে একটি খালি Result বার্তা (কোনো entity সেট করা নেই) দেখা যাবে।
  • কোন নির্দিষ্ট কোয়েরি ইনডেক্সটি ব্যর্থ হয়েছে তা শনাক্ত করতে আপনাকে অবশ্যই রেসপন্সের failed_requests ম্যাপ ফিল্ডটি চেক করতে হবে। failed_requests কী-টি রিকোয়েস্টের ব্যর্থ কোয়েরিটির ০-ভিত্তিক ইনডেক্সকে নির্দেশ করে। আংশিক ব্যর্থতার কারণে পুরো ব্যাচ কলটি ব্যর্থ হয়েছে বলে ধরে নেবেন না।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` resolve_names MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "resolve_names",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

ResolveNames-এর জন্য অনুরোধ বার্তা।

নাম সমাধান অনুরোধ

JSON উপস্থাপনা 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
ক্ষেত্র
queries[]

object ( LocationQuery )

আবশ্যক। সমাধানযোগ্য অবস্থান-সংক্রান্ত কোয়েরিগুলোর একটি তালিকা। আপনি সর্বোচ্চ ২০টি কোয়েরি উল্লেখ করতে পারেন।

locationBias

object ( LocationBias )

ঐচ্ছিক। রেজোলিউশন ফলাফলকে প্রভাবিত করার জন্য একটি ঐচ্ছিক অঞ্চল। যদি এটি নির্দিষ্ট করা হয়, তাহলে রেজোলিউশন ফলাফল এই অঞ্চলের নিকটবর্তী সত্তাগুলোর দিকে পক্ষপাতদুষ্ট হবে। location_bias বা region_code অন্তর্ভুক্ত করলে প্রায়শই অনুসন্ধানের ক্ষেত্র সংকুচিত হওয়ার মাধ্যমে আরও ভালো ফলাফল পাওয়া যায়।

যদি location_bias এবং region_code উভয়ই নির্দিষ্ট করা থাকে, তাহলে location_bias region_code উপর অগ্রাধিকার পাবে।

regionCode

string

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

যদি location_bias এবং region_code উভয়ই নির্দিষ্ট করা থাকে, তাহলে location_bias region_code উপর অগ্রাধিকার পাবে।

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

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 )

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

ভিউপোর্ট

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

object ( LatLng )

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

high

object ( LatLng )

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

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

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

number

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

longitude

number

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

আউটপুট স্কিমা

ResolveNames-এর জন্য প্রতিক্রিয়া বার্তা।

ResolveNamesResponse

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

object ( Result )

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

failedRequests

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

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

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

ফলাফল

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

object ( Entity )

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

confidence

enum ( Confidence )

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

সত্তা

JSON উপস্থাপনা 
{

  // Union field entity can be only one of the following:
  "place": string
  // End of list of possible types for union field entity.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড entity । নির্ধারিত এনটিটি টাইপ। entity নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
place

string

সমাধানকৃত স্থানের রিসোর্স নাম।

ব্যর্থ অনুরোধ এন্ট্রি

JSON উপস্থাপনা 
{
  "key": integer,
  "value": {
    object (Status)
  }
}
ক্ষেত্র
key

integer

value

object ( Status )

অবস্থা

JSON উপস্থাপনা 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ক্ষেত্র
code

integer

স্ট্যাটাস কোডটি google.rpc.Code এর একটি enum ভ্যালু হওয়া উচিত।

message

string

ডেভেলপারদের জন্য একটি ত্রুটির বার্তা, যা ইংরেজিতে হওয়া উচিত। ব্যবহারকারীদের জন্য যেকোনো ত্রুটির বার্তা স্থানীয়করণ করে google.rpc.Status.details ফিল্ডে পাঠাতে হবে, অথবা ক্লায়েন্ট দ্বারা স্থানীয়করণ করতে হবে।

details[]

object

ত্রুটির বিবরণ বহনকারী বার্তাগুলির একটি তালিকা। এপিআই (API) ব্যবহারের জন্য কিছু সাধারণ বার্তা প্রকার রয়েছে।

একটি অবজেক্ট যাতে যেকোনো ধরনের ফিল্ড থাকে। "@type" নামে একটি অতিরিক্ত ফিল্ড থাকে, যা ধরনটি শনাক্তকারী একটি URI ধারণ করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।

যেকোনো

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

string

একটি স্ল্যাশ-যুক্ত প্রিফিক্স এবং সম্পূর্ণ টাইপের নাম সমন্বিত একটি URI রেফারেন্সের মাধ্যমে সিরিয়ালাইজড প্রোটোবাফ মেসেজের ধরন শনাক্ত করে।

উদাহরণ: type.googleapis.com/google.protobuf.StringValue

এই স্ট্রিংটিতে অবশ্যই অন্তত একটি / অক্ষর থাকতে হবে, এবং শেষ / এর পরের অংশটি অবশ্যই টাইপের সম্পূর্ণ-যোগ্য নাম হতে হবে, যা ক্যানোনিকাল ফর্মে এবং শুরুতে কোনো ডট ছাড়া থাকবে। এই URI রেফারেন্সগুলিতে কোনো স্কিম লিখবেন না, যাতে ক্লায়েন্টরা এগুলোর সাথে যোগাযোগ করার চেষ্টা না করে।

প্রিফিক্সটি ইচ্ছামত হতে পারে এবং আশা করা হয় যে প্রোটোবাফ ইমপ্লিমেন্টেশনগুলো টাইপটি শনাক্ত করার জন্য শেষ / পর্যন্ত সবকিছু বাদ দিয়ে দেবে। type.googleapis.com/ একটি সাধারণ ডিফল্ট প্রিফিক্স যা কিছু পুরোনো ইমপ্লিমেন্টেশনের জন্য প্রয়োজন হয়। এই প্রিফিক্সটি টাইপের উৎস নির্দেশ করে না, এবং এটি ধারণকারী URI-গুলো কোনো অনুরোধে সাড়া দেবে বলে আশা করা হয় না।

সকল প্রকারের URL স্ট্রিং অবশ্যই বৈধ URI রেফারেন্স হতে হবে এবং এর সাথে একটি অতিরিক্ত শর্ত (টেক্সট ফরম্যাটের জন্য) হলো, রেফারেন্সের বিষয়বস্তুতে শুধুমাত্র অ্যালফানিউমেরিক অক্ষর, পার্সেন্ট-এনকোডেড এস্কেপ এবং নিম্নলিখিত সেটের অক্ষরসমূহ (বাইরের ব্যাকটিকগুলো বাদে) থাকতে হবে: /-.~_!$&()*+,;= । যদিও আমরা পার্সেন্ট এনকোডিংয়ের অনুমতি দিই, বিদ্যমান পার্সারগুলোর সাথে বিভ্রান্তি এড়াতে ইমপ্লিমেন্টেশনগুলোর উচিত নয় এগুলোকে আন-এস্কেপ করা। উদাহরণস্বরূপ, type.googleapis.com%2FFoo প্রত্যাখ্যান করা উচিত।

Any এর মূল নকশায়, এই টাইপ ইউআরএলগুলিতে একটি টাইপ রেজোলিউশন পরিষেবা চালু করার সম্ভাবনা বিবেচনা করা হয়েছিল, কিন্তু প্রোটোবাফ কখনও তা বাস্তবায়ন করেনি এবং এই ইউআরএলগুলির সাথে যোগাযোগ করাকে সমস্যাজনক ও একটি সম্ভাব্য নিরাপত্তা ঝুঁকি হিসেবে বিবেচনা করে। টাইপ ইউআরএলগুলির সাথে যোগাযোগ করার চেষ্টা করবেন না।

value

string ( bytes format)

type_url দ্বারা বর্ণিত টাইপের একটি প্রোটোবাফ সিরিয়ালাইজেশন ধারণ করে।

একটি বেস৬৪-এনকোডেড স্ট্রিং।

আত্মবিশ্বাস

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

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

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্ব-সূচক ইঙ্গিত: ❌ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌