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