ऑटोकंप्लीट पर माइग्रेट करें (नया)

परिचय

Places API, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) और क्वेरी के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) एपीआई के साथ काम करता है. अगर आपको इन एपीआई के बारे में जानकारी है, तो ऑटोकंप्लीट (नया) में ये बदलाव किए गए हैं:

• ऑटोकंप्लीट (नया) सुविधा, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, लेगसी एपीआई में यूआरएल पैरामीटर को एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके पास किया जाता है.
• ऑटोकंप्लीट (नया) में, पहचान की पुष्टि करने के लिए एपीआई पासकोड और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.
• ऑटोकंप्लीट (नया) में, रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON का इस्तेमाल किया जा सकता है.

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

मौजूदा पैरामीटर	नया पैरामीटर	नोट
components	includedRegionCodes
language	languageCode
location	locationBias
ipbias		अगर आपने locationBias और locationRestriction, दोनों को शामिल नहीं किया है, तो एपीआई डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है.
offset	inputOffset
radius	locationBias या locationRestriction
region	regionCode
stricbounds	locationRestriction
sessiontoken	sessionToken
types	includedPrimaryTypes

अनुरोध का उदाहरण

यहां दिए गए जीईटी अनुरोध के उदाहरण में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने JSON रिस्पॉन्स का अनुरोध किया है. इसमें "Amoeba" नाम की जगहों की जानकारी शामिल है. ये जगहें establishment टाइप की हैं. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया गया है:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

ऑटोकंप्लीट (नया) की मदद से, पोस्ट अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या पोस्ट अनुरोध के हिस्से के तौर पर हेडर में पास किया जाता है.

अपने-आप पूरा होने की सुविधा (नई) के अनुरोधों के लिए, फ़ील्ड मास्क ज़रूरी नहीं हैं. हालांकि, इनका इस्तेमाल जवाब में खास नतीजे पाने के लिए किया जा सकता है. उदाहरण के लिए, यहां दिए गए अनुरोध में फ़ील्ड मास्क का इस्तेमाल किया गया है, ताकि जवाब में सिर्फ़ सुझाव का suggestions.placePrediction.text शामिल हो:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

फ़ील्ड मास्क इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, जगह की जानकारी (नया वर्शन) देखें.