क्वेरी ऑटोकंप्लीट (लेगसी)

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

क्वेरी ऑटोकंप्लीट (लेगसी) का इस्तेमाल, टेक्स्ट पर आधारित भौगोलिक खोजों के लिए क्वेरी का अनुमान लगाने के लिए किया जा सकता है. इसके लिए, आपके टाइप करते समय सुझाई गई क्वेरी दिखाई जाती हैं.

Query Autocomplete (लेगसी) के अनुरोध

क्वेरी ऑटोकंप्लीट (लेगसी), Places API (लेगसी) का हिस्सा है. यह Places API (लेगसी) के साथ एपीआई कुंजी और कोटा शेयर करता है.

क्वेरी ऑटोकंप्लीट (लेगसी) की सुविधा की मदद से, अपने ऐप्लिकेशन में क्वेरी के लिए भौगोलिक सुझाव तुरंत जोड़े जा सकते हैं. किसी खास जगह की जानकारी खोजने के बजाय, कोई व्यक्ति कैटगरी के हिसाब से खोज कर सकता है. जैसे, "न्यूयॉर्क के आस-पास पिज़्ज़ा". इसके बाद, सेवा उस स्ट्रिंग से मिलती-जुलती क्वेरी की सूची दिखाती है. क्वेरी अपने-आप पूरी होने की सुविधा (लेगसी) में, पूरे शब्दों और सबस्ट्रिंग, दोनों को मैच किया जा सकता है. इसलिए, ऐप्लिकेशन, उपयोगकर्ता के टाइप करते समय क्वेरी भेज सकते हैं, ताकि तुरंत अनुमान लगाया जा सके.

Query Autocomplete (लेगसी) का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:

https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters

यहां output, json या xml हो सकता है.

क्वेरी ऑटोकंप्लीट (लेगसी) का अनुरोध शुरू करने के लिए, कुछ पैरामीटर ज़रूरी होते हैं. यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है. पैरामीटर और उनकी संभावित वैल्यू की सूची यहां दी गई है.

ज़रूरी पैरामीटर

  • इनपुट

    वह टेक्स्ट स्ट्रिंग जिसमें खोजना है. जगह के नाम अपने-आप भरने की सुविधा, इस स्ट्रिंग के आधार पर संभावित मैच दिखाएगी. साथ ही, नतीजों को इस आधार पर क्रम में लगाएगी कि वे कितने काम के हैं.

ज़रूरी नहीं पैरामीटर

  • भाषा

    वह भाषा जिसमें नतीजे दिखाने हैं.

    • इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, इस सुविधा के लिए उपलब्ध भाषाओं को अक्सर अपडेट करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
    • अगर language नहीं दिया जाता है, तो एपीआई, Accept-Language हेडर में बताई गई पसंदीदा भाषा का इस्तेमाल करने की कोशिश करता है.
    • एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सकता है. ऐसा करते समय, यह उपयोगकर्ता की पसंदीदा भाषा का ध्यान रखता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
    • अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
    • पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए गए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं. उदाहरण के लिए, हंगेरियन भाषा में utca और tér, सड़क के लिए इस्तेमाल होने वाले समानार्थी शब्द हैं.

  • जगह

    यह latitude,longitude निर्देशांकों के तौर पर, उस पॉइंट को तय करता है जिसके आस-पास खोजना है. Places सेवा, खोज के नतीजों को प्राथमिकता देने के लिए जगह की जानकारी का इस्तेमाल करती है. इससे location और radius में तय की गई जगह के हिसाब से नतीजे दिखाए जाते हैं. हालांकि, तय की गई जगह के बाहर के नतीजे भी दिखाए जा सकते हैं.

    अगर query में Market in Barcelona जैसी कोई जगह की जानकारी शामिल है, तो location पैरामीटर को बदला जा सकता है. क्वेरी के आस-पास कोटेशन मार्क का इस्तेमाल करने से, location और radius को दिए गए वेट पर भी असर पड़ सकता है.

  • ऑफ़सेट

    इनपुट शब्द में, आखिरी वर्ण की वह जगह जिसका इस्तेमाल सेवा, अनुमानों से मिलान करने के लिए करती है. उदाहरण के लिए, अगर इनपुट Google है और ऑफ़सेट 3 है, तो सेवा Goo से मेल खाएगी. ऑफ़सेट से तय की गई स्ट्रिंग का मिलान, इनपुट शब्द के सिर्फ़ पहले शब्द से किया जाता है. उदाहरण के लिए, अगर इनपुट शब्द Google abc है और ऑफ़सेट 3 है, तो सेवा Goo abc से मिलान करने की कोशिश करेगी. अगर कोई ऑफ़सेट नहीं दिया जाता है, तो सेवा पूरे शब्द का इस्तेमाल करेगी. ऑफ़सेट को आम तौर पर, टेक्स्ट कैरेट की पोज़िशन पर सेट किया जाना चाहिए.

  • दायरा

    यह जगह के नतीजों को दिखाने के लिए, दूरी (मीटर में) तय करता है. location और radius पैरामीटर पास करके, किसी खास सर्कल के हिसाब से नतीजे दिखाए जा सकते हैं. ऐसा करने पर, Places सेवा को उस सर्कल के अंदर के नतीजे दिखाने के लिए प्राथमिकता देने का निर्देश मिलता है. हालांकि, तय की गई जगह से बाहर के नतीजे अब भी दिखाए जा सकते हैं.

    सर्च के टाइप और अन्य पैरामीटर के आधार पर, दायरा अपने-आप ज़्यादा से ज़्यादा वैल्यू पर सेट हो जाएगा.

    • ऑटोकंप्लीट: 50,000 मीटर
    • आस-पास की जगहों की जानकारी:
      • keyword या name के साथ: 50,000 मीटर
      • keyword या name के बिना
        • यह 50,000 मीटर तक हो सकता है. हालांकि, यह इलाके की आबादी के हिसाब से अपने-आप कम-ज़्यादा होता रहता है. यह rankby पैरामीटर से अलग होता है.
        • rankby=distance का इस्तेमाल करने पर, रेडियस पैरामीटर स्वीकार नहीं किया जाएगा. साथ ही, इससे INVALID_REQUEST मिलेगा.
    • क्वेरी अपने-आप पूरी होने की सुविधा: 50,000 मीटर
    • टेक्स्ट से खोजें: 50,000 मीटर

