Method: resolveMapsUrls

Google Maps के यूआरएल की सूची को, Google Maps पर मौजूद खास जगहों (जैसे, जगहों) से जोड़ता है.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "urls": [
    string
  ]
}
फ़ील्ड
urls[]

string

ज़रूरी है. Google Maps के वे यूआरएल जिन्हें हल करना है. हर यूआरएल, Google Maps का मान्य यूआरएल होना चाहिए. जैसे, https://maps.app.goo.gl/..., https://www.google.com/maps/place/..., या https://maps.google.com/.... फ़िलहाल, सिर्फ़ एक जगह की ओर ले जाने वाले यूआरएल काम करते हैं. ज़्यादा से ज़्यादा 20 यूआरएल दिए जा सकते हैं.

जवाब का मुख्य हिस्सा

v1alpha.resolveMapsUrls के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
फ़ील्ड
entities[]

object (Entity)

सिर्फ़ आउटपुट के लिए. Google Maps के यूआरएल से हल की गई जगहों की सूची. यह गारंटी दी जाती है कि यह अनुरोध के urls इंडेक्स के साथ 1:1 मैप करेगी. इंडेक्स i पर खाली मैसेज (जहां कोई entity सेट नहीं है) से पता चलता है कि उस यूआरएल के लिए रिज़ॉल्यूशन फ़ेल हो गया है. अगर रिज़ॉल्यूशन फ़ेल हो गया है, तो गड़बड़ी की स्थिति जानने के लिए, कृपया failedRequests फ़ील्ड देखें.

failedRequests

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

सिर्फ़ आउटपुट के लिए. Google Maps के यूआरएल के लिए, आंशिक तौर पर फ़ेल होने की जानकारी देने वाला मैप. कुंजी, 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