Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

ध्यान दें: सर्वर साइड और क्लाइंट-साइड लाइब्रेरी

Places API, Google Maps की सेवाओं के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट के साथ भी उपलब्ध है. Places API और क्लाइंट लाइब्रेरी का इस्तेमाल, सर्वर ऐप्लिकेशन में किया जाता है.

अगर आपको क्लाइंट-साइड ऐप्लिकेशन बनाना है, तो Places SDK for Android (नया वर्शन), Places SDK for iOS (नया वर्शन), और Places Library, Maps JavaScript API देखें.

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

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

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 मीटर

Query Autocomplete (लेगसी) के उदाहरण

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'

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

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 कलेक्शन दिखाता है. एक्सएमएल रिस्पॉन्स में, शून्य या उससे ज़्यादा <prediction> एलिमेंट होते हैं.

PlacesQueryAutocompleteResponse

फ़ील्ड	ज़रूरी है	टाइप	ब्यौरा
`predictions`	ज़रूरी है	Array<PlaceAutocompletePrediction>	इसमें सुझावों का कलेक्शन होता है. ज़्यादा जानकारी के लिए, PlaceAutocompletePrediction देखें.
`status`	ज़रूरी है	PlacesAutocompleteStatus	इसमें अनुरोध की स्थिति की जानकारी होती है. साथ ही, इसमें डीबग करने की जानकारी भी हो सकती है. इससे आपको यह पता लगाने में मदद मिलती है कि अनुरोध पूरा क्यों नहीं हुआ. ज़्यादा जानकारी के लिए, PlacesAutocompleteStatus देखें.
`error_message`	ज़रूरी नहीं	स्ट्रिंग	जब सेवा `OK` के अलावा कोई दूसरा स्टेटस कोड दिखाती है, तो रिस्पॉन्स ऑब्जेक्ट में एक और `error_message` फ़ील्ड हो सकता है. इस फ़ील्ड में, दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी होती है. यह फ़ील्ड हमेशा नहीं दिखता है और इसके कॉन्टेंट में बदलाव हो सकता है.
`info_messages`	ज़रूरी नहीं	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 कलेक्शन दिखाता है. एक्सएमएल रिस्पॉन्स में शून्य या उससे ज़्यादा <prediction> एलिमेंट होते हैं.

PlaceAutocompletePrediction

फ़ील्ड	ज़रूरी है	टाइप	ब्यौरा
`description`	ज़रूरी है	स्ट्रिंग	इसमें नतीजे का ऐसा नाम शामिल होता है जिसे आसानी से पढ़ा जा सकता है. `establishment` नतीजों के लिए, आम तौर पर यह कारोबार का नाम होता है. इस कॉन्टेंट को इसी तरह पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें.
`matched_substrings`	ज़रूरी है	Array<PlaceAutocompleteMatchedSubstring>	सबस्ट्रिंग की एक सूची, जो अनुमानित नतीजे के टेक्स्ट में डाले गए शब्द की जगह के बारे में बताती है. इससे, ज़रूरत पड़ने पर शब्द को हाइलाइट किया जा सकता है. ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.
`structured_formatting`	ज़रूरी है	PlaceAutocompleteStructuredFormat	पहले से फ़ॉर्मैट किया गया टेक्स्ट उपलब्ध कराता है, जिसे ऑटोकंप्लीट की सुविधा के नतीजों में दिखाया जा सकता है. इस कॉन्टेंट को इसी तरह पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. ज़्यादा जानकारी के लिए, PlaceAutocompleteStructuredFormat देखें.
`terms`	ज़रूरी है	Array<PlaceAutocompleteTerm>	इसमें शब्दों का एक कलेक्शन होता है, जो दिखाए गए ब्यौरे के हर सेक्शन की पहचान करता है. आम तौर पर, ब्यौरे का कोई सेक्शन कॉमा लगाकर खत्म किया जाता है. कलेक्शन की हर एंट्री में एक `value` फ़ील्ड होता है. इसमें शब्द का टेक्स्ट होता है. साथ ही, इसमें एक `offset` फ़ील्ड होता है, जो ब्यौरे में इस शब्द की शुरुआती पोज़िशन के बारे में बताता है. इसे यूनिकोड वर्णों में मेज़र किया जाता है. ज़्यादा जानकारी के लिए, PlaceAutocompleteTerm देखें.
`distance_meters`	ज़रूरी नहीं	पूर्णांक	शुरुआती जगह से मीटर में सीधी दूरी. यह फ़ील्ड सिर्फ़ `origin` से किए गए अनुरोधों के लिए दिखाया जाता है.
`place_id`	ज़रूरी नहीं	स्ट्रिंग	टेक्स्ट के तौर पर मौजूद एक आइडेंटिफ़ायर, जो किसी जगह की खास तौर पर पहचान करता है. किसी जगह की जानकारी पाने के लिए, Places API अनुरोध के placeId फ़ील्ड में यह आइडेंटिफ़ायर डालें. जगह के आईडी के बारे में ज़्यादा जानकारी के लिए, जगह के आईडी की खास जानकारी देखें.
`reference`	ज़रूरी नहीं	स्ट्रिंग	`reference` के इस्तेमाल पर रोक लगा दी गई है. place_id देखें.
`types`	ज़रूरी नहीं	Array<string>	इसमें इस जगह पर लागू होने वाले टाइप की कैटगरी शामिल होती है. उदाहरण के लिए: `[ "political", "locality" ]` या `[ "establishment", "geocode", "beauty_salon" ]`. ऐरे में कई वैल्यू हो सकती हैं. जगह के टाइप के बारे में ज़्यादा जानें.

