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 रिस्पॉन्स का अनुरोध किया है. इसमें, 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
फ़ील्ड मास्क इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, जगहों की जानकारी (नया) देखें.