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

परिचय

Places API supports the Place Autocomplete (लेगसी) और Query Autocomplete (लेगसी) एपीआई के साथ काम करता है. अगर आपको इन एपीआई के बारे में जानकारी है, तो ऑटोकंप्लीट (नया) में ये बदलाव किए गए हैं:

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

यहां दी गई टेबल में, Place Autocomplete (लेगसी) और Query Autocomplete (लेगसी) के उन पैरामीटर की सूची दी गई है जिनका नाम बदलकर ऑटोकंप्लीट (नया) के लिए बदला गया है या जिनमें बदलाव किया गया है. साथ ही, उन पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.

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

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

यहां दिए गए जीईटी अनुरोध के उदाहरण में, Place Autocomplete (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने "Amoeba" नाम की जगहों के बारे में जानकारी देने वाले JSON जवाब का अनुरोध किया है. ये जगहें 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

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