PlaceAutocompleteMatchedSubstring

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

PlaceAutocompleteStructuredFormat

फ़ील्ड	ज़रूरी है	टाइप	ब्यौरा
`main_text`	ज़रूरी है	स्ट्रिंग	इसमें अनुमान का मुख्य टेक्स्ट होता है. आम तौर पर, यह जगह का नाम होता है.
`main_text_matched_substrings`	ज़रूरी है	Array<PlaceAutocompleteMatchedSubstring>	इसमें `offset` वैल्यू और `length` वाला अरे शामिल है. इनसे, अनुमानित नतीजे के टेक्स्ट में डाले गए शब्द की जगह की जानकारी मिलती है, ताकि ज़रूरत पड़ने पर उस शब्द को हाइलाइट किया जा सके. ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.
`secondary_text`	ज़रूरी नहीं	स्ट्रिंग	इसमें अनुमान का सेकंडरी टेक्स्ट होता है. आम तौर पर, यह जगह की जानकारी होती है.
`secondary_text_matched_substrings`	ज़रूरी नहीं	Array<PlaceAutocompleteMatchedSubstring>	इसमें `offset` वैल्यू और `length` वाला अरे शामिल है. इनसे, अनुमानित नतीजे के टेक्स्ट में डाले गए शब्द की जगह की जानकारी मिलती है, ताकि ज़रूरत पड़ने पर उस शब्द को हाइलाइट किया जा सके. ज़्यादा जानकारी के लिए, PlaceAutocompleteMatchedSubstring देखें.

PlaceAutocompleteTerm

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

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

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

इनपुट

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

भाषा

जगह

ऑफ़सेट

दायरा

Query Autocomplete (लेगसी) के उदाहरण

URL

curl

URL

curl

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

URL

curl

JSON

XML

PlacesQueryAutocompleteResponse

predictions

status

error_message

info_messages

PlacesAutocompleteStatus

PlaceAutocompletePrediction

description

matched_substrings

structured_formatting

terms

distance_meters

place_id

reference

types

PlaceAutocompleteMatchedSubstring

length

offset

PlaceAutocompleteStructuredFormat

main_text

main_text_matched_substrings

secondary_text

secondary_text_matched_substrings

PlaceAutocompleteTerm

offset

value

`predictions`

`status`

`error_message`

`info_messages`

`description`

`matched_substrings`

`structured_formatting`

`terms`

`distance_meters`

`place_id`

`reference`

`types`

`length`

`offset`

`main_text`

`main_text_matched_substrings`

`secondary_text`

`secondary_text_matched_substrings`

`offset`

`value`