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, दोनों को सेट किया गया है, तो regionCode के मुकाबले locationBias को प्राथमिकता दी जाती है.
regionCode

string

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

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

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

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