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

परिचय

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

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

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

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

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

नीचे दिए गए उदाहरण में, GET अनुरोध के लिए Place Autocomplete (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने establishment टाइप की "अमीबा" नाम की जगहों के बारे में जानकारी देने वाले JSON जवाब का अनुरोध किया है. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया है:

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 अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या POST अनुरोध के हिस्से के तौर पर हेडर में पास किया जाता है.

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

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