परिचय
Places API, Place Autocomplete (लेगसी) और Query Autocomplete (लेगसी) एपीआई के साथ काम करता है. अगर आपको इन एपीआई के बारे में जानकारी है, तो Autocomplete (New) में ये बदलाव किए गए हैं:
- ऑटोकंप्लीट (नया), एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करता है. अनुरोध के मुख्य हिस्से या हेडर में, एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर पैरामीटर पास करें. इसके उलट, लेगसी एपीआई में, एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
- ऑटोकंप्लीट (नई) सुविधा में, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और 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 |
अनुरोध का उदाहरण
यहां दिए गए जीईटी अनुरोध के उदाहरण में, 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'
ऑटोकंप्लीट (नया) की सुविधा के साथ, 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
फ़ील्ड मास्क इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, जगह की जानकारी (नया) देखें.