ऑटोकंप्लीट (नया)

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

ऑटोकंप्लीट (नई) सेवा, एक ऐसी वेब सेवा है जो आपके काम की एक HTTP अनुरोध के जवाब में पूर्वानुमान और क्वेरी पूर्वानुमान. अनुरोध में कोई टेक्स्ट डालें खोज स्ट्रिंग और भौगोलिक सीमाएं शामिल होती हैं, जो खोज क्षेत्र को नियंत्रित करती हैं.

ऑटोकंप्लीट (नई) सेवा, पूरे शब्दों और इनपुट की सबस्ट्रिंग, जगहों के नाम, पते, और प्लस कोड शामिल करें. इसलिए, आवेदन जैसे-जैसे उपयोगकर्ता टाइप की क्वेरी पूछी जाती हैं.

ऑटोकंप्लीट (नया) एपीआई से मिलने वाले जवाब में दो तरह के नतीजे हो सकते हैं का अनुमान:

• जगह के अनुमान: जगहें, जैसे कि कारोबार, पते, और जगहों के सुझाव रुचि, दिए गए इनपुट टेक्स्ट स्ट्रिंग और खोज क्षेत्र के आधार पर. स्थान पूर्वानुमान हैं डिफ़ॉल्ट रूप से लौटाया जाता है.
• क्वेरी के लिए सुझाव: ऐसी क्वेरी स्ट्रिंग जो इनपुट टेक्स्ट स्ट्रिंग और क्षेत्र खोजें. क्वेरी के लिए मिलने वाले सुझाव, डिफ़ॉल्ट रूप से नहीं दिखते. इसका इस्तेमाल करें क्वेरी के सुझावों को जोड़ने के लिए, includeQueryPredictions अनुरोध पैरामीटर जवाब.

उदाहरण के लिए, ऐसी स्ट्रिंग को इनपुट के तौर पर इस्तेमाल करके एपीआई को कॉल किया जाता है जिसमें उपयोगकर्ता का कुछ इनपुट मौजूद होता है, "सिसिलियन पिज़", जिसकी खोज करने का क्षेत्र सिर्फ़ सैन फ़्रांसिस्को, कैलिफ़ोर्निया तक सीमित है. इसके बाद, जवाब में यह खोज स्ट्रिंग और खोज क्षेत्र से मेल खाने वाले स्थान पूर्वानुमान की सूची, जैसे "सिसिलियन पिज़्ज़ा किचन" नाम का रेस्टोरेंट और जगह के बारे में जानकारी.

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

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

ध्यान दें: ऑटोकंप्लीट की सुविधा (नया) का इस्तेमाल करके, होना चाहिए. अगर मैप को दिखाया जाता है, तो वह Google Maps होना चाहिए. जब डिसप्ले किया जाता है ऑटोकंप्लीट (नई) सुविधा की मदद से, बिना मैप वाली सेवा का इस्तेमाल करते हैं, तो आपको खोज फ़ील्ड/नतीजों के साथ Google का दिखाया गया लोगो शामिल करना चाहिए. ज़्यादा जानकारी के लिए, यह देखें Google का लोगो और एट्रिब्यूशन दिखाना.

एपीआई एक्सप्लोरर की मदद से लाइव अनुरोध किए जा सकते हैं, ताकि आप एपीआई और एपीआई विकल्प:

इसे आज़माएं!

ऑटोकंप्लीट की सुविधा (नए) अनुरोध

अपने-आप पूरा होने वाला (नया) अनुरोध, किसी यूआरएल के लिए एचटीटीपी पोस्ट अनुरोध है फ़ॉर्म:

https://places.googleapis.com/v1/places:autocomplete

सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से या हेडर में, पोस्ट अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:

curl -X POST -d '{
  "input": "pizza",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

जवाब के बारे में जानकारी

ऑटोकंप्लीट की सुविधा (नया) जवाब के तौर पर JSON ऑब्जेक्ट दिखाता है. जवाब में:

• suggestions कलेक्शन में, अनुमानित जगहों और क्वेरी के क्रम में सभी शामिल होते हैं उनकी समझ के आधार पर. हर जगह को placePrediction फ़ील्ड और हर क्वेरी की जानकारी दी गई है queryPrediction फ़ील्ड के हिसाब से.
• placePrediction फ़ील्ड में, किसी एक आइटम के बारे में पूरी जानकारी होती है स्थान का पूर्वानुमान, जिसमें स्थान आईडी और टेक्स्ट विवरण शामिल हैं.
• queryPrediction फ़ील्ड में, किसी एक आइटम के बारे में पूरी जानकारी होती है खोज का अनुमान लगाता है.

