Method: resolveNames

यह कुकी, जगहों के नामों (या पतों) की सूची को Google Maps पर मौजूद खास भू-स्थानिक इकाइयों (जैसे, जगहों) में बदलती है.

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

POST https://mapstools.googleapis.com/v1alpha: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 से ज़्यादा प्राथमिकता दी जाएगी.

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

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
फ़ील्ड
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" }.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/maps-platform.mapstools
  • https://www.googleapis.com/auth/cloud-platform.read-only

LocationQuery

जगह की जानकारी से जुड़ी क्वेरी, किसी खास जगह की इकाई के बारे में होती है. इसे Google Maps की मदद से हल किया जा सकता है. फ़िलहाल, जगह के नाम और पते को ही लोकेशन क्वेरी के तौर पर इस्तेमाल किया जा सकता है.

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

string

ज़रूरी है. Google Maps पर किसी खास भौगोलिक इकाई, जैसे कि कोई जगह या पता को हल करने के लिए टेक्स्ट क्वेरी. क्वेरी जितनी सटीक होगी, समस्या का समाधान उतना ही सटीक होगा. उदाहरण के लिए, "सैन फ़्रांसिस्को", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" या "एफ़िल टावर, पैरिस". क्वेरी में किसी जगह का नाम या पता होना चाहिए. चेन का नाम (जैसे, Starbucks) या "रेस्टोरेंट" जैसी खोज क्वेरी जैसी सामान्य जगहों के लिए यह सुविधा काम नहीं करती.

LocationBias

वह क्षेत्र जिसके हिसाब से, समाधान के नतीजों को प्राथमिकता दी जाएगी.

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)

बाउंडिंग बॉक्स से तय किया गया व्यूपोर्ट.

व्यूपोर्ट

अक्षांश-देशांतर व्यूपोर्ट, जिसे दो विकर्ण विपरीत low और high पॉइंट के तौर पर दिखाया गया है. व्यूपोर्ट को एक बंद क्षेत्र माना जाता है. इसका मतलब है कि इसमें इसकी सीमा शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए. साथ ही, देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. इनमें ये मामले शामिल हैं:

  • अगर low = high है, तो व्यूपोर्ट में सिर्फ़ एक पॉइंट होता है.

  • अगर low.longitude > high.longitude है, तो देशांतर की रेंज उलट जाती है. इसका मतलब है कि व्यूपोर्ट, 180 डिग्री देशांतर की लाइन को पार कर जाता है.

  • अगर low.longitude = -180 डिग्री और high.longitude = 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.

  • अगर low.longitude = 180 डिग्री और high.longitude = -180 डिग्री है, तो देशांतर की सीमा खाली होती है.

  • अगर low.latitude > high.latitude है, तो अक्षांश की रेंज खाली होती है.

low और high, दोनों फ़ील्ड में वैल्यू मौजूद होनी चाहिए. साथ ही, दिखाए गए बॉक्स में कोई वैल्यू मौजूद होनी चाहिए. ऊपर दी गई परिभाषाओं के मुताबिक, बॉक्स खाली नहीं होना चाहिए. व्यू पोर्ट खाली होने पर गड़बड़ी होगी.

उदाहरण के लिए, इस व्यूपोर्ट में न्यूयॉर्क शहर पूरी तरह से शामिल है:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON के काेड में दिखाना 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
फ़ील्ड
low

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे निचला पॉइंट.
high

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी हिस्सा.

LatLng

यह ऑब्जेक्ट, अक्षांश/देशांतर की जोड़ी को दिखाता है. इसे डबल के पेयर के तौर पर दिखाया जाता है, ताकि अक्षांश और देशांतर की डिग्री दिखाई जा सके. जब तक अलग से कोई जानकारी न दी जाए, तब तक इस ऑब्जेक्ट को WGS84 स्टैंडर्ड के मुताबिक होना चाहिए. वैल्यू, सामान्य की गई रेंज में होनी चाहिए.

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

नतीजा

जगह की जानकारी वाली क्वेरी से मिली एक ऐसी इकाई जिसे हल कर दिया गया है. साथ ही, हल करने के कॉन्फ़िडेंस लेवल की जानकारी भी.

JSON के काेड में दिखाना 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
फ़ील्ड
entity

object (Entity)

सिर्फ़ आउटपुट के लिए. जगह की जानकारी से जुड़ी क्वेरी से हल की गई इकाई.
confidence

enum (Confidence)

सिर्फ़ आउटपुट के लिए. जवाब के सही होने का कॉन्फ़िडेंस लेवल.

आत्मविश्वास

जवाब के सही होने का कॉन्फ़िडेंस लेवल.

Enums
CONFIDENCE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
MEDIUM 'ज़्यादा संभावना है' का मतलब है कि समस्या का समाधान सही है, लेकिन अन्य समाधान भी हो सकते हैं.
HIGH ज़्यादा कॉन्फ़िडेंस का मतलब है कि नतीजे में दी गई जानकारी सही है और यह किसी खास भू-स्थानिक इकाई (जैसे, कोई जगह) के बारे में है.