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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

ऑटोकंप्लीट (नया) सुविधा, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी POST अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, लेगसी एपीआई में, एचटीटीपी 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 अनुरोध के उदाहरण में, 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

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