Method: resolveMapsUrls

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

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

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

অনুরোধকারী শরীর

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

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

string

প্রয়োজনীয়। যে গুগল ম্যাপস ইউআরএলগুলো সমাধান করতে হবে। প্রতিটি ইউআরএল অবশ্যই একটি বৈধ গুগল ম্যাপস ইউআরএল হতে হবে, যেমন, https://maps.app.goo.gl/... , https://www.google.com/maps/place/... , অথবা https://maps.google.com/... । বর্তমানে, শুধুমাত্র একটি নির্দিষ্ট স্থানের ইউআরএলগুলোই সমর্থিত। আপনি সর্বোচ্চ ২০টি ইউআরএল উল্লেখ করতে পারেন।

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

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

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

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

object ( Entity )

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

failedRequests

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

শুধুমাত্র আউটপুট। গুগল ম্যাপস ইউআরএলগুলোর আংশিক ব্যর্থতা নির্দেশকারী একটি মানচিত্র। এর মূল চাবিকাঠি হলো urls ফিল্ডে থাকা ব্যর্থ অনুরোধটির সূচক। এর মান হলো ত্রুটির স্থিতি, যা সমাধান ব্যর্থ হওয়ার কারণ বিস্তারিতভাবে বর্ণনা করে।

একটি অবজেক্ট যা "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