ध्यान दें: ऑटोकंप्लीट की सुविधा (नया) कुल पांच अनुमान दिखाता है, जैसे कि placePredictions, अनुरोध के आधार पर, queryPredictions या दोनों का एक साथ इस्तेमाल करें. उदाहरण के लिए, अगर अनुरोध includeQueryPredictions सेट नहीं है, जवाब के मुख्य भाग में ज़्यादा से ज़्यादा पाँच शामिल हैं placePredictions. अगर अनुरोध includeQueryPredictions सेट करता है, तो जवाब के मुख्य हिस्से में placePredictions के कॉम्बिनेशन में ज़्यादा से ज़्यादा पांच अनुमान शामिल होते हैं और queryPredictions.

JSON ऑब्जेक्ट, इस फ़ॉर्मैट में है:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }]
        },
      ...
    },
    {
      "queryPrediction": {
        "text": {
          "text": "Amoeba Music",
          "matches": [
            {
              "endOffset": 6
            }]
        },
        ...
    }
  ...]
}

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

• इनपुट

  वह टेक्स्ट स्ट्रिंग जिस पर खोजना है. पूरे शब्द और सबस्ट्रिंग की जानकारी दें, जगहों के नाम, पते, और प्लस कोड. ऑटोकंप्लीट (नई) सेवा इस स्ट्रिंग के आधार पर उम्मीदवार के मैच दिखाता है और इसके आधार पर ऑर्डर करता है वे कितने काम के हैं.

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

• includedPrimaryTypes

  किसी जगह का सिर्फ़ एक प्राइमरी टाइप, नीचे दिए गए टाइप में हो सकता है टेबल A या टेबल B. उदाहरण के लिए, प्राइमरी टाइप "mexican_restaurant" या "steak_house" हो सकता है.

  डिफ़ॉल्ट रूप से, एपीआई input पैरामीटर के आधार पर सभी जगहों की जानकारी दिखाता है दर्ज करें. किसी एक नतीजे को सीमित करें includedPrimaryTypes पैरामीटर को पास करके, प्राइमरी टाइप या प्राइमरी टाइप का इस्तेमाल करता है.

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

  इसके बजाय, इस पैरामीटर में (regions) या (cities) में से कोई एक शामिल भी हो सकता है. इलाकों और पिन कोड जैसे इलाकों या डिवीज़न के लिए, (regions) टाइप के कलेक्शन फ़िल्टर. जगहों के लिए (cities) टाइप कलेक्शन फ़िल्टर, जिन्हें Google शहर के तौर पर पहचानता है.

  अनुरोध को INVALID_REQUEST गड़बड़ी के साथ अस्वीकार कर दिया जाता है, अगर:

  • पाँच से ज़्यादा प्रकार बताए गए हैं.
  • (cities) या (regions) के अलावा, कोई भी टाइप बताया जाता है.
  • कोई भी अज्ञात प्रकार दर्ज किया गया है.
  ध्यान दें: includedPrimaryTypes पैरामीटर सिर्फ़ जगह के मुख्य टाइप पर काम करता है, सभी प्रकार के लिए नहीं. हालांकि हर जगह का एक प्राथमिक प्रकार होता है, हर जगह नहीं प्राथमिक प्रकार Places API (नया) द्वारा समर्थित है. इस्तेमाल किए जा सकने वाले टाइप में वे टाइप शामिल हैं जो टेबल A या टेबल B.

• includeQueryPredictions

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

• includedRegionCodes

  सिर्फ़ खास इलाकों की सूची के नतीजों को शामिल करें. इन इलाकों की रेंज 15 तक तय की गई है ccTLD ("टॉप लेवल डोमेन") दो वर्ण वाले मान. अगर यह जवाब नहीं दिया जाता है, तो जवाब पर कोई पाबंदी नहीं होगी. उदाहरण के लिए, इन क्षेत्रों को जर्मनी और फ़्रांस तक सीमित करने के लिए:

      "includedRegionCodes": ["de", "fr"]

  अगर locationRestriction और includedRegionCodes, दोनों की जानकारी दी जाती है, तो परिणाम दो सेटिंग के प्रतिच्छेदन क्षेत्र में स्थित होते हैं.

• inputOffset

  शून्य पर आधारित यूनिकोड वर्ण ऑफ़सेट, input में कर्सर की जगह दिखाता है. कर्सर की जगह से यह तय होता है कि कौनसे सुझाव दिखाए जाएंगे. अगर यह खाली है, तो यह डिफ़ॉल्ट रूप से input की लंबाई.

  ध्यान दें: शुरुआती निजी झलक रिलीज़ में, प्रॉपर्टी को predictionTermOffset कॉल किया गया.