क्वेरी अपने-आप पूरी होने की सुविधा (लेगसी) के उदाहरण

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

"पार के आस-पास पिज़्ज़ा" के लिए किया गया अनुरोध, जिसके नतीजे फ़्रेंच में हैं:

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &language=fr
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'

ध्यान दें कि आपको इन उदाहरणों में दी गई एपीआई कुंजी को अपनी कुंजी से बदलना होगा.

Query Autocomplete (लेगसी) के जवाब

क्वेरी अपने-आप पूरी होने की सुविधा (लेगसी) के जवाब, यूआरएल अनुरोध के पाथ में मौजूद output फ़्लैग से तय किए गए फ़ॉर्मैट में दिखाए जाते हैं. यहां दिए गए नतीजे, इन पैरामीटर वाली क्वेरी के लिए दिखाए गए हैं:

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

JSON

{
  "predictions":
    [
      {
        "description": "pizza near Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris" },
            { "offset": 18, "value": "France" },
          ],
      },
      {
        "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Pari Chowk" },
            { "offset": 23, "value": "NRI City" },
            { "offset": 33, "value": "Omega II" },
            { "offset": 43, "value": "Noida" },
            { "offset": 50, "value": "Uttar Pradesh" },
            { "offset": 65, "value": "India" },
          ],
      },
      {
        "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 16 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Disneyland Park" },
            { "offset": 28, "value": "Disneyland Drive" },
            { "offset": 46, "value": "Anaheim" },
            { "offset": 55, "value": "CA" },
            { "offset": 59, "value": "USA" },
          ],
      },
      {
        "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 30 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" },
            { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" },
            { "offset": 83, "value": "Paris" },
            { "offset": 90, "value": "France" },
          ],
      },
      {
        "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris Beauvais Airport" },
            { "offset": 35, "value": "Route de l'Aéroport" },
            { "offset": 56, "value": "Tillé" },
            { "offset": 63, "value": "France" },
          ],
      },
    ],
  "status": "OK",
}

