Method: resolveNames

यह Google Maps पर मौजूद खास जियोस्पेशल इकाइयों (जैसे, जगहों) के लिए, जगहों के नामों (या पतों) की सूची को रिज़ॉल्व करता है.

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

POST https://mapstools.googleapis.com/v1:resolveNames

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

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

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

JSON के काेड में दिखाना 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
फ़ील्ड
queries[]

object (LocationQuery)

ज़रूरी है. जगह की जानकारी से जुड़ी उन क्वेरी की सूची जिन्हें हल करना है. ज़्यादा से ज़्यादा 20 क्वेरी डाली जा सकती हैं.
locationBias

object (LocationBias)

ज़रूरी नहीं. यह एक वैकल्पिक इलाका है, ताकि रिज़ॉल्यूशन के नतीजों को बायस किया जा सके. अगर यह तय किया गया है, तो रिज़ॉल्यूशन के नतीजे उन इकाइयों के पक्ष में होंगे जो इस इलाके के करीब हैं. locationBias या regionCode को शामिल करने से, अक्सर बेहतर नतीजे मिलते हैं. ऐसा इसलिए होता है, क्योंकि इससे खोज के दायरे को सीमित किया जा सकता है.

अगर locationBias और regionCode, दोनों की वैल्यू दी गई हैं, तो locationBias को regionCode से ज़्यादा प्राथमिकता दी जाती है.
regionCode

string

ज़रूरी नहीं. यह एक वैकल्पिक रीजन कोड है, जो रिज़ॉल्यूशन के नतीजों को बायस करता है. अगर जगह की जानकारी दी जाती है, तो रिज़ॉल्यूशन के नतीजे, उस जगह या उसके आस-पास मौजूद इकाइयों के हिसाब से दिखाए जाएंगे. यह CLDR क्षेत्र कोड होना चाहिए. उदाहरण के लिए, "US" या "CA". locationBias या regionCode को शामिल करने से, अक्सर खोज के दायरे को सीमित करके बेहतर नतीजे मिलते हैं.

अगर locationBias और regionCode, दोनों की वैल्यू दी गई हैं, तो locationBias को regionCode से ज़्यादा प्राथमिकता दी जाती है.

जवाब का मुख्य भाग

v1.resolveNames के लिए जवाब वाला मैसेज.

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

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

object (Result)

सिर्फ़ आउटपुट के लिए. जगह की जानकारी से जुड़ी क्वेरी से हल की गई इकाइयों की सूची. अनुरोध queries इंडेक्स के साथ 1:1 मैप करने की गारंटी है. इंडेक्स 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 पर किसी खास जियोस्पेशल इकाई, जैसे कि कोई जगह या पता ढूंढने के लिए टेक्स्ट क्वेरी. क्वेरी जितनी सटीक होगी, समस्या का समाधान उतना ही सटीक होगा. उदाहरण के लिए, "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" या "Eiffel Tower, Paris". क्वेरी में किसी खास पते या जगह का नाम होना चाहिए. किसी चेन के नाम (जैसे, 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 हाई कॉन्फ़िडेंस से पता चलता है कि रिज़ॉल्यूशन सही है और यह किसी खास जियोस्पेशल इकाई (जैसे, कोई खास जगह) को दिखाता है.