• languageCode

  वह पसंदीदा भाषा जिसमें नतीजे देना है. नतीजे अलग-अलग भाषाओं में हो सकते हैं अगर input में इस्तेमाल की गई भाषा languageCode या अगर लौटाए गए स्थान का कोई अनुवाद नहीं है स्थानीय भाषा languageCode की है.

  • आपको आईईटीएफ़ का इस्तेमाल करना होगा पसंदीदा भाषा तय करने के लिए, BCP-47 भाषा कोड.
  • अगर languageCode नहीं दिया जाता है, तो एपीआई Accept-Language हेडर. अगर दोनों में से कोई तय नहीं किया गया है, तो डिफ़ॉल्ट स्थिति en. अगर अमान्य भाषा कोड डाला जाता है, तो एपीआई INVALID_ARGUMENT गड़बड़ी.
  • पसंदीदा भाषा का, नतीजों के सेट पर थोड़ा असर होता है एपीआई फिर से लौटाने का विकल्प चुनता है और उसके लौटाए जाने का क्रम तय करता है. इससे वर्तनी की गड़बड़ियां ठीक करने की एपीआई की क्षमता पर भी असर पड़ता है.
  • एपीआई, मोहल्ले का ऐसा पता देने की कोशिश करता है जिसे उपयोगकर्ता और उपयोगकर्ता, दोनों आसानी से पढ़ सकें साथ ही, यह उपयोगकर्ता के इनपुट को भी दिखाता है. स्थान पूर्वानुमान हैं इसका फ़ॉर्मैट, हर अनुरोध में उपयोगकर्ता के इनपुट के आधार पर अलग-अलग होता है.
    • अलाइन किए गए नामों का इस्तेमाल करके, input पैरामीटर में मेल खाने वाले शब्द पहले चुने जाते हैं इस सेटिंग के चालू होने पर, languageCode पैरामीटर से यह दिखाया जाएगा कि आपकी पसंदीदा भाषा कौनसी है उपलब्ध न हो, जबकि अन्य तरीके से ऐसे नामों का उपयोग कर रहे हों जो उपयोगकर्ता इनपुट से सबसे अच्छी तरह मेल खाते हों.
    • मोहल्ले के पतों को स्थानीय भाषा में उस स्क्रिप्ट में फ़ॉर्मैट किया जाता है जिसे उपयोगकर्ता पढ़ सकता है जब संभव हो, तब ही input पैरामीटर.
    • मिलते-जुलते शब्दों के बाद अन्य सभी पते पसंदीदा भाषा में लौटाए जाते हैं को input पैरामीटर में मौजूद शब्दों से मैच करने के लिए चुना गया है. अगर नाम नहीं है पसंदीदा भाषा में उपलब्ध है, तो एपीआई सबसे नज़दीकी मिलान का इस्तेमाल करता है.

• LocationBias या जगह की जानकारी पर पाबंदी

  आपके पास locationBias या locationRestriction बताने का विकल्प है, नहीं, बल्कि खोज क्षेत्र को परिभाषित करने के लिए दोनों में से किसी एक का ही इस्तेमाल करें. locationRestriction के बारे में सोचें वह इलाका जिसमें नतीजे होने चाहिए. साथ ही, locationBias वह क्षेत्र तय करते हुए जिसमें नतीजे इसके पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं क्षेत्र.

  ध्यान दें: अगर आपने locationBias और, दोनों को छोड़ दिया है locationRestriction का इस्तेमाल किया जाता है, तो एपीआई डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है. आईपी बायिंग के साथ, नतीजों को तय करने के लिए, एपीआई डिवाइस के आईपी पते का इस्तेमाल करता है.

  • locationBias

    इस नीति से, खोजे जाने वाले किसी इलाके के बारे में पता चलता है. इस जगह की जानकारी पूर्वाग्रह के तौर पर है जिसका मतलब है बताई गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इनमें, नतीजे भी शामिल हैं का इस्तेमाल करें.

  • locationRestriction

    इस नीति से, खोजे जाने वाले किसी इलाके के बारे में पता चलता है. चुने गए इलाके से बाहर के नतीजे नहीं दिखाए जा सकते वापस किया गया.

  locationBias या locationRestriction क्षेत्र को आयताकार व्यूपोर्ट या सर्कल के तौर पर.

  • सर्कल को सेंटर पॉइंट और मीटर में रेडियस से तय किया जाता है. दायरा इनके बीच होना चाहिए 0.0 और 50000.0 सहित. डिफ़ॉल्ट वैल्यू 0.0 है. locationRestriction के लिए, आपको दायरा 0.0 से ज़्यादा पर सेट करना होगा. अगर ऐसा नहीं होता है, तो अनुरोध कोई नतीजा नहीं मिला.

    उदाहरण के लिए:

    "locationBias": {
      "circle": {
        "center": {
          "latitude": 37.7937,
          "longitude": -122.3965
        },
        "radius": 500.0
      }
    }

  • रेक्टैंगल, अक्षांश-देशांतर का व्यूपोर्ट होता है. इसे दो फ़ॉर्मैट में दिखाया जाता है low और उच्च बिंदुओं के सामने तिरछा है. व्यूपोर्ट को बंद क्षेत्र है, जिसका मतलब है इसकी सीमा शामिल है. अक्षांश की सीमाएं यह -90 से 90 डिग्री के बीच होना चाहिए, और देशांतर की सीमा यह -180 से 180 डिग्री के बीच होना चाहिए, जिसमें ये भी शामिल हैं:

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

    low और high, दोनों में अपने-आप जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स दिखना चाहिए खाली नहीं हो सकता. व्यूपोर्ट का खाली होने पर गड़बड़ी होती है.

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

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