XML

      
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>pizza near Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>France</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Pari Chowk</value>
   <offset>11</offset>
  </term>
  <term>
   <value>NRI City</value>
   <offset>23</offset>
  </term>
  <term>
   <value>Omega II</value>
   <offset>33</offset>
  </term>
  <term>
   <value>Noida</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Uttar Pradesh</value>
   <offset>50</offset>
  </term>
  <term>
   <value>India</value>
   <offset>65</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Disneyland Park</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Disneyland Drive</value>
   <offset>28</offset>
  </term>
  <term>
   <value>Anaheim</value>
   <offset>46</offset>
  </term>
  <term>
   <value>CA</value>
   <offset>55</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>59</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>22</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>16</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Cathédrale Notre-Dame de Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Parvis Notre-Dame - place Jean-Paul-II</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>83</offset>
  </term>
  <term>
   <value>France</value>
   <offset>90</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>36</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>30</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris Beauvais Airport</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Route de l'Aéroport</value>
   <offset>35</offset>
  </term>
  <term>
   <value>Tillé</value>
   <offset>56</offset>
  </term>
  <term>
   <value>France</value>
   <offset>63</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

जब Places सेवा, खोज के नतीजों को JSON फ़ॉर्मैट में दिखाती है, तो वह उन्हें predictions ऐरे में रखती है. अगर सेवा कोई नतीजा नहीं दिखाती है (जैसे कि location रिमोट है), तो भी यह खाली predictions कलेक्शन दिखाता है. XML जवाबों में, शून्य या उससे ज़्यादा <prediction> एलिमेंट होते हैं.

PlacesQueryAutocompleteResponse

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है Array<PlaceAutocompletePrediction>

इसमें अनुमानों का कलेक्शन होता है.

ज़्यादा जानकारी के लिए, PlaceAutocompletePrediction देखें.

ज़रूरी है PlacesAutocompleteStatus

इसमें अनुरोध की स्थिति के बारे में जानकारी होती है. इसमें डीबग करने से जुड़ी जानकारी भी हो सकती है. इससे आपको यह पता लगाने में मदद मिलती है कि अनुरोध पूरा क्यों नहीं हुआ.

ज़्यादा जानकारी के लिए, PlacesAutocompleteStatus देखें.

ज़रूरी नहीं स्ट्रिंग

जब सेवा, OK के अलावा कोई दूसरा स्टेटस कोड दिखाती है, तब रिस्पॉन्स ऑब्जेक्ट में एक और error_message फ़ील्ड मौजूद हो सकता है. इस फ़ील्ड में, दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी होती है. यह फ़ील्ड हमेशा नहीं दिखता है. साथ ही, इसके कॉन्टेंट में बदलाव किया जा सकता है.

ज़रूरी नहीं Array<string>

जब सेवा, अनुरोध की खास जानकारी के बारे में अतिरिक्त जानकारी दिखाती है, तो रिस्पॉन्स ऑब्जेक्ट में एक और info_messages फ़ील्ड हो सकता है. यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए दिखाया जाता है जो पूरे हो चुके हैं. ऐसा हो सकता है कि यह हमेशा न दिखे. साथ ही, इसके कॉन्टेंट में बदलाव हो सकता है.

PlacesAutocompleteStatus

सेवा से मिले स्टेटस कोड.

  • OK से पता चलता है कि एपीआई अनुरोध पूरा हो गया है.
  • ZERO_RESULTS से पता चलता है कि खोज पूरी हो गई है, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब खोज के लिए दूर-दराज़ की जगह की सीमाएं तय की गई हों.
  • INVALID_REQUEST से पता चलता है कि एपीआई अनुरोध गलत तरीके से किया गया था. आम तौर पर, ऐसा input पैरामीटर के मौजूद न होने की वजह से होता है.
  • OVER_QUERY_LIMIT इनमें से किसी भी समस्या के बारे में बताता है:
    • आपने क्यूपीएस की सीमाएं पार कर ली हैं.
    • आपके खाते में बिलिंग की सुविधा चालू नहीं है.
    • महीने के 200 डॉलर के क्रेडिट या इस्तेमाल की तय सीमा से ज़्यादा का इस्तेमाल किया गया है.
    • पेमेंट का दिया गया तरीका अब मान्य नहीं है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है.
    इस गड़बड़ी को ठीक करने के तरीके के बारे में ज़्यादा जानने के लिए, Maps के बारे में अक्सर पूछे जाने वाले सवाल देखें.
  • REQUEST_DENIED में बताया गया है कि आपका अनुरोध अस्वीकार कर दिया गया है. आम तौर पर, इसकी वजह यह होती है:
    • अनुरोध में एपीआई पासकोड मौजूद नहीं है.
    • key पैरामीटर अमान्य है.
  • UNKNOWN_ERROR से पता चलता है कि कोई गड़बड़ी हुई है.

