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

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

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

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

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

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

यहां दिए गए उदाहरण में, GET अनुरोध में जगह के नाम के लिए ऑटोकंप्लीट की मौजूदा सुविधा का इस्तेमाल किया गया है. इस उदाहरण में, आपने 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'

अपने-आप पूरा होने की सुविधा (नया) का इस्तेमाल करके, POST अनुरोध किया जाता है. साथ ही, POST अनुरोध के हिस्से के तौर पर, 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

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