• origin

  वह मूल बिंदु जहां से सीधी रेखा की दूरी की गणना करनी है गंतव्य (distanceMeters के रूप में दिखाया गया). अगर यह वैल्यू छोड़ा गया, सीधी-लाइन की दूरी दिखाई नहीं जाएगी. इस रूप में दर्ज होना चाहिए अक्षांश और देशांतर निर्देशांक:

  "origin": {
      "latitude": 40.477398,
      "longitude": -74.259087
  }

• regionCode

  जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्रीय कोड, जिसे ccTLD ("टॉप लेवल डोमेन") दो वर्ण वाला मान. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. इसमें कुछ अहम अपवाद शामिल हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "यूके" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है (तकनीकी तौर पर, इकाई "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉदर्न आयरलैंड" है.

  किसी अमान्य क्षेत्र का कोड डालने पर, एपीआई INVALID_ARGUMENT दिखाता है गड़बड़ी. पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.

• sessionToken

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

ऑटोकंप्लीट की सुविधा (नए) के उदाहरण

जगह की पाबंदी और locationBias का इस्तेमाल करें

एपीआई, खोज वाली जगह को कंट्रोल करने के लिए डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है. आईपी बायसिंग के साथ, एपीआई नतीजे तय करने के लिए डिवाइस का आईपी पता. वैकल्पिक रूप से, खोजा जाने वाला इलाका बताने के लिए, locationRestriction या locationBias, लेकिन दोनों नहीं.

locationRestriction, खोजे जाने वाले हिस्से के बारे में बताता है. चुने गए इलाके से बाहर के नतीजे लौटाए नहीं जाते. यहां दिए गए उदाहरण में, locationRestriction का इस्तेमाल करके, सैन फ़्रांसिस्को के केंद्र में 5000 मीटर के दायरे में सर्कल के लिए अनुरोध:

curl -X POST -d '{
  "input": "Amoeba",
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

तय की गई जगहों से जुड़े सभी नतीजे, suggestions कलेक्शन में शामिल होते हैं:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Haight Street, San Francisco, CA, USA"
          }
        },
        "types": [
          "home_goods_store",
          "establishment",
          "store",
          "point_of_interest",
          "electronics_store"
        ]
      }
    }
  ]
}

locationBias के साथ, स्थान को पूर्वाग्रह माना जाता है जिसका मतलब है के आस-पास के नतीजे इस जगह को दिखाया जा सकता है. इसमें, तय किए गए इलाके से बाहर के नतीजे भी शामिल हैं. अगले सेशन में उदाहरण के लिए, locationBias का इस्तेमाल करने का अनुरोध बदला जाता है:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

नतीजों में अब कई और आइटम शामिल हैं. इनमें 5000 मीटर के दायरे से बाहर के नतीजे भी शामिल हैं:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Haight Street, San Francisco, CA, USA"
          }
        },
        "types": [
          "electronics_store",
          "point_of_interest",
          "store",
          "establishment",
          "home_goods_store"
        ]
      }
    },
    {
      "placePrediction": {
        "place": "places/ChIJr7uwwy58hYARBY-e7-QVwqw",
        "placeId": "ChIJr7uwwy58hYARBY-e7-QVwqw",
        "text": {
          "text": "Amoeba Music, Telegraph Avenue, Berkeley, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Telegraph Avenue, Berkeley, CA, USA"
          }
        },
        "types": [
          "electronics_store",
          "point_of_interest",
          "establishment",
          "home_goods_store",
          "store"
        ]
      }
    },
    ...
  ]
}