जब Places सेवा, खोज के नतीजों को JSON फ़ॉर्मैट में दिखाती है, तो वह उन्हें predictions कलेक्शन में रखती है. अगर सेवा कोई नतीजा नहीं दिखाती है (जैसे कि अगर location दूर है), तब भी वह एक खाली predictions कलेक्शन दिखाती है. XML फ़ॉर्मैट में मिले जवाबों में, शून्य या उससे ज़्यादा <prediction> एलिमेंट होते हैं.

PlaceAutocompletePrediction

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है स्ट्रिंग

इसमें खोज के नतीजों का ऐसा नाम होता है जिसे आसानी से पढ़ा जा सकता है. establishment नतीजों के लिए, यह आम तौर पर कारोबार का नाम होता है. इस कॉन्टेंट को जैसा है वैसा ही पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें.

ज़रूरी है Array<PlaceAutocompleteMatchedSubstring>

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

ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.

ज़रूरी है PlaceAutocompleteStructuredFormat

यह पहले से फ़ॉर्मैट किया गया टेक्स्ट उपलब्ध कराता है, जिसे ऑटोकंप्लीट की सुविधा वाले नतीजों में दिखाया जा सकता है. इस कॉन्टेंट को जैसा है वैसा ही पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें.

ज़्यादा जानकारी के लिए, PlaceAutocompleteStructuredFormat देखें.

ज़रूरी है Array<PlaceAutocompleteTerm>

इसमें ऐसे शब्दों का कलेक्शन होता है जो जवाब में मिली जानकारी के हर सेक्शन की पहचान करते हैं. जानकारी का एक सेक्शन आम तौर पर, कॉमा से खत्म होता है. ऐरे में मौजूद हर एंट्री में, value फ़ील्ड होता है. इसमें शब्द का टेक्स्ट होता है. साथ ही, इसमें offset फ़ील्ड होता है. यह फ़ील्ड, ब्यौरे में इस शब्द की शुरुआती पोज़िशन तय करता है. इसे यूनिकोड वर्णों में मापा जाता है.

ज़्यादा जानकारी के लिए, PlaceAutocompleteTerm देखें.

ज़रूरी नहीं पूर्णांक

ऑरिजिन से सीधी दूरी, मीटर में. यह फ़ील्ड, सिर्फ़ origin के साथ किए गए अनुरोधों के लिए दिखाया जाता है.

ज़रूरी नहीं स्ट्रिंग

यह टेक्स्ट वाला आइडेंटिफ़ायर होता है. इससे किसी जगह की यूनीक पहचान होती है. जगह की जानकारी पाने के लिए, इस आइडेंटिफ़ायर को Places API के अनुरोध के placeId फ़ील्ड में पास करें. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.

ज़रूरी नहीं स्ट्रिंग

place_id देखें.
ज़रूरी नहीं Array<string>

इसमें उन टाइप का कलेक्शन होता है जो इस जगह पर लागू होते हैं. उदाहरण के लिए: [ "political", "locality" ] या [ "establishment", "geocode", "beauty_salon" ]. ऐरे में कई वैल्यू हो सकती हैं. जगह के टाइप के बारे में ज़्यादा जानें.

PlaceAutocompleteMatchedSubstring

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

अनुमान के नतीजे के टेक्स्ट में, मैच किए गए सबस्ट्रिंग की लंबाई.
ज़रूरी है संख्या

मिलान करने वाली सबस्ट्रिंग की शुरुआती जगह, अनुमान के नतीजे के टेक्स्ट में.

PlaceAutocompleteStructuredFormat

फ़ील्ड ज़रूरी है टाइप ब्यौरा

main_text

ज़रूरी है स्ट्रिंग

इसमें अनुमान का मुख्य टेक्स्ट होता है. आम तौर पर, यह जगह का नाम होता है.

main_text_matched_substrings

ज़रूरी है Array<PlaceAutocompleteMatchedSubstring>

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

ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.

secondary_text

ज़रूरी नहीं स्ट्रिंग

इसमें अनुमानित नतीजे का सेकंडरी टेक्स्ट होता है. आम तौर पर, यह जगह की जानकारी होती है.

secondary_text_matched_substrings

ज़रूरी नहीं Array<PlaceAutocompleteMatchedSubstring>

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

ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.

PlaceAutocompleteTerm

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

यह बताता है कि ब्यौरे में यह शब्द कहां से शुरू होता है. इसे यूनिकोड वर्णों में मापा जाता है

ज़रूरी है स्ट्रिंग

शब्द का टेक्स्ट.