यह प्रॉडक्ट या सुविधा, लेगसी स्टेटस में है. लेगसी स्टेटस के बारे में ज़्यादा जानने के लिए, लेगसी प्रॉडक्ट और सुविधाएं देखें. Places API (नया) पर माइग्रेट करने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.

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

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

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

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

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

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

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

फ़ील्ड	ज़रूरी है	टाइप	ब्यौरा
`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 कलेक्शन दिखाती है. XML जवाबों में, शून्य या उससे ज़्यादा <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 (लेगसी) के अनुरोध

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

इनपुट

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

भाषा

जगह

ऑफ़सेट

दायरा

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

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`