Places API, मौजूदा आस-पास खोजने की सुविधा के साथ काम करता है. अगर आप मौजूदा आस-पास खोज की सुविधा के बारे में जानते हैं, तो आस-पास खोज की सुविधा के नए वर्शन में ये बदलाव किए जाते हैं:
- आस-पास की नई खोज के लिए, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल किया जाता है. एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. वहीं, मौजूदा आस-पास खोज की सुविधा से, एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
- फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि जवाब में कौनसे फ़ील्ड लौटाए जाने हैं. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. अगर इस सूची को छोड़ दिया जाता है, तो इन तरीकों की वजह से गड़बड़ी दिखती है. ज़्यादा जानकारी के लिए, FieldMask देखें.
- आस-पास खोजने की नई सुविधा, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth टोकन, दोनों के साथ काम करती है.
- नए Nearby Search में रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON काम करता है.
- टेक्स्ट क्वेरी वाले सभी अनुरोधों को अब टेक्स्ट सर्च (नया) का इस्तेमाल करना चाहिए, क्योंकि आस-पास सर्च (नया) में टेक्स्ट इनपुट की सुविधा काम नहीं करती.
- Nearby Search (नया) एपीआई के लिए JSON रिस्पॉन्स फ़ॉर्मैट, मौजूदा एपीआई के फ़ॉर्मैट से बदल गया है. ज़्यादा जानकारी के लिए, जगह की जानकारी के एपीआई से मिले रिस्पॉन्स को माइग्रेट करना देखें.
नीचे दी गई टेबल में मौजूदा आस-पास खोज की सुविधा में ऐसे पैरामीटर दिए गए हैं जिनका नाम बदला गया है या जिनमें नई आस-पास खोज की सुविधा के लिए बदलाव किए गए हैं. इसके अलावा, ऐसे पैरामीटर भी दिए गए हैं जो अब काम नहीं करते.
मौजूदा पैरामीटर | नया पैरामीटर | ज़रूरी जानकारी |
---|---|---|
keyword |
मौजूद नहीं. इसके बजाय, Text Search (नया) का इस्तेमाल करें. | |
language |
languageCode |
|
location |
locationRestriction |
ज़रूरी है. |
maxprice/minprice |
|
मौजूद नहीं. |
maxResultCount |
नया पैरामीटर. | |
opennow |
|
मौजूद नहीं. |
pagetoken |
मौजूद नहीं. | |
radius |
|
locationRestriction का अभी इस्तेमाल करें. |
rankby |
rankPreference |
|
regionCode |
नया पैरामीटर. | |
type |
includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes
|
नए पैरामीटर में कई टाइप की वैल्यू भी स्वीकार की जाती हैं. मौजूदा एपीआई सिर्फ़ एक वैल्यू स्वीकार करता है. |
अनुरोध का उदाहरण
जीईटी अनुरोध के इस उदाहरण में, मौजूदा
आस-पास खोज की सुविधा का इस्तेमाल किया गया है. इस उदाहरण में, आपने JSON रिस्पॉन्स का अनुरोध किया है, जिसमें restaurant
टाइप की जगहों के बारे में जानकारी शामिल है. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया जाता है:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Nearby Search (नया) का इस्तेमाल करके, पोस्ट करने का अनुरोध किया जा सकता है और JSON अनुरोध के मुख्य हिस्से या हेडर में सभी पैरामीटर को पोस्ट अनुरोध के हिस्से के तौर पर पास किया जा सकता है. इस उदाहरण में फ़ील्ड मास्क का भी इस्तेमाल किया गया है, इसलिए जवाब में सिर्फ़ जगह का डिसप्ले नाम और फ़ॉर्मैट किया गया पता शामिल है:
curl -X POST -d '{ "includedTypes": ["restaurant"], "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } } }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \ https://places.googleapis.com/v1/places:searchNearby