शामिल किए गएprimaryTypes का इस्तेमाल करें

includedPrimaryTypes पैरामीटर का इस्तेमाल करके, ज़्यादा से ज़्यादा पांच टाइप की वैल्यू तय करें टेबल A, टेबल B, या सिर्फ़ (regions) या सिर्फ़ (cities). जगह चुनी गई किसी एक जगह से मेल खानी चाहिए प्राथमिक प्रकार के मान शामिल करने होंगे.

यहां दिए गए उदाहरण में, आपनेinput "सॉकर" और नतीजों को सीमित करने के लिए, includedPrimaryTypes पैरामीटर का इस्तेमाल करें "sporting_goods_store" टाइप के संस्थान:

curl -X POST -d '{
  "input": "Soccer",
  "includedPrimaryTypes": ["sporting_goods_store"],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

includedPrimaryTypes पैरामीटर को छोड़ने पर, नतीजों में ये शामिल हो सकते हैं किसी भी तरह के ऐसे कारोबार जो आपको नहीं चाहिए, जैसे कि "athletic_field".

क्वेरी के अनुमानों के लिए अनुरोध करें

क्वेरी के लिए मिलने वाले सुझाव, डिफ़ॉल्ट रूप से नहीं दिखते. includeQueryPredictions का इस्तेमाल करना रिस्पॉन्स में क्वेरी के सुझावों को जोड़ने के लिए अनुरोध पैरामीटर का इस्तेमाल करता है. उदाहरण के लिए:

curl -X POST -d '{
  "input": "Amoeba",
  "includeQueryPredictions": true,
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

suggestions कलेक्शन में अब जगह के बारे में अनुमान और क्वेरी के अनुमान, दोनों शामिल हैं जैसा कि ऊपर जवाब के बारे में जानकारी वाले सेक्शन में बताया गया है. हर क्वेरी का अनुमान में सुझाई गई टेक्स्ट सर्च स्ट्रिंग वाले text फ़ील्ड को शामिल किया जाता है. आपके पास टेक्स्ट खोज (नई सुविधा) का अनुरोध करें.

ध्यान दें: क्वेरी के लिए दिए गए सुझाव तब नहीं दिखते, जब includedRegionCodes पैरामीटर सेट किया गया है.

ऑरिजिन का इस्तेमाल करें

इस उदाहरण में, origin को अनुरोध में अक्षांश और देशांतर निर्देशांक के तौर पर शामिल करें. origin को शामिल करने पर, एपीआई के distanceMeters फ़ील्ड को रिस्पॉन्स जिसमें origin से मंज़िल तक सीधी लाइन की दूरी शामिल है. यह उदाहरण मूल को सैन फ़्रांसिस्को के केंद्र पर सेट करता है:

curl -X POST -d '{
  "input": "Amoeba",
  "origin": {
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7749,
        "longitude": -122.4194
      },
      "radius": 5000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
https://places.googleapis.com/v1/places:autocomplete

जवाब में अब distanceMeters शामिल है:

{
  "suggestions": [
    {
      "placePrediction": {
        "place": "places/ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "placeId": "ChIJ5YQQf1GHhYARPKG7WLIaOko",
        "text": {
          "text": "Amoeba Music, Haight Street, San Francisco, CA, USA",
          "matches": [
            {
              "endOffset": 6
            }
          ]
        },
        "structuredFormat": {
          "mainText": {
            "text": "Amoeba Music",
            "matches": [
              {
                "endOffset": 6
              }
            ]
          },
          "secondaryText": {
            "text": "Haight Street, San Francisco, CA, USA"
          }
        },
        "types": [
          "home_goods_store",
          "establishment",
          "point_of_interest",
          "store",
          "electronics_store"
        ],
        "distanceMeters": 3012
      }
    }
  ]
}

इसे आज़माएं!

एपीआई एक्सप्लोरर की मदद से, सैंपल के तौर पर अनुरोध किए जा सकते हैं. को एपीआई और एपीआई विकल्पों के बारे में अच्छे से जान सकते हैं.

1. एपीआई का आइकॉन चुनें. पर क्लिक करें.
2. विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और सेट करें fields पैरामीटर को फ़ील्ड मास्क तक लाएँ.
3. विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.
4. लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

5. एपीआई एक्सप्लोरर पैनल में, 'बड़ा करें' आइकॉन को चुनें. एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, .